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