| tag | 3c3f404f3491443bb71f387caa8fe803786cbce4 | |
|---|---|---|
| tagger | Camilla Berglund <elmindreda@elmindreda.org> | Sun Jan 18 17:48:22 2015 +0100 |
| object | 4188c263e31ec3d5da99a77d939ab56bc199fda6 |
Tagged 3.1 release.
| commit | 4188c263e31ec3d5da99a77d939ab56bc199fda6 | [log] [tgz] |
|---|---|---|
| author | Camilla Berglund <elmindreda@elmindreda.org> | Sun Jan 18 01:55:25 2015 +0100 |
| committer | Camilla Berglund <elmindreda@elmindreda.org> | Sun Jan 18 17:30:10 2015 +0100 |
| tree | cf8318a3f3210263e5a925b6c83b1d526a7551de | |
| parent | 3efff4e8de00f6e29099fd76a3750586b6c4a071 [diff] |
Documentation work.
GLFW is a free, Open Source, multi-platform library for OpenGL and OpenGL ES application development. It provides a simple, platform-independent API for creating windows and contexts, reading input, handling events, etc.
Version 3.1 adds improved documentation, support for custom system cursors, file drop events, main thread wake-up, window frame size retrieval, floating windows, character input with modifier keys, single buffered windows, build improvements and fixes for a large number of bugs.
If you are new to GLFW, you may find the introductory tutorial for GLFW 3 useful. If you have used GLFW 2 in the past, there is a transition guide for moving to the GLFW 3 API.
Note that a number of source files have been added or renamed in 3.1, which may require you to update any custom build files you have.
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 bundles a number of dependencies in the deps/ directory.
GLFWcursor custom system cursor handleglfwCreateCursor, glfwCreateStandardCursor, glfwDestroyCursor and glfwSetCursor for managing system cursor imagesGLFWimage struct for passing 32-bit RGBA imagesglfwSetDropCallback and GLFWdropfun for receiving dropped filesglfwPostEmptyEvent for allowing secondary threads to cause glfwWaitEvents to returnempty test program for verifying posting of empty eventsglfwSetCharModsCallback for receiving character events with modifiersglfwGetWindowFrameSize for retrieving the size of the frame around the client area of a windowGLFW_AUTO_ICONIFY for controlling whether full screen windows automatically iconify (and restore the previous video mode) on focus lossGLFW_DONT_CARE for indicating that any value is acceptableGLFW_DOUBLEBUFFER for controlling whether to use double bufferingGLFW_CONTEXT_RELEASE_BEHAVIOR and values GLFW_ANY_RELEASE_BEHAVIOR, GLFW_RELEASE_BEHAVIOR_FLUSH and GLFW_RELEASE_BEHAVIOR_NONE for GL_KHR_context_flush_control supportGLFW_INCLUDE_ES31 for including the OpenGL ES 3.1 headerGLFW_FLOATING for creating always-on-top windowed mode windowsGLFW_FOCUSED window hint for controlling initial input focusGLFW_REFRESH_RATE to GLFW_DONT_CARE to maintain the default behaviorglfwGetCursorPos to query the system directly for all cursor modes except captured modeGL_ARB_debug_output even when a debug context had not been requestedglfwExtensionSupported always failed for OpenGL ES 3.0 and later if the library was compiled for OpenGL ES_GLFW_USE_RETINA to control whether windows will use the full resolution on Retina displaysNSOpenGLViewNSScreen was found for a given CGDisplaywinmm.dllglfwShowWindowXRRGetScreenResources with XRRGetScreenResourcesCurrent for monitor property retrieval_NET_SUPPORTING_WM_CHECK root window property would cause an uncaught BadWindow errorGLX_SGIX_fbconfig was unavailableglfwDestroyWindow did not flush the output buffer"C" localeglfwInit were not detected (temporary inotify solution until proper libudev solution)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 questions related to the use of GLFW, we have a support forum, and the IRC channel #glfw on Freenode.
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, we have an occasionally active developer's mailing list, or you could join us on #glfw.
GLFW exists because people around the world donated their time and lent their skills.