From 6ada069737738bca2f54124c2c28d987c2cd1de3 Mon Sep 17 00:00:00 2001
From: ConfiG <cgytrus@cgyt.ru>
Date: Thu, 1 Jun 2023 23:04:05 +0300
Subject: [PATCH] fix glfw headers
---
.../include/Geode/cocos/robtop/glfw/glfw3.h | 1925 +++++++++++++----
.../include/Geode/cocos/robtop/glfw/glfw3.lib | Bin 123840 -> 0 bytes
.../Geode/cocos/robtop/glfw/glfw3native.h | 219 +-
3 files changed, 1679 insertions(+), 465 deletions(-)
delete mode 100644 loader/include/Geode/cocos/robtop/glfw/glfw3.lib
diff --git a/loader/include/Geode/cocos/robtop/glfw/glfw3.h b/loader/include/Geode/cocos/robtop/glfw/glfw3.h
index 2e969af8..89414491 100644
--- a/loader/include/Geode/cocos/robtop/glfw/glfw3.h
+++ b/loader/include/Geode/cocos/robtop/glfw/glfw3.h
@@ -1,5 +1,5 @@
/*************************************************************************
- * GLFW 3.0 - www.glfw.org
+ * GLFW 3.1 - www.glfw.org
* A library for OpenGL, window and input
*------------------------------------------------------------------------
* Copyright (c) 2002-2006 Marcus Geelnard
@@ -38,23 +38,27 @@ extern "C" {
* Doxygen documentation
*************************************************************************/
-/*! @defgroup clipboard Clipboard support
- */
/*! @defgroup context Context handling
+ *
+ * This is the reference documentation for context related functions. For more
+ * information, see the @ref context.
*/
-/*! @defgroup error Error handling
- */
-/*! @defgroup init Initialization and version information
+/*! @defgroup init Initialization, version and errors
+ *
+ * This is the reference documentation for initialization and termination of
+ * the library, version management and error handling. For more information,
+ * see the @ref intro.
*/
/*! @defgroup input Input handling
+ *
+ * This is the reference documentation for input related functions and types.
+ * For more information, see the @ref input.
*/
/*! @defgroup monitor Monitor handling
*
* This is the reference documentation for monitor related functions and types.
* For more information, see the @ref monitor.
*/
-/*! @defgroup time Time input
- */
/*! @defgroup window Window handling
*
* This is the reference documentation for window related functions and types,
@@ -140,67 +144,81 @@ extern "C" {
/* Include the chosen client API headers.
*/
#if defined(__APPLE_CC__)
- #if defined(GLFW_INCLUDE_GLCOREARB)
- #include <OpenGL/gl3.h>
- #elif !defined(GLFW_INCLUDE_NONE)
- #if defined(__arm64__)
- #include <OpenGLES/ES1/gl.h> // idk
- #else
- #define GL_GLEXT_LEGACY
- #include <OpenGL/gl.h>
- #endif
+ #if defined(GLFW_INCLUDE_GLCOREARB)
+ #include <OpenGL/gl3.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+ #include <OpenGL/gl3ext.h>
#endif
- #if defined(GLFW_INCLUDE_GLU)
- #include <OpenGL/glu.h>
+ #elif !defined(GLFW_INCLUDE_NONE)
+ #if !defined(GLFW_INCLUDE_GLEXT)
+ #define GL_GLEXT_LEGACY
#endif
+ #include <OpenGL/gl.h>
+ #endif
+ #if defined(GLFW_INCLUDE_GLU)
+ #include <OpenGL/glu.h>
+ #endif
#else
- #if defined(GLFW_INCLUDE_GLCOREARB)
- #include <GL/glcorearb.h>
- #elif defined(GLFW_INCLUDE_ES1)
- #include <GLES/gl.h>
- #elif defined(GLFW_INCLUDE_ES2)
- #include <GLES2/gl2.h>
- #elif defined(GLFW_INCLUDE_ES3)
- #include <GLES3/gl3.h>
- #elif !defined(GLFW_INCLUDE_NONE)
- #include <GL/gl.h>
+ #if defined(GLFW_INCLUDE_GLCOREARB)
+ #include <GL/glcorearb.h>
+ #elif defined(GLFW_INCLUDE_ES1)
+ #include <GLES/gl.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+ #include <GLES/glext.h>
#endif
- #if defined(GLFW_INCLUDE_GLU)
- #include <GL/glu.h>
+ #elif defined(GLFW_INCLUDE_ES2)
+ #include <GLES2/gl2.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+ #include <GLES2/gl2ext.h>
#endif
+ #elif defined(GLFW_INCLUDE_ES3)
+ #include <GLES3/gl3.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+ #include <GLES3/gl2ext.h>
+ #endif
+ #elif defined(GLFW_INCLUDE_ES31)
+ #include <GLES3/gl31.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+ #include <GLES3/gl2ext.h>
+ #endif
+ #elif !defined(GLFW_INCLUDE_NONE)
+ #include <GL/gl.h>
+ #if defined(GLFW_INCLUDE_GLEXT)
+ #include <GL/glext.h>
+ #endif
+ #endif
+ #if defined(GLFW_INCLUDE_GLU)
+ #include <GL/glu.h>
+ #endif
#endif
#if defined(GLFW_DLL) && defined(_GLFW_BUILD_DLL)
- /* GLFW_DLL is defined by users of GLFW when compiling programs that will link
- * to the DLL version of the GLFW library. _GLFW_BUILD_DLL is defined by the
- * GLFW configuration header when compiling the DLL version of the library.
+ /* GLFW_DLL must be defined by applications that are linking against the DLL
+ * version of the GLFW library. _GLFW_BUILD_DLL is defined by the GLFW
+ * configuration header when compiling the DLL version of the library.
*/
#error "You must not have both GLFW_DLL and _GLFW_BUILD_DLL defined"
#endif
+/* GLFWAPI is used to declare public API functions for export
+ * from the DLL / shared library / dynamic library.
+ */
#if defined(_WIN32) && defined(_GLFW_BUILD_DLL)
-
- /* We are building a Win32 DLL */
+ /* We are building GLFW as a Win32 DLL */
#define GLFWAPI __declspec(dllexport)
-
#elif defined(_WIN32) && defined(GLFW_DLL)
-
- /* We are calling a Win32 DLL */
+ /* We are calling GLFW as a Win32 DLL */
#if defined(__LCC__)
#define GLFWAPI extern
#else
#define GLFWAPI __declspec(dllimport)
#endif
-
#elif defined(__GNUC__) && defined(_GLFW_BUILD_DLL)
-
+ /* We are building GLFW as a shared / dynamic library */
#define GLFWAPI __attribute__((visibility("default")))
-
#else
-
- /* We are either building/calling a static lib or we are non-win32 */
+ /* We are building or calling GLFW as a static library */
#define GLFWAPI
-
#endif
/* -------------------- END SYSTEM/COMPILER SPECIFIC --------------------- */
@@ -224,27 +242,36 @@ extern "C" {
* backward-compatible.
* @ingroup init
*/
-#define GLFW_VERSION_MINOR 0
+#define GLFW_VERSION_MINOR 1
/*! @brief The revision number of the GLFW library.
*
* This is incremented when a bug fix release is made that does not contain any
* API changes.
* @ingroup init
*/
-#define GLFW_VERSION_REVISION 4
+#define GLFW_VERSION_REVISION 0
/*! @} */
/*! @name Key and button actions
* @{ */
-/*! @brief The key or button was released.
+/*! @brief The key or mouse button was released.
+ *
+ * The key or mouse button was released.
+ *
* @ingroup input
*/
#define GLFW_RELEASE 0
-/*! @brief The key or button was pressed.
+/*! @brief The key or mouse button was pressed.
+ *
+ * The key or mouse button was pressed.
+ *
* @ingroup input
*/
#define GLFW_PRESS 1
/*! @brief The key was held down until it repeated.
+ *
+ * The key was held down until it repeated.
+ *
* @ingroup input
*/
#define GLFW_REPEAT 2
@@ -252,20 +279,22 @@ extern "C" {
/*! @defgroup keys Keyboard keys
*
- * These key codes are inspired by the *USB HID Usage Tables v1.12* (p. 53-60),
- * but re-arranged to map to 7-bit ASCII for printable keys (function keys are
- * put in the 256+ range).
+ * See [key input](@ref input_key) for how these are used.
*
- * The naming of the key codes follow these rules:
- * - The US keyboard layout is used
- * - Names of printable alpha-numeric characters are used (e.g. "A", "R",
- * "3", etc.)
- * - For non-alphanumeric characters, Unicode:ish names are used (e.g.
- * "COMMA", "LEFT_SQUARE_BRACKET", etc.). Note that some names do not
- * correspond to the Unicode standard (usually for brevity)
- * - Keys that lack a clear US mapping are named "WORLD_x"
- * - For non-printable keys, custom names are used (e.g. "F4",
- * "BACKSPACE", etc.)
+ * These key codes are inspired by the _USB HID Usage Tables v1.12_ (p. 53-60),
+ * but re-arranged to map to 7-bit ASCII for printable keys (function keys are
+ * put in the 256+ range).
+ *
+ * The naming of the key codes follow these rules:
+ * - The US keyboard layout is used
+ * - Names of printable alpha-numeric characters are used (e.g. "A", "R",
+ * "3", etc.)
+ * - For non-alphanumeric characters, Unicode:ish names are used (e.g.
+ * "COMMA", "LEFT_SQUARE_BRACKET", etc.). Note that some names do not
+ * correspond to the Unicode standard (usually for brevity)
+ * - Keys that lack a clear US mapping are named "WORLD_x"
+ * - For non-printable keys, custom names are used (e.g. "F4",
+ * "BACKSPACE", etc.)
*
* @ingroup input
* @{
@@ -402,6 +431,9 @@ extern "C" {
/*! @} */
/*! @defgroup mods Modifier key flags
+ *
+ * See [key input](@ref input_key) for how these are used.
+ *
* @ingroup input
* @{ */
@@ -421,6 +453,9 @@ extern "C" {
/*! @} */
/*! @defgroup buttons Mouse buttons
+ *
+ * See [mouse button input](@ref input_mouse_button) for how these are used.
+ *
* @ingroup input
* @{ */
#define GLFW_MOUSE_BUTTON_1 0
@@ -438,6 +473,9 @@ extern "C" {
/*! @} */
/*! @defgroup joysticks Joysticks
+ *
+ * See [joystick input](@ref joystick) for how these are used.
+ *
* @ingroup input
* @{ */
#define GLFW_JOYSTICK_1 0
@@ -460,36 +498,128 @@ extern "C" {
/*! @} */
/*! @defgroup errors Error codes
- * @ingroup error
+ *
+ * See [error handling](@ref error_handling) for how these are used.
+ *
+ * @ingroup init
* @{ */
/*! @brief GLFW has not been initialized.
+ *
+ * This occurs if a GLFW function was called that may not be called unless the
+ * library is [initialized](@ref intro_init).
+ *
+ * @par Analysis
+ * Application programmer error. Initialize GLFW before calling any function
+ * that requires initialization.
*/
#define GLFW_NOT_INITIALIZED 0x00010001
/*! @brief No context is current for this thread.
+ *
+ * This occurs if a GLFW function was called that needs and operates on the
+ * current OpenGL or OpenGL ES context but no context is current on the calling
+ * thread. One such function is @ref glfwSwapInterval.
+ *
+ * @par Analysis
+ * Application programmer error. Ensure a context is current before calling
+ * functions that require a current context.
*/
#define GLFW_NO_CURRENT_CONTEXT 0x00010002
-/*! @brief One of the enum parameters for the function was given an invalid
- * enum.
+/*! @brief One of the arguments to the function was an invalid enum value.
+ *
+ * One of the arguments to the function was an invalid enum value, for example
+ * requesting [GLFW_RED_BITS](@ref window_hints_fb) with @ref
+ * glfwGetWindowAttrib.
+ *
+ * @par Analysis
+ * Application programmer error. Fix the offending call.
*/
#define GLFW_INVALID_ENUM 0x00010003
-/*! @brief One of the parameters for the function was given an invalid value.
+/*! @brief One of the arguments to the function was an invalid value.
+ *
+ * One of the arguments to the function was an invalid value, for example
+ * requesting a non-existent OpenGL or OpenGL ES version like 2.7.
+ *
+ * Requesting a valid but unavailable OpenGL or OpenGL ES version will instead
+ * result in a @ref GLFW_VERSION_UNAVAILABLE error.
+ *
+ * @par Analysis
+ * Application programmer error. Fix the offending call.
*/
#define GLFW_INVALID_VALUE 0x00010004
/*! @brief A memory allocation failed.
+ *
+ * A memory allocation failed.
+ *
+ * @par Analysis
+ * A bug in GLFW or the underlying operating system. Report the bug to our
+ * [issue tracker](https://github.com/glfw/glfw/issues).
*/
#define GLFW_OUT_OF_MEMORY 0x00010005
/*! @brief GLFW could not find support for the requested client API on the
* system.
+ *
+ * GLFW could not find support for the requested client API on the system.
+ *
+ * @par Analysis
+ * The installed graphics driver does not support the requested client API, or
+ * does not support it via the chosen context creation backend. Below are
+ * a few examples.
+ *
+ * @par
+ * Some pre-installed Windows graphics drivers do not support OpenGL. AMD only
+ * supports OpenGL ES via EGL, while Nvidia and Intel only supports it via
+ * a WGL or GLX extension. OS X does not provide OpenGL ES at all. The Mesa
+ * EGL, OpenGL and OpenGL ES libraries do not interface with the Nvidia binary
+ * driver.
*/
#define GLFW_API_UNAVAILABLE 0x00010006
-/*! @brief The requested client API version is not available.
+/*! @brief The requested OpenGL or OpenGL ES version is not available.
+ *
+ * The requested OpenGL or OpenGL ES version (including any requested profile
+ * or context option) is not available on this machine.
+ *
+ * @par Analysis
+ * The machine does not support your requirements. If your application is
+ * sufficiently flexible, downgrade your requirements and try again.
+ * Otherwise, inform the user that their machine does not match your
+ * requirements.
+ *
+ * @par
+ * Future invalid OpenGL and OpenGL ES versions, for example OpenGL 4.8 if 5.0
+ * comes out before the 4.x series gets that far, also fail with this error and
+ * not @ref GLFW_INVALID_VALUE, because GLFW cannot know what future versions
+ * will exist.
*/
#define GLFW_VERSION_UNAVAILABLE 0x00010007
/*! @brief A platform-specific error occurred that does not match any of the
* more specific categories.
+ *
+ * A platform-specific error occurred that does not match any of the more
+ * specific categories.
+ *
+ * @par Analysis
+ * A bug in GLFW or the underlying operating system. Report the bug to our
+ * [issue tracker](https://github.com/glfw/glfw/issues).
*/
#define GLFW_PLATFORM_ERROR 0x00010008
-/*! @brief The clipboard did not contain data in the requested format.
+/*! @brief The requested format is not supported or available.
+ *
+ * If emitted during window creation, the requested pixel format is not
+ * supported.
+ *
+ * If emitted when querying the clipboard, the contents of the clipboard could
+ * not be converted to the requested format.
+ *
+ * @par Analysis
+ * If emitted during window creation, one or more
+ * [hard constraints](@ref window_hints_hard) did not match any of the
+ * available pixel formats. If your application is sufficiently flexible,
+ * downgrade your requirements and try again. Otherwise, inform the user that
+ * their machine does not match your requirements.
+ *
+ * @par
+ * If emitted when querying the clipboard, ignore the error or report it to
+ * the user, as appropriate.
*/
#define GLFW_FORMAT_UNAVAILABLE 0x00010009
/*! @} */
@@ -499,6 +629,8 @@ extern "C" {
#define GLFW_RESIZABLE 0x00020003
#define GLFW_VISIBLE 0x00020004
#define GLFW_DECORATED 0x00020005
+#define GLFW_AUTO_ICONIFY 0x00020006
+#define GLFW_FLOATING 0x00020007
#define GLFW_RED_BITS 0x00021001
#define GLFW_GREEN_BITS 0x00021002
@@ -515,6 +647,7 @@ extern "C" {
#define GLFW_SAMPLES 0x0002100D
#define GLFW_SRGB_CAPABLE 0x0002100E
#define GLFW_REFRESH_RATE 0x0002100F
+#define GLFW_DOUBLEBUFFER 0x00021010
#define GLFW_CLIENT_API 0x00022001
#define GLFW_CONTEXT_VERSION_MAJOR 0x00022002
@@ -524,6 +657,7 @@ extern "C" {
#define GLFW_OPENGL_FORWARD_COMPAT 0x00022006
#define GLFW_OPENGL_DEBUG_CONTEXT 0x00022007
#define GLFW_OPENGL_PROFILE 0x00022008
+#define GLFW_CONTEXT_RELEASE_BEHAVIOR 0x00022009
#define GLFW_OPENGL_API 0x00030001
#define GLFW_OPENGL_ES_API 0x00030002
@@ -544,9 +678,54 @@ extern "C" {
#define GLFW_CURSOR_HIDDEN 0x00034002
#define GLFW_CURSOR_DISABLED 0x00034003
+#define GLFW_ANY_RELEASE_BEHAVIOR 0
+#define GLFW_RELEASE_BEHAVIOR_FLUSH 0x00035001
+#define GLFW_RELEASE_BEHAVIOR_NONE 0x00035002
+
+/*! @defgroup shapes Standard cursor shapes
+ *
+ * See [standard cursor creation](@ref cursor_standard) for how these are used.
+ *
+ * @ingroup input
+ * @{ */
+
+/*! @brief The regular arrow cursor shape.
+ *
+ * The regular arrow cursor.
+ */
+#define GLFW_ARROW_CURSOR 0x00036001
+/*! @brief The text input I-beam cursor shape.
+ *
+ * The text input I-beam cursor shape.
+ */
+#define GLFW_IBEAM_CURSOR 0x00036002
+/*! @brief The crosshair shape.
+ *
+ * The crosshair shape.
+ */
+#define GLFW_CROSSHAIR_CURSOR 0x00036003
+/*! @brief The hand shape.
+ *
+ * The hand shape.
+ */
+#define GLFW_HAND_CURSOR 0x00036004
+/*! @brief The horizontal resize arrow shape.
+ *
+ * The horizontal resize arrow shape.
+ */
+#define GLFW_HRESIZE_CURSOR 0x00036005
+/*! @brief The vertical resize arrow shape.
+ *
+ * The vertical resize arrow shape.
+ */
+#define GLFW_VRESIZE_CURSOR 0x00036006
+/*! @} */
+
#define GLFW_CONNECTED 0x00040001
#define GLFW_DISCONNECTED 0x00040002
+#define GLFW_DONT_CARE -1
+
/*************************************************************************
* GLFW API types
@@ -577,6 +756,14 @@ typedef struct GLFWmonitor GLFWmonitor;
*/
typedef struct GLFWwindow GLFWwindow;
+/*! @brief Opaque cursor object.
+ *
+ * Opaque cursor object.
+ *
+ * @ingroup cursor
+ */
+typedef struct GLFWcursor GLFWcursor;
+
/*! @brief The function signature for error callbacks.
*
* This is the function signature for error callback functions.
@@ -586,7 +773,7 @@ typedef struct GLFWwindow GLFWwindow;
*
* @sa glfwSetErrorCallback
*
- * @ingroup error
+ * @ingroup init
*/
typedef void (* GLFWerrorfun)(int,const char*);
@@ -594,7 +781,7 @@ typedef void (* GLFWerrorfun)(int,const char*);
*
* This is the function signature for window position callback functions.
*
- * @param[in] window The window that the user moved.
+ * @param[in] window The window that was moved.
* @param[in] xpos The new x-coordinate, in screen coordinates, of the
* upper-left corner of the client area of the window.
* @param[in] ypos The new y-coordinate, in screen coordinates, of the
@@ -610,7 +797,7 @@ typedef void (* GLFWwindowposfun)(GLFWwindow*,int,int);
*
* This is the function signature for window size callback functions.
*
- * @param[in] window The window that the user resized.
+ * @param[in] window The window that was resized.
* @param[in] width The new width, in screen coordinates, of the window.
* @param[in] height The new height, in screen coordinates, of the window.
*
@@ -648,9 +835,9 @@ typedef void (* GLFWwindowrefreshfun)(GLFWwindow*);
*
* This is the function signature for window focus callback functions.
*
- * @param[in] window The window that was focused or defocused.
- * @param[in] focused `GL_TRUE` if the window was focused, or `GL_FALSE` if
- * it was defocused.
+ * @param[in] window The window that gained or lost input focus.
+ * @param[in] focused `GL_TRUE` if the window was given input focus, or
+ * `GL_FALSE` if it lost it.
*
* @sa glfwSetWindowFocusCallback
*
@@ -754,7 +941,7 @@ typedef void (* GLFWscrollfun)(GLFWwindow*,double,double);
* @param[in] window The window that received the event.
* @param[in] key The [keyboard key](@ref keys) that was pressed or released.
* @param[in] scancode The system-specific scancode of the key.
- * @param[in] action @ref GLFW_PRESS, @ref GLFW_RELEASE or @ref GLFW_REPEAT.
+ * @param[in] action `GLFW_PRESS`, `GLFW_RELEASE` or `GLFW_REPEAT`.
* @param[in] mods Bit field describing which [modifier keys](@ref mods) were
* held down.
*
@@ -777,6 +964,38 @@ typedef void (* GLFWkeyfun)(GLFWwindow*,int,int,int,int);
*/
typedef void (* GLFWcharfun)(GLFWwindow*,unsigned int);
+/*! @brief The function signature for Unicode character with modifiers
+ * callbacks.
+ *
+ * This is the function signature for Unicode character with modifiers callback
+ * functions. It is called for each input character, regardless of what
+ * modifier keys are held down.
+ *
+ * @param[in] window The window that received the event.
+ * @param[in] codepoint The Unicode code point of the character.
+ * @param[in] mods Bit field describing which [modifier keys](@ref mods) were
+ * held down.
+ *
+ * @sa glfwSetCharModsCallback
+ *
+ * @ingroup input
+ */
+typedef void (* GLFWcharmodsfun)(GLFWwindow*,unsigned int,int);
+
+/*! @brief The function signature for file drop callbacks.
+ *
+ * This is the function signature for file drop callbacks.
+ *
+ * @param[in] window The window that received the event.
+ * @param[in] count The number of dropped files.
+ * @param[in] names The UTF-8 encoded path names of the dropped files.
+ *
+ * @sa glfwSetDropCallback
+ *
+ * @ingroup input
+ */
+typedef void (* GLFWdropfun)(GLFWwindow*,int,const char**);
+
/*! @brief The function signature for monitor configuration callbacks.
*
* This is the function signature for monitor configuration callback functions.
@@ -842,6 +1061,21 @@ typedef struct GLFWgammaramp
unsigned int size;
} GLFWgammaramp;
+/*! @brief Image data.
+ */
+typedef struct GLFWimage
+{
+ /*! The width, in pixels, of this image.
+ */
+ int width;
+ /*! The height, in pixels, of this image.
+ */
+ int height;
+ /*! The pixel data of this image, arranged left-to-right, top-to-bottom.
+ */
+ unsigned char* pixels;
+} GLFWimage;
+
/*************************************************************************
* GLFW API functions
@@ -850,53 +1084,70 @@ typedef struct GLFWgammaramp
/*! @brief Initializes the GLFW library.
*
* This function initializes the GLFW library. Before most GLFW functions can
- * be used, GLFW must be initialized, and before a program terminates GLFW
+ * be used, GLFW must be initialized, and before an application terminates GLFW
* should be terminated in order to free any resources allocated during or
* after initialization.
*
* If this function fails, it calls @ref glfwTerminate before returning. If it
- * succeeds, you should call @ref glfwTerminate before the program exits.
+ * succeeds, you should call @ref glfwTerminate before the application exits.
*
* Additional calls to this function after successful initialization but before
- * termination will succeed but will do nothing.
+ * termination will return `GL_TRUE` immediately.
*
- * @return `GL_TRUE` if successful, or `GL_FALSE` if an error occurred.
+ * @return `GL_TRUE` if successful, or `GL_FALSE` if an
+ * [error](@ref error_handling) occurred.
*
- * @par New in GLFW 3
- * This function no longer registers @ref glfwTerminate with `atexit`.
- *
- * @note This function may only be called from the main thread.
- *
- * @note **OS X:** This function will change the current directory of the
+ * @remarks __OS X:__ This function will change the current directory of the
* application to the `Contents/Resources` subdirectory of the application's
- * bundle, if present.
+ * bundle, if present. This can be disabled with a
+ * [compile-time option](@ref compile_options_osx).
*
+ * @remarks __X11:__ If the `LC_CTYPE` category of the current locale is set to
+ * `"C"` then the environment's locale will be applied to that category. This
+ * is done because character input will not function when `LC_CTYPE` is set to
+ * `"C"`. If another locale was set before this function was called, it will
+ * be left untouched.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref intro_init
* @sa glfwTerminate
*
+ * @since Added in GLFW 1.0.
+ *
* @ingroup init
*/
GLFWAPI int glfwInit(void);
/*! @brief Terminates the GLFW library.
*
- * This function destroys all remaining windows, frees any allocated resources
- * and sets the library to an uninitialized state. Once this is called, you
- * must again call @ref glfwInit successfully before you will be able to use
- * most GLFW functions.
+ * This function destroys all remaining windows and cursors, restores any
+ * modified gamma ramps and frees any other allocated resources. Once this
+ * function is called, you must again call @ref glfwInit successfully before
+ * you will be able to use most GLFW functions.
*
* If GLFW has been successfully initialized, this function should be called
- * before the program exits. If initialization fails, there is no need to call
- * this function, as it is called by @ref glfwInit before it returns failure.
+ * before the application exits. If initialization fails, there is no need to
+ * call this function, as it is called by @ref glfwInit before it returns
+ * failure.
*
* @remarks This function may be called before @ref glfwInit.
*
- * @note This function may only be called from the main thread.
- *
* @warning No window's context may be current on another thread when this
* function is called.
*
+ * @par Reentrancy
+ * This function may not be called from a callback.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref intro_init
* @sa glfwInit
*
+ * @since Added in GLFW 1.0.
+ *
* @ingroup init
*/
GLFWAPI void glfwTerminate(void);
@@ -907,46 +1158,55 @@ GLFWAPI void glfwTerminate(void);
* library. It is intended for when you are using GLFW as a shared library and
* want to ensure that you are using the minimum required version.
*
+ * Any or all of the version arguments may be `NULL`. This function always
+ * succeeds.
+ *
* @param[out] major Where to store the major version number, or `NULL`.
* @param[out] minor Where to store the minor version number, or `NULL`.
* @param[out] rev Where to store the revision number, or `NULL`.
*
* @remarks This function may be called before @ref glfwInit.
*
- * @remarks This function may be called from any thread.
+ * @par Thread Safety
+ * This function may be called from any thread.
*
+ * @sa @ref intro_version
* @sa glfwGetVersionString
*
+ * @since Added in GLFW 1.0.
+ *
* @ingroup init
*/
GLFWAPI void glfwGetVersion(int* major, int* minor, int* rev);
/*! @brief Returns a string describing the compile-time configuration.
*
- * This function returns a static string generated at compile-time according to
- * which configuration macros were defined. This is intended for use when
- * submitting bug reports, to allow developers to see which code paths are
- * enabled in a binary.
+ * This function returns the compile-time generated
+ * [version string](@ref intro_version_string) of the GLFW library binary. It
+ * describes the version, platform, compiler and any platform-specific
+ * compile-time options.
*
- * The format of the string is as follows:
- * - The version of GLFW
- * - The name of the window system API
- * - The name of the context creation API
- * - Any additional options or APIs
+ * __Do not use the version string__ to parse the GLFW library version. The
+ * @ref glfwGetVersion function already provides the version of the running
+ * library binary.
*
- * For example, when compiling GLFW 3.0 with MinGW using the Win32 and WGL
- * back ends, the version string may look something like this:
- *
- * 3.0.0 Win32 WGL MinGW
+ * This function always succeeds.
*
* @return The GLFW version string.
*
* @remarks This function may be called before @ref glfwInit.
*
- * @remarks This function may be called from any thread.
+ * @par Pointer Lifetime
+ * The returned string is static and compile-time generated.
*
+ * @par Thread Safety
+ * This function may be called from any thread.
+ *
+ * @sa @ref intro_version
* @sa glfwGetVersion
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup init
*/
GLFWAPI const char* glfwGetVersionString(void);
@@ -956,23 +1216,31 @@ GLFWAPI const char* glfwGetVersionString(void);
* This function sets the error callback, which is called with an error code
* and a human-readable description each time a GLFW error occurs.
*
+ * The error callback is called on the thread where the error occurred. If you
+ * are using GLFW from multiple threads, your error callback needs to be
+ * written accordingly.
+ *
+ * Because the description string may have been generated specifically for that
+ * error, it is not guaranteed to be valid after the callback has returned. If
+ * you wish to use it after the callback returns, you need to make a copy.
+ *
+ * Once set, the error callback remains set even after the library has been
+ * terminated.
+ *
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set.
*
* @remarks This function may be called before @ref glfwInit.
*
- * @note The error callback is called by the thread where the error was
- * generated. If you are using GLFW from multiple threads, your error callback
- * needs to be written accordingly.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
- * @note Because the description string provided to the callback may have been
- * generated specifically for that error, it is not guaranteed to be valid
- * after the callback has returned. If you wish to use it after that, you need
- * to make your own copy of it before returning.
+ * @sa @ref error_handling
*
- * @ingroup error
+ * @since Added in GLFW 3.0.
+ *
+ * @ingroup init
*/
GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);
@@ -981,19 +1249,25 @@ GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);
* This function returns an array of handles for all currently connected
* monitors.
*
- * @param[out] count Where to store the size of the returned array. This is
- * set to zero if an error occurred.
- * @return An array of monitor handles, or `NULL` if an error occurred.
+ * @param[out] count Where to store the number of monitors in the returned
+ * array. This is set to zero if an error occurred.
+ * @return An array of monitor handles, or `NULL` if an
+ * [error](@ref error_handling) occurred.
*
- * @note The returned array is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned array is allocated and freed by GLFW. You should not free it
+ * yourself. It is guaranteed to be valid only until the monitor configuration
+ * changes or the library is terminated.
*
- * @note The returned array is valid only until the monitor configuration
- * changes. See @ref glfwSetMonitorCallback to receive notifications of
- * configuration changes.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref monitor_monitors
+ * @sa @ref monitor_event
* @sa glfwGetPrimaryMonitor
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup monitor
*/
GLFWAPI GLFWmonitor** glfwGetMonitors(int* count);
@@ -1003,10 +1277,17 @@ GLFWAPI GLFWmonitor** glfwGetMonitors(int* count);
* This function returns the primary monitor. This is usually the monitor
* where elements like the Windows task bar or the OS X menu bar is located.
*
- * @return The primary monitor, or `NULL` if an error occurred.
+ * @return The primary monitor, or `NULL` if an [error](@ref error_handling)
+ * occurred.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_monitors
* @sa glfwGetMonitors
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup monitor
*/
GLFWAPI GLFWmonitor* glfwGetPrimaryMonitor(void);
@@ -1016,10 +1297,20 @@ GLFWAPI GLFWmonitor* glfwGetPrimaryMonitor(void);
* This function returns the position, in screen coordinates, of the upper-left
* corner of the specified monitor.
*
+ * Any or all of the position arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` position arguments will be set to zero.
+ *
* @param[in] monitor The monitor to query.
* @param[out] xpos Where to store the monitor x-coordinate, or `NULL`.
* @param[out] ypos Where to store the monitor y-coordinate, or `NULL`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_properties
+ *
+ * @since Added in GLFW 3.0.
+ *
* @ingroup monitor
*/
GLFWAPI void glfwGetMonitorPos(GLFWmonitor* monitor, int* xpos, int* ypos);
@@ -1029,31 +1320,55 @@ GLFWAPI void glfwGetMonitorPos(GLFWmonitor* monitor, int* xpos, int* ypos);
* This function returns the size, in millimetres, of the display area of the
* specified monitor.
*
- * @param[in] monitor The monitor to query.
- * @param[out] width Where to store the width, in mm, of the monitor's display
- * area, or `NULL`.
- * @param[out] height Where to store the height, in mm, of the monitor's
- * display area, or `NULL`.
+ * Some systems do not provide accurate monitor size information, either
+ * because the monitor
+ * [EDID](https://en.wikipedia.org/wiki/Extended_display_identification_data)
+ * data is incorrect or because the driver does not report it accurately.
*
- * @note Some operating systems do not provide accurate information, either
- * because the monitor's EDID data is incorrect, or because the driver does not
- * report it accurately.
+ * Any or all of the size arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` size arguments will be set to zero.
+ *
+ * @param[in] monitor The monitor to query.
+ * @param[out] widthMM Where to store the width, in millimetres, of the
+ * monitor's display area, or `NULL`.
+ * @param[out] heightMM Where to store the height, in millimetres, of the
+ * monitor's display area, or `NULL`.
+ *
+ * @remarks __Windows:__ The OS calculates the returned physical size from the
+ * current resolution and system DPI instead of querying the monitor EDID data.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_properties
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup monitor
*/
-GLFWAPI void glfwGetMonitorPhysicalSize(GLFWmonitor* monitor, int* width, int* height);
+GLFWAPI void glfwGetMonitorPhysicalSize(GLFWmonitor* monitor, int* widthMM, int* heightMM);
/*! @brief Returns the name of the specified monitor.
*
* This function returns a human-readable name, encoded as UTF-8, of the
- * specified monitor.
+ * specified monitor. The name typically reflects the make and model of the
+ * monitor and is not guaranteed to be unique among the connected monitors.
*
* @param[in] monitor The monitor to query.
- * @return The UTF-8 encoded name of the monitor, or `NULL` if an error
- * occurred.
+ * @return The UTF-8 encoded name of the monitor, or `NULL` if an
+ * [error](@ref error_handling) occurred.
*
- * @note The returned string is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned string is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the specified monitor is disconnected or the
+ * library is terminated.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_properties
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup monitor
*/
@@ -1067,12 +1382,19 @@ GLFWAPI const char* glfwGetMonitorName(GLFWmonitor* monitor);
*
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
*
- * @bug **X11:** This callback is not yet called on monitor configuration
+ * @bug __X11:__ This callback is not yet called on monitor configuration
* changes.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_event
+ *
+ * @since Added in GLFW 3.0.
+ *
* @ingroup monitor
*/
GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun cbfun);
@@ -1087,16 +1409,25 @@ GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun cbfun);
* @param[in] monitor The monitor to query.
* @param[out] count Where to store the number of video modes in the returned
* array. This is set to zero if an error occurred.
- * @return An array of video modes, or `NULL` if an error occurred.
+ * @return An array of video modes, or `NULL` if an
+ * [error](@ref error_handling) occurred.
*
- * @note The returned array is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned array is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the specified monitor is disconnected, this
+ * function is called again for that monitor or the library is terminated.
*
- * @note The returned array is valid only until this function is called again
- * for the specified monitor.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref monitor_modes
* @sa glfwGetVideoMode
*
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Changed to return an array of modes for a specific monitor.
+ *
* @ingroup monitor
*/
GLFWAPI const GLFWvidmode* glfwGetVideoModes(GLFWmonitor* monitor, int* count);
@@ -1104,17 +1435,26 @@ GLFWAPI const GLFWvidmode* glfwGetVideoModes(GLFWmonitor* monitor, int* count);
/*! @brief Returns the current mode of the specified monitor.
*
* This function returns the current video mode of the specified monitor. If
- * you are using a full screen window, the return value will therefore depend
- * on whether it is focused.
+ * you have created a full screen window for that monitor, the return value
+ * will depend on whether that window is iconified.
*
* @param[in] monitor The monitor to query.
- * @return The current mode of the monitor, or `NULL` if an error occurred.
+ * @return The current mode of the monitor, or `NULL` if an
+ * [error](@ref error_handling) occurred.
*
- * @note The returned struct is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned array is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the specified monitor is disconnected or the
+ * library is terminated.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_modes
* @sa glfwGetVideoModes
*
+ * @since Added in GLFW 3.0. Replaces `glfwGetDesktopMode`.
+ *
* @ingroup monitor
*/
GLFWAPI const GLFWvidmode* glfwGetVideoMode(GLFWmonitor* monitor);
@@ -1127,19 +1467,37 @@ GLFWAPI const GLFWvidmode* glfwGetVideoMode(GLFWmonitor* monitor);
* @param[in] monitor The monitor whose gamma ramp to set.
* @param[in] gamma The desired exponent.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_gamma
+ *
+ * @since Added in GLFW 3.0.
+ *
* @ingroup monitor
*/
GLFWAPI void glfwSetGamma(GLFWmonitor* monitor, float gamma);
-/*! @brief Retrieves the current gamma ramp for the specified monitor.
+/*! @brief Returns the current gamma ramp for the specified monitor.
*
- * This function retrieves the current gamma ramp of the specified monitor.
+ * This function returns the current gamma ramp of the specified monitor.
*
* @param[in] monitor The monitor to query.
- * @return The current gamma ramp, or `NULL` if an error occurred.
+ * @return The current gamma ramp, or `NULL` if an
+ * [error](@ref error_handling) occurred.
*
- * @note The value arrays of the returned ramp are allocated and freed by GLFW.
- * You should not free them yourself.
+ * @par Pointer Lifetime
+ * The returned structure and its arrays are allocated and freed by GLFW. You
+ * should not free them yourself. They are valid until the specified monitor
+ * is disconnected, this function is called again for that monitor or the
+ * library is terminated.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_gamma
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup monitor
*/
@@ -1147,13 +1505,25 @@ GLFWAPI const GLFWgammaramp* glfwGetGammaRamp(GLFWmonitor* monitor);
/*! @brief Sets the current gamma ramp for the specified monitor.
*
- * This function sets the current gamma ramp for the specified monitor.
+ * This function sets the current gamma ramp for the specified monitor. The
+ * original gamma ramp for that monitor is saved by GLFW the first time this
+ * function is called and is restored by @ref glfwTerminate.
*
* @param[in] monitor The monitor whose gamma ramp to set.
* @param[in] ramp The gamma ramp to use.
*
* @note Gamma ramp sizes other than 256 are not supported by all hardware.
*
+ * @par Pointer Lifetime
+ * The specified gamma ramp is copied before this function returns.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref monitor_gamma
+ *
+ * @since Added in GLFW 3.0.
+ *
* @ingroup monitor
*/
GLFWAPI void glfwSetGammaRamp(GLFWmonitor* monitor, const GLFWgammaramp* ramp);
@@ -1163,10 +1533,14 @@ GLFWAPI void glfwSetGammaRamp(GLFWmonitor* monitor, const GLFWgammaramp* ramp);
* This function resets all window hints to their
* [default values](@ref window_hints_values).
*
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_hints
* @sa glfwWindowHint
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwDefaultWindowHints(void);
@@ -1176,52 +1550,70 @@ GLFWAPI void glfwDefaultWindowHints(void);
* This function sets hints for the next call to @ref glfwCreateWindow. The
* hints, once set, retain their values until changed by a call to @ref
* glfwWindowHint or @ref glfwDefaultWindowHints, or until the library is
- * terminated with @ref glfwTerminate.
+ * terminated.
*
* @param[in] target The [window hint](@ref window_hints) to set.
* @param[in] hint The new value of the window hint.
*
- * @par New in GLFW 3
- * Hints are no longer reset to their default values on window creation. To
- * set default hint values, use @ref glfwDefaultWindowHints.
- *
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_hints
* @sa glfwDefaultWindowHints
*
+ * @since Added in GLFW 3.0. Replaces `glfwOpenWindowHint`.
+ *
* @ingroup window
*/
GLFWAPI void glfwWindowHint(int target, int hint);
/*! @brief Creates a window and its associated context.
*
- * This function creates a window and its associated context. Most of the
- * options controlling how the window and its context should be created are
- * specified through @ref glfwWindowHint.
+ * This function creates a window and its associated OpenGL or OpenGL ES
+ * context. Most of the options controlling how the window and its context
+ * should be created are specified with [window hints](@ref window_hints).
*
* Successful creation does not change which context is current. Before you
- * can use the newly created context, you need to make it current using @ref
- * glfwMakeContextCurrent.
+ * can use the newly created context, you need to
+ * [make it current](@ref context_current). For information about the `share`
+ * parameter, see @ref context_sharing.
*
- * Note that the created window and context may differ from what you requested,
- * as not all parameters and hints are
+ * The created window, framebuffer and context may differ from what you
+ * requested, as not all parameters and hints are
* [hard constraints](@ref window_hints_hard). This includes the size of the
- * window, especially for full screen windows. To retrieve the actual
- * attributes of the created window and context, use queries like @ref
+ * window, especially for full screen windows. To query the actual attributes
+ * of the created window, framebuffer and context, use queries like @ref
* glfwGetWindowAttrib and @ref glfwGetWindowSize.
*
- * To create a full screen window, you need to specify the monitor to use. If
- * no monitor is specified, windowed mode will be used. Unless you have a way
- * for the user to choose a specific monitor, it is recommended that you pick
- * the primary monitor. For more information on how to retrieve monitors, see
- * @ref monitor_monitors.
+ * To create a full screen window, you need to specify the monitor the window
+ * will cover. If no monitor is specified, windowed mode will be used. Unless
+ * you have a way for the user to choose a specific monitor, it is recommended
+ * that you pick the primary monitor. For more information on how to query
+ * connected monitors, see @ref monitor_monitors.
*
- * To create the window at a specific position, make it initially invisible
- * using the `GLFW_VISIBLE` window hint, set its position and then show it.
+ * For full screen windows, the specified size becomes the resolution of the
+ * window's _desired video mode_. As long as a full screen window has input
+ * focus, the supported video mode most closely matching the desired video mode
+ * is set for the specified monitor. For more information about full screen
+ * windows, including the creation of so called _windowed full screen_ or
+ * _borderless full screen_ windows, see @ref window_windowed_full_screen.
*
- * If a full screen window is active, the screensaver is prohibited from
+ * By default, newly created windows use the placement recommended by the
+ * window system. To create the window at a specific position, make it
+ * initially invisible using the [GLFW_VISIBLE](@ref window_hints_wnd) window
+ * hint, set its [position](@ref window_pos) and then [show](@ref window_hide)
+ * it.
+ *
+ * If a full screen window has input focus, the screensaver is prohibited from
* starting.
*
+ * Window systems put limits on window sizes. Very large or very small window
+ * dimensions may be overridden by the window system on creation. Check the
+ * actual [size](@ref window_size) after creation.
+ *
+ * The [swap interval](@ref buffer_swap) is not set during window creation and
+ * the initial value may vary depending on driver settings and defaults.
+ *
* @param[in] width The desired width, in screen coordinates, of the window.
* This must be greater than zero.
* @param[in] height The desired height, in screen coordinates, of the window.
@@ -1231,32 +1623,47 @@ GLFWAPI void glfwWindowHint(int target, int hint);
* windowed mode.
* @param[in] share The window whose context to share resources with, or `NULL`
* to not share resources.
- * @return The handle of the created window, or `NULL` if an error occurred.
+ * @return The handle of the created window, or `NULL` if an
+ * [error](@ref error_handling) occurred.
*
- * @remarks **Windows:** Window creation will fail if the Microsoft GDI
+ * @remarks __Windows:__ Window creation will fail if the Microsoft GDI
* software OpenGL implementation is the only one available.
*
- * @remarks **Windows:** If the executable has an icon resource named
+ * @remarks __Windows:__ If the executable has an icon resource named
* `GLFW_ICON,` it will be set as the icon for the window. If no such icon is
* present, the `IDI_WINLOGO` icon will be used instead.
*
- * @remarks **OS X:** The GLFW window has no icon, as it is not a document
+ * @remarks __Windows:__ The context to share resources with may not be current
+ * on any other thread.
+ *
+ * @remarks __OS X:__ The GLFW window has no icon, as it is not a document
* window, but the dock icon will be the same as the application bundle's icon.
- * Also, the first time a window is opened the menu bar is populated with
- * common commands like Hide, Quit and About. The (minimal) about dialog uses
- * information from the application's bundle. For more information on bundles,
- * see the Bundle Programming Guide provided by Apple.
+ * For more information on bundles, see the
+ * [Bundle Programming Guide](https://developer.apple.com/library/mac/documentation/CoreFoundation/Conceptual/CFBundles/)
+ * in the Mac Developer Library.
*
- * @remarks **X11:** There is no mechanism for setting the window icon yet.
+ * @remarks __OS X:__ The first time a window is created the menu bar is
+ * populated with common commands like Hide, Quit and About. The About entry
+ * opens a minimal about dialog with information from the application's bundle.
+ * The menu bar can be disabled with a
+ * [compile-time option](@ref compile_options_osx).
*
- * @remarks The swap interval is not set during window creation, but is left at
- * the default value for that platform. For more information, see @ref
- * glfwSwapInterval.
+ * @remarks __X11:__ There is no mechanism for setting the window icon yet.
*
- * @note This function may only be called from the main thread.
+ * @remarks __X11:__ Some window managers will not respect the placement of
+ * initially hidden windows.
*
+ * @par Reentrancy
+ * This function may not be called from a callback.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_creation
* @sa glfwDestroyWindow
*
+ * @since Added in GLFW 3.0. Replaces `glfwOpenWindow`.
+ *
* @ingroup window
*/
GLFWAPI GLFWwindow* glfwCreateWindow(int width, int height, const char* title, GLFWmonitor* monitor, GLFWwindow* share);
@@ -1266,19 +1673,25 @@ GLFWAPI GLFWwindow* glfwCreateWindow(int width, int height, const char* title, G
* This function destroys the specified window and its context. On calling
* this function, no further callbacks will be called for that window.
*
- * @param[in] window The window to destroy.
- *
- * @note This function may only be called from the main thread.
- *
- * @note This function may not be called from a callback.
- *
- * @note If the window's context is current on the main thread, it is
+ * If the context of the specified window is current on the main thread, it is
* detached before being destroyed.
*
- * @warning The window's context must not be current on any other thread.
+ * @param[in] window The window to destroy.
*
+ * @note The context of the specified window must not be current on any other
+ * thread when this function is called.
+ *
+ * @par Reentrancy
+ * This function may not be called from a callback.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_creation
* @sa glfwCreateWindow
*
+ * @since Added in GLFW 3.0. Replaces `glfwCloseWindow`.
+ *
* @ingroup window
*/
GLFWAPI void glfwDestroyWindow(GLFWwindow* window);
@@ -1290,7 +1703,12 @@ GLFWAPI void glfwDestroyWindow(GLFWwindow* window);
* @param[in] window The window to query.
* @return The value of the close flag.
*
- * @remarks This function may be called from secondary threads.
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @sa @ref window_close
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1305,7 +1723,12 @@ GLFWAPI int glfwWindowShouldClose(GLFWwindow* window);
* @param[in] window The window whose flag to change.
* @param[in] value The new value.
*
- * @remarks This function may be called from secondary threads.
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @sa @ref window_close
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1319,7 +1742,15 @@ GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* window, int value);
* @param[in] window The window whose title to change.
* @param[in] title The UTF-8 encoded window title.
*
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_title
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
*
* @ingroup window
*/
@@ -1330,14 +1761,23 @@ GLFWAPI void glfwSetWindowTitle(GLFWwindow* window, const char* title);
* This function retrieves the position, in screen coordinates, of the
* upper-left corner of the client area of the specified window.
*
+ * Any or all of the position arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` position arguments will be set to zero.
+ *
* @param[in] window The window to query.
* @param[out] xpos Where to store the x-coordinate of the upper-left corner of
* the client area, or `NULL`.
* @param[out] ypos Where to store the y-coordinate of the upper-left corner of
* the client area, or `NULL`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_pos
* @sa glfwSetWindowPos
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos);
@@ -1345,27 +1785,30 @@ GLFWAPI void glfwGetWindowPos(GLFWwindow* window, int* xpos, int* ypos);
/*! @brief Sets the position of the client area of the specified window.
*
* This function sets the position, in screen coordinates, of the upper-left
- * corner of the client area of the window.
+ * corner of the client area of the specified windowed mode window. If the
+ * window is a full screen window, this function does nothing.
*
- * If the specified window is a full screen window, this function does nothing.
+ * __Do not use this function__ to move an already visible window unless you
+ * have very good reasons for doing so, as it will confuse and annoy the user.
*
- * If you wish to set an initial window position you should create a hidden
- * window (using @ref glfwWindowHint and `GLFW_VISIBLE`), set its position and
- * then show it.
+ * The window manager may put limits on what positions are allowed. GLFW
+ * cannot and should not override these limits.
*
* @param[in] window The window to query.
* @param[in] xpos The x-coordinate of the upper-left corner of the client area.
* @param[in] ypos The y-coordinate of the upper-left corner of the client area.
*
- * @note It is very rarely a good idea to move an already visible window, as it
- * will confuse and annoy the user.
- *
- * @note This function may only be called from the main thread.
- *
- * @note The window manager may put limits on what positions are allowed.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_pos
* @sa glfwGetWindowPos
*
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
* @ingroup window
*/
GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos);
@@ -1374,7 +1817,10 @@ GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos);
*
* This function retrieves the size, in screen coordinates, of the client area
* of the specified window. If you wish to retrieve the size of the
- * framebuffer in pixels, see @ref glfwGetFramebufferSize.
+ * framebuffer of the window in pixels, see @ref glfwGetFramebufferSize.
+ *
+ * Any or all of the size arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` size arguments will be set to zero.
*
* @param[in] window The window whose size to retrieve.
* @param[out] width Where to store the width, in screen coordinates, of the
@@ -1382,8 +1828,17 @@ GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos);
* @param[out] height Where to store the height, in screen coordinates, of the
* client area, or `NULL`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_size
* @sa glfwSetWindowSize
*
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
* @ingroup window
*/
GLFWAPI void glfwGetWindowSize(GLFWwindow* window, int* width, int* height);
@@ -1398,16 +1853,24 @@ GLFWAPI void glfwGetWindowSize(GLFWwindow* window, int* width, int* height);
* the context is unaffected, the bit depths of the framebuffer remain
* unchanged.
*
+ * The window manager may put limits on what sizes are allowed. GLFW cannot
+ * and should not override these limits.
+ *
* @param[in] window The window to resize.
* @param[in] width The desired width of the specified window.
* @param[in] height The desired height of the specified window.
*
- * @note This function may only be called from the main thread.
- *
- * @note The window manager may put limits on what window sizes are allowed.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_size
* @sa glfwGetWindowSize
*
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
* @ingroup window
*/
GLFWAPI void glfwSetWindowSize(GLFWwindow* window, int width, int height);
@@ -1418,80 +1881,149 @@ GLFWAPI void glfwSetWindowSize(GLFWwindow* window, int width, int height);
* specified window. If you wish to retrieve the size of the window in screen
* coordinates, see @ref glfwGetWindowSize.
*
+ * Any or all of the size arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` size arguments will be set to zero.
+ *
* @param[in] window The window whose framebuffer to query.
* @param[out] width Where to store the width, in pixels, of the framebuffer,
* or `NULL`.
* @param[out] height Where to store the height, in pixels, of the framebuffer,
* or `NULL`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_fbsize
* @sa glfwSetFramebufferSizeCallback
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwGetFramebufferSize(GLFWwindow* window, int* width, int* height);
+/*! @brief Retrieves the size of the frame of the window.
+ *
+ * This function retrieves the size, in screen coordinates, of each edge of the
+ * frame of the specified window. This size includes the title bar, if the
+ * window has one. The size of the frame may vary depending on the
+ * [window-related hints](@ref window_hints_wnd) used to create it.
+ *
+ * Because this function retrieves the size of each window frame edge and not
+ * the offset along a particular coordinate axis, the retrieved values will
+ * always be zero or positive.
+ *
+ * Any or all of the size arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` size arguments will be set to zero.
+ *
+ * @param[in] window The window whose frame size to query.
+ * @param[out] left Where to store the size, in screen coordinates, of the left
+ * edge of the window frame, or `NULL`.
+ * @param[out] top Where to store the size, in screen coordinates, of the top
+ * edge of the window frame, or `NULL`.
+ * @param[out] right Where to store the size, in screen coordinates, of the
+ * right edge of the window frame, or `NULL`.
+ * @param[out] bottom Where to store the size, in screen coordinates, of the
+ * bottom edge of the window frame, or `NULL`.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_size
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup window
+ */
+GLFWAPI void glfwGetWindowFrameSize(GLFWwindow* window, int* left, int* top, int* right, int* bottom);
+
/*! @brief Iconifies the specified window.
*
- * This function iconifies/minimizes the specified window, if it was previously
- * restored. If it is a full screen window, the original monitor resolution is
- * restored until the window is restored. If the window is already iconified,
- * this function does nothing.
+ * This function iconifies (minimizes) the specified window if it was
+ * previously restored. If the window is already iconified, this function does
+ * nothing.
+ *
+ * If the specified window is a full screen window, the original monitor
+ * resolution is restored until the window is restored.
*
* @param[in] window The window to iconify.
*
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_iconify
* @sa glfwRestoreWindow
*
+ * @since Added in GLFW 2.1.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
* @ingroup window
*/
GLFWAPI void glfwIconifyWindow(GLFWwindow* window);
/*! @brief Restores the specified window.
*
- * This function restores the specified window, if it was previously
- * iconified/minimized. If it is a full screen window, the resolution chosen
- * for the window is restored on the selected monitor. If the window is
- * already restored, this function does nothing.
+ * This function restores the specified window if it was previously iconified
+ * (minimized). If the window is already restored, this function does nothing.
+ *
+ * If the specified window is a full screen window, the resolution chosen for
+ * the window is restored on the selected monitor.
*
* @param[in] window The window to restore.
*
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_iconify
* @sa glfwIconifyWindow
*
+ * @since Added in GLFW 2.1.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
* @ingroup window
*/
GLFWAPI void glfwRestoreWindow(GLFWwindow* window);
/*! @brief Makes the specified window visible.
*
- * This function makes the specified window visible, if it was previously
+ * This function makes the specified window visible if it was previously
* hidden. If the window is already visible or is in full screen mode, this
* function does nothing.
*
* @param[in] window The window to make visible.
*
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_hide
* @sa glfwHideWindow
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwShowWindow(GLFWwindow* window);
/*! @brief Hides the specified window.
*
- * This function hides the specified window, if it was previously visible. If
+ * This function hides the specified window if it was previously visible. If
* the window is already hidden or is in full screen mode, this function does
* nothing.
*
* @param[in] window The window to hide.
*
- * @note This function may only be called from the main thread.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref window_hide
* @sa glfwShowWindow
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwHideWindow(GLFWwindow* window);
@@ -1502,7 +2034,15 @@ GLFWAPI void glfwHideWindow(GLFWwindow* window);
* in full screen on.
*
* @param[in] window The window to query.
- * @return The monitor, or `NULL` if the window is in windowed mode.
+ * @return The monitor, or `NULL` if the window is in windowed mode or an error
+ * occurred.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_monitor
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1510,13 +2050,22 @@ GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window);
/*! @brief Returns an attribute of the specified window.
*
- * This function returns an attribute of the specified window. There are many
- * attributes, some related to the window and others to its context.
+ * This function returns the value of an attribute of the specified window or
+ * its OpenGL or OpenGL ES context.
*
* @param[in] window The window to query.
* @param[in] attrib The [window attribute](@ref window_attribs) whose value to
* return.
- * @return The value of the attribute, or zero if an error occurred.
+ * @return The value of the attribute, or zero if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_attribs
+ *
+ * @since Added in GLFW 3.0. Replaces `glfwGetWindowParam` and
+ * `glfwGetGLVersion`.
*
* @ingroup window
*/
@@ -1531,8 +2080,14 @@ GLFWAPI int glfwGetWindowAttrib(GLFWwindow* window, int attrib);
* @param[in] window The window whose pointer to set.
* @param[in] pointer The new value.
*
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @sa @ref window_userptr
* @sa glfwGetWindowUserPointer
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwSetWindowUserPointer(GLFWwindow* window, void* pointer);
@@ -1544,8 +2099,14 @@ GLFWAPI void glfwSetWindowUserPointer(GLFWwindow* window, void* pointer);
*
* @param[in] window The window whose pointer to return.
*
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @sa @ref window_userptr
* @sa glfwSetWindowUserPointer
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup window
*/
GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* window);
@@ -1559,8 +2120,15 @@ GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* window);
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_pos
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1575,8 +2143,18 @@ GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* window, GLFWwindow
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_size
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter. Updated callback signature.
*
* @ingroup window
*/
@@ -1596,15 +2174,22 @@ GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwind
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
*
- * @par New in GLFW 3
- * The close callback no longer returns a value.
- *
- * @remarks **OS X:** Selecting Quit from the application menu will
+ * @remarks __OS X:__ Selecting Quit from the application menu will
* trigger the close callback for all windows.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_close
+ *
+ * @since Added in GLFW 2.5.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter. Updated callback signature.
+ *
* @ingroup window
*/
GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* window, GLFWwindowclosefun cbfun);
@@ -1622,12 +2207,18 @@ GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* window, GLFWwi
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
*
- * @note On compositing window systems such as Aero, Compiz or Aqua, where the
- * window contents are saved off-screen, this callback may be called only very
- * infrequently or never at all.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_refresh
+ *
+ * @since Added in GLFW 2.5.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter. Updated callback signature.
*
* @ingroup window
*/
@@ -1636,18 +2227,25 @@ GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* window, GL
/*! @brief Sets the focus callback for the specified window.
*
* This function sets the focus callback of the specified window, which is
- * called when the window gains or loses focus.
+ * called when the window gains or loses input focus.
*
- * After the focus callback is called for a window that lost focus, synthetic
- * key and mouse button release events will be generated for all such that had
- * been pressed. For more information, see @ref glfwSetKeyCallback and @ref
- * glfwSetMouseButtonCallback.
+ * After the focus callback is called for a window that lost input focus,
+ * synthetic key and mouse button release events will be generated for all such
+ * that had been pressed. For more information, see @ref glfwSetKeyCallback
+ * and @ref glfwSetMouseButtonCallback.
*
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_focus
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1661,8 +2259,15 @@ GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* window, GLFWwi
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_iconify
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1676,8 +2281,15 @@ GLFWAPI GLFWwindowiconifyfun glfwSetWindowIconifyCallback(GLFWwindow* window, GL
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref window_fbsize
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup window
*/
@@ -1685,114 +2297,164 @@ GLFWAPI GLFWframebuffersizefun glfwSetFramebufferSizeCallback(GLFWwindow* window
/*! @brief Processes all pending events.
*
- * This function processes only those events that have already been received
- * and then returns immediately. Processing events will cause the window and
- * input callbacks associated with those events to be called.
+ * This function processes only those events that are already in the event
+ * queue and then returns immediately. Processing events will cause the window
+ * and input callbacks associated with those events to be called.
*
- * This function is not required for joystick input to work.
+ * On some platforms, a window move, resize or menu operation will cause event
+ * processing to block. This is due to how event processing is designed on
+ * those platforms. You can use the
+ * [window refresh callback](@ref window_refresh) to redraw the contents of
+ * your window when necessary during such operations.
*
- * @par New in GLFW 3
- * This function is no longer called by @ref glfwSwapBuffers. You need to call
- * it or @ref glfwWaitEvents yourself.
+ * On some platforms, certain events are sent directly to the application
+ * without going through the event queue, causing callbacks to be called
+ * outside of a call to one of the event processing functions.
*
- * @remarks On some platforms, a window move, resize or menu operation will
- * cause event processing to block. This is due to how event processing is
- * designed on those platforms. You can use the
- * [window refresh callback](@ref GLFWwindowrefreshfun) to redraw the contents
- * of your window when necessary during the operation.
+ * Event processing is not required for joystick input to work.
*
- * @note This function may only be called from the main thread.
+ * @par Reentrancy
+ * This function may not be called from a callback.
*
- * @note This function may not be called from a callback.
- *
- * @note On some platforms, certain callbacks may be called outside of a call
- * to one of the event processing functions.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref events
* @sa glfwWaitEvents
*
+ * @since Added in GLFW 1.0.
+ *
* @ingroup window
*/
GLFWAPI void glfwPollEvents(void);
-/*! @brief Waits until events are pending and processes them.
+/*! @brief Waits until events are queued and processes them.
*
- * This function puts the calling thread to sleep until at least one event has
- * been received. Once one or more events have been received, it behaves as if
- * @ref glfwPollEvents was called, i.e. the events are processed and the
- * function then returns immediately. Processing events will cause the window
- * and input callbacks associated with those events to be called.
+ * This function puts the calling thread to sleep until at least one event is
+ * available in the event queue. Once one or more events are available,
+ * it behaves exactly like @ref glfwPollEvents, i.e. the events in the queue
+ * are processed and the function then returns immediately. Processing events
+ * will cause the window and input callbacks associated with those events to be
+ * called.
*
* Since not all events are associated with callbacks, this function may return
* without a callback having been called even if you are monitoring all
* callbacks.
*
- * This function is not required for joystick input to work.
+ * On some platforms, a window move, resize or menu operation will cause event
+ * processing to block. This is due to how event processing is designed on
+ * those platforms. You can use the
+ * [window refresh callback](@ref window_refresh) to redraw the contents of
+ * your window when necessary during such operations.
*
- * @remarks On some platforms, a window move, resize or menu operation will
- * cause event processing to block. This is due to how event processing is
- * designed on those platforms. You can use the
- * [window refresh callback](@ref GLFWwindowrefreshfun) to redraw the contents
- * of your window when necessary during the operation.
+ * On some platforms, certain callbacks may be called outside of a call to one
+ * of the event processing functions.
*
- * @note This function may only be called from the main thread.
+ * If no windows exist, this function returns immediately. For synchronization
+ * of threads in applications that do not create windows, use your threading
+ * library of choice.
*
- * @note This function may not be called from a callback.
+ * Event processing is not required for joystick input to work.
*
- * @note On some platforms, certain callbacks may be called outside of a call
- * to one of the event processing functions.
+ * @par Reentrancy
+ * This function may not be called from a callback.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref events
* @sa glfwPollEvents
*
+ * @since Added in GLFW 2.5.
+ *
* @ingroup window
*/
GLFWAPI void glfwWaitEvents(void);
+/*! @brief Posts an empty event to the event queue.
+ *
+ * This function posts an empty event from the current thread to the event
+ * queue, causing @ref glfwWaitEvents to return.
+ *
+ * If no windows exist, this function returns immediately. For synchronization
+ * of threads in applications that do not create windows, use your threading
+ * library of choice.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread.
+ *
+ * @sa @ref events
+ * @sa glfwWaitEvents
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup window
+ */
+GLFWAPI void glfwPostEmptyEvent(void);
+
/*! @brief Returns the value of an input option for the specified window.
+ *
+ * This function returns the value of an input option for the specified window.
+ * The mode must be one of `GLFW_CURSOR`, `GLFW_STICKY_KEYS` or
+ * `GLFW_STICKY_MOUSE_BUTTONS`.
*
* @param[in] window The window to query.
* @param[in] mode One of `GLFW_CURSOR`, `GLFW_STICKY_KEYS` or
* `GLFW_STICKY_MOUSE_BUTTONS`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
* @sa glfwSetInputMode
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup input
*/
GLFWAPI int glfwGetInputMode(GLFWwindow* window, int mode);
/*! @brief Sets an input option for the specified window.
+ *
+ * This function sets an input mode option for the specified window. The mode
+ * must be one of `GLFW_CURSOR`, `GLFW_STICKY_KEYS` or
+ * `GLFW_STICKY_MOUSE_BUTTONS`.
+ *
+ * If the mode is `GLFW_CURSOR`, the value must be one of the following cursor
+ * modes:
+ * - `GLFW_CURSOR_NORMAL` makes the cursor visible and behaving normally.
+ * - `GLFW_CURSOR_HIDDEN` makes the cursor invisible when it is over the client
+ * area of the window but does not restrict the cursor from leaving.
+ * - `GLFW_CURSOR_DISABLED` hides and grabs the cursor, providing virtual
+ * and unlimited cursor movement. This is useful for implementing for
+ * example 3D camera controls.
+ *
+ * If the mode is `GLFW_STICKY_KEYS`, the value must be either `GL_TRUE` to
+ * enable sticky keys, or `GL_FALSE` to disable it. If sticky keys are
+ * enabled, a key press will ensure that @ref glfwGetKey returns `GLFW_PRESS`
+ * the next time it is called even if the key had been released before the
+ * call. This is useful when you are only interested in whether keys have been
+ * pressed but not when or in which order.
+ *
+ * If the mode is `GLFW_STICKY_MOUSE_BUTTONS`, the value must be either
+ * `GL_TRUE` to enable sticky mouse buttons, or `GL_FALSE` to disable it. If
+ * sticky mouse buttons are enabled, a mouse button press will ensure that @ref
+ * glfwGetMouseButton returns `GLFW_PRESS` the next time it is called even if
+ * the mouse button had been released before the call. This is useful when you
+ * are only interested in whether mouse buttons have been pressed but not when
+ * or in which order.
+ *
* @param[in] window The window whose input mode to set.
* @param[in] mode One of `GLFW_CURSOR`, `GLFW_STICKY_KEYS` or
* `GLFW_STICKY_MOUSE_BUTTONS`.
* @param[in] value The new value of the specified input mode.
*
- * If `mode` is `GLFW_CURSOR`, the value must be one of the supported input
- * modes:
- * - `GLFW_CURSOR_NORMAL` makes the cursor visible and behaving normally.
- * - `GLFW_CURSOR_HIDDEN` makes the cursor invisible when it is over the client
- * area of the window but does not restrict the cursor from leaving. This is
- * useful if you wish to render your own cursor or have no visible cursor at
- * all.
- * - `GLFW_CURSOR_DISABLED` hides and grabs the cursor, providing virtual
- * and unlimited cursor movement. This is useful for implementing for
- * example 3D camera controls.
- *
- * If `mode` is `GLFW_STICKY_KEYS`, the value must be either `GL_TRUE` to
- * enable sticky keys, or `GL_FALSE` to disable it. If sticky keys are
- * enabled, a key press will ensure that @ref glfwGetKey returns @ref
- * GLFW_PRESS the next time it is called even if the key had been released
- * before the call. This is useful when you are only interested in whether
- * keys have been pressed but not when or in which order.
- *
- * If `mode` is `GLFW_STICKY_MOUSE_BUTTONS`, the value must be either `GL_TRUE`
- * to enable sticky mouse buttons, or `GL_FALSE` to disable it. If sticky
- * mouse buttons are enabled, a mouse button press will ensure that @ref
- * glfwGetMouseButton returns @ref GLFW_PRESS the next time it is called even
- * if the mouse button had been released before the call. This is useful when
- * you are only interested in whether mouse buttons have been pressed but not
- * when or in which order.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
* @sa glfwGetInputMode
*
+ * @since Added in GLFW 3.0. Replaces `glfwEnable` and `glfwDisable`.
+ *
* @ingroup input
*/
GLFWAPI void glfwSetInputMode(GLFWwindow* window, int mode, int value);
@@ -1802,22 +2464,34 @@ GLFWAPI void glfwSetInputMode(GLFWwindow* window, int mode, int value);
*
* This function returns the last state reported for the specified key to the
* specified window. The returned state is one of `GLFW_PRESS` or
- * `GLFW_RELEASE`. The higher-level state `GLFW_REPEAT` is only reported to
+ * `GLFW_RELEASE`. The higher-level action `GLFW_REPEAT` is only reported to
* the key callback.
*
* If the `GLFW_STICKY_KEYS` input mode is enabled, this function returns
- * `GLFW_PRESS` the first time you call this function after a key has been
- * pressed, even if the key has already been released.
+ * `GLFW_PRESS` the first time you call it for a key that was pressed, even if
+ * that key has already been released.
*
* The key functions deal with physical keys, with [key tokens](@ref keys)
* named after their use on the standard US keyboard layout. If you want to
* input text, use the Unicode character callback instead.
*
+ * The [modifier key bit masks](@ref mods) are not key tokens and cannot be
+ * used with this function.
+ *
* @param[in] window The desired window.
- * @param[in] key The desired [keyboard key](@ref keys).
+ * @param[in] key The desired [keyboard key](@ref keys). `GLFW_KEY_UNKNOWN` is
+ * not a valid key for this function.
* @return One of `GLFW_PRESS` or `GLFW_RELEASE`.
*
- * @note `GLFW_KEY_UNKNOWN` is not a valid key for this function.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref input_key
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
*
* @ingroup input
*/
@@ -1827,26 +2501,37 @@ GLFWAPI int glfwGetKey(GLFWwindow* window, int key);
* window.
*
* This function returns the last state reported for the specified mouse button
- * to the specified window.
+ * to the specified window. The returned state is one of `GLFW_PRESS` or
+ * `GLFW_RELEASE`.
*
* If the `GLFW_STICKY_MOUSE_BUTTONS` input mode is enabled, this function
- * returns `GLFW_PRESS` the first time you call this function after a mouse
- * button has been pressed, even if the mouse button has already been released.
+ * `GLFW_PRESS` the first time you call it for a mouse button that was pressed,
+ * even if that mouse button has already been released.
*
* @param[in] window The desired window.
* @param[in] button The desired [mouse button](@ref buttons).
* @return One of `GLFW_PRESS` or `GLFW_RELEASE`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref input_mouse_button
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
* @ingroup input
*/
GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button);
-/*! @brief Retrieves the last reported cursor position, relative to the client
- * area of the window.
+/*! @brief Retrieves the position of the cursor relative to the client area of
+ * the window.
*
- * This function returns the last reported position of the cursor, in screen
- * coordinates, relative to the upper-left corner of the client area of the
- * specified window.
+ * This function returns the position of the cursor, in screen coordinates,
+ * relative to the upper-left corner of the client area of the specified
+ * window.
*
* If the cursor is disabled (with `GLFW_CURSOR_DISABLED`) then the cursor
* position is unbounded and limited only by the minimum and maximum values of
@@ -1856,14 +2541,23 @@ GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button);
* `floor` function. Casting directly to an integer type works for positive
* coordinates, but fails for negative ones.
*
+ * Any or all of the position arguments may be `NULL`. If an error occurs, all
+ * non-`NULL` position arguments will be set to zero.
+ *
* @param[in] window The desired window.
* @param[out] xpos Where to store the cursor x-coordinate, relative to the
* left edge of the client area, or `NULL`.
* @param[out] ypos Where to store the cursor y-coordinate, relative to the to
* top edge of the client area, or `NULL`.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_pos
* @sa glfwSetCursorPos
*
+ * @since Added in GLFW 3.0. Replaces `glfwGetMousePos`.
+ *
* @ingroup input
*/
GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos);
@@ -1873,11 +2567,16 @@ GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos);
*
* This function sets the position, in screen coordinates, of the cursor
* relative to the upper-left corner of the client area of the specified
- * window. The window must be focused. If the window does not have focus when
- * this function is called, it fails silently.
+ * window. The window must have input focus. If the window does not have
+ * input focus when this function is called, it fails silently.
*
- * If the cursor is disabled (with `GLFW_CURSOR_DISABLED`) then the cursor
- * position is unbounded and limited only by the minimum and maximum values of
+ * __Do not use this function__ to implement things like camera controls. GLFW
+ * already provides the `GLFW_CURSOR_DISABLED` cursor mode that hides the
+ * cursor, transparently re-centers it and provides unconstrained cursor
+ * motion. See @ref glfwSetInputMode for more information.
+ *
+ * If the cursor mode is `GLFW_CURSOR_DISABLED` then the cursor position is
+ * unconstrained and limited only by the minimum and maximum values of
* a `double`.
*
* @param[in] window The desired window.
@@ -1886,15 +2585,138 @@ GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos);
* @param[in] ypos The desired y-coordinate, relative to the top edge of the
* client area.
*
+ * @remarks __X11:__ Due to the asynchronous nature of a modern X desktop, it
+ * may take a moment for the window focus event to arrive. This means you will
+ * not be able to set the cursor position directly after window creation.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_pos
* @sa glfwGetCursorPos
*
+ * @since Added in GLFW 3.0. Replaces `glfwSetMousePos`.
+ *
* @ingroup input
*/
GLFWAPI void glfwSetCursorPos(GLFWwindow* window, double xpos, double ypos);
+/*! @brief Creates a custom cursor.
+ *
+ * Creates a new custom cursor image that can be set for a window with @ref
+ * glfwSetCursor. The cursor can be destroyed with @ref glfwDestroyCursor.
+ * Any remaining cursors are destroyed by @ref glfwTerminate.
+ *
+ * The pixels are 32-bit little-endian RGBA, i.e. eight bits per channel. They
+ * are arranged canonically as packed sequential rows, starting from the
+ * top-left corner.
+ *
+ * The cursor hotspot is specified in pixels, relative to the upper-left corner
+ * of the cursor image. Like all other coordinate systems in GLFW, the X-axis
+ * points to the right and the Y-axis points down.
+ *
+ * @param[in] image The desired cursor image.
+ * @param[in] xhot The desired x-coordinate, in pixels, of the cursor hotspot.
+ * @param[in] yhot The desired y-coordinate, in pixels, of the cursor hotspot.
+ *
+ * @return The handle of the created cursor, or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Pointer Lifetime
+ * The specified image data is copied before this function returns.
+ *
+ * @par Reentrancy
+ * This function may not be called from a callback.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_object
+ * @sa glfwDestroyCursor
+ * @sa glfwCreateStandardCursor
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup input
+ */
+GLFWAPI GLFWcursor* glfwCreateCursor(const GLFWimage* image, int xhot, int yhot);
+
+/*! @brief Creates a cursor with a standard shape.
+ *
+ * Returns a cursor with a [standard shape](@ref shapes), that can be set for
+ * a window with @ref glfwSetCursor.
+ *
+ * @param[in] shape One of the [standard shapes](@ref shapes).
+ *
+ * @return A new cursor ready to use or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Reentrancy
+ * This function may not be called from a callback.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_object
+ * @sa glfwCreateCursor
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup input
+ */
+GLFWAPI GLFWcursor* glfwCreateStandardCursor(int shape);
+
+/*! @brief Destroys a cursor.
+ *
+ * This function destroys a cursor previously created with @ref
+ * glfwCreateCursor. Any remaining cursors will be destroyed by @ref
+ * glfwTerminate.
+ *
+ * @param[in] cursor The cursor object to destroy.
+ *
+ * @par Reentrancy
+ * This function may not be called from a callback.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_object
+ * @sa glfwCreateCursor
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup input
+ */
+GLFWAPI void glfwDestroyCursor(GLFWcursor* cursor);
+
+/*! @brief Sets the cursor for the window.
+ *
+ * This function sets the cursor image to be used when the cursor is over the
+ * client area of the specified window. The set cursor will only be visible
+ * when the [cursor mode](@ref cursor_mode) of the window is
+ * `GLFW_CURSOR_NORMAL`.
+ *
+ * On some platforms, the set cursor may not be visible unless the window also
+ * has input focus.
+ *
+ * @param[in] window The window to set the cursor for.
+ * @param[in] cursor The cursor to set, or `NULL` to switch back to the default
+ * arrow cursor.
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_object
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup input
+ */
+GLFWAPI void glfwSetCursor(GLFWwindow* window, GLFWcursor* cursor);
+
/*! @brief Sets the key callback.
*
- * This function sets the key callback of the specific window, which is called
+ * This function sets the key callback of the specified window, which is called
* when a key is pressed, repeated or released.
*
* The key functions deal with physical keys, with layout independent
@@ -1902,16 +2724,16 @@ GLFWAPI void glfwSetCursorPos(GLFWwindow* window, double xpos, double ypos);
* layout. If you want to input text, use the
* [character callback](@ref glfwSetCharCallback) instead.
*
- * When a window loses focus, it will generate synthetic key release events
- * for all pressed keys. You can tell these events from user-generated events
- * by the fact that the synthetic ones are generated after the window has lost
- * focus, i.e. `GLFW_FOCUSED` will be false and the focus callback will have
- * already been called.
+ * When a window loses input focus, it will generate synthetic key release
+ * events for all pressed keys. You can tell these events from user-generated
+ * events by the fact that the synthetic ones are generated after the focus
+ * loss event has been processed, i.e. after the
+ * [window focus callback](@ref glfwSetWindowFocusCallback) has been called.
*
* The scancode of a key is specific to that platform or sometimes even to that
* machine. Scancodes are intended to allow users to bind keys that don't have
* a GLFW key token. Such keys have `key` set to `GLFW_KEY_UNKNOWN`, their
- * state is not saved and so it cannot be retrieved with @ref glfwGetKey.
+ * state is not saved and so it cannot be queried with @ref glfwGetKey.
*
* Sometimes GLFW needs to generate synthetic key events, in which case the
* scancode may be zero.
@@ -1919,8 +2741,18 @@ GLFWAPI void glfwSetCursorPos(GLFWwindow* window, double xpos, double ypos);
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new key callback, or `NULL` to remove the currently
* set callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref input_key
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter. Updated callback signature.
*
* @ingroup input
*/
@@ -1928,11 +2760,56 @@ GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun cbfun);
/*! @brief Sets the Unicode character callback.
*
- * This function sets the character callback of the specific window, which is
+ * This function sets the character callback of the specified window, which is
* called when a Unicode character is input.
*
- * The character callback is intended for text input. If you want to know
- * whether a specific key was pressed or released, use the
+ * The character callback is intended for Unicode text input. As it deals with
+ * characters, it is keyboard layout dependent, whereas the
+ * [key callback](@ref glfwSetKeyCallback) is not. Characters do not map 1:1
+ * to physical keys, as a key may produce zero, one or more characters. If you
+ * want to know whether a specific physical key was pressed or released, see
+ * the key callback instead.
+ *
+ * The character callback behaves as system text input normally does and will
+ * not be called if modifier keys are held down that would prevent normal text
+ * input on that platform, for example a Super (Command) key on OS X or Alt key
+ * on Windows. There is a
+ * [character with modifiers callback](@ref glfwSetCharModsCallback) that
+ * receives these events.
+ *
+ * @param[in] window The window whose callback to set.
+ * @param[in] cbfun The new callback, or `NULL` to remove the currently set
+ * callback.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref input_char
+ *
+ * @since Added in GLFW 2.4.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter. Updated callback signature.
+ *
+ * @ingroup input
+ */
+GLFWAPI GLFWcharfun glfwSetCharCallback(GLFWwindow* window, GLFWcharfun cbfun);
+
+/*! @brief Sets the Unicode character with modifiers callback.
+ *
+ * This function sets the character with modifiers callback of the specified
+ * window, which is called when a Unicode character is input regardless of what
+ * modifier keys are used.
+ *
+ * The character with modifiers callback is intended for implementing custom
+ * Unicode character input. For regular Unicode text input, see the
+ * [character callback](@ref glfwSetCharCallback). Like the character
+ * callback, the character with modifiers callback deals with characters and is
+ * keyboard layout dependent. Characters do not map 1:1 to physical keys, as
+ * a key may produce zero, one or more characters. If you want to know whether
+ * a specific physical key was pressed or released, see the
* [key callback](@ref glfwSetKeyCallback) instead.
*
* @param[in] window The window whose callback to set.
@@ -1941,26 +2818,43 @@ GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun cbfun);
* @return The previously set callback, or `NULL` if no callback was set or an
* error occurred.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref input_char
+ *
+ * @since Added in GLFW 3.1.
+ *
* @ingroup input
*/
-GLFWAPI GLFWcharfun glfwSetCharCallback(GLFWwindow* window, GLFWcharfun cbfun);
+GLFWAPI GLFWcharmodsfun glfwSetCharModsCallback(GLFWwindow* window, GLFWcharmodsfun cbfun);
/*! @brief Sets the mouse button callback.
*
* This function sets the mouse button callback of the specified window, which
* is called when a mouse button is pressed or released.
*
- * When a window loses focus, it will generate synthetic mouse button release
- * events for all pressed mouse buttons. You can tell these events from
- * user-generated events by the fact that the synthetic ones are generated
- * after the window has lost focus, i.e. `GLFW_FOCUSED` will be false and the
- * focus callback will have already been called.
+ * When a window loses input focus, it will generate synthetic mouse button
+ * release events for all pressed mouse buttons. You can tell these events
+ * from user-generated events by the fact that the synthetic ones are generated
+ * after the focus loss event has been processed, i.e. after the
+ * [window focus callback](@ref glfwSetWindowFocusCallback) has been called.
*
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref input_mouse_button
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter. Updated callback signature.
*
* @ingroup input
*/
@@ -1976,8 +2870,15 @@ GLFWAPI GLFWmousebuttonfun glfwSetMouseButtonCallback(GLFWwindow* window, GLFWmo
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_pos
+ *
+ * @since Added in GLFW 3.0. Replaces `glfwSetMousePosCallback`.
*
* @ingroup input
*/
@@ -1992,8 +2893,15 @@ GLFWAPI GLFWcursorposfun glfwSetCursorPosCallback(GLFWwindow* window, GLFWcursor
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref cursor_enter
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup input
*/
@@ -2011,20 +2919,61 @@ GLFWAPI GLFWcursorenterfun glfwSetCursorEnterCallback(GLFWwindow* window, GLFWcu
* @param[in] window The window whose callback to set.
* @param[in] cbfun The new scroll callback, or `NULL` to remove the currently
* set callback.
- * @return The previously set callback, or `NULL` if no callback was set or an
- * error occurred.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref scrolling
+ *
+ * @since Added in GLFW 3.0. Replaces `glfwSetMouseWheelCallback`.
*
* @ingroup input
*/
GLFWAPI GLFWscrollfun glfwSetScrollCallback(GLFWwindow* window, GLFWscrollfun cbfun);
+/*! @brief Sets the file drop callback.
+ *
+ * This function sets the file drop callback of the specified window, which is
+ * called when one or more dragged files are dropped on the window.
+ *
+ * Because the path array and its strings may have been generated specifically
+ * for that event, they are not guaranteed to be valid after the callback has
+ * returned. If you wish to use them after the callback returns, you need to
+ * make a deep copy.
+ *
+ * @param[in] window The window whose callback to set.
+ * @param[in] cbfun The new file drop callback, or `NULL` to remove the
+ * currently set callback.
+ * @return The previously set callback, or `NULL` if no callback was set or the
+ * library had not been [initialized](@ref intro_init).
+ *
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref path_drop
+ *
+ * @since Added in GLFW 3.1.
+ *
+ * @ingroup input
+ */
+GLFWAPI GLFWdropfun glfwSetDropCallback(GLFWwindow* window, GLFWdropfun cbfun);
+
/*! @brief Returns whether the specified joystick is present.
*
* This function returns whether the specified joystick is present.
*
- * @param[in] joy The joystick to query.
+ * @param[in] joy The [joystick](@ref joysticks) to query.
* @return `GL_TRUE` if the joystick is present, or `GL_FALSE` otherwise.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref joystick
+ *
+ * @since Added in GLFW 3.0. Replaces `glfwGetJoystickParam`.
+ *
* @ingroup input
*/
GLFWAPI int glfwJoystickPresent(int joy);
@@ -2032,17 +2981,24 @@ GLFWAPI int glfwJoystickPresent(int joy);
/*! @brief Returns the values of all axes of the specified joystick.
*
* This function returns the values of all axes of the specified joystick.
+ * Each element in the array is a value between -1.0 and 1.0.
*
- * @param[in] joy The joystick to query.
- * @param[out] count Where to store the size of the returned array. This is
- * set to zero if an error occurred.
+ * @param[in] joy The [joystick](@ref joysticks) to query.
+ * @param[out] count Where to store the number of axis values in the returned
+ * array. This is set to zero if an error occurred.
* @return An array of axis values, or `NULL` if the joystick is not present.
*
- * @note The returned array is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned array is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the specified joystick is disconnected, this
+ * function is called again for that joystick or the library is terminated.
*
- * @note The returned array is valid only until the next call to @ref
- * glfwGetJoystickAxes for that joystick.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref joystick_axis
+ *
+ * @since Added in GLFW 3.0. Replaces `glfwGetJoystickPos`.
*
* @ingroup input
*/
@@ -2051,17 +3007,27 @@ GLFWAPI const float* glfwGetJoystickAxes(int joy, int* count);
/*! @brief Returns the state of all buttons of the specified joystick.
*
* This function returns the state of all buttons of the specified joystick.
+ * Each element in the array is either `GLFW_PRESS` or `GLFW_RELEASE`.
*
- * @param[in] joy The joystick to query.
- * @param[out] count Where to store the size of the returned array. This is
- * set to zero if an error occurred.
+ * @param[in] joy The [joystick](@ref joysticks) to query.
+ * @param[out] count Where to store the number of button states in the returned
+ * array. This is set to zero if an error occurred.
* @return An array of button states, or `NULL` if the joystick is not present.
*
- * @note The returned array is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned array is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the specified joystick is disconnected, this
+ * function is called again for that joystick or the library is terminated.
*
- * @note The returned array is valid only until the next call to @ref
- * glfwGetJoystickButtons for that joystick.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref joystick_button
+ *
+ * @since Added in GLFW 2.2.
+ *
+ * @par
+ * __GLFW 3:__ Changed to return a dynamic array.
*
* @ingroup input
*/
@@ -2070,16 +3036,24 @@ GLFWAPI const unsigned char* glfwGetJoystickButtons(int joy, int* count);
/*! @brief Returns the name of the specified joystick.
*
* This function returns the name, encoded as UTF-8, of the specified joystick.
+ * The returned string is allocated and freed by GLFW. You should not free it
+ * yourself.
*
- * @param[in] joy The joystick to query.
+ * @param[in] joy The [joystick](@ref joysticks) to query.
* @return The UTF-8 encoded name of the joystick, or `NULL` if the joystick
* is not present.
*
- * @note The returned string is allocated and freed by GLFW. You should not
- * free it yourself.
+ * @par Pointer Lifetime
+ * The returned string is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the specified joystick is disconnected, this
+ * function is called again for that joystick or the library is terminated.
*
- * @note The returned string is valid only until the next call to @ref
- * glfwGetJoystickName for that joystick.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref joystick_name
+ *
+ * @since Added in GLFW 3.0.
*
* @ingroup input
*/
@@ -2088,40 +3062,50 @@ GLFWAPI const char* glfwGetJoystickName(int joy);
/*! @brief Sets the clipboard to the specified string.
*
* This function sets the system clipboard to the specified, UTF-8 encoded
- * string. The string is copied before returning, so you don't have to retain
- * it afterwards.
+ * string.
*
* @param[in] window The window that will own the clipboard contents.
* @param[in] string A UTF-8 encoded string.
*
- * @note This function may only be called from the main thread.
+ * @par Pointer Lifetime
+ * The specified string is copied before this function returns.
*
+ * @par Thread Safety
+ * This function may only be called from the main thread.
+ *
+ * @sa @ref clipboard
* @sa glfwGetClipboardString
*
- * @ingroup clipboard
+ * @since Added in GLFW 3.0.
+ *
+ * @ingroup input
*/
GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* string);
-/*! @brief Retrieves the contents of the clipboard as a string.
+/*! @brief Returns the contents of the clipboard as a string.
*
* This function returns the contents of the system clipboard, if it contains
* or is convertible to a UTF-8 encoded string.
*
* @param[in] window The window that will request the clipboard contents.
* @return The contents of the clipboard as a UTF-8 encoded string, or `NULL`
- * if an error occurred.
+ * if an [error](@ref error_handling) occurred.
*
- * @note This function may only be called from the main thread.
+ * @par Pointer Lifetime
+ * The returned string is allocated and freed by GLFW. You should not free it
+ * yourself. It is valid until the next call to @ref
+ * glfwGetClipboardString or @ref glfwSetClipboardString, or until the library
+ * is terminated.
*
- * @note The returned string is allocated and freed by GLFW. You should not
- * free it yourself.
- *
- * @note The returned string is valid only until the next call to @ref
- * glfwGetClipboardString or @ref glfwSetClipboardString.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
+ * @sa @ref clipboard
* @sa glfwSetClipboardString
*
- * @ingroup clipboard
+ * @since Added in GLFW 3.0.
+ *
+ * @ingroup input
*/
GLFWAPI const char* glfwGetClipboardString(GLFWwindow* window);
@@ -2131,15 +3115,21 @@ GLFWAPI const char* glfwGetClipboardString(GLFWwindow* window);
* been set using @ref glfwSetTime, the timer measures time elapsed since GLFW
* was initialized.
*
- * @return The current value, in seconds, or zero if an error occurred.
+ * The resolution of the timer is system dependent, but is usually on the order
+ * of a few micro- or nanoseconds. It uses the highest-resolution monotonic
+ * time source on each supported platform.
*
- * @remarks This function may be called from secondary threads.
+ * @return The current value, in seconds, or zero if an
+ * [error](@ref error_handling) occurred.
*
- * @note The resolution of the timer is system dependent, but is usually on the
- * order of a few micro- or nanoseconds. It uses the highest-resolution
- * monotonic time source on each supported platform.
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
*
- * @ingroup time
+ * @sa @ref time
+ *
+ * @since Added in GLFW 1.0.
+ *
+ * @ingroup input
*/
GLFWAPI double glfwGetTime(void);
@@ -2150,44 +3140,61 @@ GLFWAPI double glfwGetTime(void);
*
* @param[in] time The new value, in seconds.
*
- * @note The resolution of the timer is system dependent, but is usually on the
- * order of a few micro- or nanoseconds. It uses the highest-resolution
- * monotonic time source on each supported platform.
+ * @par Thread Safety
+ * This function may only be called from the main thread.
*
- * @ingroup time
+ * @sa @ref time
+ *
+ * @since Added in GLFW 2.2.
+ *
+ * @ingroup input
*/
GLFWAPI void glfwSetTime(double time);
/*! @brief Makes the context of the specified window current for the calling
* thread.
*
- * This function makes the context of the specified window current on the
- * calling thread. A context can only be made current on a single thread at
- * a time and each thread can have only a single current context at a time.
+ * This function makes the OpenGL or OpenGL ES context of the specified window
+ * current on the calling thread. A context can only be made current on
+ * a single thread at a time and each thread can have only a single current
+ * context at a time.
+ *
+ * By default, making a context non-current implicitly forces a pipeline flush.
+ * On machines that support `GL_KHR_context_flush_control`, you can control
+ * whether a context performs this flush by setting the
+ * [GLFW_CONTEXT_RELEASE_BEHAVIOR](@ref window_hints_ctx) window hint.
*
* @param[in] window The window whose context to make current, or `NULL` to
* detach the current context.
*
- * @remarks This function may be called from secondary threads.
+ * @par Thread Safety
+ * This function may be called from any thread.
*
+ * @sa @ref context_current
* @sa glfwGetCurrentContext
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup context
*/
GLFWAPI void glfwMakeContextCurrent(GLFWwindow* window);
/*! @brief Returns the window whose context is current on the calling thread.
*
- * This function returns the window whose context is current on the calling
- * thread.
+ * This function returns the window whose OpenGL or OpenGL ES context is
+ * current on the calling thread.
*
* @return The window whose context is current, or `NULL` if no window's
* context is current.
*
- * @remarks This function may be called from secondary threads.
+ * @par Thread Safety
+ * This function may be called from any thread.
*
+ * @sa @ref context_current
* @sa glfwMakeContextCurrent
*
+ * @since Added in GLFW 3.0.
+ *
* @ingroup context
*/
GLFWAPI GLFWwindow* glfwGetCurrentContext(void);
@@ -2200,24 +3207,28 @@ GLFWAPI GLFWwindow* glfwGetCurrentContext(void);
*
* @param[in] window The window whose buffers to swap.
*
- * @remarks This function may be called from secondary threads.
- *
- * @par New in GLFW 3
- * This function no longer calls @ref glfwPollEvents. You need to call it or
- * @ref glfwWaitEvents yourself.
+ * @par Thread Safety
+ * This function may be called from any thread.
*
+ * @sa @ref buffer_swap
* @sa glfwSwapInterval
*
- * @ingroup context
+ * @since Added in GLFW 1.0.
+ *
+ * @par
+ * __GLFW 3:__ Added window handle parameter.
+ *
+ * @ingroup window
*/
GLFWAPI void glfwSwapBuffers(GLFWwindow* window);
/*! @brief Sets the swap interval for the current context.
*
* This function sets the swap interval for the current context, i.e. the
- * number of screen updates to wait before swapping the buffers of a window and
- * returning from @ref glfwSwapBuffers. This is sometimes called 'vertical
- * synchronization', 'vertical retrace synchronization' or 'vsync'.
+ * number of screen updates to wait from the time @ref glfwSwapBuffers was
+ * called before swapping the buffers and returning. This is sometimes called
+ * _vertical synchronization_, _vertical retrace synchronization_ or just
+ * _vsync_.
*
* Contexts that support either of the `WGL_EXT_swap_control_tear` and
* `GLX_EXT_swap_control_tear` extensions also accept negative swap intervals,
@@ -2226,11 +3237,12 @@ GLFWAPI void glfwSwapBuffers(GLFWwindow* window);
* glfwExtensionSupported. For more information about swap tearing, see the
* extension specifications.
*
+ * A context must be current on the calling thread. Calling this function
+ * without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.
+ *
* @param[in] interval The minimum number of screen updates to wait for
* until the buffers are swapped by @ref glfwSwapBuffers.
*
- * @remarks This function may be called from secondary threads.
- *
* @note This function is not called during window creation, leaving the swap
* interval set to whatever is the default on that platform. This is done
* because some swap interval extensions used by GLFW do not allow the swap
@@ -2240,8 +3252,14 @@ GLFWAPI void glfwSwapBuffers(GLFWwindow* window);
* because of user settings that override the request or due to bugs in the
* driver.
*
+ * @par Thread Safety
+ * This function may be called from any thread.
+ *
+ * @sa @ref buffer_swap
* @sa glfwSwapBuffers
*
+ * @since Added in GLFW 1.0.
+ *
* @ingroup context
*/
GLFWAPI void glfwSwapInterval(int interval);
@@ -2249,19 +3267,28 @@ GLFWAPI void glfwSwapInterval(int interval);
/*! @brief Returns whether the specified extension is available.
*
* This function returns whether the specified
- * [OpenGL or context creation API extension](@ref context_glext) is supported
- * by the current context. For example, on Windows both the OpenGL and WGL
- * extension strings are checked.
+ * [API extension](@ref context_glext) is supported by the current OpenGL or
+ * OpenGL ES context. It searches both for OpenGL and OpenGL ES extension and
+ * platform-specific context creation API extensions.
+ *
+ * A context must be current on the calling thread. Calling this function
+ * without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.
+ *
+ * As this functions retrieves and searches one or more extension strings each
+ * call, it is recommended that you cache its results if it is going to be used
+ * frequently. The extension strings will not change during the lifetime of
+ * a context, so there is no danger in doing this.
*
* @param[in] extension The ASCII encoded name of the extension.
* @return `GL_TRUE` if the extension is available, or `GL_FALSE` otherwise.
*
- * @remarks This function may be called from secondary threads.
+ * @par Thread Safety
+ * This function may be called from any thread.
*
- * @note As this functions searches one or more extension strings on each call,
- * it is recommended that you cache its results if it's going to be used
- * frequently. The extension strings will not change during the lifetime of
- * a context, so there is no danger in doing this.
+ * @sa @ref context_glext
+ * @sa glfwGetProcAddress
+ *
+ * @since Added in GLFW 1.0.
*
* @ingroup context
*/
@@ -2274,15 +3301,27 @@ GLFWAPI int glfwExtensionSupported(const char* extension);
* [client API or extension function](@ref context_glext), if it is supported
* by the current context.
*
+ * A context must be current on the calling thread. Calling this function
+ * without a current context will cause a @ref GLFW_NO_CURRENT_CONTEXT error.
+ *
* @param[in] procname The ASCII encoded name of the function.
* @return The address of the function, or `NULL` if the function is
- * unavailable.
+ * unavailable or an [error](@ref error_handling) occurred.
*
- * @remarks This function may be called from secondary threads.
+ * @note The addresses of a given function is not guaranteed to be the same
+ * between contexts.
*
- * @note The addresses of these functions are not guaranteed to be the same for
- * all contexts, especially if they use different client APIs or even different
- * context creation hints.
+ * @par Pointer Lifetime
+ * The returned function pointer is valid until the context is destroyed or the
+ * library is terminated.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread.
+ *
+ * @sa @ref context_glext
+ * @sa glfwExtensionSupported
+ *
+ * @since Added in GLFW 1.0.
*
* @ingroup context
*/
diff --git a/loader/include/Geode/cocos/robtop/glfw/glfw3.lib b/loader/include/Geode/cocos/robtop/glfw/glfw3.lib
deleted file mode 100644
index 53cea6dae255f436859ad45710157cd35adaea34..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 123840
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
diff --git a/loader/include/Geode/cocos/robtop/glfw/glfw3native.h b/loader/include/Geode/cocos/robtop/glfw/glfw3native.h
index a229f566..b3ce7482 100644
--- a/loader/include/Geode/cocos/robtop/glfw/glfw3native.h
+++ b/loader/include/Geode/cocos/robtop/glfw/glfw3native.h
@@ -1,7 +1,6 @@
/*************************************************************************
- * GLFW - An OpenGL library
- * API version: 3.0
- * WWW: http://www.glfw.org/
+ * GLFW 3.1 - www.glfw.org
+ * A library for OpenGL, window and input
*------------------------------------------------------------------------
* Copyright (c) 2002-2006 Marcus Geelnard
* Copyright (c) 2006-2010 Camilla Berglund <elmindreda@elmindreda.org>
@@ -41,13 +40,13 @@ extern "C" {
/*! @defgroup native Native access
*
- * **By using the native API, you assert that you know what you are doing and
- * how to fix problems caused by using it. If you don't, you shouldn't be
- * using it.**
+ * **By using the native access functions you assert that you know what you're
+ * doing and how to fix problems caused by using them. If you don't, you
+ * shouldn't be using them.**
*
* Before the inclusion of @ref glfw3native.h, you must define exactly one
- * window API macro and exactly one context API macro. Failure to do this
- * will cause a compile-time error.
+ * window system API macro and exactly one context creation API macro. Failure
+ * to do this will cause a compile-time error.
*
* The available window API macros are:
* * `GLFW_EXPOSE_NATIVE_WIN32`
@@ -60,8 +59,8 @@ extern "C" {
* * `GLFW_EXPOSE_NATIVE_GLX`
* * `GLFW_EXPOSE_NATIVE_EGL`
*
- * These macros select which of the native access functions are declared and
- * which platform-specific headers to include. It is then up your (by
+ * These macros select which of the native access functions that are declared
+ * and which platform-specific headers to include. It is then up your (by
* definition platform-specific) code to handle which of these should be
* defined.
*/
@@ -72,8 +71,13 @@ extern "C" {
*************************************************************************/
#if defined(GLFW_EXPOSE_NATIVE_WIN32)
+ // This is a workaround for the fact that glfw3.h needs to export APIENTRY (for
+ // example to allow applications to correctly declare a GL_ARB_debug_output
+ // callback) but windows.h assumes no one will define APIENTRY before it does
+ #undef APIENTRY
#include <windows.h>
#elif defined(GLFW_EXPOSE_NATIVE_COCOA)
+ #include <ApplicationServices/ApplicationServices.h>
#if defined(__OBJC__)
#import <Cocoa/Cocoa.h>
#else
@@ -81,8 +85,9 @@ extern "C" {
#endif
#elif defined(GLFW_EXPOSE_NATIVE_X11)
#include <X11/Xlib.h>
+ #include <X11/extensions/Xrandr.h>
#else
- #error "No window API specified"
+ #error "No window API selected"
#endif
#if defined(GLFW_EXPOSE_NATIVE_WGL)
@@ -94,7 +99,7 @@ extern "C" {
#elif defined(GLFW_EXPOSE_NATIVE_EGL)
#include <EGL/egl.h>
#else
- #error "No context API specified"
+ #error "No context API selected"
#endif
@@ -103,8 +108,49 @@ extern "C" {
*************************************************************************/
#if defined(GLFW_EXPOSE_NATIVE_WIN32)
+/*! @brief Returns the adapter device name of the specified monitor.
+ *
+ * @return The UTF-8 encoded adapter device name (for example `\\.\DISPLAY1`)
+ * of the specified monitor, or `NULL` if an [error](@ref error_handling)
+ * occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.1.
+ *
+ * @ingroup native
+ */
+GLFWAPI const char* glfwGetWin32Adapter(GLFWmonitor* monitor);
+
+/*! @brief Returns the display device name of the specified monitor.
+ *
+ * @return The UTF-8 encoded display device name (for example
+ * `\\.\DISPLAY1\Monitor0`) of the specified monitor, or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.1.
+ *
+ * @ingroup native
+ */
+GLFWAPI const char* glfwGetWin32Monitor(GLFWmonitor* monitor);
+
/*! @brief Returns the `HWND` of the specified window.
- * @return The `HWND` of the specified window.
+ *
+ * @return The `HWND` of the specified window, or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI HWND glfwGetWin32Window(GLFWwindow* window);
@@ -112,15 +158,48 @@ GLFWAPI HWND glfwGetWin32Window(GLFWwindow* window);
#if defined(GLFW_EXPOSE_NATIVE_WGL)
/*! @brief Returns the `HGLRC` of the specified window.
- * @return The `HGLRC` of the specified window.
+ *
+ * @return The `HGLRC` of the specified window, or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI HGLRC glfwGetWGLContext(GLFWwindow* window);
#endif
#if defined(GLFW_EXPOSE_NATIVE_COCOA)
+/*! @brief Returns the `CGDirectDisplayID` of the specified monitor.
+ *
+ * @return The `CGDirectDisplayID` of the specified monitor, or
+ * `kCGNullDirectDisplay` if an [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.1.
+ *
+ * @ingroup native
+ */
+GLFWAPI CGDirectDisplayID glfwGetCocoaMonitor(GLFWmonitor* monitor);
+
/*! @brief Returns the `NSWindow` of the specified window.
- * @return The `NSWindow` of the specified window.
+ *
+ * @return The `NSWindow` of the specified window, or `nil` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI id glfwGetCocoaWindow(GLFWwindow* window);
@@ -128,7 +207,16 @@ GLFWAPI id glfwGetCocoaWindow(GLFWwindow* window);
#if defined(GLFW_EXPOSE_NATIVE_NSGL)
/*! @brief Returns the `NSOpenGLContext` of the specified window.
- * @return The `NSOpenGLContext` of the specified window.
+ *
+ * @return The `NSOpenGLContext` of the specified window, or `nil` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI id glfwGetNSGLContext(GLFWwindow* window);
@@ -136,12 +224,61 @@ GLFWAPI id glfwGetNSGLContext(GLFWwindow* window);
#if defined(GLFW_EXPOSE_NATIVE_X11)
/*! @brief Returns the `Display` used by GLFW.
- * @return The `Display` used by GLFW.
+ *
+ * @return The `Display` used by GLFW, or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI Display* glfwGetX11Display(void);
+
+/*! @brief Returns the `RRCrtc` of the specified monitor.
+ *
+ * @return The `RRCrtc` of the specified monitor, or `None` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.1.
+ *
+ * @ingroup native
+ */
+GLFWAPI RRCrtc glfwGetX11Adapter(GLFWmonitor* monitor);
+
+/*! @brief Returns the `RROutput` of the specified monitor.
+ *
+ * @return The `RROutput` of the specified monitor, or `None` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.1.
+ *
+ * @ingroup native
+ */
+GLFWAPI RROutput glfwGetX11Monitor(GLFWmonitor* monitor);
+
/*! @brief Returns the `Window` of the specified window.
- * @return The `Window` of the specified window.
+ *
+ * @return The `Window` of the specified window, or `None` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI Window glfwGetX11Window(GLFWwindow* window);
@@ -149,7 +286,16 @@ GLFWAPI Window glfwGetX11Window(GLFWwindow* window);
#if defined(GLFW_EXPOSE_NATIVE_GLX)
/*! @brief Returns the `GLXContext` of the specified window.
- * @return The `GLXContext` of the specified window.
+ *
+ * @return The `GLXContext` of the specified window, or `NULL` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI GLXContext glfwGetGLXContext(GLFWwindow* window);
@@ -157,17 +303,46 @@ GLFWAPI GLXContext glfwGetGLXContext(GLFWwindow* window);
#if defined(GLFW_EXPOSE_NATIVE_EGL)
/*! @brief Returns the `EGLDisplay` used by GLFW.
- * @return The `EGLDisplay` used by GLFW.
+ *
+ * @return The `EGLDisplay` used by GLFW, or `EGL_NO_DISPLAY` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI EGLDisplay glfwGetEGLDisplay(void);
+
/*! @brief Returns the `EGLContext` of the specified window.
- * @return The `EGLContext` of the specified window.
+ *
+ * @return The `EGLContext` of the specified window, or `EGL_NO_CONTEXT` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI EGLContext glfwGetEGLContext(GLFWwindow* window);
+
/*! @brief Returns the `EGLSurface` of the specified window.
- * @return The `EGLSurface` of the specified window.
+ *
+ * @return The `EGLSurface` of the specified window, or `EGL_NO_SURFACE` if an
+ * [error](@ref error_handling) occurred.
+ *
+ * @par Thread Safety
+ * This function may be called from any thread. Access is not synchronized.
+ *
+ * @par History
+ * Added in GLFW 3.0.
+ *
* @ingroup native
*/
GLFWAPI EGLSurface glfwGetEGLSurface(GLFWwindow* window);