|
|
|
@ -4,21 +4,6 @@ |
|
|
|
|
|
|
|
|
|
@section news_33 Release notes for 3.3 |
|
|
|
|
|
|
|
|
|
@subsection news_33_focusonshow GLFW_FOCUS_ON_SHOW window hint and attribute |
|
|
|
|
|
|
|
|
|
GLFW now supports the [GLFW_FOCUS_ON_SHOW](@ref GLFW_DECORATED_hint) window hint |
|
|
|
|
and attribute for controlling input focus when calling @ref glfwShowWindow |
|
|
|
|
|
|
|
|
|
@see @ref window_hide |
|
|
|
|
|
|
|
|
|
@subsection news_33_geterror Error query |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the last error code for the calling thread and its |
|
|
|
|
human-readable description with @ref glfwGetError. |
|
|
|
|
|
|
|
|
|
@see @ref error_handling |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_gamepad SDL_GameControllerDB support and gamepad input |
|
|
|
|
|
|
|
|
|
GLFW now supports remapping of gamepads and controllers to a 360-like controller |
|
|
|
@ -29,28 +14,37 @@ and the input state struct @ref GLFWgamepadstate. |
|
|
|
|
@sa @ref gamepad |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_attention User attention request |
|
|
|
|
@subsection news_33_joyhats Support for joystick hats |
|
|
|
|
|
|
|
|
|
GLFW now supports requesting user attention to a specific window (on macOS to |
|
|
|
|
the application as a whole) with @ref glfwRequestWindowAttention. |
|
|
|
|
GLFW now supports querying the hats (or POVs or D-pads) of a joystick with @ref |
|
|
|
|
glfwGetJoystickHats. Hats are by default also exposed as buttons, but this can |
|
|
|
|
be disabled with the @ref GLFW_JOYSTICK_HAT_BUTTONS init hint. |
|
|
|
|
|
|
|
|
|
@see @ref window_attention |
|
|
|
|
@see @ref joystick_hat |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_maximize Window maximization callback |
|
|
|
|
@subsection news_33_contentscale Content scale queries for DPI-aware rendering |
|
|
|
|
|
|
|
|
|
GLFW now supports notifying the application that the window has been maximized |
|
|
|
|
@ref glfwSetWindowMaximizeCallback. |
|
|
|
|
GLFW now supports querying the window and monitor content scale, i.e. the ratio |
|
|
|
|
between the current DPI and the platform's default DPI, with @ref |
|
|
|
|
glfwGetWindowContentScale and @ref glfwGetMonitorContentScale. |
|
|
|
|
|
|
|
|
|
@see @ref window_maximize |
|
|
|
|
Changes of the content scale of a window can be received with the window content |
|
|
|
|
scale callback, set with @ref glfwSetWindowContentScaleCallback. |
|
|
|
|
|
|
|
|
|
The @ref GLFW_SCALE_TO_MONITOR window hint enables automatic resizing of a |
|
|
|
|
window by the content scale of the monitor it is placed, on platforms like |
|
|
|
|
Windows and X11 where this is necessary. |
|
|
|
|
|
|
|
|
|
@subsection news_33_keyscancode Platform-specific key scancode query |
|
|
|
|
@see @ref window_scale |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the platform dependent scancode of any physical key |
|
|
|
|
with @ref glfwGetKeyScancode. |
|
|
|
|
|
|
|
|
|
@see @ref input_key |
|
|
|
|
@subsection news_33_moltenvk Support for Vulkan on macOS via MoltenVK |
|
|
|
|
|
|
|
|
|
GLFW now supports the `VK_MVK_macos_surface` window surface creation extension |
|
|
|
|
provided by MoltenVK in the [LunarG Vulkan SDK](https://vulkan.lunarg.com/). |
|
|
|
|
|
|
|
|
|
@see @ref vulkan_guide |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_setwindowattrib Support for updating window attributes |
|
|
|
@ -64,28 +58,20 @@ windows with @ref glfwSetWindowAttrib. |
|
|
|
|
@see @ref window_attribs |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_contentscale Content scale queries for DPI-aware rendering |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the window and monitor content scale, i.e. the ratio |
|
|
|
|
between the current DPI and the platform's default DPI, with @ref |
|
|
|
|
glfwGetWindowContentScale and @ref glfwGetMonitorContentScale. |
|
|
|
|
|
|
|
|
|
Changes of the content scale of a window can be received with the window content |
|
|
|
|
scale callback, set with @ref glfwSetWindowContentScaleCallback. |
|
|
|
|
|
|
|
|
|
The @ref GLFW_SCALE_TO_MONITOR window hint enables automatic resizing of a |
|
|
|
|
window by the content scale of the monitor it is placed, on platforms like |
|
|
|
|
Windows and X11 where this is necessary. |
|
|
|
|
@subsection news_33_rawmotion Support for raw mouse motion |
|
|
|
|
|
|
|
|
|
@see @ref window_scale |
|
|
|
|
GLFW now supports raw (unscaled and unaccelerated) mouse motion in disabled |
|
|
|
|
cursor mode with the [GLFW_RAW_MOUSE_MOTION](@ref GLFW_RAW_MOUSE_MOTION) input |
|
|
|
|
mode. Call @ref glfwRawMouseMotionSupported to check if the current machine |
|
|
|
|
supports raw mouse motion. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_workarea Support for monitor work area |
|
|
|
|
@subsection news_33_geterror Error query |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the work area of a monitor, i.e. the area not |
|
|
|
|
occupied by task bars or global menu bars, with @ref glfwGetMonitorWorkarea. |
|
|
|
|
GLFW now supports querying the last error code for the calling thread and its |
|
|
|
|
human-readable description with @ref glfwGetError. |
|
|
|
|
|
|
|
|
|
@see @ref monitor_workarea |
|
|
|
|
@see @ref error_handling |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_inithint Support for initialization hints |
|
|
|
@ -105,13 +91,28 @@ features that are only available on a single platform. |
|
|
|
|
@see @ref window_hints_osx |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_joyhats Support for joystick hats |
|
|
|
|
@subsection news_33_attention User attention request |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the hats (or POVs or D-pads) of a joystick with @ref |
|
|
|
|
glfwGetJoystickHats. Hats are by default also exposed as buttons, but this can |
|
|
|
|
be disabled with the @ref GLFW_JOYSTICK_HAT_BUTTONS init hint. |
|
|
|
|
GLFW now supports requesting user attention to a specific window (on macOS to |
|
|
|
|
the application as a whole) with @ref glfwRequestWindowAttention. |
|
|
|
|
|
|
|
|
|
@see @ref joystick_hat |
|
|
|
|
@see @ref window_attention |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_maximize Window maximization callback |
|
|
|
|
|
|
|
|
|
GLFW now supports notifying the application that the window has been maximized |
|
|
|
|
@ref glfwSetWindowMaximizeCallback. |
|
|
|
|
|
|
|
|
|
@see @ref window_maximize |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_workarea Support for monitor work area |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the work area of a monitor, i.e. the area not |
|
|
|
|
occupied by task bars or global menu bars, with @ref glfwGetMonitorWorkarea. |
|
|
|
|
|
|
|
|
|
@see @ref monitor_workarea |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_transparent Support for transparent windows and framebuffers |
|
|
|
@ -127,6 +128,14 @@ window including decorations and unlike framebuffer transparency can be changed |
|
|
|
|
at any time after window creation. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_keyscancode Platform-specific key scancode query |
|
|
|
|
|
|
|
|
|
GLFW now supports querying the platform dependent scancode of any physical key |
|
|
|
|
with @ref glfwGetKeyScancode. |
|
|
|
|
|
|
|
|
|
@see @ref input_key |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_centercursor Cursor centering window hint |
|
|
|
|
|
|
|
|
|
GLFW now supports controlling whether the cursor is centered over newly created |
|
|
|
@ -141,20 +150,26 @@ area with the [GLFW_HOVERED](@ref GLFW_HOVERED_attrib) window attribute. This |
|
|
|
|
attribute corresponds to the [cursor enter/leave](@ref cursor_enter) event. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_rawmotion Support for raw mouse motion |
|
|
|
|
@subsection news_33_focusonshow GLFW_FOCUS_ON_SHOW window hint and attribute |
|
|
|
|
|
|
|
|
|
GLFW now supports raw (unscaled and unaccelerated) mouse motion in disabled |
|
|
|
|
cursor mode with the [GLFW_RAW_MOUSE_MOTION](@ref GLFW_RAW_MOUSE_MOTION) input |
|
|
|
|
mode. Call @ref glfwRawMouseMotionSupported to check if the current machine |
|
|
|
|
supports raw mouse motion. |
|
|
|
|
GLFW now supports the [GLFW_FOCUS_ON_SHOW](@ref GLFW_DECORATED_hint) window hint |
|
|
|
|
and attribute for controlling input focus when calling @ref glfwShowWindow |
|
|
|
|
|
|
|
|
|
@see @ref window_hide |
|
|
|
|
|
|
|
|
|
@subsection news_33_moltenvk Support for Vulkan on macOS via MoltenVK |
|
|
|
|
|
|
|
|
|
GLFW now supports the `VK_MVK_macos_surface` window surface creation extension |
|
|
|
|
provided by MoltenVK in the [LunarG Vulkan SDK](https://vulkan.lunarg.com/). |
|
|
|
|
@subsection news_33_userptr Monitor and joystick user pointers |
|
|
|
|
|
|
|
|
|
@see @ref vulkan_guide |
|
|
|
|
GLFW now supports setting and querying user pointers for connected monitors and |
|
|
|
|
joysticks with @ref glfwSetMonitorUserPointer, @ref glfwGetMonitorUserPointer, |
|
|
|
|
@ref glfwSetJoystickUserPointer and @ref glfwGetJoystickUserPointer. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_primary X11 primary selection access |
|
|
|
|
|
|
|
|
|
GLFW now supports querying and setting the X11 primary selection via the native |
|
|
|
|
access functions @ref glfwGetX11SelectionString and @ref |
|
|
|
|
glfwSetX11SelectionString. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_osmesa OSMesa backend for headless software rendering |
|
|
|
@ -169,20 +184,6 @@ creation API, intended for automated testing. This backend does not provide |
|
|
|
|
input. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_userptr Monitor and joystick user pointers |
|
|
|
|
|
|
|
|
|
GLFW now supports setting and querying user pointers for connected monitors and |
|
|
|
|
joysticks with @ref glfwSetMonitorUserPointer, @ref glfwGetMonitorUserPointer, |
|
|
|
|
@ref glfwSetJoystickUserPointer and @ref glfwGetJoystickUserPointer. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_primary X11 primary selection access |
|
|
|
|
|
|
|
|
|
GLFW now supports querying and setting the X11 primary selection via the native |
|
|
|
|
access functions @ref glfwGetX11SelectionString and @ref |
|
|
|
|
glfwSetX11SelectionString. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@subsection news_33_mir_removal Experimental Mir support has been removed |
|
|
|
|
|
|
|
|
|
As per the release of Mir 1.0, the recommended API is now Wayland, the |
|
|
|
|