|tagger||Camilla Berglund <email@example.com>||Thu Jun 02 14:57:18 2016|
Tag 3.2 release
|author||Camilla Berglund <firstname.lastname@example.org>||Thu Jun 02 14:13:47 2016|
|committer||Camilla Berglund <email@example.com>||Thu Jun 02 14:13:47 2016|
Fix documentation for timer thread safety
GLFW is a free, Open Source, multi-platform library for OpenGL, OpenGL ES and Vulkan application development. It provides a simple, platform-independent API for creating windows, contexts and surfaces, reading input, handling events, etc.
Version 3.2 adds support for Vulkan surface creation, window mode switching, window maximization, window input focus control, window size and aspect ratio limits, human-readable key names, window icons, joystick connection events, XInput and DirectInput joystick input, event waiting with timeout, 64-bit integer raw timer, context-less window creation, error-less contexts via
GL_KHR_no_error (where available), run-time context creation API selection, Windows 8.1 per-monitor DPI and the CMake config-file package system, adds simpler build-time configuration, improved documentation and fixes for a large number of bugs that together affect all supported platforms.
See the Compiling GLFW guide in the GLFW documentation.
See the Building programs that use GLFW guide in the GLFW documentation.
Bugs are reported to our issue tracker. Please always include the name and version of the OS where the bug occurs and the version of GLFW used. If you have cloned it, include the commit ID used.
If it's a build issue, please also include the build log and the name and version of your development environment.
If it's a context creation issue, please also include the make and model of your graphics card and the version of your driver.
This will help both us and other people experiencing the same bug.
GLFW itself needs only the headers and libraries for your window system. It does not need the headers for any context creation API (WGL, GLX, EGL, NSGL) or rendering API (OpenGL, OpenGL ES, Vulkan) to enable support for them.
The examples and test programs depend on a number of tiny libraries. These are located in the
The Vulkan example additionally requires the Vulkan SDK to be installed, or it will not be included in the build.
The documentation is generated with Doxygen. If CMake does not find Doxygen, the documentation will not be generated.
glfwCreateWindowSurfacefor platform independent Vulkan support
glfwSetWindowMonitorfor switching between windowed and full screen modes and updating the monitor and desired video mode of full screen windows
GLFW_MAXIMIZEDfor window maximization
glfwFocusWindowfor giving windows input focus
glfwSetWindowAspectRatiofor setting absolute and relative window size limits
glfwGetKeyNamefor querying the layout-specific name of printable keys
glfwWaitEventsTimeoutfor waiting for events for a set amount of time
glfwSetWindowIconfor setting the icon of a window
glfwGetTimerFrequencyfor raw timer access
GLFWjoystickfunfor joystick connection and disconnection events
GLFW_NO_APIfor creating window without contexts
GLFW_INCLUDE_VULKANfor including the Vulkan header
GLFW_EGL_CONTEXT_APIfor run-time context creation API selection
GLFW_CONTEXT_NO_ERRORcontext hint for
GLFW_FALSEas client API independent boolean values
XI_Motionevents interfered with the Steam overlay
glfwGetGLXWindowto query the
GLXWindowof a window
_GLFW_USE_EGLPLATFORM_Hconfiguration macro for controlling whether to use an existing
The official website for GLFW is glfw.org. There you can find the latest version of GLFW, as well as news, documentation and other information about the project.
If you have a bug to report, a patch to submit or a feature you'd like to request, please file it in the issue tracker on GitHub.
Finally, if you're interested in helping out with the development of GLFW or porting it to your favorite platform, join us on GitHub or IRC.
GLFW exists because people around the world donated their time and lent their skills.