|
|
@ -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 |
|
|
@ -40,13 +40,13 @@ extern "C" { |
|
|
|
|
|
|
|
/*! @defgroup native Native access
|
|
|
|
* |
|
|
|
* **By using the native API, you assert that you know what you're 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` |
|
|
@ -71,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 |
|
|
@ -80,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) |
|
|
@ -93,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 |
|
|
|
|
|
|
|
|
|
|
@ -102,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); |
|
|
@ -111,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); |
|
|
@ -127,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); |
|
|
@ -135,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); |
|
|
@ -148,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); |
|
|
@ -156,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); |
|
|
|