parent
5caa56b085
commit
2f301f0d29
File diff suppressed because it is too large
Load Diff
@ -1,634 +0,0 @@ |
|||||||
/*************************************************************************
|
|
||||||
* GLFW 3.4 - www.glfw.org |
|
||||||
* A library for OpenGL, window and input |
|
||||||
*------------------------------------------------------------------------ |
|
||||||
* Copyright (c) 2002-2006 Marcus Geelnard |
|
||||||
* Copyright (c) 2006-2018 Camilla Löwy <elmindreda@glfw.org> |
|
||||||
* |
|
||||||
* This software is provided 'as-is', without any express or implied |
|
||||||
* warranty. In no event will the authors be held liable for any damages |
|
||||||
* arising from the use of this software. |
|
||||||
* |
|
||||||
* Permission is granted to anyone to use this software for any purpose, |
|
||||||
* including commercial applications, and to alter it and redistribute it |
|
||||||
* freely, subject to the following restrictions: |
|
||||||
* |
|
||||||
* 1. The origin of this software must not be misrepresented; you must not |
|
||||||
* claim that you wrote the original software. If you use this software |
|
||||||
* in a product, an acknowledgment in the product documentation would |
|
||||||
* be appreciated but is not required. |
|
||||||
* |
|
||||||
* 2. Altered source versions must be plainly marked as such, and must not |
|
||||||
* be misrepresented as being the original software. |
|
||||||
* |
|
||||||
* 3. This notice may not be removed or altered from any source |
|
||||||
* distribution. |
|
||||||
* |
|
||||||
*************************************************************************/ |
|
||||||
|
|
||||||
#ifndef _glfw3_native_h_ |
|
||||||
#define _glfw3_native_h_ |
|
||||||
|
|
||||||
#ifdef __cplusplus |
|
||||||
extern "C" { |
|
||||||
#endif |
|
||||||
|
|
||||||
|
|
||||||
/*************************************************************************
|
|
||||||
* Doxygen documentation |
|
||||||
*************************************************************************/ |
|
||||||
|
|
||||||
/*! @file glfw3native.h
|
|
||||||
* @brief The header of the native access functions. |
|
||||||
* |
|
||||||
* This is the header file of the native access functions. See @ref native for |
|
||||||
* more information. |
|
||||||
*/ |
|
||||||
/*! @defgroup native Native access
|
|
||||||
* @brief Functions related to accessing native handles. |
|
||||||
* |
|
||||||
* **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 may define zero or more |
|
||||||
* window system API macro and zero or more context creation API macros. |
|
||||||
* |
|
||||||
* The chosen backends must match those the library was compiled for. Failure |
|
||||||
* to do this will cause a link-time error. |
|
||||||
* |
|
||||||
* The available window API macros are: |
|
||||||
* * `GLFW_EXPOSE_NATIVE_WIN32` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_COCOA` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_X11` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_WAYLAND` |
|
||||||
* |
|
||||||
* The available context API macros are: |
|
||||||
* * `GLFW_EXPOSE_NATIVE_WGL` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_NSGL` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_GLX` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_EGL` |
|
||||||
* * `GLFW_EXPOSE_NATIVE_OSMESA` |
|
||||||
* |
|
||||||
* 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. |
|
||||||
* |
|
||||||
* If you do not want the platform-specific headers to be included, define |
|
||||||
* `GLFW_NATIVE_INCLUDE_NONE` before including the @ref glfw3native.h header. |
|
||||||
* |
|
||||||
* @code |
|
||||||
* #define GLFW_EXPOSE_NATIVE_WIN32 |
|
||||||
* #define GLFW_EXPOSE_NATIVE_WGL |
|
||||||
* #define GLFW_NATIVE_INCLUDE_NONE |
|
||||||
* #include <GLFW/glfw3native.h> |
|
||||||
* @endcode |
|
||||||
*/ |
|
||||||
|
|
||||||
|
|
||||||
/*************************************************************************
|
|
||||||
* System headers and types |
|
||||||
*************************************************************************/ |
|
||||||
|
|
||||||
#if !defined(GLFW_NATIVE_INCLUDE_NONE) |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_WIN32) || defined(GLFW_EXPOSE_NATIVE_WGL) |
|
||||||
/* This is a workaround for the fact that glfw3.h needs to export APIENTRY (for
|
|
||||||
* example to allow applications to correctly declare a GL_KHR_debug callback) |
|
||||||
* but windows.h assumes no one will define APIENTRY before it does |
|
||||||
*/ |
|
||||||
#if defined(GLFW_APIENTRY_DEFINED) |
|
||||||
#undef APIENTRY |
|
||||||
#undef GLFW_APIENTRY_DEFINED |
|
||||||
#endif |
|
||||||
#include <windows.h> |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_COCOA) || defined(GLFW_EXPOSE_NATIVE_NSGL) |
|
||||||
#if defined(__OBJC__) |
|
||||||
#import <Cocoa/Cocoa.h> |
|
||||||
#else |
|
||||||
#include <ApplicationServices/ApplicationServices.h> |
|
||||||
#include <objc/objc.h> |
|
||||||
#endif |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_X11) || defined(GLFW_EXPOSE_NATIVE_GLX) |
|
||||||
#include <X11/Xlib.h> |
|
||||||
#include <X11/extensions/Xrandr.h> |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_WAYLAND) |
|
||||||
#include <wayland-client.h> |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_WGL) |
|
||||||
/* WGL is declared by windows.h */ |
|
||||||
#endif |
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_NSGL) |
|
||||||
/* NSGL is declared by Cocoa.h */ |
|
||||||
#endif |
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_GLX) |
|
||||||
/* This is a workaround for the fact that glfw3.h defines GLAPIENTRY because by
|
|
||||||
* default it also acts as an OpenGL header |
|
||||||
* However, glx.h will include gl.h, which will define it unconditionally |
|
||||||
*/ |
|
||||||
#if defined(GLFW_GLAPIENTRY_DEFINED) |
|
||||||
#undef GLAPIENTRY |
|
||||||
#undef GLFW_GLAPIENTRY_DEFINED |
|
||||||
#endif |
|
||||||
#include <GL/glx.h> |
|
||||||
#endif |
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_EGL) |
|
||||||
#include <EGL/egl.h> |
|
||||||
#endif |
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_OSMESA) |
|
||||||
/* This is a workaround for the fact that glfw3.h defines GLAPIENTRY because by
|
|
||||||
* default it also acts as an OpenGL header |
|
||||||
* However, osmesa.h will include gl.h, which will define it unconditionally |
|
||||||
*/ |
|
||||||
#if defined(GLFW_GLAPIENTRY_DEFINED) |
|
||||||
#undef GLAPIENTRY |
|
||||||
#undef GLFW_GLAPIENTRY_DEFINED |
|
||||||
#endif |
|
||||||
#include <GL/osmesa.h> |
|
||||||
#endif |
|
||||||
|
|
||||||
#endif /*GLFW_NATIVE_INCLUDE_NONE*/ |
|
||||||
|
|
||||||
|
|
||||||
/*************************************************************************
|
|
||||||
* Functions |
|
||||||
*************************************************************************/ |
|
||||||
|
|
||||||
#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. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 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. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 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, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @remark The `HDC` associated with the window can be queried with the |
|
||||||
* [GetDC](https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-getdc)
|
|
||||||
* function. |
|
||||||
* @code |
|
||||||
* HDC dc = GetDC(glfwGetWin32Window(window)); |
|
||||||
* @endcode |
|
||||||
* This DC is private and does not need to be released. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI HWND glfwGetWin32Window(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_WGL) |
|
||||||
/*! @brief Returns the `HGLRC` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `HGLRC` of the specified window, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @remark The `HDC` associated with the window can be queried with the |
|
||||||
* [GetDC](https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-getdc)
|
|
||||||
* function. |
|
||||||
* @code |
|
||||||
* HDC dc = GetDC(glfwGetWin32Window(window)); |
|
||||||
* @endcode |
|
||||||
* This DC is private and does not need to be released. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 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. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.1. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI CGDirectDisplayID glfwGetCocoaMonitor(GLFWmonitor* monitor); |
|
||||||
|
|
||||||
/*! @brief Returns the `NSWindow` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `NSWindow` of the specified window, or `nil` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI id glfwGetCocoaWindow(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_NSGL) |
|
||||||
/*! @brief Returns the `NSOpenGLContext` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `NSOpenGLContext` of the specified window, or `nil` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI id glfwGetNSGLContext(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_X11) |
|
||||||
/*! @brief Returns the `Display` used by GLFW.
|
|
||||||
* |
|
||||||
* @return The `Display` used by GLFW, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 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. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 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. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.1. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI RROutput glfwGetX11Monitor(GLFWmonitor* monitor); |
|
||||||
|
|
||||||
/*! @brief Returns the `Window` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `Window` of the specified window, or `None` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI Window glfwGetX11Window(GLFWwindow* window); |
|
||||||
|
|
||||||
/*! @brief Sets the current primary selection to the specified string.
|
|
||||||
* |
|
||||||
* @param[in] string A UTF-8 encoded string. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref |
|
||||||
* GLFW_PLATFORM_ERROR. |
|
||||||
* |
|
||||||
* @pointer_lifetime The specified string is copied before this function |
|
||||||
* returns. |
|
||||||
* |
|
||||||
* @thread_safety This function must only be called from the main thread. |
|
||||||
* |
|
||||||
* @sa @ref clipboard |
|
||||||
* @sa glfwGetX11SelectionString |
|
||||||
* @sa glfwSetClipboardString |
|
||||||
* |
|
||||||
* @since Added in version 3.3. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI void glfwSetX11SelectionString(const char* string); |
|
||||||
|
|
||||||
/*! @brief Returns the contents of the current primary selection as a string.
|
|
||||||
* |
|
||||||
* If the selection is empty or if its contents cannot be converted, `NULL` |
|
||||||
* is returned and a @ref GLFW_FORMAT_UNAVAILABLE error is generated. |
|
||||||
* |
|
||||||
* @return The contents of the selection as a UTF-8 encoded string, or `NULL` |
|
||||||
* if an [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref |
|
||||||
* GLFW_PLATFORM_ERROR. |
|
||||||
* |
|
||||||
* @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 |
|
||||||
* glfwGetX11SelectionString or @ref glfwSetX11SelectionString, or until the |
|
||||||
* library is terminated. |
|
||||||
* |
|
||||||
* @thread_safety This function must only be called from the main thread. |
|
||||||
* |
|
||||||
* @sa @ref clipboard |
|
||||||
* @sa glfwSetX11SelectionString |
|
||||||
* @sa glfwGetClipboardString |
|
||||||
* |
|
||||||
* @since Added in version 3.3. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI const char* glfwGetX11SelectionString(void); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_GLX) |
|
||||||
/*! @brief Returns the `GLXContext` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `GLXContext` of the specified window, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI GLXContext glfwGetGLXContext(GLFWwindow* window); |
|
||||||
|
|
||||||
/*! @brief Returns the `GLXWindow` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `GLXWindow` of the specified window, or `None` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.2. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI GLXWindow glfwGetGLXWindow(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_WAYLAND) |
|
||||||
/*! @brief Returns the `struct wl_display*` used by GLFW.
|
|
||||||
* |
|
||||||
* @return The `struct wl_display*` used by GLFW, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.2. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI struct wl_display* glfwGetWaylandDisplay(void); |
|
||||||
|
|
||||||
/*! @brief Returns the `struct wl_output*` of the specified monitor.
|
|
||||||
* |
|
||||||
* @return The `struct wl_output*` of the specified monitor, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.2. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI struct wl_output* glfwGetWaylandMonitor(GLFWmonitor* monitor); |
|
||||||
|
|
||||||
/*! @brief Returns the main `struct wl_surface*` of the specified window.
|
|
||||||
* |
|
||||||
* @return The main `struct wl_surface*` of the specified window, or `NULL` if |
|
||||||
* an [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.2. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI struct wl_surface* glfwGetWaylandWindow(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_EGL) |
|
||||||
/*! @brief Returns the `EGLDisplay` used by GLFW.
|
|
||||||
* |
|
||||||
* @return The `EGLDisplay` used by GLFW, or `EGL_NO_DISPLAY` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @remark Because EGL is initialized on demand, this function will return |
|
||||||
* `EGL_NO_DISPLAY` until the first context has been created via EGL. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI EGLDisplay glfwGetEGLDisplay(void); |
|
||||||
|
|
||||||
/*! @brief Returns the `EGLContext` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `EGLContext` of the specified window, or `EGL_NO_CONTEXT` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI EGLContext glfwGetEGLContext(GLFWwindow* window); |
|
||||||
|
|
||||||
/*! @brief Returns the `EGLSurface` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `EGLSurface` of the specified window, or `EGL_NO_SURFACE` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.0. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI EGLSurface glfwGetEGLSurface(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(GLFW_EXPOSE_NATIVE_OSMESA) |
|
||||||
/*! @brief Retrieves the color buffer associated with the specified window.
|
|
||||||
* |
|
||||||
* @param[in] window The window whose color buffer to retrieve. |
|
||||||
* @param[out] width Where to store the width of the color buffer, or `NULL`. |
|
||||||
* @param[out] height Where to store the height of the color buffer, or `NULL`. |
|
||||||
* @param[out] format Where to store the OSMesa pixel format of the color |
|
||||||
* buffer, or `NULL`. |
|
||||||
* @param[out] buffer Where to store the address of the color buffer, or |
|
||||||
* `NULL`. |
|
||||||
* @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.3. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI int glfwGetOSMesaColorBuffer(GLFWwindow* window, int* width, int* height, int* format, void** buffer); |
|
||||||
|
|
||||||
/*! @brief Retrieves the depth buffer associated with the specified window.
|
|
||||||
* |
|
||||||
* @param[in] window The window whose depth buffer to retrieve. |
|
||||||
* @param[out] width Where to store the width of the depth buffer, or `NULL`. |
|
||||||
* @param[out] height Where to store the height of the depth buffer, or `NULL`. |
|
||||||
* @param[out] bytesPerValue Where to store the number of bytes per depth |
|
||||||
* buffer element, or `NULL`. |
|
||||||
* @param[out] buffer Where to store the address of the depth buffer, or |
|
||||||
* `NULL`. |
|
||||||
* @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.3. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI int glfwGetOSMesaDepthBuffer(GLFWwindow* window, int* width, int* height, int* bytesPerValue, void** buffer); |
|
||||||
|
|
||||||
/*! @brief Returns the `OSMesaContext` of the specified window.
|
|
||||||
* |
|
||||||
* @return The `OSMesaContext` of the specified window, or `NULL` if an |
|
||||||
* [error](@ref error_handling) occurred. |
|
||||||
* |
|
||||||
* @errors Possible errors include @ref GLFW_NO_WINDOW_CONTEXT and @ref |
|
||||||
* GLFW_NOT_INITIALIZED. |
|
||||||
* |
|
||||||
* @thread_safety This function may be called from any thread. Access is not |
|
||||||
* synchronized. |
|
||||||
* |
|
||||||
* @since Added in version 3.3. |
|
||||||
* |
|
||||||
* @ingroup native |
|
||||||
*/ |
|
||||||
GLFWAPI OSMesaContext glfwGetOSMesaContext(GLFWwindow* window); |
|
||||||
#endif |
|
||||||
|
|
||||||
#ifdef __cplusplus |
|
||||||
} |
|
||||||
#endif |
|
||||||
|
|
||||||
#endif /* _glfw3_native_h_ */ |
|
||||||
|
|
@ -1,311 +0,0 @@ |
|||||||
#ifndef __khrplatform_h_ |
|
||||||
#define __khrplatform_h_ |
|
||||||
|
|
||||||
/*
|
|
||||||
** Copyright (c) 2008-2018 The Khronos Group Inc. |
|
||||||
** |
|
||||||
** Permission is hereby granted, free of charge, to any person obtaining a |
|
||||||
** copy of this software and/or associated documentation files (the |
|
||||||
** "Materials"), to deal in the Materials without restriction, including |
|
||||||
** without limitation the rights to use, copy, modify, merge, publish, |
|
||||||
** distribute, sublicense, and/or sell copies of the Materials, and to |
|
||||||
** permit persons to whom the Materials are furnished to do so, subject to |
|
||||||
** the following conditions: |
|
||||||
** |
|
||||||
** The above copyright notice and this permission notice shall be included |
|
||||||
** in all copies or substantial portions of the Materials. |
|
||||||
** |
|
||||||
** THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
|
||||||
** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
|
||||||
** MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
|
||||||
** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
|
||||||
** CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
|
||||||
** TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
|
||||||
** MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS. |
|
||||||
*/ |
|
||||||
|
|
||||||
/* Khronos platform-specific types and definitions.
|
|
||||||
* |
|
||||||
* The master copy of khrplatform.h is maintained in the Khronos EGL |
|
||||||
* Registry repository at https://github.com/KhronosGroup/EGL-Registry
|
|
||||||
* The last semantic modification to khrplatform.h was at commit ID: |
|
||||||
* 67a3e0864c2d75ea5287b9f3d2eb74a745936692 |
|
||||||
* |
|
||||||
* Adopters may modify this file to suit their platform. Adopters are |
|
||||||
* encouraged to submit platform specific modifications to the Khronos |
|
||||||
* group so that they can be included in future versions of this file. |
|
||||||
* Please submit changes by filing pull requests or issues on |
|
||||||
* the EGL Registry repository linked above. |
|
||||||
* |
|
||||||
* |
|
||||||
* See the Implementer's Guidelines for information about where this file |
|
||||||
* should be located on your system and for more details of its use: |
|
||||||
* http://www.khronos.org/registry/implementers_guide.pdf
|
|
||||||
* |
|
||||||
* This file should be included as |
|
||||||
* #include <KHR/khrplatform.h> |
|
||||||
* by Khronos client API header files that use its types and defines. |
|
||||||
* |
|
||||||
* The types in khrplatform.h should only be used to define API-specific types. |
|
||||||
* |
|
||||||
* Types defined in khrplatform.h: |
|
||||||
* khronos_int8_t signed 8 bit |
|
||||||
* khronos_uint8_t unsigned 8 bit |
|
||||||
* khronos_int16_t signed 16 bit |
|
||||||
* khronos_uint16_t unsigned 16 bit |
|
||||||
* khronos_int32_t signed 32 bit |
|
||||||
* khronos_uint32_t unsigned 32 bit |
|
||||||
* khronos_int64_t signed 64 bit |
|
||||||
* khronos_uint64_t unsigned 64 bit |
|
||||||
* khronos_intptr_t signed same number of bits as a pointer |
|
||||||
* khronos_uintptr_t unsigned same number of bits as a pointer |
|
||||||
* khronos_ssize_t signed size |
|
||||||
* khronos_usize_t unsigned size |
|
||||||
* khronos_float_t signed 32 bit floating point |
|
||||||
* khronos_time_ns_t unsigned 64 bit time in nanoseconds |
|
||||||
* khronos_utime_nanoseconds_t unsigned time interval or absolute time in |
|
||||||
* nanoseconds |
|
||||||
* khronos_stime_nanoseconds_t signed time interval in nanoseconds |
|
||||||
* khronos_boolean_enum_t enumerated boolean type. This should |
|
||||||
* only be used as a base type when a client API's boolean type is |
|
||||||
* an enum. Client APIs which use an integer or other type for |
|
||||||
* booleans cannot use this as the base type for their boolean. |
|
||||||
* |
|
||||||
* Tokens defined in khrplatform.h: |
|
||||||
* |
|
||||||
* KHRONOS_FALSE, KHRONOS_TRUE Enumerated boolean false/true values. |
|
||||||
* |
|
||||||
* KHRONOS_SUPPORT_INT64 is 1 if 64 bit integers are supported; otherwise 0. |
|
||||||
* KHRONOS_SUPPORT_FLOAT is 1 if floats are supported; otherwise 0. |
|
||||||
* |
|
||||||
* Calling convention macros defined in this file: |
|
||||||
* KHRONOS_APICALL |
|
||||||
* KHRONOS_APIENTRY |
|
||||||
* KHRONOS_APIATTRIBUTES |
|
||||||
* |
|
||||||
* These may be used in function prototypes as: |
|
||||||
* |
|
||||||
* KHRONOS_APICALL void KHRONOS_APIENTRY funcname( |
|
||||||
* int arg1, |
|
||||||
* int arg2) KHRONOS_APIATTRIBUTES; |
|
||||||
*/ |
|
||||||
|
|
||||||
#if defined(__SCITECH_SNAP__) && !defined(KHRONOS_STATIC) |
|
||||||
# define KHRONOS_STATIC 1 |
|
||||||
#endif |
|
||||||
|
|
||||||
/*-------------------------------------------------------------------------
|
|
||||||
* Definition of KHRONOS_APICALL |
|
||||||
*------------------------------------------------------------------------- |
|
||||||
* This precedes the return type of the function in the function prototype. |
|
||||||
*/ |
|
||||||
#if defined(KHRONOS_STATIC) |
|
||||||
/* If the preprocessor constant KHRONOS_STATIC is defined, make the
|
|
||||||
* header compatible with static linking. */ |
|
||||||
# define KHRONOS_APICALL |
|
||||||
#elif defined(_WIN32) |
|
||||||
# define KHRONOS_APICALL __declspec(dllimport) |
|
||||||
#elif defined (__SYMBIAN32__) |
|
||||||
# define KHRONOS_APICALL IMPORT_C |
|
||||||
#elif defined(__ANDROID__) |
|
||||||
# define KHRONOS_APICALL __attribute__((visibility("default"))) |
|
||||||
#else |
|
||||||
# define KHRONOS_APICALL |
|
||||||
#endif |
|
||||||
|
|
||||||
/*-------------------------------------------------------------------------
|
|
||||||
* Definition of KHRONOS_APIENTRY |
|
||||||
*------------------------------------------------------------------------- |
|
||||||
* This follows the return type of the function and precedes the function |
|
||||||
* name in the function prototype. |
|
||||||
*/ |
|
||||||
#if defined(_WIN32) && !defined(_WIN32_WCE) && !defined(__SCITECH_SNAP__) |
|
||||||
/* Win32 but not WinCE */ |
|
||||||
# define KHRONOS_APIENTRY __stdcall |
|
||||||
#else |
|
||||||
# define KHRONOS_APIENTRY |
|
||||||
#endif |
|
||||||
|
|
||||||
/*-------------------------------------------------------------------------
|
|
||||||
* Definition of KHRONOS_APIATTRIBUTES |
|
||||||
*------------------------------------------------------------------------- |
|
||||||
* This follows the closing parenthesis of the function prototype arguments. |
|
||||||
*/ |
|
||||||
#if defined (__ARMCC_2__) |
|
||||||
#define KHRONOS_APIATTRIBUTES __softfp |
|
||||||
#else |
|
||||||
#define KHRONOS_APIATTRIBUTES |
|
||||||
#endif |
|
||||||
|
|
||||||
/*-------------------------------------------------------------------------
|
|
||||||
* basic type definitions |
|
||||||
*-----------------------------------------------------------------------*/ |
|
||||||
#if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__GNUC__) || defined(__SCO__) || defined(__USLC__) |
|
||||||
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Using <stdint.h> |
|
||||||
*/ |
|
||||||
#include <stdint.h> |
|
||||||
typedef int32_t khronos_int32_t; |
|
||||||
typedef uint32_t khronos_uint32_t; |
|
||||||
typedef int64_t khronos_int64_t; |
|
||||||
typedef uint64_t khronos_uint64_t; |
|
||||||
#define KHRONOS_SUPPORT_INT64 1 |
|
||||||
#define KHRONOS_SUPPORT_FLOAT 1 |
|
||||||
/*
|
|
||||||
* To support platform where unsigned long cannot be used interchangeably with |
|
||||||
* inptr_t (e.g. CHERI-extended ISAs), we can use the stdint.h intptr_t. |
|
||||||
* Ideally, we could just use (u)intptr_t everywhere, but this could result in |
|
||||||
* ABI breakage if khronos_uintptr_t is changed from unsigned long to |
|
||||||
* unsigned long long or similar (this results in different C++ name mangling). |
|
||||||
* To avoid changes for existing platforms, we restrict usage of intptr_t to |
|
||||||
* platforms where the size of a pointer is larger than the size of long. |
|
||||||
*/ |
|
||||||
#if defined(__SIZEOF_LONG__) && defined(__SIZEOF_POINTER__) |
|
||||||
#if __SIZEOF_POINTER__ > __SIZEOF_LONG__ |
|
||||||
#define KHRONOS_USE_INTPTR_T |
|
||||||
#endif |
|
||||||
#endif |
|
||||||
|
|
||||||
#elif defined(__VMS ) || defined(__sgi) |
|
||||||
|
|
||||||
/*
|
|
||||||
* Using <inttypes.h> |
|
||||||
*/ |
|
||||||
#include <inttypes.h> |
|
||||||
typedef int32_t khronos_int32_t; |
|
||||||
typedef uint32_t khronos_uint32_t; |
|
||||||
typedef int64_t khronos_int64_t; |
|
||||||
typedef uint64_t khronos_uint64_t; |
|
||||||
#define KHRONOS_SUPPORT_INT64 1 |
|
||||||
#define KHRONOS_SUPPORT_FLOAT 1 |
|
||||||
|
|
||||||
#elif defined(_WIN32) && !defined(__SCITECH_SNAP__) |
|
||||||
|
|
||||||
/*
|
|
||||||
* Win32 |
|
||||||
*/ |
|
||||||
typedef __int32 khronos_int32_t; |
|
||||||
typedef unsigned __int32 khronos_uint32_t; |
|
||||||
typedef __int64 khronos_int64_t; |
|
||||||
typedef unsigned __int64 khronos_uint64_t; |
|
||||||
#define KHRONOS_SUPPORT_INT64 1 |
|
||||||
#define KHRONOS_SUPPORT_FLOAT 1 |
|
||||||
|
|
||||||
#elif defined(__sun__) || defined(__digital__) |
|
||||||
|
|
||||||
/*
|
|
||||||
* Sun or Digital |
|
||||||
*/ |
|
||||||
typedef int khronos_int32_t; |
|
||||||
typedef unsigned int khronos_uint32_t; |
|
||||||
#if defined(__arch64__) || defined(_LP64) |
|
||||||
typedef long int khronos_int64_t; |
|
||||||
typedef unsigned long int khronos_uint64_t; |
|
||||||
#else |
|
||||||
typedef long long int khronos_int64_t; |
|
||||||
typedef unsigned long long int khronos_uint64_t; |
|
||||||
#endif /* __arch64__ */ |
|
||||||
#define KHRONOS_SUPPORT_INT64 1 |
|
||||||
#define KHRONOS_SUPPORT_FLOAT 1 |
|
||||||
|
|
||||||
#elif 0 |
|
||||||
|
|
||||||
/*
|
|
||||||
* Hypothetical platform with no float or int64 support |
|
||||||
*/ |
|
||||||
typedef int khronos_int32_t; |
|
||||||
typedef unsigned int khronos_uint32_t; |
|
||||||
#define KHRONOS_SUPPORT_INT64 0 |
|
||||||
#define KHRONOS_SUPPORT_FLOAT 0 |
|
||||||
|
|
||||||
#else |
|
||||||
|
|
||||||
/*
|
|
||||||
* Generic fallback |
|
||||||
*/ |
|
||||||
#include <stdint.h> |
|
||||||
typedef int32_t khronos_int32_t; |
|
||||||
typedef uint32_t khronos_uint32_t; |
|
||||||
typedef int64_t khronos_int64_t; |
|
||||||
typedef uint64_t khronos_uint64_t; |
|
||||||
#define KHRONOS_SUPPORT_INT64 1 |
|
||||||
#define KHRONOS_SUPPORT_FLOAT 1 |
|
||||||
|
|
||||||
#endif |
|
||||||
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Types that are (so far) the same on all platforms |
|
||||||
*/ |
|
||||||
typedef signed char khronos_int8_t; |
|
||||||
typedef unsigned char khronos_uint8_t; |
|
||||||
typedef signed short int khronos_int16_t; |
|
||||||
typedef unsigned short int khronos_uint16_t; |
|
||||||
|
|
||||||
/*
|
|
||||||
* Types that differ between LLP64 and LP64 architectures - in LLP64, |
|
||||||
* pointers are 64 bits, but 'long' is still 32 bits. Win64 appears |
|
||||||
* to be the only LLP64 architecture in current use. |
|
||||||
*/ |
|
||||||
#ifdef KHRONOS_USE_INTPTR_T |
|
||||||
typedef intptr_t khronos_intptr_t; |
|
||||||
typedef uintptr_t khronos_uintptr_t; |
|
||||||
#elif defined(_WIN64) |
|
||||||
typedef signed long long int khronos_intptr_t; |
|
||||||
typedef unsigned long long int khronos_uintptr_t; |
|
||||||
#else |
|
||||||
typedef signed long int khronos_intptr_t; |
|
||||||
typedef unsigned long int khronos_uintptr_t; |
|
||||||
#endif |
|
||||||
|
|
||||||
#if defined(_WIN64) |
|
||||||
typedef signed long long int khronos_ssize_t; |
|
||||||
typedef unsigned long long int khronos_usize_t; |
|
||||||
#else |
|
||||||
typedef signed long int khronos_ssize_t; |
|
||||||
typedef unsigned long int khronos_usize_t; |
|
||||||
#endif |
|
||||||
|
|
||||||
#if KHRONOS_SUPPORT_FLOAT |
|
||||||
/*
|
|
||||||
* Float type |
|
||||||
*/ |
|
||||||
typedef float khronos_float_t; |
|
||||||
#endif |
|
||||||
|
|
||||||
#if KHRONOS_SUPPORT_INT64 |
|
||||||
/* Time types
|
|
||||||
* |
|
||||||
* These types can be used to represent a time interval in nanoseconds or |
|
||||||
* an absolute Unadjusted System Time. Unadjusted System Time is the number |
|
||||||
* of nanoseconds since some arbitrary system event (e.g. since the last |
|
||||||
* time the system booted). The Unadjusted System Time is an unsigned |
|
||||||
* 64 bit value that wraps back to 0 every 584 years. Time intervals |
|
||||||
* may be either signed or unsigned. |
|
||||||
*/ |
|
||||||
typedef khronos_uint64_t khronos_utime_nanoseconds_t; |
|
||||||
typedef khronos_int64_t khronos_stime_nanoseconds_t; |
|
||||||
#endif |
|
||||||
|
|
||||||
/*
|
|
||||||
* Dummy value used to pad enum types to 32 bits. |
|
||||||
*/ |
|
||||||
#ifndef KHRONOS_MAX_ENUM |
|
||||||
#define KHRONOS_MAX_ENUM 0x7FFFFFFF |
|
||||||
#endif |
|
||||||
|
|
||||||
/*
|
|
||||||
* Enumerated boolean type |
|
||||||
* |
|
||||||
* Values other than zero should be considered to be true. Therefore |
|
||||||
* comparisons should not be made against KHRONOS_TRUE. |
|
||||||
*/ |
|
||||||
typedef enum { |
|
||||||
KHRONOS_FALSE = 0, |
|
||||||
KHRONOS_TRUE = 1, |
|
||||||
KHRONOS_BOOLEAN_ENUM_FORCE_SIZE = KHRONOS_MAX_ENUM |
|
||||||
} khronos_boolean_enum_t; |
|
||||||
|
|
||||||
#endif /* __khrplatform_h_ */ |
|
File diff suppressed because it is too large
Load Diff
Loading…
Reference in new issue