|
@@ -4,21 +4,6 @@
|
|
|
|
|
|
@section news_33 Release notes for 3.3
|
|
@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
|
|
@subsection news_33_gamepad SDL_GameControllerDB support and gamepad input
|
|
|
|
|
|
GLFW now supports remapping of gamepads and controllers to a 360-like controller
|
|
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
|
|
@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
|
|
@subsection news_33_setwindowattrib Support for updating window attributes
|
|
@@ -64,28 +58,20 @@ windows with @ref glfwSetWindowAttrib.
|
|
@see @ref window_attribs
|
|
@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
|
|
@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
|
|
@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
|
|
@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.
|
|
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
|
|
@subsection news_33_centercursor Cursor centering window hint
|
|
|
|
|
|
GLFW now supports controlling whether the cursor is centered over newly created
|
|
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.
|
|
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
|
|
@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.
|
|
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
|
|
@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
|
|
As per the release of Mir 1.0, the recommended API is now Wayland, the
|