bindings-GLFW 3.1.2.4 → 3.2.1.0

raw patch · 62 files changed

+17238/−11187 lines, 62 filesPVP ok

version bump matches the API change (PVP)

API changes (from Hackage documentation)

Files

• Bindings/GLFW.hsc +304/−8
• README.md +8/−18
• Test.hs +216/−43
• bindings-GLFW.cabal +11/−8
• glfw/include/GLFW/glfw3.h +4220/−3331
• glfw/include/GLFW/glfw3native.h +172/−72
• glfw/src/cocoa_init.m +144/−18
• glfw/src/cocoa_joystick.h +60/−0
• glfw/src/cocoa_joystick.m +511/−0
• glfw/src/cocoa_monitor.m +38/−64
• glfw/src/cocoa_platform.h +58/−32
• glfw/src/cocoa_time.c +60/−0
• glfw/src/cocoa_window.m +610/−244
• glfw/src/context.c +233/−178
• glfw/src/egl_context.c +453/−240
• glfw/src/egl_context.h +163/−35
• glfw/src/glx_context.c +356/−237
• glfw/src/glx_context.h +128/−66
• glfw/src/init.c +20/−21
• glfw/src/input.c +198/−143
• glfw/src/internal.h +346/−177
• glfw/src/iokit_joystick.h +0/−61
• glfw/src/iokit_joystick.m +0/−506
• glfw/src/linux_joystick.c +112/−95
• glfw/src/linux_joystick.h +26/−21
• glfw/src/mach_time.c +0/−71
• glfw/src/mir_init.c +154/−17
• glfw/src/mir_monitor.c +52/−8
• glfw/src/mir_platform.h +41/−21
• glfw/src/mir_window.c +435/−274
• glfw/src/monitor.c +62/−27
• glfw/src/nsgl_context.h +13/−15
• glfw/src/nsgl_context.m +106/−112
• glfw/src/posix_time.c +24/−36
• glfw/src/posix_time.h +8/−9
• glfw/src/posix_tls.c +14/−12
• glfw/src/posix_tls.h +8/−8
• glfw/src/vulkan.c +302/−0
• glfw/src/wgl_context.c +403/−394
• glfw/src/wgl_context.h +110/−42
• glfw/src/win32_init.c +161/−82
• glfw/src/win32_joystick.c +763/−0
• glfw/src/win32_joystick.h +64/−0
• glfw/src/win32_monitor.c +141/−88
• glfw/src/win32_platform.h +158/−58
• glfw/src/win32_time.c +19/−31
• glfw/src/win32_tls.c +12/−12
• glfw/src/win32_tls.h +0/−48
• glfw/src/win32_window.c +1709/−1297
• glfw/src/window.c +338/−174
• glfw/src/winmm_joystick.c +0/−177
• glfw/src/winmm_joystick.h +0/−47
• glfw/src/wl_init.c +184/−156
• glfw/src/wl_monitor.c +27/−8
• glfw/src/wl_platform.h +60/−21
• glfw/src/wl_window.c +631/−105
• glfw/src/x11_init.c +190/−177
• glfw/src/x11_monitor.c +33/−36
• glfw/src/x11_platform.h +91/−62
• glfw/src/x11_window.c +2454/−1920
• glfw/src/xkb_unicode.c +20/−20
• glfw/src/xkb_unicode.h +4/−4

@@ -7,6 +7,7 @@  #include <bindings.dsl.h> #include <GLFW/glfw3.h>+ #ifdef ExposeNative   #warning "You are compiling glfw using the native access functions. BEWARE." @@ -22,8 +23,16 @@    #elif defined(__linux__) -    #define GLFW_EXPOSE_NATIVE_X11-    #define GLFW_EXPOSE_NATIVE_GLX+    #if defined(BINDINGS_GLFW_USE_X11)+      #define GLFW_EXPOSE_NATIVE_X11+      #define GLFW_EXPOSE_NATIVE_GLX+    #elif defined(BINDINGS_GLFW_USE_WAYLAND)+      #define GLFW_EXPOSE_NATIVE_WAYLAND+      #define GLFW_EXPOSE_NATIVE_EGL+    #elif defined(BINDINGS_GLFW_USE_MIR)+      #define GLFW_EXPOSE_NATIVE_MIR+      #define GLFW_EXPOSE_NATIVE_EGL+    #endif    #endif @@ -36,19 +45,19 @@ module Bindings.GLFW where  import Prelude (Eq, IO, Num, Show)-import Prelude (($), return)+import Prelude (($), return, error, (++))  import Data.Data        (Data)+import Data.Int         (Int32)+import Data.Word        (Word32, Word64) import Data.Typeable    (Typeable) import Foreign.C.Types  (CChar, CUChar, CUShort)-import Foreign.C.Types  (CDouble(..), CFloat(..), CInt(..), CUInt(..))-import Foreign.Ptr      (FunPtr, Ptr, plusPtr)+import Foreign.C.Types  (CDouble(..), CFloat(..), CInt(..), CUInt(..), CULong(..))+import Foreign.C.String (CString)+import Foreign.Ptr      (FunPtr, nullFunPtr, Ptr, plusPtr) import Foreign.Storable (Storable(..)) -------------------------------------------------------------------------------- -#num GL_FALSE-#num GL_TRUE- #num GLFW_VERSION_MAJOR #num GLFW_VERSION_MINOR #num GLFW_VERSION_REVISION@@ -406,6 +415,14 @@ #num GLFW_HAND_CURSOR #num GLFW_HRESIZE_CURSOR #num GLFW_VRESIZE_CURSOR+#num GLFW_DONT_CARE+#num GLFW_DOUBLEBUFFER+#num GLFW_AUTO_ICONIFY+#num GLFW_FLOATING+#num GLFW_CONTEXT_RELEASE_BEHAVIOR+#num GLFW_ANY_RELEASE_BEHAVIOR+#num GLFW_RELEASE_BEHAVIOR_FLUSH+#num GLFW_RELEASE_BEHAVIOR_NONE  #starttype GLFWimage #field width  , CInt@@ -418,9 +435,288 @@ deriving instance Data     C'GLFWcursor  #callback GLFWdropfun , Ptr <GLFWwindow> -> CInt -> Ptr (Ptr CChar) -> IO ()+#callback GLFWcharmodsfun , Ptr <GLFWwindow> -> CUInt -> CInt -> IO ()  #ccall glfwCreateCursor , Ptr <GLFWimage> -> CInt -> CInt -> IO (Ptr <GLFWcursor>) #ccall glfwCreateStandardCursor , CInt -> IO (Ptr <GLFWcursor>) #ccall glfwSetCursor , Ptr <GLFWwindow> -> Ptr <GLFWcursor> -> IO () #ccall glfwDestroyCursor , Ptr <GLFWcursor> -> IO () #ccall glfwSetDropCallback , Ptr <GLFWwindow> -> <GLFWdropfun> -> IO <GLFWdropfun>+#ccall glfwSetCharModsCallback , Ptr <GLFWwindow> -> <GLFWcharmodsfun> -> IO <GLFWcharmodsfun>+#ccall glfwGetWindowFrameSize , Ptr <GLFWwindow> -> Ptr CInt -> Ptr CInt -> Ptr CInt -> Ptr CInt -> IO ()++--------------------------------------------------------------------------------+-- GLFW 3.2 additions+--------------------------------------------------------------------------------++#num GLFW_NO_API+#num GLFW_CONTEXT_CREATION_API+#num GLFW_NATIVE_CONTEXT_API+#num GLFW_EGL_CONTEXT_API+#num GLFW_CONTEXT_NO_ERROR+#num GLFW_TRUE+#num GLFW_FALSE+#num GLFW_MAXIMIZED++#ccall glfwFocusWindow , Ptr <GLFWwindow> -> IO ()+#ccall glfwMaximizeWindow , Ptr <GLFWwindow> -> IO ()+#ccall glfwSetWindowMonitor , Ptr <GLFWwindow> -> Ptr <GLFWmonitor> -> CInt -> CInt -> CInt -> CInt -> CInt -> IO ()+#ccall glfwSetWindowIcon , Ptr <GLFWwindow> -> CInt -> Ptr <GLFWimage> -> IO ()+#ccall glfwWaitEventsTimeout , CDouble -> IO ()+#ccall glfwSetWindowSizeLimits , Ptr <GLFWwindow> -> CInt -> CInt -> CInt -> CInt -> IO ()+#ccall glfwSetWindowAspectRatio , Ptr <GLFWwindow> -> CInt -> CInt -> IO ()+#ccall glfwGetKeyName , CInt -> CInt -> IO CString+#ccall glfwGetTimerValue , IO (CULong)+#ccall glfwGetTimerFrequency , IO (CULong)++#callback GLFWjoystickfun , CInt -> CInt -> IO ()+#ccall glfwSetJoystickCallback , <GLFWjoystickfun> -> IO <GLFWjoystickfun>++#ccall glfwVulkanSupported , IO CInt+#ccall glfwGetRequiredInstanceExtensions , Ptr Word32 -> IO (Ptr CString)++-- GLFW prevents the declaration of some of the Vulkan functions in its header+-- glfw3.h if it cannot find the required Vulkan headers. As of now (4/2018),+-- these functions are still *defined* in vulkan.c, which is built regardless of+-- whether or not the Vulkan headers were found. Internally, the required types+-- are defined locally in order to make the build work, and h2c will still link+-- against them without a problem. Whether or not you have a valid Vulkan+-- implementation might not be clear though. Nothing is preventing the glfw3+-- authors from hiding the Vulkan functions without valid headers, which could+-- cause some pain in the future, so use the following functions with caution.+-- See commit @521d161af85047 for a way to deal with this more annoyingly.+#ccall glfwGetInstanceProcAddress               , Ptr vkInstance -> CString -> IO (FunPtr vkProc)+#ccall glfwGetPhysicalDevicePresentationSupport , Ptr vkInstance -> Ptr vkPhysicalDevice -> Word32 -> IO CInt+#ccall glfwCreateWindowSurface                  , Ptr vkInstance -> Ptr <GLFWwindow> -> Ptr vkAllocationCallbacks -> Ptr vkSurfaceKHR -> IO Int32+++--------------------------------------------------------------------------------+-- Native APIs+--------------------------------------------------------------------------------++#if defined(GLFW_EXPOSE_NATIVE_WIN32)+#ccall glfwGetWin32Adapter , Ptr <GLFWwindow> -> IO CString+#ccall glfwGetWin32Monitor , Ptr <GLFWwindow> -> IO (Ptr ())+#ccall glfwGetWin32Window  , Ptr <GLFWwindow> -> IO (Ptr ())+#else++p'glfwGetWin32Adapter :: FunPtr (Ptr C'GLFWwindow -> IO CString)+p'glfwGetWin32Adapter = nullFunPtr++c'glfwGetWin32Adapter :: Ptr C'GLFWwindow -> IO CString+c'glfwGetWin32Adapter =+  error $ "c'glfwGetWin32Adapter undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetWin32Monitor :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetWin32Monitor = nullFunPtr++c'glfwGetWin32Monitor :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetWin32Monitor =+  error $ "c'glfwGetWin32Monitor undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetWin32Window :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetWin32Window = nullFunPtr++c'glfwGetWin32Window ::  Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetWin32Window =+  error $ "c'glfwGetWin32Window undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_WGL)+#ccall glfwGetWGLContext , Ptr <GLFWwindow> -> IO (Ptr ())+#else+p'glfwGetWGLContext :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetWGLContext = nullFunPtr++c'glfwGetWGLContext :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetWGLContext =+  error $ "c'glfwGetWGLContext undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_COCOA)+#ccall glfwGetCocoaMonitor , Ptr <GLFWwindow> -> IO (Ptr Word32)+#ccall glfwGetCocoaWindow , Ptr <GLFWwindow> -> IO (Ptr ())+#else+p'glfwGetCocoaMonitor :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr Word32))+p'glfwGetCocoaMonitor = nullFunPtr++c'glfwGetCocoaMonitor :: Ptr C'GLFWwindow -> IO (Ptr Word32)+c'glfwGetCocoaMonitor =+  error $ "c'glfwGetCocoaMonitor undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetCocoaWindow :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetCocoaWindow = nullFunPtr++c'glfwGetCocoaWindow :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetCocoaWindow =+  error $ "c'glfwGetCocoaWindow undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_NSGL)+#ccall glfwGetNSGLContext , Ptr <GLFWwindow> -> IO (Ptr ())+#else+p'glfwGetNSGLContext :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetNSGLContext = nullFunPtr++c'glfwGetNSGLContext :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetNSGLContext =+  error $ "c'glfwGetNSGLContext undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_X11)+#ccall glfwGetX11Display , Ptr <GLFWwindow> -> IO (Ptr display)+#ccall glfwGetX11Adapter , Ptr <GLFWwindow> -> IO Word64+#ccall glfwGetX11Monitor , Ptr <GLFWwindow> -> IO Word64+#ccall glfwGetX11Window  , Ptr <GLFWwindow> -> IO Word64+#else+p'glfwGetX11Display :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr display))+p'glfwGetX11Display = nullFunPtr++c'glfwGetX11Display :: Ptr C'GLFWwindow -> IO (Ptr display)+c'glfwGetX11Display =+  error $ "c'glfwGetX11Display undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetX11Adapter :: FunPtr (Ptr C'GLFWwindow -> IO Word64)+p'glfwGetX11Adapter = nullFunPtr++c'glfwGetX11Adapter :: Ptr C'GLFWwindow -> IO Word64+c'glfwGetX11Adapter =+  error $ "c'glfwGetX11Adapter undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetX11Monitor :: FunPtr (Ptr C'GLFWwindow -> IO Word64)+p'glfwGetX11Monitor = nullFunPtr++c'glfwGetX11Monitor :: Ptr C'GLFWwindow -> IO Word64+c'glfwGetX11Monitor =+  error $ "c'glfwGetX11Monitor undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetX11Window :: FunPtr (Ptr C'GLFWwindow -> IO Word64)+p'glfwGetX11Window = nullFunPtr++c'glfwGetX11Window ::  Ptr C'GLFWwindow -> IO Word64+c'glfwGetX11Window =+  error $ "c'glfwGetX11Window undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_GLX)+#ccall glfwGetGLXContext , Ptr <GLFWwindow> -> IO (Ptr ())+#ccall glfwGetGLXWindow  , Ptr <GLFWwindow> -> IO Word64+#else+p'glfwGetGLXContext :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetGLXContext = nullFunPtr++c'glfwGetGLXContext :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetGLXContext =+  error $ "c'glfwGetGLXContext undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetGLXWindow :: FunPtr (Ptr C'GLFWwindow -> IO Word64)+p'glfwGetGLXWindow = nullFunPtr++c'glfwGetGLXWindow ::  Ptr C'GLFWwindow -> IO Word64+c'glfwGetGLXWindow =+  error $ "c'glfwGetGLXWindow undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_WAYLAND)+#ccall glfwGetWaylandDisplay , IO (Ptr wl_display)+#ccall glfwGetWaylandMonitor , Ptr <GLFWwindow> -> IO (Ptr wl_output)+#ccall glfwGetWaylandWindow , Ptr <GLFWwindow> -> IO (Ptr wl_surface)+#else+p'glfwGetWaylandDisplay :: FunPtr (IO (Ptr wl_display))+p'glfwGetWaylandDisplay = nullFunPtr++c'glfwGetWaylandDisplay :: IO (Ptr wl_display)+c'glfwGetWaylandDisplay =+  error $ "c'glfwGetWaylandDisplay undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetWaylandMonitor :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr wl_output))+p'glfwGetWaylandMonitor = nullFunPtr++c'glfwGetWaylandMonitor :: Ptr C'GLFWwindow -> IO (Ptr wl_output)+c'glfwGetWaylandMonitor =+  error $ "c'glfwGetWaylandMonitor undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetWaylandWindow :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr wl_surface))+p'glfwGetWaylandWindow = nullFunPtr++c'glfwGetWaylandWindow :: Ptr C'GLFWwindow -> IO (Ptr wl_surface)+c'glfwGetWaylandWindow =+  error $ "c'glfwGetWaylandWindow undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_MIR)+#ccall glfwGetMirDisplay , IO (Ptr mir_connection)+#ccall glfwGetMirMonitor , Ptr <GLFWwindow> -> IO CInt+#ccall glfwGetMirWindow , Ptr <GLFWwindow> -> IO (Ptr mir_surface)+#else+p'glfwGetMirDisplay :: FunPtr (IO (Ptr mir_connection))+p'glfwGetMirDisplay = nullFunPtr++c'glfwGetMirDisplay :: IO (Ptr mir_connection)+c'glfwGetMirDisplay =+  error $ "c'glfwGetMirDisplay undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetMirMonitor :: FunPtr (Ptr C'GLFWwindow -> IO CInt)+p'glfwGetMirMonitor = nullFunPtr++c'glfwGetMirMonitor :: Ptr C'GLFWwindow -> IO CInt+c'glfwGetMirMonitor =+  error $ "c'glfwGetMirMonitor undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetMirWindow :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr mir_surface))+p'glfwGetMirWindow = nullFunPtr++c'glfwGetMirWindow :: Ptr C'GLFWwindow -> IO (Ptr mir_surface)+c'glfwGetMirWindow =+  error $ "c'glfwGetMirWindow undefined! -- "+       ++ "Did you use the wrong glfw3native API?"+#endif++#if defined(GLFW_EXPOSE_NATIVE_EGL)+#ccall glfwGetEGLDisplay , IO (Ptr ())+#ccall glfwGetEGLContext , Ptr <GLFWwindow> -> IO (Ptr ())+#ccall glfwGetEGLSurface , Ptr <GLFWwindow> -> IO (Ptr ())+#else+p'glfwGetEGLDisplay :: FunPtr (IO (Ptr ()))+p'glfwGetEGLDisplay = nullFunPtr++c'glfwGetEGLDisplay :: IO (Ptr ())+c'glfwGetEGLDisplay =+  error $ "c'glfwGetEGLDisplay undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetEGLContext :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetEGLContext = nullFunPtr++c'glfwGetEGLContext :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetEGLContext =+  error $ "c'glfwGetEGLContext undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++p'glfwGetEGLSurface :: FunPtr (Ptr C'GLFWwindow -> IO (Ptr ()))+p'glfwGetEGLSurface = nullFunPtr++c'glfwGetEGLSurface :: Ptr C'GLFWwindow -> IO (Ptr ())+c'glfwGetEGLSurface =+  error $ "c'glfwGetEGLSurface undefined! -- "+       ++ "Did you use the wrong glfw3native API?"++#endif

@@ -9,30 +9,20 @@ library for creating windows with OpenGL contexts and managing input and events. -The binding is to [GLFW 3.1 released 2015-01-18][3].+The binding is to [GLFW 3.2.1 released 2016-08-18][3]. -*These bindings are too low-level for normal use.* For higher-level GLFW-bindings, see [GLFW-b][4].+*These bindings are a lot lower level than intended for normal use.*+For higher-level GLFW bindings, see [GLFW-b][4].  ## Contributing -This package uses git-flow as development model, in short that means that:--1. New features should be added to "develop" branch.-2. "master" branch is reserved for stable releases.-3. Patches for bugs related with previous releases should always be done in-    "hotfixes" branch.-4. All merge commits to master from "hotfixes" should be done-    using the "--no-ff" flag and from "develop" should avoid merging commits.--Until we have a defined road-map we are going to leave out "release-"branches" and "feature branches". For more information about this development-model please refer to [this site.][5]+1. To add a new feature or fix a bug, please start a new branch with a+   meaningful name (not "feature").+2. "master" branch is reserved as the current up-to-date working tree. -Thanks you, and happy coding.+Thank you, and happy coding.  [1]: http://www.haskell.org/ [2]: http://www.glfw.org/-[3]: http://www.glfw.org/Version-3.1-released.html+[3]: http://www.glfw.org/Version-3.2.1-released.html [4]: https://github.com/bsl/GLFW-b-[5]: http://nvie.com/posts/a-successful-git-branching-model/

@@ -4,13 +4,14 @@ import Data.Char             (isAscii) import Data.List             (intercalate, isPrefixOf) import Foreign.C.String      (peekCString, withCString)+import Foreign.C.Types       (CDouble(..)) import Foreign.Marshal.Alloc (alloca) import Foreign.Marshal.Array (peekArray)-import Foreign.Ptr           (Ptr, nullPtr)+import Foreign.Ptr           (Ptr, nullPtr, nullFunPtr) import Foreign.Storable      (Storable(..))  -- HUnit-import Test.HUnit ((@?=), assertBool, assertFailure)+import Test.HUnit ((@?=), (@?), assertBool, assertFailure)  -- test-framework import Test.Framework (Test, defaultMain, testGroup)@@ -39,11 +40,19 @@      p'mon <- c'glfwGetPrimaryMonitor -    c'glfwWindowHint c'GLFW_VISIBLE c'GL_FALSE+    c'glfwWindowHint c'GLFW_VISIBLE c'GLFW_FALSE     p'win <- withCString "bindings-GLFW test" $ \p'title ->       c'glfwCreateWindow 100 100 p'title nullPtr nullPtr     c'glfwMakeContextCurrent p'win +    -- Mostly check for compiling+    cmcb <- mk'GLFWcharmodsfun $ \win x y ->+        putStrLn $ "Got char mods callback! " ++ show (win, x, y)+    _ <- c'glfwSetCharModsCallback p'win cmcb+    jcb <- mk'GLFWjoystickfun $ \x y ->+        putStrLn $ "Got joystick callback! " ++ show (x, y)+    _ <- c'glfwSetJoystickCallback jcb+     defaultMain $ tests p'mon p'win      -- TODO because of how defaultMain works, this code is not reached@@ -54,7 +63,7 @@  versionMajor, versionMinor, versionRevision :: Int versionMajor    = 3-versionMinor    = 1+versionMinor    = 2 versionRevision = 1  giveItTime :: IO ()@@ -114,30 +123,43 @@       -- , testCase "gamma ramp"                 $ test_glfwGamma_ramp p'mon       ]     , testGroup "Window handling"-      [ testCase "glfwDefaultWindowHints"   test_glfwDefaultWindowHints-      , testCase "window close flag"      $ test_window_close_flag p'win-      , testCase "glfwSetWindowTitle"     $ test_glfwSetWindowTitle p'win-      , testCase "window pos"             $ test_window_pos p'win-      , testCase "window size"            $ test_window_size p'win-      , testCase "glfwGetFramebufferSize" $ test_glfwGetFramebufferSize p'win-      , testCase "iconification"          $ test_iconification p'win-      -- , testCase "show/hide"              $ test_show_hide p'win-      , testCase "glfwGetWindowMonitor"   $ test_glfwGetWindowMonitor p'win p'mon-      , testCase "cursor pos"             $ test_cursor_pos p'win-      , testCase "glfwGetWindowAttrib"    $ test_glfwGetWindowAttrib p'win-      , testCase "glfwPollEvents"           test_glfwPollEvents-      , testCase "glfwWaitEvents"           test_glfwWaitEvents+      [ testCase "glfwDefaultWindowHints"       test_glfwDefaultWindowHints+      , testCase "glfwGetWindowAttrib"        $ test_glfwGetWindowAttrib p'win+      , testCase "window close flag"          $ test_window_close_flag p'win+      , testCase "glfwSetWindowTitle"         $ test_glfwSetWindowTitle p'win+      , testCase "window pos"                 $ test_window_pos p'win+      , testCase "window size"                $ test_window_size p'win+      , testCase "glfwGetWindowFrameSize"     $ test_glfwGetWindowFrameSize p'win+      , testCase "glfwGetFramebufferSize"     $ test_glfwGetFramebufferSize p'win+      , testCase "iconification"              $ test_iconification p'win+      -- , testCase "show/hide"                  $ test_show_hide p'win+      , testCase "glfwGetWindowMonitor"       $ test_glfwGetWindowMonitor p'win p'mon+      , testCase "glfwSetWindowMonitor"       $ test_glfwSetWindowMonitor p'win p'mon+      , testCase "glfwSetWindowIcon"          $ test_glfwSetWindowIcon p'win+      , testCase "glfwMaximizeWindow"         $ test_glfwMaximizeWindow p'win+      , testCase "glfwSetWindowSizeLimits"    $ test_glfwSetWindowSizeLimits p'win+      , testCase "glfwSetWindowAspectRatio"   $ test_glfwSetWindowAspectRatio p'win+      , testCase "glfwFocusWindow"            $ test_glfwFocusWindow p'win+      , testCase "cursor pos"                 $ test_cursor_pos p'win+      , testCase "glfwPollEvents"               test_glfwPollEvents+      , testCase "glfwWaitEvents"               test_glfwWaitEvents+      , testCase "glfwWaitEventsTimeout"        test_glfwWaitEventsTimeout       ]     , testGroup "Input handling"       [ testCase "glfwJoystickPresent"    test_glfwJoystickPresent       , testCase "glfwGetJoystickAxes"    test_glfwGetJoystickAxes       , testCase "glfwGetJoystickButtons" test_glfwGetJoystickButtons       , testCase "glfwGetJoystickName"    test_glfwGetJoystickName+      , testCase "glfwGetKeyName"         test_glfwGetKeyName       ]     , testGroup "Time"       [ testCase "glfwGetTime" test_glfwGetTime       , testCase "glfwSetTime" test_glfwSetTime       ]+    , testGroup "Timers"+      [ testCase "glfwGetTimerValue"         test_glfwGetTimerValue+      , testCase "glfwSetTimerFrequency"     test_glfwGetTimerFrequency+      ]     , testGroup "Context"       [ testCase "glfwGetCurrentContext"  $ test_glfwGetCurrentContext p'win       , testCase "glfwSwapBuffers"        $ test_glfwSwapBuffers p'win@@ -147,6 +169,13 @@     , testGroup "Clipboard"       [ testCase "clipboard" $ test_clipboard p'win       ]+    , testGroup "Vulkan"+      [ testCase "glfwVulkanSupported"                          test_glfwVulkanSupported+      , testCase "glfwGetRequiredInstanceExtensions"            test_glfwGetRequiredInstanceExtensions+      , testCase "glfwGetInstanceProcAddress"                   test_glfwGetInstanceProcAddress+      , testCase "glfwGetPhysicalDevicePresentationSupport"     test_glfwGetPhysicalDevicePresentationSupport+      , testCase "glfwCreateWindowSurface"                    $ test_glfwCreateWindowSurface p'win+      ]     ]  --------------------------------------------------------------------------------@@ -275,15 +304,15 @@ test_window_close_flag :: Ptr C'GLFWwindow -> IO () test_window_close_flag p'win = do     r0 <- c'glfwWindowShouldClose p'win-    r0 @?= c'GL_FALSE+    r0 @?= c'GLFW_FALSE -    c'glfwSetWindowShouldClose p'win c'GL_TRUE+    c'glfwSetWindowShouldClose p'win c'GLFW_TRUE     r1 <- c'glfwWindowShouldClose p'win-    r1 @?= c'GL_TRUE+    r1 @?= c'GLFW_TRUE -    c'glfwSetWindowShouldClose p'win c'GL_FALSE+    c'glfwSetWindowShouldClose p'win c'GLFW_FALSE     r2 <- c'glfwWindowShouldClose p'win-    r2 @?= c'GL_FALSE+    r2 @?= c'GLFW_FALSE  test_glfwSetWindowTitle :: Ptr C'GLFWwindow -> IO () test_glfwSetWindowTitle p'win =@@ -309,6 +338,7 @@     setGet :: Int -> Int -> IO (Int, Int, Int, Int)     setGet x0 y0 = do         c'glfwSetWindowPos p'win (fromIntegral x0) (fromIntegral y0)+        c'glfwSwapBuffers p'win         giveItTime         alloca $ \p'x1 ->           alloca $ \p'y1 -> do@@ -320,8 +350,8 @@  test_window_size :: Ptr C'GLFWwindow -> IO () test_window_size p'win = do-    let w = 17-        h = 37+    let w = 177+        h = 372     c'glfwSetWindowSize p'win w h     giveItTime     alloca $ \p'w' ->@@ -332,6 +362,15 @@           w' @?= w           h' @?= h +-- Really all we can say here is that we likely have a title bar, so just check+-- that the 'frame' around the top edge is > 0.+test_glfwGetWindowFrameSize :: Ptr C'GLFWwindow -> IO ()+test_glfwGetWindowFrameSize p'win =+    alloca $ \p'win_frame_top -> do+        c'glfwGetWindowFrameSize p'win nullPtr p'win_frame_top nullPtr nullPtr+        top <- peek p'win_frame_top+        assertBool "Window has no frame width up top!" $ top > 0+ test_glfwGetFramebufferSize :: Ptr C'GLFWwindow -> IO () test_glfwGetFramebufferSize p'win =     alloca $ \p'w  ->@@ -344,88 +383,146 @@         h  <- peek p'h         fw <- peek p'fw         fh <- peek p'fh-        fw @?= w-        fh @?= h+        ((fw `mod` w) == 0) @? "Framebuffer width multiple of window's"+        ((fh `mod` h) == 0) @? "Framebuffer height multiple of window's"  test_iconification :: Ptr C'GLFWwindow -> IO () test_iconification p'win = do+    c'glfwShowWindow p'win     r0 <- c'glfwGetWindowAttrib p'win c'GLFW_ICONIFIED-    r0 @?= c'GL_FALSE+    r0 @?= c'GLFW_FALSE      c'glfwIconifyWindow p'win     giveItTime      r1 <- c'glfwGetWindowAttrib p'win c'GLFW_ICONIFIED-    r1 @?= c'GL_TRUE+    r1 @?= c'GLFW_TRUE      c'glfwRestoreWindow p'win+    c'glfwHideWindow p'win  -- test_show_hide :: Ptr C'GLFWwindow -> IO () -- test_show_hide p'win = do --     v0 <- c'glfwGetWindowAttrib p'win c'GLFW_VISIBLE---     v0 @?= c'GL_FALSE+--     v0 @?= c'GLFW_FALSE  --     c'glfwShowWindow p'win --     giveItTime --     v1 <- c'glfwGetWindowAttrib p'win c'GLFW_VISIBLE---     v1 @?= c'GL_TRUE+--     v1 @?= c'GLFW_TRUE  --     c'glfwHideWindow p'win --     giveItTime --     v2 <- c'glfwGetWindowAttrib p'win c'GLFW_VISIBLE---     v2 @?= c'GL_FALSE+--     v2 @?= c'GLFW_FALSE  test_glfwGetWindowMonitor :: Ptr C'GLFWwindow -> Ptr C'GLFWmonitor -> IO () test_glfwGetWindowMonitor p'win _ = do     p'mon <- c'glfwGetWindowMonitor p'win     p'mon @?= nullPtr +test_glfwSetWindowMonitor :: Ptr C'GLFWwindow -> Ptr C'GLFWmonitor -> IO ()+test_glfwSetWindowMonitor p'win _ = do+    c'glfwSetWindowMonitor p'win nullPtr 0 0 100 100 60++test_glfwSetWindowIcon :: Ptr C'GLFWwindow -> IO ()+test_glfwSetWindowIcon p'win = do+    c'glfwSetWindowIcon p'win 0 nullPtr++test_glfwSetWindowSizeLimits :: Ptr C'GLFWwindow -> IO ()+test_glfwSetWindowSizeLimits p'win = do+    c'glfwSetWindowSizeLimits p'win 640 480 1024 768++test_glfwSetWindowAspectRatio :: Ptr C'GLFWwindow -> IO ()+test_glfwSetWindowAspectRatio p'win = do+    c'glfwSetWindowAspectRatio p'win c'GLFW_DONT_CARE c'GLFW_DONT_CARE++test_glfwFocusWindow :: Ptr C'GLFWwindow -> IO ()+test_glfwFocusWindow = c'glfwFocusWindow++-- NOTE: This test seems to fail in X11. This might be due to the asynchronous+-- nature of focus events in X. We may be able to fix it by waiting for the focus+-- event before setting the cursor position. test_cursor_pos :: Ptr C'GLFWwindow -> IO () test_cursor_pos p'win =     alloca $ \p'w   ->     alloca $ \p'h   ->     alloca $ \p'cx' ->     alloca $ \p'cy' -> do+        c'glfwShowWindow p'win         c'glfwGetWindowSize p'win p'w p'h         w <- peek p'w         h <- peek p'h-        let cx = fromIntegral w / 2-            cy = fromIntegral h / 2++        -- Make sure we use integral coordinates here so that we don't run into+        -- platform-dependent differences.+        let cx :: CDouble+            cy :: CDouble+            (cx, cy) = (fromIntegral $ w `div` 2, fromIntegral $ h `div` 2)++        -- !HACK! Poll events seems to be necessary on OS X,+        -- before /and/ after glfwSetCursorPos, otherwise, the+        -- windowing system likely never receives the cursor update. This is+        -- reflected in the C version of GLFW as well, we just call it here in+        -- order to have a more robust test.++        c'glfwPollEvents+         c'glfwSetCursorPos p'win cx cy-        giveItTime++        c'glfwPollEvents -- !HACK! see comment above+         c'glfwGetCursorPos p'win p'cx' p'cy'         cx' <- peek p'cx'         cy' <- peek p'cy'         cx' @?= cx         cy' @?= cy+        c'glfwHideWindow p'win  test_glfwGetWindowAttrib :: Ptr C'GLFWwindow -> IO () test_glfwGetWindowAttrib p'win = do     let pairs =-          [ ( c'GLFW_FOCUSED,    c'GL_FALSE        )-          , ( c'GLFW_ICONIFIED,  c'GL_FALSE        )-          , ( c'GLFW_RESIZABLE,  c'GL_TRUE         )-          , ( c'GLFW_DECORATED,  c'GL_TRUE         )+          [ ( c'GLFW_FOCUSED,    c'GLFW_FALSE        )+          , ( c'GLFW_ICONIFIED,  c'GLFW_FALSE        )+          , ( c'GLFW_RESIZABLE,  c'GLFW_TRUE         )+          , ( c'GLFW_DECORATED,  c'GLFW_TRUE         )           , ( c'GLFW_CLIENT_API, c'GLFW_OPENGL_API )           ]     rs <- mapM (c'glfwGetWindowAttrib p'win . fst) pairs     rs @?= map snd pairs +test_glfwMaximizeWindow :: Ptr C'GLFWwindow -> IO ()+test_glfwMaximizeWindow p'win = do+    c'glfwShowWindow p'win+    startsMaximized <- c'glfwGetWindowAttrib p'win c'GLFW_MAXIMIZED+    startsMaximized @?= c'GLFW_FALSE++    c'glfwMaximizeWindow p'win+    giveItTime++    isMaximized <- c'glfwGetWindowAttrib p'win c'GLFW_MAXIMIZED+    isMaximized @?= c'GLFW_TRUE+    c'glfwHideWindow p'win+ test_glfwPollEvents :: IO () test_glfwPollEvents =     c'glfwPollEvents  test_glfwWaitEvents :: IO ()-test_glfwWaitEvents =-    c'glfwWaitEvents+test_glfwWaitEvents = c'glfwPostEmptyEvent >> c'glfwWaitEvents +test_glfwWaitEventsTimeout :: IO ()+test_glfwWaitEventsTimeout =+    -- to not slow down the test too much we set the timeout to 0.001 second :+    c'glfwWaitEventsTimeout 0.001+ --------------------------------------------------------------------------------  test_glfwJoystickPresent :: IO () test_glfwJoystickPresent = do     _ <- c'glfwJoystickPresent c'GLFW_JOYSTICK_1     r <- c'glfwJoystickPresent c'GLFW_JOYSTICK_16-    r @?= c'GL_FALSE+    r @?= c'GLFW_FALSE  test_glfwGetJoystickAxes :: IO () test_glfwGetJoystickAxes =@@ -461,6 +558,14 @@             name <- peekCString p'name             assertBool "" $ not $ null name +test_glfwGetKeyName :: IO ()+test_glfwGetKeyName =+    forM_ [c'GLFW_KEY_SLASH, c'GLFW_KEY_PERIOD] $ \k -> do+        p'name <- c'glfwGetKeyName k 0+        when (p'name /= nullPtr) $ do+            name <- peekCString p'name+            assertBool "" $ not $ null name+ --------------------------------------------------------------------------------  test_glfwGetTime :: IO ()@@ -477,6 +582,18 @@  -------------------------------------------------------------------------------- +test_glfwGetTimerValue :: IO ()+test_glfwGetTimerValue = do+    val <- c'glfwGetTimerValue+    assertBool "" $ val > 0++test_glfwGetTimerFrequency :: IO ()+test_glfwGetTimerFrequency = do+    freq <- c'glfwGetTimerFrequency+    assertBool "" $ freq > 0++--------------------------------------------------------------------------------+ test_glfwGetCurrentContext :: Ptr C'GLFWwindow -> IO () test_glfwGetCurrentContext p'win = do     p'win' <- c'glfwGetCurrentContext@@ -493,8 +610,8 @@ test_glfwExtensionSupported :: IO () test_glfwExtensionSupported = do     let pairs =-          [ ( "GL_ARB_multisample", c'GL_TRUE  )-          , ( "bogus",              c'GL_FALSE )+          [ ( "GL_ARB_multisample", c'GLFW_TRUE  )+          , ( "bogus",              c'GLFW_FALSE )           ]     rs <- forM (map fst pairs) $ \ext ->       withCString ext c'glfwExtensionSupported@@ -514,11 +631,67 @@     setGet s = do         withCString s $ \p's ->           c'glfwSetClipboardString p'win p's+        threadDelay 100000  -- Give it a little time         p's' <- c'glfwGetClipboardString p'win         if p's' == nullPtr           then return ""           else peekCString p's'  --------------------------------------------------------------------------------++test_glfwVulkanSupported :: IO ()+test_glfwVulkanSupported =+    -- Just test that it doesn't error. If it does, then we have a problem, but+    -- some platforms (like OS X) don't actually support vulkan.+    c'glfwVulkanSupported >> return ()++test_glfwGetRequiredInstanceExtensions :: IO ()+test_glfwGetRequiredInstanceExtensions = do+    support <- c'glfwVulkanSupported+    if (support == 1)+        then alloca $ \p'count ->+            c'glfwGetRequiredInstanceExtensions p'count >> return ()+        else return ()++test_glfwGetInstanceProcAddress :: IO ()+test_glfwGetInstanceProcAddress = do+    support <- c'glfwVulkanSupported+    if support == 1+    then do+        shouldBeNull <- withCString "notafunction" $+                        \s -> c'glfwGetInstanceProcAddress nullPtr s+        shouldBeNull @?= nullFunPtr+        assertBool "Function pointer is defined!" $+          p'glfwGetInstanceProcAddress /= nullFunPtr+    else return ()++test_glfwGetPhysicalDevicePresentationSupport :: IO ()+test_glfwGetPhysicalDevicePresentationSupport = do+    -- We don't really have the proper types to test this function+    support <- c'glfwVulkanSupported+    if support == 1+    then do+        shouldBeFalse <-+          c'glfwGetPhysicalDevicePresentationSupport nullPtr nullPtr 0+        shouldBeFalse @?= c'GLFW_FALSE+        assertBool "Function pointer is defined!" $+          p'glfwGetPhysicalDevicePresentationSupport /= nullFunPtr+    else return ()++test_glfwCreateWindowSurface :: Ptr C'GLFWwindow -> IO ()+test_glfwCreateWindowSurface p'win = do+    -- We don't really have the proper types to test this function+    support <- c'glfwVulkanSupported+    if support == 1+    then do+        alloca $ \p'surface -> do+          let resPtr = p'surface :: Ptr ()+          shouldNotBeSuccessful <-+            c'glfwCreateWindowSurface nullPtr p'win nullPtr resPtr+          assertBool "c'glfwCreateSurface was successful??" $+            shouldNotBeSuccessful /= 0+        assertBool "Function pointer is defined!" $+          p'glfwCreateWindowSurface /= nullFunPtr+    else return ()  {-# ANN module "HLint: ignore Use camelCase" #-}

@@ -1,5 +1,5 @@ name:         bindings-GLFW-version:      3.1.2.4+version:      3.2.1.0 category:     Graphics  author:       Brian Lewis <brian@lorf.org>@@ -126,6 +126,7 @@       glfw/src/input.c       glfw/src/monitor.c       glfw/src/window.c+      glfw/src/vulkan.c      cc-options: -D_GLFW_USE_CONFIG_H @@ -133,25 +134,27 @@       include-dirs:         glfw/include/os/unix-like       c-sources:+        glfw/src/glx_context.c+        glfw/src/egl_context.c         glfw/src/xkb_unicode.c         glfw/src/linux_joystick.c         glfw/src/posix_time.c         glfw/src/posix_tls.c       if flag(X)+        cc-options: -DBINDINGS_GLFW_USE_X11         c-sources:-          glfw/src/glx_context.c           glfw/src/x11_init.c           glfw/src/x11_monitor.c           glfw/src/x11_window.c       if flag(Wayland)+        cc-options: -DBINDINGS_GLFW_USE_WAYLAND         c-sources:-          glfw/src/egl_context.c           glfw/src/wl_init.c           glfw/src/wl_monitor.c           glfw/src/wl_window.c       if flag(Mir)+        cc-options: -DBINDINGS_GLFW_USE_MIR         c-sources:-          glfw/src/egl_context.c           glfw/src/mir_init.c           glfw/src/mir_monitor.c           glfw/src/mir_window.c@@ -170,10 +173,10 @@       include-dirs:          glfw/include/os/darwin       c-sources:-         glfw/src/mach_time.c+         glfw/src/cocoa_time.c          glfw/src/posix_tls.c          glfw/src/cocoa_init.m-         glfw/src/iokit_joystick.m+         glfw/src/cocoa_joystick.m          glfw/src/cocoa_monitor.m          glfw/src/cocoa_window.m          glfw/src/nsgl_context.m@@ -189,8 +192,9 @@       include-dirs:         glfw/include/os/windows       c-sources:+        glfw/src/egl_context.c         glfw/src/win32_init.c-        glfw/src/winmm_joystick.c+        glfw/src/win32_joystick.c         glfw/src/win32_monitor.c         glfw/src/win32_time.c         glfw/src/win32_window.c@@ -202,7 +206,6 @@    if flag(ExposeNative)     cc-options: -DExposeNative- --------------------------------------------------------------------------------  test-suite main

@@ -1,3335 +1,4224 @@ /*************************************************************************- * 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>- *- * 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_h_-#define _glfw3_h_--#ifdef __cplusplus-extern "C" {-#endif---/*************************************************************************- * Doxygen documentation- *************************************************************************/--/*! @defgroup context Context handling- *- *  This is the reference documentation for context related functions.  For more- *  information, see the @ref context.- */-/*! @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 window Window handling- *- *  This is the reference documentation for window related functions and types,- *  including creation, deletion and event polling.  For more information, see- *  the @ref window.- */---/*************************************************************************- * Global definitions- *************************************************************************/--/* ------------------- BEGIN SYSTEM/COMPILER SPECIFIC -------------------- */--/* Please report any problems that you find with your compiler, which may- * be solved in this section! There are several compilers that I have not- * been able to test this file with yet.- *- * First: If we are we on Windows, we want a single define for it (_WIN32)- * (Note: For Cygwin the compiler flag -mwin32 should be used, but to- * make sure that things run smoothly for Cygwin users, we add __CYGWIN__- * to the list of "valid Win32 identifiers", which removes the need for- * -mwin32)- */-#if !defined(_WIN32) && (defined(__WIN32__) || defined(WIN32) || defined(__CYGWIN__))- #define _WIN32-#endif /* _WIN32 */--/* In order for extension support to be portable, we need to define an- * OpenGL function call method. We use the keyword APIENTRY, which is- * defined for Win32. (Note: Windows also needs this for <GL/gl.h>)- */-#ifndef APIENTRY- #ifdef _WIN32-  #define APIENTRY __stdcall- #else-  #define APIENTRY- #endif-#endif /* APIENTRY */--/* The following three defines are here solely to make some Windows-based- * <GL/gl.h> files happy. Theoretically we could include <windows.h>, but- * it has the major drawback of severely polluting our namespace.- */--/* Under Windows, we need WINGDIAPI defined */-#if !defined(WINGDIAPI) && defined(_WIN32)- #if defined(_MSC_VER) || defined(__BORLANDC__) || defined(__POCC__)-  /* Microsoft Visual C++, Borland C++ Builder and Pelles C */-  #define WINGDIAPI __declspec(dllimport)- #elif defined(__LCC__)-  /* LCC-Win32 */-  #define WINGDIAPI __stdcall- #else-  /* Others (e.g. MinGW, Cygwin) */-  #define WINGDIAPI extern- #endif- #define GLFW_WINGDIAPI_DEFINED-#endif /* WINGDIAPI */--/* Some <GL/glu.h> files also need CALLBACK defined */-#if !defined(CALLBACK) && defined(_WIN32)- #if defined(_MSC_VER)-  /* Microsoft Visual C++ */-  #if (defined(_M_MRX000) || defined(_M_IX86) || defined(_M_ALPHA) || defined(_M_PPC)) && !defined(MIDL_PASS)-   #define CALLBACK __stdcall-  #else-   #define CALLBACK-  #endif- #else-  /* Other Windows compilers */-  #define CALLBACK __stdcall- #endif- #define GLFW_CALLBACK_DEFINED-#endif /* CALLBACK */--/* Most GL/glu.h variants on Windows need wchar_t- * OpenGL/gl.h blocks the definition of ptrdiff_t by glext.h on OS X */-#if !defined(GLFW_INCLUDE_NONE)- #include <stddef.h>-#endif--/* Include the chosen client API headers.- */-#if defined(__APPLE_CC__)- #if defined(GLFW_INCLUDE_GLCOREARB)-  #include <OpenGL/gl3.h>-  #if defined(GLFW_INCLUDE_GLEXT)-   #include <OpenGL/gl3ext.h>-  #endif- #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>-  #if defined(GLFW_INCLUDE_GLEXT)-   #include <GLES/glext.h>-  #endif- #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 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 GLFW as a Win32 DLL */- #define GLFWAPI __declspec(dllexport)-#elif defined(_WIN32) && defined(GLFW_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 building or calling GLFW as a static library */- #define GLFWAPI-#endif--/* -------------------- END SYSTEM/COMPILER SPECIFIC --------------------- */---/*************************************************************************- * GLFW API tokens- *************************************************************************/--/*! @name GLFW version macros- *  @{ */-/*! @brief The major version number of the GLFW library.- *- *  This is incremented when the API is changed in non-compatible ways.- *  @ingroup init- */-#define GLFW_VERSION_MAJOR          3-/*! @brief The minor version number of the GLFW library.- *- *  This is incremented when features are added to the API but it remains- *  backward-compatible.- *  @ingroup init- */-#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       1-/*! @} */--/*! @name Key and button actions- *  @{ */-/*! @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 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-/*! @} */--/*! @defgroup keys Keyboard keys- *- *  See [key input](@ref input_key) for how these are used.- *- *  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- *  @{- */--/* The unknown key */-#define GLFW_KEY_UNKNOWN            -1--/* Printable keys */-#define GLFW_KEY_SPACE              32-#define GLFW_KEY_APOSTROPHE         39  /* ' */-#define GLFW_KEY_COMMA              44  /* , */-#define GLFW_KEY_MINUS              45  /* - */-#define GLFW_KEY_PERIOD             46  /* . */-#define GLFW_KEY_SLASH              47  /* / */-#define GLFW_KEY_0                  48-#define GLFW_KEY_1                  49-#define GLFW_KEY_2                  50-#define GLFW_KEY_3                  51-#define GLFW_KEY_4                  52-#define GLFW_KEY_5                  53-#define GLFW_KEY_6                  54-#define GLFW_KEY_7                  55-#define GLFW_KEY_8                  56-#define GLFW_KEY_9                  57-#define GLFW_KEY_SEMICOLON          59  /* ; */-#define GLFW_KEY_EQUAL              61  /* = */-#define GLFW_KEY_A                  65-#define GLFW_KEY_B                  66-#define GLFW_KEY_C                  67-#define GLFW_KEY_D                  68-#define GLFW_KEY_E                  69-#define GLFW_KEY_F                  70-#define GLFW_KEY_G                  71-#define GLFW_KEY_H                  72-#define GLFW_KEY_I                  73-#define GLFW_KEY_J                  74-#define GLFW_KEY_K                  75-#define GLFW_KEY_L                  76-#define GLFW_KEY_M                  77-#define GLFW_KEY_N                  78-#define GLFW_KEY_O                  79-#define GLFW_KEY_P                  80-#define GLFW_KEY_Q                  81-#define GLFW_KEY_R                  82-#define GLFW_KEY_S                  83-#define GLFW_KEY_T                  84-#define GLFW_KEY_U                  85-#define GLFW_KEY_V                  86-#define GLFW_KEY_W                  87-#define GLFW_KEY_X                  88-#define GLFW_KEY_Y                  89-#define GLFW_KEY_Z                  90-#define GLFW_KEY_LEFT_BRACKET       91  /* [ */-#define GLFW_KEY_BACKSLASH          92  /* \ */-#define GLFW_KEY_RIGHT_BRACKET      93  /* ] */-#define GLFW_KEY_GRAVE_ACCENT       96  /* ` */-#define GLFW_KEY_WORLD_1            161 /* non-US #1 */-#define GLFW_KEY_WORLD_2            162 /* non-US #2 */--/* Function keys */-#define GLFW_KEY_ESCAPE             256-#define GLFW_KEY_ENTER              257-#define GLFW_KEY_TAB                258-#define GLFW_KEY_BACKSPACE          259-#define GLFW_KEY_INSERT             260-#define GLFW_KEY_DELETE             261-#define GLFW_KEY_RIGHT              262-#define GLFW_KEY_LEFT               263-#define GLFW_KEY_DOWN               264-#define GLFW_KEY_UP                 265-#define GLFW_KEY_PAGE_UP            266-#define GLFW_KEY_PAGE_DOWN          267-#define GLFW_KEY_HOME               268-#define GLFW_KEY_END                269-#define GLFW_KEY_CAPS_LOCK          280-#define GLFW_KEY_SCROLL_LOCK        281-#define GLFW_KEY_NUM_LOCK           282-#define GLFW_KEY_PRINT_SCREEN       283-#define GLFW_KEY_PAUSE              284-#define GLFW_KEY_F1                 290-#define GLFW_KEY_F2                 291-#define GLFW_KEY_F3                 292-#define GLFW_KEY_F4                 293-#define GLFW_KEY_F5                 294-#define GLFW_KEY_F6                 295-#define GLFW_KEY_F7                 296-#define GLFW_KEY_F8                 297-#define GLFW_KEY_F9                 298-#define GLFW_KEY_F10                299-#define GLFW_KEY_F11                300-#define GLFW_KEY_F12                301-#define GLFW_KEY_F13                302-#define GLFW_KEY_F14                303-#define GLFW_KEY_F15                304-#define GLFW_KEY_F16                305-#define GLFW_KEY_F17                306-#define GLFW_KEY_F18                307-#define GLFW_KEY_F19                308-#define GLFW_KEY_F20                309-#define GLFW_KEY_F21                310-#define GLFW_KEY_F22                311-#define GLFW_KEY_F23                312-#define GLFW_KEY_F24                313-#define GLFW_KEY_F25                314-#define GLFW_KEY_KP_0               320-#define GLFW_KEY_KP_1               321-#define GLFW_KEY_KP_2               322-#define GLFW_KEY_KP_3               323-#define GLFW_KEY_KP_4               324-#define GLFW_KEY_KP_5               325-#define GLFW_KEY_KP_6               326-#define GLFW_KEY_KP_7               327-#define GLFW_KEY_KP_8               328-#define GLFW_KEY_KP_9               329-#define GLFW_KEY_KP_DECIMAL         330-#define GLFW_KEY_KP_DIVIDE          331-#define GLFW_KEY_KP_MULTIPLY        332-#define GLFW_KEY_KP_SUBTRACT        333-#define GLFW_KEY_KP_ADD             334-#define GLFW_KEY_KP_ENTER           335-#define GLFW_KEY_KP_EQUAL           336-#define GLFW_KEY_LEFT_SHIFT         340-#define GLFW_KEY_LEFT_CONTROL       341-#define GLFW_KEY_LEFT_ALT           342-#define GLFW_KEY_LEFT_SUPER         343-#define GLFW_KEY_RIGHT_SHIFT        344-#define GLFW_KEY_RIGHT_CONTROL      345-#define GLFW_KEY_RIGHT_ALT          346-#define GLFW_KEY_RIGHT_SUPER        347-#define GLFW_KEY_MENU               348-#define GLFW_KEY_LAST               GLFW_KEY_MENU--/*! @} */--/*! @defgroup mods Modifier key flags- *- *  See [key input](@ref input_key) for how these are used.- *- *  @ingroup input- *  @{ */--/*! @brief If this bit is set one or more Shift keys were held down.- */-#define GLFW_MOD_SHIFT           0x0001-/*! @brief If this bit is set one or more Control keys were held down.- */-#define GLFW_MOD_CONTROL         0x0002-/*! @brief If this bit is set one or more Alt keys were held down.- */-#define GLFW_MOD_ALT             0x0004-/*! @brief If this bit is set one or more Super keys were held down.- */-#define GLFW_MOD_SUPER           0x0008--/*! @} */--/*! @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-#define GLFW_MOUSE_BUTTON_2         1-#define GLFW_MOUSE_BUTTON_3         2-#define GLFW_MOUSE_BUTTON_4         3-#define GLFW_MOUSE_BUTTON_5         4-#define GLFW_MOUSE_BUTTON_6         5-#define GLFW_MOUSE_BUTTON_7         6-#define GLFW_MOUSE_BUTTON_8         7-#define GLFW_MOUSE_BUTTON_LAST      GLFW_MOUSE_BUTTON_8-#define GLFW_MOUSE_BUTTON_LEFT      GLFW_MOUSE_BUTTON_1-#define GLFW_MOUSE_BUTTON_RIGHT     GLFW_MOUSE_BUTTON_2-#define GLFW_MOUSE_BUTTON_MIDDLE    GLFW_MOUSE_BUTTON_3-/*! @} */--/*! @defgroup joysticks Joysticks- *- *  See [joystick input](@ref joystick) for how these are used.- *- *  @ingroup input- *  @{ */-#define GLFW_JOYSTICK_1             0-#define GLFW_JOYSTICK_2             1-#define GLFW_JOYSTICK_3             2-#define GLFW_JOYSTICK_4             3-#define GLFW_JOYSTICK_5             4-#define GLFW_JOYSTICK_6             5-#define GLFW_JOYSTICK_7             6-#define GLFW_JOYSTICK_8             7-#define GLFW_JOYSTICK_9             8-#define GLFW_JOYSTICK_10            9-#define GLFW_JOYSTICK_11            10-#define GLFW_JOYSTICK_12            11-#define GLFW_JOYSTICK_13            12-#define GLFW_JOYSTICK_14            13-#define GLFW_JOYSTICK_15            14-#define GLFW_JOYSTICK_16            15-#define GLFW_JOYSTICK_LAST          GLFW_JOYSTICK_16-/*! @} */--/*! @defgroup errors Error codes- *- *  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 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 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 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 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-/*! @} */--#define GLFW_FOCUSED                0x00020001-#define GLFW_ICONIFIED              0x00020002-#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-#define GLFW_BLUE_BITS              0x00021003-#define GLFW_ALPHA_BITS             0x00021004-#define GLFW_DEPTH_BITS             0x00021005-#define GLFW_STENCIL_BITS           0x00021006-#define GLFW_ACCUM_RED_BITS         0x00021007-#define GLFW_ACCUM_GREEN_BITS       0x00021008-#define GLFW_ACCUM_BLUE_BITS        0x00021009-#define GLFW_ACCUM_ALPHA_BITS       0x0002100A-#define GLFW_AUX_BUFFERS            0x0002100B-#define GLFW_STEREO                 0x0002100C-#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-#define GLFW_CONTEXT_VERSION_MINOR  0x00022003-#define GLFW_CONTEXT_REVISION       0x00022004-#define GLFW_CONTEXT_ROBUSTNESS     0x00022005-#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--#define GLFW_NO_ROBUSTNESS                   0-#define GLFW_NO_RESET_NOTIFICATION  0x00031001-#define GLFW_LOSE_CONTEXT_ON_RESET  0x00031002--#define GLFW_OPENGL_ANY_PROFILE              0-#define GLFW_OPENGL_CORE_PROFILE    0x00032001-#define GLFW_OPENGL_COMPAT_PROFILE  0x00032002--#define GLFW_CURSOR                 0x00033001-#define GLFW_STICKY_KEYS            0x00033002-#define GLFW_STICKY_MOUSE_BUTTONS   0x00033003--#define GLFW_CURSOR_NORMAL          0x00034001-#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- *************************************************************************/--/*! @brief Client API function pointer type.- *- *  Generic function pointer used for returning client API function pointers- *  without forcing a cast from a regular pointer.- *- *  @ingroup context- */-typedef void (*GLFWglproc)(void);--/*! @brief Opaque monitor object.- *- *  Opaque monitor object.- *- *  @ingroup monitor- */-typedef struct GLFWmonitor GLFWmonitor;--/*! @brief Opaque window object.- *- *  Opaque window object.- *- *  @ingroup window- */-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.- *- *  @param[in] error An [error code](@ref errors).- *  @param[in] description A UTF-8 encoded string describing the error.- *- *  @sa glfwSetErrorCallback- *- *  @ingroup init- */-typedef void (* GLFWerrorfun)(int,const char*);--/*! @brief The function signature for window position callbacks.- *- *  This is the function signature for window position callback functions.- *- *  @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- *  upper-left corner of the client area of the window.- *- *  @sa glfwSetWindowPosCallback- *- *  @ingroup window- */-typedef void (* GLFWwindowposfun)(GLFWwindow*,int,int);--/*! @brief The function signature for window resize callbacks.- *- *  This is the function signature for window size callback functions.- *- *  @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.- *- *  @sa glfwSetWindowSizeCallback- *- *  @ingroup window- */-typedef void (* GLFWwindowsizefun)(GLFWwindow*,int,int);--/*! @brief The function signature for window close callbacks.- *- *  This is the function signature for window close callback functions.- *- *  @param[in] window The window that the user attempted to close.- *- *  @sa glfwSetWindowCloseCallback- *- *  @ingroup window- */-typedef void (* GLFWwindowclosefun)(GLFWwindow*);--/*! @brief The function signature for window content refresh callbacks.- *- *  This is the function signature for window refresh callback functions.- *- *  @param[in] window The window whose content needs to be refreshed.- *- *  @sa glfwSetWindowRefreshCallback- *- *  @ingroup window- */-typedef void (* GLFWwindowrefreshfun)(GLFWwindow*);--/*! @brief The function signature for window focus/defocus callbacks.- *- *  This is the function signature for window focus callback functions.- *- *  @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- *- *  @ingroup window- */-typedef void (* GLFWwindowfocusfun)(GLFWwindow*,int);--/*! @brief The function signature for window iconify/restore callbacks.- *- *  This is the function signature for window iconify/restore callback- *  functions.- *- *  @param[in] window The window that was iconified or restored.- *  @param[in] iconified `GL_TRUE` if the window was iconified, or `GL_FALSE`- *  if it was restored.- *- *  @sa glfwSetWindowIconifyCallback- *- *  @ingroup window- */-typedef void (* GLFWwindowiconifyfun)(GLFWwindow*,int);--/*! @brief The function signature for framebuffer resize callbacks.- *- *  This is the function signature for framebuffer resize callback- *  functions.- *- *  @param[in] window The window whose framebuffer was resized.- *  @param[in] width The new width, in pixels, of the framebuffer.- *  @param[in] height The new height, in pixels, of the framebuffer.- *- *  @sa glfwSetFramebufferSizeCallback- *- *  @ingroup window- */-typedef void (* GLFWframebuffersizefun)(GLFWwindow*,int,int);--/*! @brief The function signature for mouse button callbacks.- *- *  This is the function signature for mouse button callback functions.- *- *  @param[in] window The window that received the event.- *  @param[in] button The [mouse button](@ref buttons) that was pressed or- *  released.- *  @param[in] action One of `GLFW_PRESS` or `GLFW_RELEASE`.- *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were- *  held down.- *- *  @sa glfwSetMouseButtonCallback- *- *  @ingroup input- */-typedef void (* GLFWmousebuttonfun)(GLFWwindow*,int,int,int);--/*! @brief The function signature for cursor position callbacks.- *- *  This is the function signature for cursor position callback functions.- *- *  @param[in] window The window that received the event.- *  @param[in] xpos The new x-coordinate, in screen coordinates, of the cursor.- *  @param[in] ypos The new y-coordinate, in screen coordinates, of the cursor.- *- *  @sa glfwSetCursorPosCallback- *- *  @ingroup input- */-typedef void (* GLFWcursorposfun)(GLFWwindow*,double,double);--/*! @brief The function signature for cursor enter/leave callbacks.- *- *  This is the function signature for cursor enter/leave callback functions.- *- *  @param[in] window The window that received the event.- *  @param[in] entered `GL_TRUE` if the cursor entered the window's client- *  area, or `GL_FALSE` if it left it.- *- *  @sa glfwSetCursorEnterCallback- *- *  @ingroup input- */-typedef void (* GLFWcursorenterfun)(GLFWwindow*,int);--/*! @brief The function signature for scroll callbacks.- *- *  This is the function signature for scroll callback functions.- *- *  @param[in] window The window that received the event.- *  @param[in] xoffset The scroll offset along the x-axis.- *  @param[in] yoffset The scroll offset along the y-axis.- *- *  @sa glfwSetScrollCallback- *- *  @ingroup input- */-typedef void (* GLFWscrollfun)(GLFWwindow*,double,double);--/*! @brief The function signature for keyboard key callbacks.- *- *  This is the function signature for keyboard key callback functions.- *- *  @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 `GLFW_PRESS`, `GLFW_RELEASE` or `GLFW_REPEAT`.- *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were- *  held down.- *- *  @sa glfwSetKeyCallback- *- *  @ingroup input- */-typedef void (* GLFWkeyfun)(GLFWwindow*,int,int,int,int);--/*! @brief The function signature for Unicode character callbacks.- *- *  This is the function signature for Unicode character callback functions.- *- *  @param[in] window The window that received the event.- *  @param[in] codepoint The Unicode code point of the character.- *- *  @sa glfwSetCharCallback- *- *  @ingroup input- */-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] paths The UTF-8 encoded file and/or directory path names.- *- *  @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.- *- *  @param[in] monitor The monitor that was connected or disconnected.- *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.- *- *  @sa glfwSetMonitorCallback- *- *  @ingroup monitor- */-typedef void (* GLFWmonitorfun)(GLFWmonitor*,int);--/*! @brief Video mode type.- *- *  This describes a single video mode.- *- *  @ingroup monitor- */-typedef struct GLFWvidmode-{-    /*! The width, in screen coordinates, of the video mode.-     */-    int width;-    /*! The height, in screen coordinates, of the video mode.-     */-    int height;-    /*! The bit depth of the red channel of the video mode.-     */-    int redBits;-    /*! The bit depth of the green channel of the video mode.-     */-    int greenBits;-    /*! The bit depth of the blue channel of the video mode.-     */-    int blueBits;-    /*! The refresh rate, in Hz, of the video mode.-     */-    int refreshRate;-} GLFWvidmode;--/*! @brief Gamma ramp.- *- *  This describes the gamma ramp for a monitor.- *- *  @sa glfwGetGammaRamp glfwSetGammaRamp- *- *  @ingroup monitor- */-typedef struct GLFWgammaramp-{-    /*! An array of value describing the response of the red channel.-     */-    unsigned short* red;-    /*! An array of value describing the response of the green channel.-     */-    unsigned short* green;-    /*! An array of value describing the response of the blue channel.-     */-    unsigned short* blue;-    /*! The number of elements in each array.-     */-    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- *************************************************************************/--/*! @brief Initializes the GLFW library.- *- *  This function initializes the GLFW library.  Before most GLFW functions can- *  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 application exits.- *- *  Additional calls to this function after successful initialization but before- *  termination will return `GL_TRUE` immediately.- *- *  @return `GL_TRUE` if successful, or `GL_FALSE` if an- *  [error](@ref error_handling) occurred.- *- *  @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.  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 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 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.- *- *  @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);--/*! @brief Retrieves the version of the GLFW library.- *- *  This function retrieves the major, minor and revision numbers of the GLFW- *  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.- *- *  @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 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.- *- *  __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.- *- *  This function always succeeds.- *- *  @return The GLFW version string.- *- *  @remarks This function may be called before @ref glfwInit.- *- *  @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);--/*! @brief Sets the error callback.- *- *  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.- *- *  @remarks This function may be called before @ref glfwInit.- *- *  @par Thread Safety- *  This function may only be called from the main thread.- *- *  @sa @ref error_handling- *- *  @since Added in GLFW 3.0.- *- *  @ingroup init- */-GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);--/*! @brief Returns the currently connected monitors.- *- *  This function returns an array of handles for all currently connected- *  monitors.- *- *  @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.- *- *  @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.- *- *  @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);--/*! @brief Returns the primary monitor.- *- *  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](@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);--/*! @brief Returns the position of the monitor's viewport on the virtual screen.- *- *  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);--/*! @brief Returns the physical size of the monitor.- *- *  This function returns the size, in millimetres, of the display area of the- *  specified monitor.- *- *  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.- *- *  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* 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.  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](@ref error_handling) occurred.- *- *  @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- */-GLFWAPI const char* glfwGetMonitorName(GLFWmonitor* monitor);--/*! @brief Sets the monitor configuration callback.- *- *  This function sets the monitor configuration callback, or removes the- *  currently set callback.  This is called when a monitor is connected to or- *  disconnected from the system.- *- *  @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).- *- *  @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);--/*! @brief Returns the available video modes for the specified monitor.- *- *  This function returns an array of all video modes supported by the specified- *  monitor.  The returned array is sorted in ascending order, first by color- *  bit depth (the sum of all channel depths) and then by resolution area (the- *  product of width and height).- *- *  @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](@ref error_handling) occurred.- *- *  @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.- *- *  @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);--/*! @brief Returns the current mode of the specified monitor.- *- *  This function returns the current video mode of the specified monitor.  If- *  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](@ref error_handling) occurred.- *- *  @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);--/*! @brief Generates a gamma ramp and sets it for the specified monitor.- *- *  This function generates a 256-element gamma ramp from the specified exponent- *  and then calls @ref glfwSetGammaRamp with it.- *- *  @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 Returns the current gamma ramp for 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](@ref error_handling) occurred.- *- *  @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- */-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.  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);--/*! @brief Resets all window hints to their default values.- *- *  This function resets all window hints to their- *  [default values](@ref window_hints_values).- *- *  @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);--/*! @brief Sets the specified window hint to the desired value.- *- *  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.- *- *  @param[in] target The [window hint](@ref window_hints) to set.- *  @param[in] hint The new value of the window hint.- *- *  @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 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](@ref context_current).  For information about the `share`- *  parameter, see @ref context_sharing.- *- *  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 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 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.- *- *  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.- *- *  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.- *  This must be greater than zero.- *  @param[in] title The initial, UTF-8 encoded window title.- *  @param[in] monitor The monitor to use for full screen mode, or `NULL` to use- *  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](@ref error_handling) occurred.- *- *  @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- *  `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 __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.- *  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 __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 __X11:__ There is no mechanism for setting the window icon yet.- *- *  @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);--/*! @brief Destroys the specified window and its context.- *- *  This function destroys the specified window and its context.  On calling- *  this function, no further callbacks will be called for that window.- *- *  If the context of the specified window is current on the main thread, it is- *  detached before being destroyed.- *- *  @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);--/*! @brief Checks the close flag of the specified window.- *- *  This function returns the value of the close flag of the specified window.- *- *  @param[in] window The window to query.- *  @return The value of the close flag.- *- *  @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- */-GLFWAPI int glfwWindowShouldClose(GLFWwindow* window);--/*! @brief Sets the close flag of the specified window.- *- *  This function sets the value of the close flag of the specified window.- *  This can be used to override the user's attempt to close the window, or- *  to signal that it should be closed.- *- *  @param[in] window The window whose flag to change.- *  @param[in] value The new value.- *- *  @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- */-GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* window, int value);--/*! @brief Sets the title of the specified window.- *- *  This function sets the window title, encoded as UTF-8, of the specified- *  window.- *- *  @param[in] window The window whose title to change.- *  @param[in] title The UTF-8 encoded window title.- *- *  @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- */-GLFWAPI void glfwSetWindowTitle(GLFWwindow* window, const char* title);--/*! @brief Retrieves the position of the client area of the specified window.- *- *  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);--/*! @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 specified windowed mode window.  If the- *  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.- *- *  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.- *- *  @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);--/*! @brief Retrieves the size of the client area of the specified window.- *- *  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 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- *  client area, or `NULL`.- *  @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);--/*! @brief Sets the size of the client area of the specified window.- *- *  This function sets the size, in screen coordinates, of the client area of- *  the specified window.- *- *  For full screen windows, this function selects and switches to the resolution- *  closest to the specified size, without affecting the window's context.  As- *  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.- *- *  @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);--/*! @brief Retrieves the size of the framebuffer of the specified window.- *- *  This function retrieves the size, in pixels, of the framebuffer of the- *  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 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.- *- *  @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 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.- *- *  @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- *  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.- *- *  @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- *  the window is already hidden or is in full screen mode, this function does- *  nothing.- *- *  @param[in] window The window to hide.- *- *  @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);--/*! @brief Returns the monitor that the window uses for full screen mode.- *- *  This function returns the handle of the monitor that the specified window is- *  in full screen on.- *- *  @param[in] window The window to query.- *  @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- */-GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window);--/*! @brief Returns an attribute of the specified window.- *- *  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](@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- */-GLFWAPI int glfwGetWindowAttrib(GLFWwindow* window, int attrib);--/*! @brief Sets the user pointer of the specified window.- *- *  This function sets the user-defined pointer of the specified window.  The- *  current value is retained until the window is destroyed.  The initial value- *  is `NULL`.- *- *  @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);--/*! @brief Returns the user pointer of the specified window.- *- *  This function returns the current value of the user-defined pointer of the- *  specified window.  The initial value is `NULL`.- *- *  @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);--/*! @brief Sets the position callback for the specified window.- *- *  This function sets the position callback of the specified window, which is- *  called when the window is moved.  The callback is provided with the screen- *  position of the upper-left corner of the client area of the 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 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- */-GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* window, GLFWwindowposfun cbfun);--/*! @brief Sets the size callback for the specified window.- *- *  This function sets the size callback of the specified window, which is- *  called when the window is resized.  The callback is provided with the size,- *  in screen coordinates, of the client area of the 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 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- */-GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwindowsizefun cbfun);--/*! @brief Sets the close callback for the specified window.- *- *  This function sets the close callback of the specified window, which is- *  called when the user attempts to close the window, for example by clicking- *  the close widget in the title bar.- *- *  The close flag is set before this callback is called, but you can modify it- *  at any time with @ref glfwSetWindowShouldClose.- *- *  The close callback is not triggered by @ref glfwDestroyWindow.- *- *  @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).- *- *  @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);--/*! @brief Sets the refresh callback for the specified window.- *- *  This function sets the refresh callback of the specified window, which is- *  called when the client area of the window needs to be redrawn, for example- *  if the window has been exposed after having been covered by another window.- *- *  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.- *- *  @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 window_refresh- *- *  @since Added in GLFW 2.5.- *- *  @par- *  __GLFW 3:__ Added window handle parameter.  Updated callback signature.- *- *  @ingroup window- */-GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* window, GLFWwindowrefreshfun cbfun);--/*! @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 input focus.- *- *  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 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- */-GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* window, GLFWwindowfocusfun cbfun);--/*! @brief Sets the iconify callback for the specified window.- *- *  This function sets the iconification callback of the specified window, which- *  is called when the window is iconified or restored.- *- *  @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 window_iconify- *- *  @since Added in GLFW 3.0.- *- *  @ingroup window- */-GLFWAPI GLFWwindowiconifyfun glfwSetWindowIconifyCallback(GLFWwindow* window, GLFWwindowiconifyfun cbfun);--/*! @brief Sets the framebuffer resize callback for the specified window.- *- *  This function sets the framebuffer resize callback of the specified window,- *  which is called when the framebuffer of the specified window is resized.- *- *  @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 window_fbsize- *- *  @since Added in GLFW 3.0.- *- *  @ingroup window- */-GLFWAPI GLFWframebuffersizefun glfwSetFramebufferSizeCallback(GLFWwindow* window, GLFWframebuffersizefun cbfun);--/*! @brief Processes all pending events.- *- *  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.- *- *  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.- *- *  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.- *- *  Event processing is not required for joystick input to work.- *- *  @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 glfwWaitEvents- *- *  @since Added in GLFW 1.0.- *- *  @ingroup window- */-GLFWAPI void glfwPollEvents(void);--/*! @brief Waits until events are queued and processes them.- *- *  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.- *- *  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.- *- *  On some platforms, certain callbacks may be called outside of a call to one- *  of the event processing functions.- *- *  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.- *- *  Event processing is not required for joystick input to work.- *- *  @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.- *- *  @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);--/*! @brief Returns the last reported state of a keyboard key for the specified- *  window.- *- *  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 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 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).  `GLFW_KEY_UNKNOWN` is- *  not a valid key for this function.- *  @return One of `GLFW_PRESS` or `GLFW_RELEASE`.- *- *  @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- */-GLFWAPI int glfwGetKey(GLFWwindow* window, int key);--/*! @brief Returns the last reported state of a mouse button for the specified- *  window.- *- *  This function returns the last state reported for the specified mouse button- *  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- *  `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 position of the cursor relative to the client area of- *  the 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- *  a `double`.- *- *  The coordinate can be converted to their integer equivalents with the- *  `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);--/*! @brief Sets the position of the cursor, relative to the client area of the- *  window.- *- *  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 have input focus.  If the window does not have- *  input focus when this function is called, it fails silently.- *- *  __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.- *  @param[in] xpos The desired x-coordinate, relative to the left edge of the- *  client area.- *  @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 specified window, which is called- *  when a key is pressed, repeated or released.- *- *  The key functions deal with physical keys, with layout independent- *  [key tokens](@ref keys) named after their values in the standard US keyboard- *  layout.  If you want to input text, use the- *  [character callback](@ref glfwSetCharCallback) instead.- *- *  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 queried with @ref glfwGetKey.- *- *  Sometimes GLFW needs to generate synthetic key events, in which case the- *  scancode may be zero.- *- *  @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 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- */-GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun cbfun);--/*! @brief Sets the Unicode character callback.- *- *  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 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.- *  @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.- *- *  @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 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 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 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- */-GLFWAPI GLFWmousebuttonfun glfwSetMouseButtonCallback(GLFWwindow* window, GLFWmousebuttonfun cbfun);--/*! @brief Sets the cursor position callback.- *- *  This function sets the cursor position callback of the specified window,- *  which is called when the cursor is moved.  The callback is provided with the- *  position, in screen coordinates, relative to the upper-left corner of the- *  client area of the 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 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- */-GLFWAPI GLFWcursorposfun glfwSetCursorPosCallback(GLFWwindow* window, GLFWcursorposfun cbfun);--/*! @brief Sets the cursor enter/exit callback.- *- *  This function sets the cursor boundary crossing callback of the specified- *  window, which is called when the cursor enters or leaves the client area of- *  the 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 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- */-GLFWAPI GLFWcursorenterfun glfwSetCursorEnterCallback(GLFWwindow* window, GLFWcursorenterfun cbfun);--/*! @brief Sets the scroll callback.- *- *  This function sets the scroll callback of the specified window, which is- *  called when a scrolling device is used, such as a mouse wheel or scrolling- *  area of a touchpad.- *- *  The scroll callback receives all scrolling input, like that from a mouse- *  wheel or a touchpad scrolling area.- *- *  @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 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](@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);--/*! @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](@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.- *- *  @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.- *- *  @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- */-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](@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.- *- *  @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.- *- *  @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- */-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](@ref joysticks) to query.- *  @return The UTF-8 encoded name of the joystick, or `NULL` if the joystick- *  is not present.- *- *  @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.- *- *  @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- */-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.- *- *  @param[in] window The window that will own the clipboard contents.- *  @param[in] string A UTF-8 encoded string.- *- *  @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- *- *  @since Added in GLFW 3.0.- *- *  @ingroup input- */-GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* 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](@ref error_handling) occurred.- *- *  @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.- *- *  @par Thread Safety- *  This function may only be called from the main thread.- *- *  @sa @ref clipboard- *  @sa glfwSetClipboardString- *- *  @since Added in GLFW 3.0.- *- *  @ingroup input- */-GLFWAPI const char* glfwGetClipboardString(GLFWwindow* window);--/*! @brief Returns the value of the GLFW timer.- *- *  This function returns the value of the GLFW timer.  Unless the timer has- *  been set using @ref glfwSetTime, the timer measures time elapsed since GLFW- *  was initialized.- *- *  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.- *- *  @return The current value, in seconds, or zero if an- *  [error](@ref error_handling) occurred.- *- *  @par Thread Safety- *  This function may be called from any thread.  Access is not synchronized.- *- *  @sa @ref time- *- *  @since Added in GLFW 1.0.- *- *  @ingroup input- */-GLFWAPI double glfwGetTime(void);--/*! @brief Sets the GLFW timer.- *- *  This function sets the value of the GLFW timer.  It then continues to count- *  up from that value.  The value must be a positive finite number.- *- *  @param[in] time The new value, in seconds.- *- *  @par Thread Safety- *  This function may only be called from the main thread.- *- *  @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 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.- *- *  @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 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.- *- *  @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);--/*! @brief Swaps the front and back buffers of the specified window.- *- *  This function swaps the front and back buffers of the specified window.  If- *  the swap interval is greater than zero, the GPU driver waits the specified- *  number of screen updates before swapping the buffers.- *- *  @param[in] window The window whose buffers to swap.- *- *  @par Thread Safety- *  This function may be called from any thread.- *- *  @sa @ref buffer_swap- *  @sa glfwSwapInterval- *- *  @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 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,- *  which allow the driver to swap even if a frame arrives a little bit late.- *  You can check for the presence of these extensions using @ref- *  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 is not called during context 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- *  interval to be reset to zero once it has been set to a non-zero value.- *- *  @remarks Some GPU drivers do not honor the requested swap interval, either- *  because of a user setting that overrides the application's 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);--/*! @brief Returns whether the specified extension is available.- *- *  This function returns whether the specified- *  [client 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.- *- *  @par Thread Safety- *  This function may be called from any thread.- *- *  @sa @ref context_glext- *  @sa glfwGetProcAddress- *- *  @since Added in GLFW 1.0.- *- *  @ingroup context- */-GLFWAPI int glfwExtensionSupported(const char* extension);--/*! @brief Returns the address of the specified function for the current- *  context.- *- *  This function returns the address of the specified- *  [core 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 or an [error](@ref error_handling) occurred.- *- *  @remarks The addresses of a given function is not guaranteed to be the same- *  between contexts.- *- *  @remarks This function may return a non-`NULL` address despite the- *  associated version or extension not being available.  Always check the- *  context version or extension string presence first.- *- *  @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- */-GLFWAPI GLFWglproc glfwGetProcAddress(const char* procname);+ * GLFW 3.2 - www.glfw.org+ * A library for OpenGL, window and input+ *------------------------------------------------------------------------+ * Copyright (c) 2002-2006 Marcus Geelnard+ * Copyright (c) 2006-2016 Camilla Berglund <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_h_+#define _glfw3_h_++#ifdef __cplusplus+extern "C" {+#endif+++/*************************************************************************+ * Doxygen documentation+ *************************************************************************/++/*! @file glfw3.h+ *  @brief The header of the GLFW 3 API.+ *+ *  This is the header file of the GLFW 3 API.  It defines all its types and+ *  declares all its functions.+ *+ *  For more information about how to use this file, see @ref build_include.+ */+/*! @defgroup context Context reference+ *+ *  This is the reference documentation for OpenGL and OpenGL ES context related+ *  functions.  For more task-oriented information, see the @ref context_guide.+ */+/*! @defgroup vulkan Vulkan reference+ *+ *  This is the reference documentation for Vulkan related functions and types.+ *  For more task-oriented information, see the @ref vulkan_guide.+ */+/*! @defgroup init Initialization, version and error reference+ *+ *  This is the reference documentation for initialization and termination of+ *  the library, version management and error handling.  For more task-oriented+ *  information, see the @ref intro_guide.+ */+/*! @defgroup input Input reference+ *+ *  This is the reference documentation for input related functions and types.+ *  For more task-oriented information, see the @ref input_guide.+ */+/*! @defgroup monitor Monitor reference+ *+ *  This is the reference documentation for monitor related functions and types.+ *  For more task-oriented information, see the @ref monitor_guide.+ */+/*! @defgroup window Window reference+ *+ *  This is the reference documentation for window related functions and types,+ *  including creation, deletion and event polling.  For more task-oriented+ *  information, see the @ref window_guide.+ */+++/*************************************************************************+ * Compiler- and platform-specific preprocessor work+ *************************************************************************/++/* If we are we on Windows, we want a single define for it.+ */+#if !defined(_WIN32) && (defined(__WIN32__) || defined(WIN32) || defined(__MINGW32__))+ #define _WIN32+#endif /* _WIN32 */++/* It is customary to use APIENTRY for OpenGL function pointer declarations on+ * all platforms.  Additionally, the Windows OpenGL header needs APIENTRY.+ */+#ifndef APIENTRY+ #ifdef _WIN32+  #define APIENTRY __stdcall+ #else+  #define APIENTRY+ #endif+#endif /* APIENTRY */++/* Some Windows OpenGL headers need this.+ */+#if !defined(WINGDIAPI) && defined(_WIN32)+ #define WINGDIAPI __declspec(dllimport)+ #define GLFW_WINGDIAPI_DEFINED+#endif /* WINGDIAPI */++/* Some Windows GLU headers need this.+ */+#if !defined(CALLBACK) && defined(_WIN32)+ #define CALLBACK __stdcall+ #define GLFW_CALLBACK_DEFINED+#endif /* CALLBACK */++/* Include because most Windows GLU headers need wchar_t and+ * the OS X OpenGL header blocks the definition of ptrdiff_t by glext.h.+ * Include it unconditionally to avoid surprising side-effects.+ */+#include <stddef.h>++/* Include because it is needed by Vulkan and related functions.+ */+#include <stdint.h>++/* Include the chosen client API headers.+ */+#if defined(__APPLE__)+ #if defined(GLFW_INCLUDE_GLCOREARB)+  #include <OpenGL/gl3.h>+  #if defined(GLFW_INCLUDE_GLEXT)+   #include <OpenGL/gl3ext.h>+  #endif+ #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>+  #if defined(GLFW_INCLUDE_GLEXT)+   #include <GLES/glext.h>+  #endif+ #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 <GLES2/gl2ext.h>+  #endif+ #elif defined(GLFW_INCLUDE_ES31)+  #include <GLES3/gl31.h>+  #if defined(GLFW_INCLUDE_GLEXT)+   #include <GLES2/gl2ext.h>+  #endif+ #elif defined(GLFW_INCLUDE_VULKAN)+  #include <vulkan/vulkan.h>+ #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 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 GLFW as a Win32 DLL */+ #define GLFWAPI __declspec(dllexport)+#elif defined(_WIN32) && defined(GLFW_DLL)+ /* We are calling GLFW as a Win32 DLL */+ #define GLFWAPI __declspec(dllimport)+#elif defined(__GNUC__) && defined(_GLFW_BUILD_DLL)+ /* We are building GLFW as a shared / dynamic library */+ #define GLFWAPI __attribute__((visibility("default")))+#else+ /* We are building or calling GLFW as a static library */+ #define GLFWAPI+#endif+++/*************************************************************************+ * GLFW API tokens+ *************************************************************************/++/*! @name GLFW version macros+ *  @{ */+/*! @brief The major version number of the GLFW library.+ *+ *  This is incremented when the API is changed in non-compatible ways.+ *  @ingroup init+ */+#define GLFW_VERSION_MAJOR          3+/*! @brief The minor version number of the GLFW library.+ *+ *  This is incremented when features are added to the API but it remains+ *  backward-compatible.+ *  @ingroup init+ */+#define GLFW_VERSION_MINOR          2+/*! @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       1+/*! @} */++/*! @name Boolean values+ *  @{ */+/*! @brief One.+ *+ *  One.  Seriously.  You don't _need_ to use this symbol in your code.  It's+ *  just semantic sugar for the number 1.  You can use `1` or `true` or `_True`+ *  or `GL_TRUE` or whatever you want.+ */+#define GLFW_TRUE                   1+/*! @brief Zero.+ *+ *  Zero.  Seriously.  You don't _need_ to use this symbol in your code.  It's+ *  just just semantic sugar for the number 0.  You can use `0` or `false` or+ *  `_False` or `GL_FALSE` or whatever you want.+ */+#define GLFW_FALSE                  0+/*! @} */++/*! @name Key and button actions+ *  @{ */+/*! @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 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+/*! @} */++/*! @defgroup keys Keyboard keys+ *+ *  See [key input](@ref input_key) for how these are used.+ *+ *  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+ *  @{+ */++/* The unknown key */+#define GLFW_KEY_UNKNOWN            -1++/* Printable keys */+#define GLFW_KEY_SPACE              32+#define GLFW_KEY_APOSTROPHE         39  /* ' */+#define GLFW_KEY_COMMA              44  /* , */+#define GLFW_KEY_MINUS              45  /* - */+#define GLFW_KEY_PERIOD             46  /* . */+#define GLFW_KEY_SLASH              47  /* / */+#define GLFW_KEY_0                  48+#define GLFW_KEY_1                  49+#define GLFW_KEY_2                  50+#define GLFW_KEY_3                  51+#define GLFW_KEY_4                  52+#define GLFW_KEY_5                  53+#define GLFW_KEY_6                  54+#define GLFW_KEY_7                  55+#define GLFW_KEY_8                  56+#define GLFW_KEY_9                  57+#define GLFW_KEY_SEMICOLON          59  /* ; */+#define GLFW_KEY_EQUAL              61  /* = */+#define GLFW_KEY_A                  65+#define GLFW_KEY_B                  66+#define GLFW_KEY_C                  67+#define GLFW_KEY_D                  68+#define GLFW_KEY_E                  69+#define GLFW_KEY_F                  70+#define GLFW_KEY_G                  71+#define GLFW_KEY_H                  72+#define GLFW_KEY_I                  73+#define GLFW_KEY_J                  74+#define GLFW_KEY_K                  75+#define GLFW_KEY_L                  76+#define GLFW_KEY_M                  77+#define GLFW_KEY_N                  78+#define GLFW_KEY_O                  79+#define GLFW_KEY_P                  80+#define GLFW_KEY_Q                  81+#define GLFW_KEY_R                  82+#define GLFW_KEY_S                  83+#define GLFW_KEY_T                  84+#define GLFW_KEY_U                  85+#define GLFW_KEY_V                  86+#define GLFW_KEY_W                  87+#define GLFW_KEY_X                  88+#define GLFW_KEY_Y                  89+#define GLFW_KEY_Z                  90+#define GLFW_KEY_LEFT_BRACKET       91  /* [ */+#define GLFW_KEY_BACKSLASH          92  /* \ */+#define GLFW_KEY_RIGHT_BRACKET      93  /* ] */+#define GLFW_KEY_GRAVE_ACCENT       96  /* ` */+#define GLFW_KEY_WORLD_1            161 /* non-US #1 */+#define GLFW_KEY_WORLD_2            162 /* non-US #2 */++/* Function keys */+#define GLFW_KEY_ESCAPE             256+#define GLFW_KEY_ENTER              257+#define GLFW_KEY_TAB                258+#define GLFW_KEY_BACKSPACE          259+#define GLFW_KEY_INSERT             260+#define GLFW_KEY_DELETE             261+#define GLFW_KEY_RIGHT              262+#define GLFW_KEY_LEFT               263+#define GLFW_KEY_DOWN               264+#define GLFW_KEY_UP                 265+#define GLFW_KEY_PAGE_UP            266+#define GLFW_KEY_PAGE_DOWN          267+#define GLFW_KEY_HOME               268+#define GLFW_KEY_END                269+#define GLFW_KEY_CAPS_LOCK          280+#define GLFW_KEY_SCROLL_LOCK        281+#define GLFW_KEY_NUM_LOCK           282+#define GLFW_KEY_PRINT_SCREEN       283+#define GLFW_KEY_PAUSE              284+#define GLFW_KEY_F1                 290+#define GLFW_KEY_F2                 291+#define GLFW_KEY_F3                 292+#define GLFW_KEY_F4                 293+#define GLFW_KEY_F5                 294+#define GLFW_KEY_F6                 295+#define GLFW_KEY_F7                 296+#define GLFW_KEY_F8                 297+#define GLFW_KEY_F9                 298+#define GLFW_KEY_F10                299+#define GLFW_KEY_F11                300+#define GLFW_KEY_F12                301+#define GLFW_KEY_F13                302+#define GLFW_KEY_F14                303+#define GLFW_KEY_F15                304+#define GLFW_KEY_F16                305+#define GLFW_KEY_F17                306+#define GLFW_KEY_F18                307+#define GLFW_KEY_F19                308+#define GLFW_KEY_F20                309+#define GLFW_KEY_F21                310+#define GLFW_KEY_F22                311+#define GLFW_KEY_F23                312+#define GLFW_KEY_F24                313+#define GLFW_KEY_F25                314+#define GLFW_KEY_KP_0               320+#define GLFW_KEY_KP_1               321+#define GLFW_KEY_KP_2               322+#define GLFW_KEY_KP_3               323+#define GLFW_KEY_KP_4               324+#define GLFW_KEY_KP_5               325+#define GLFW_KEY_KP_6               326+#define GLFW_KEY_KP_7               327+#define GLFW_KEY_KP_8               328+#define GLFW_KEY_KP_9               329+#define GLFW_KEY_KP_DECIMAL         330+#define GLFW_KEY_KP_DIVIDE          331+#define GLFW_KEY_KP_MULTIPLY        332+#define GLFW_KEY_KP_SUBTRACT        333+#define GLFW_KEY_KP_ADD             334+#define GLFW_KEY_KP_ENTER           335+#define GLFW_KEY_KP_EQUAL           336+#define GLFW_KEY_LEFT_SHIFT         340+#define GLFW_KEY_LEFT_CONTROL       341+#define GLFW_KEY_LEFT_ALT           342+#define GLFW_KEY_LEFT_SUPER         343+#define GLFW_KEY_RIGHT_SHIFT        344+#define GLFW_KEY_RIGHT_CONTROL      345+#define GLFW_KEY_RIGHT_ALT          346+#define GLFW_KEY_RIGHT_SUPER        347+#define GLFW_KEY_MENU               348++#define GLFW_KEY_LAST               GLFW_KEY_MENU++/*! @} */++/*! @defgroup mods Modifier key flags+ *+ *  See [key input](@ref input_key) for how these are used.+ *+ *  @ingroup input+ *  @{ */++/*! @brief If this bit is set one or more Shift keys were held down.+ */+#define GLFW_MOD_SHIFT           0x0001+/*! @brief If this bit is set one or more Control keys were held down.+ */+#define GLFW_MOD_CONTROL         0x0002+/*! @brief If this bit is set one or more Alt keys were held down.+ */+#define GLFW_MOD_ALT             0x0004+/*! @brief If this bit is set one or more Super keys were held down.+ */+#define GLFW_MOD_SUPER           0x0008++/*! @} */++/*! @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+#define GLFW_MOUSE_BUTTON_2         1+#define GLFW_MOUSE_BUTTON_3         2+#define GLFW_MOUSE_BUTTON_4         3+#define GLFW_MOUSE_BUTTON_5         4+#define GLFW_MOUSE_BUTTON_6         5+#define GLFW_MOUSE_BUTTON_7         6+#define GLFW_MOUSE_BUTTON_8         7+#define GLFW_MOUSE_BUTTON_LAST      GLFW_MOUSE_BUTTON_8+#define GLFW_MOUSE_BUTTON_LEFT      GLFW_MOUSE_BUTTON_1+#define GLFW_MOUSE_BUTTON_RIGHT     GLFW_MOUSE_BUTTON_2+#define GLFW_MOUSE_BUTTON_MIDDLE    GLFW_MOUSE_BUTTON_3+/*! @} */++/*! @defgroup joysticks Joysticks+ *+ *  See [joystick input](@ref joystick) for how these are used.+ *+ *  @ingroup input+ *  @{ */+#define GLFW_JOYSTICK_1             0+#define GLFW_JOYSTICK_2             1+#define GLFW_JOYSTICK_3             2+#define GLFW_JOYSTICK_4             3+#define GLFW_JOYSTICK_5             4+#define GLFW_JOYSTICK_6             5+#define GLFW_JOYSTICK_7             6+#define GLFW_JOYSTICK_8             7+#define GLFW_JOYSTICK_9             8+#define GLFW_JOYSTICK_10            9+#define GLFW_JOYSTICK_11            10+#define GLFW_JOYSTICK_12            11+#define GLFW_JOYSTICK_13            12+#define GLFW_JOYSTICK_14            13+#define GLFW_JOYSTICK_15            14+#define GLFW_JOYSTICK_16            15+#define GLFW_JOYSTICK_LAST          GLFW_JOYSTICK_16+/*! @} */++/*! @defgroup errors Error codes+ *+ *  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 must not be called unless the+ *  library is [initialized](@ref intro_init).+ *+ *  @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.+ *+ *  @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 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.+ *+ *  @analysis Application programmer error.  Fix the offending call.+ */+#define GLFW_INVALID_ENUM           0x00010003+/*! @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.+ *+ *  @analysis Application programmer error.  Fix the offending call.+ */+#define GLFW_INVALID_VALUE          0x00010004+/*! @brief A memory allocation failed.+ *+ *  A memory allocation failed.+ *+ *  @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 API on the system.+ *+ *  GLFW could not find support for the requested API on the system.+ *+ *  @analysis The installed graphics driver does not support the requested+ *  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 support 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.  Older graphics drivers do not support Vulkan.+ */+#define GLFW_API_UNAVAILABLE        0x00010006+/*! @brief The requested OpenGL or OpenGL ES version is not available.+ *+ *  The requested OpenGL or OpenGL ES version (including any requested context+ *  or framebuffer hints) is not available on this machine.+ *+ *  @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.+ *+ *  @analysis A bug or configuration error in GLFW, the underlying operating+ *  system or its drivers, or a lack of required resources.  Report the issue to+ *  our [issue tracker](https://github.com/glfw/glfw/issues).+ */+#define GLFW_PLATFORM_ERROR         0x00010008+/*! @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.+ *+ *  @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+/*! @brief The specified window does not have an OpenGL or OpenGL ES context.+ *+ *  A window that does not have an OpenGL or OpenGL ES context was passed to+ *  a function that requires it to have one.+ *+ *  @analysis Application programmer error.  Fix the offending call.+ */+#define GLFW_NO_WINDOW_CONTEXT      0x0001000A+/*! @} */++#define GLFW_FOCUSED                0x00020001+#define GLFW_ICONIFIED              0x00020002+#define GLFW_RESIZABLE              0x00020003+#define GLFW_VISIBLE                0x00020004+#define GLFW_DECORATED              0x00020005+#define GLFW_AUTO_ICONIFY           0x00020006+#define GLFW_FLOATING               0x00020007+#define GLFW_MAXIMIZED              0x00020008++#define GLFW_RED_BITS               0x00021001+#define GLFW_GREEN_BITS             0x00021002+#define GLFW_BLUE_BITS              0x00021003+#define GLFW_ALPHA_BITS             0x00021004+#define GLFW_DEPTH_BITS             0x00021005+#define GLFW_STENCIL_BITS           0x00021006+#define GLFW_ACCUM_RED_BITS         0x00021007+#define GLFW_ACCUM_GREEN_BITS       0x00021008+#define GLFW_ACCUM_BLUE_BITS        0x00021009+#define GLFW_ACCUM_ALPHA_BITS       0x0002100A+#define GLFW_AUX_BUFFERS            0x0002100B+#define GLFW_STEREO                 0x0002100C+#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+#define GLFW_CONTEXT_VERSION_MINOR  0x00022003+#define GLFW_CONTEXT_REVISION       0x00022004+#define GLFW_CONTEXT_ROBUSTNESS     0x00022005+#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_CONTEXT_NO_ERROR       0x0002200A+#define GLFW_CONTEXT_CREATION_API   0x0002200B++#define GLFW_NO_API                          0+#define GLFW_OPENGL_API             0x00030001+#define GLFW_OPENGL_ES_API          0x00030002++#define GLFW_NO_ROBUSTNESS                   0+#define GLFW_NO_RESET_NOTIFICATION  0x00031001+#define GLFW_LOSE_CONTEXT_ON_RESET  0x00031002++#define GLFW_OPENGL_ANY_PROFILE              0+#define GLFW_OPENGL_CORE_PROFILE    0x00032001+#define GLFW_OPENGL_COMPAT_PROFILE  0x00032002++#define GLFW_CURSOR                 0x00033001+#define GLFW_STICKY_KEYS            0x00033002+#define GLFW_STICKY_MOUSE_BUTTONS   0x00033003++#define GLFW_CURSOR_NORMAL          0x00034001+#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++#define GLFW_NATIVE_CONTEXT_API     0x00036001+#define GLFW_EGL_CONTEXT_API        0x00036002++/*! @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+ *************************************************************************/++/*! @brief Client API function pointer type.+ *+ *  Generic function pointer used for returning client API function pointers+ *  without forcing a cast from a regular pointer.+ *+ *  @sa @ref context_glext+ *  @sa glfwGetProcAddress+ *+ *  @since Added in version 3.0.+ + *  @ingroup context+ */+typedef void (*GLFWglproc)(void);++/*! @brief Vulkan API function pointer type.+ *+ *  Generic function pointer used for returning Vulkan API function pointers+ *  without forcing a cast from a regular pointer.+ *+ *  @sa @ref vulkan_proc+ *  @sa glfwGetInstanceProcAddress+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup vulkan+ */+typedef void (*GLFWvkproc)(void);++/*! @brief Opaque monitor object.+ *+ *  Opaque monitor object.+ *+ *  @see @ref monitor_object+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+typedef struct GLFWmonitor GLFWmonitor;++/*! @brief Opaque window object.+ *+ *  Opaque window object.+ *+ *  @see @ref window_object+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+typedef struct GLFWwindow GLFWwindow;++/*! @brief Opaque cursor object.+ *+ *  Opaque cursor object.+ *+ *  @see @ref cursor_object+ *+ *  @since Added in version 3.1.+ *+ *  @ingroup cursor+ */+typedef struct GLFWcursor GLFWcursor;++/*! @brief The function signature for error callbacks.+ *+ *  This is the function signature for error callback functions.+ *+ *  @param[in] error An [error code](@ref errors).+ *  @param[in] description A UTF-8 encoded string describing the error.+ *+ *  @sa @ref error_handling+ *  @sa glfwSetErrorCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup init+ */+typedef void (* GLFWerrorfun)(int,const char*);++/*! @brief The function signature for window position callbacks.+ *+ *  This is the function signature for window position callback functions.+ *+ *  @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+ *  upper-left corner of the client area of the window.+ *+ *  @sa @ref window_pos+ *  @sa glfwSetWindowPosCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+typedef void (* GLFWwindowposfun)(GLFWwindow*,int,int);++/*! @brief The function signature for window resize callbacks.+ *+ *  This is the function signature for window size callback functions.+ *+ *  @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.+ *+ *  @sa @ref window_size+ *  @sa glfwSetWindowSizeCallback+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+typedef void (* GLFWwindowsizefun)(GLFWwindow*,int,int);++/*! @brief The function signature for window close callbacks.+ *+ *  This is the function signature for window close callback functions.+ *+ *  @param[in] window The window that the user attempted to close.+ *+ *  @sa @ref window_close+ *  @sa glfwSetWindowCloseCallback+ *+ *  @since Added in version 2.5.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+typedef void (* GLFWwindowclosefun)(GLFWwindow*);++/*! @brief The function signature for window content refresh callbacks.+ *+ *  This is the function signature for window refresh callback functions.+ *+ *  @param[in] window The window whose content needs to be refreshed.+ *+ *  @sa @ref window_refresh+ *  @sa glfwSetWindowRefreshCallback+ *+ *  @since Added in version 2.5.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+typedef void (* GLFWwindowrefreshfun)(GLFWwindow*);++/*! @brief The function signature for window focus/defocus callbacks.+ *+ *  This is the function signature for window focus callback functions.+ *+ *  @param[in] window The window that gained or lost input focus.+ *  @param[in] focused `GLFW_TRUE` if the window was given input focus, or+ *  `GLFW_FALSE` if it lost it.+ *+ *  @sa @ref window_focus+ *  @sa glfwSetWindowFocusCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+typedef void (* GLFWwindowfocusfun)(GLFWwindow*,int);++/*! @brief The function signature for window iconify/restore callbacks.+ *+ *  This is the function signature for window iconify/restore callback+ *  functions.+ *+ *  @param[in] window The window that was iconified or restored.+ *  @param[in] iconified `GLFW_TRUE` if the window was iconified, or+ *  `GLFW_FALSE` if it was restored.+ *+ *  @sa @ref window_iconify+ *  @sa glfwSetWindowIconifyCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+typedef void (* GLFWwindowiconifyfun)(GLFWwindow*,int);++/*! @brief The function signature for framebuffer resize callbacks.+ *+ *  This is the function signature for framebuffer resize callback+ *  functions.+ *+ *  @param[in] window The window whose framebuffer was resized.+ *  @param[in] width The new width, in pixels, of the framebuffer.+ *  @param[in] height The new height, in pixels, of the framebuffer.+ *+ *  @sa @ref window_fbsize+ *  @sa glfwSetFramebufferSizeCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+typedef void (* GLFWframebuffersizefun)(GLFWwindow*,int,int);++/*! @brief The function signature for mouse button callbacks.+ *+ *  This is the function signature for mouse button callback functions.+ *+ *  @param[in] window The window that received the event.+ *  @param[in] button The [mouse button](@ref buttons) that was pressed or+ *  released.+ *  @param[in] action One of `GLFW_PRESS` or `GLFW_RELEASE`.+ *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were+ *  held down.+ *+ *  @sa @ref input_mouse_button+ *  @sa glfwSetMouseButtonCallback+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle and modifier mask parameters.+ *+ *  @ingroup input+ */+typedef void (* GLFWmousebuttonfun)(GLFWwindow*,int,int,int);++/*! @brief The function signature for cursor position callbacks.+ *+ *  This is the function signature for cursor position callback functions.+ *+ *  @param[in] window The window that received the event.+ *  @param[in] xpos The new cursor x-coordinate, relative to the left edge of+ *  the client area.+ *  @param[in] ypos The new cursor y-coordinate, relative to the top edge of the+ *  client area.+ *+ *  @sa @ref cursor_pos+ *  @sa glfwSetCursorPosCallback+ *+ *  @since Added in version 3.0.  Replaces `GLFWmouseposfun`.+ *+ *  @ingroup input+ */+typedef void (* GLFWcursorposfun)(GLFWwindow*,double,double);++/*! @brief The function signature for cursor enter/leave callbacks.+ *+ *  This is the function signature for cursor enter/leave callback functions.+ *+ *  @param[in] window The window that received the event.+ *  @param[in] entered `GLFW_TRUE` if the cursor entered the window's client+ *  area, or `GLFW_FALSE` if it left it.+ *+ *  @sa @ref cursor_enter+ *  @sa glfwSetCursorEnterCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup input+ */+typedef void (* GLFWcursorenterfun)(GLFWwindow*,int);++/*! @brief The function signature for scroll callbacks.+ *+ *  This is the function signature for scroll callback functions.+ *+ *  @param[in] window The window that received the event.+ *  @param[in] xoffset The scroll offset along the x-axis.+ *  @param[in] yoffset The scroll offset along the y-axis.+ *+ *  @sa @ref scrolling+ *  @sa glfwSetScrollCallback+ *+ *  @since Added in version 3.0.  Replaces `GLFWmousewheelfun`.+ *+ *  @ingroup input+ */+typedef void (* GLFWscrollfun)(GLFWwindow*,double,double);++/*! @brief The function signature for keyboard key callbacks.+ *+ *  This is the function signature for keyboard key callback functions.+ *+ *  @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 `GLFW_PRESS`, `GLFW_RELEASE` or `GLFW_REPEAT`.+ *  @param[in] mods Bit field describing which [modifier keys](@ref mods) were+ *  held down.+ *+ *  @sa @ref input_key+ *  @sa glfwSetKeyCallback+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle, scancode and modifier mask parameters.+ *+ *  @ingroup input+ */+typedef void (* GLFWkeyfun)(GLFWwindow*,int,int,int,int);++/*! @brief The function signature for Unicode character callbacks.+ *+ *  This is the function signature for Unicode character callback functions.+ *+ *  @param[in] window The window that received the event.+ *  @param[in] codepoint The Unicode code point of the character.+ *+ *  @sa @ref input_char+ *  @sa glfwSetCharCallback+ *+ *  @since Added in version 2.4.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup input+ */+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 @ref input_char+ *  @sa glfwSetCharModsCallback+ *+ *  @since Added in version 3.1.+ *+ *  @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] paths The UTF-8 encoded file and/or directory path names.+ *+ *  @sa @ref path_drop+ *  @sa glfwSetDropCallback+ *+ *  @since Added in version 3.1.+ *+ *  @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.+ *+ *  @param[in] monitor The monitor that was connected or disconnected.+ *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.+ *+ *  @sa @ref monitor_event+ *  @sa glfwSetMonitorCallback+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+typedef void (* GLFWmonitorfun)(GLFWmonitor*,int);++/*! @brief The function signature for joystick configuration callbacks.+ *+ *  This is the function signature for joystick configuration callback+ *  functions.+ *+ *  @param[in] joy The joystick that was connected or disconnected.+ *  @param[in] event One of `GLFW_CONNECTED` or `GLFW_DISCONNECTED`.+ *+ *  @sa @ref joystick_event+ *  @sa glfwSetJoystickCallback+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup input+ */+typedef void (* GLFWjoystickfun)(int,int);++/*! @brief Video mode type.+ *+ *  This describes a single video mode.+ *+ *  @sa @ref monitor_modes+ *  @sa glfwGetVideoMode glfwGetVideoModes+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added refresh rate member.+ *+ *  @ingroup monitor+ */+typedef struct GLFWvidmode+{+    /*! The width, in screen coordinates, of the video mode.+     */+    int width;+    /*! The height, in screen coordinates, of the video mode.+     */+    int height;+    /*! The bit depth of the red channel of the video mode.+     */+    int redBits;+    /*! The bit depth of the green channel of the video mode.+     */+    int greenBits;+    /*! The bit depth of the blue channel of the video mode.+     */+    int blueBits;+    /*! The refresh rate, in Hz, of the video mode.+     */+    int refreshRate;+} GLFWvidmode;++/*! @brief Gamma ramp.+ *+ *  This describes the gamma ramp for a monitor.+ *+ *  @sa @ref monitor_gamma+ *  @sa glfwGetGammaRamp glfwSetGammaRamp+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+typedef struct GLFWgammaramp+{+    /*! An array of value describing the response of the red channel.+     */+    unsigned short* red;+    /*! An array of value describing the response of the green channel.+     */+    unsigned short* green;+    /*! An array of value describing the response of the blue channel.+     */+    unsigned short* blue;+    /*! The number of elements in each array.+     */+    unsigned int size;+} GLFWgammaramp;++/*! @brief Image data.+ *+ *  @sa @ref cursor_custom+ *  @sa @ref window_icon+ *+ *  @since Added in version 2.1.+ *  @glfw3 Removed format and bytes-per-pixel members.+ */+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+ *************************************************************************/++/*! @brief Initializes the GLFW library.+ *+ *  This function initializes the GLFW library.  Before most GLFW functions can+ *  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 application exits.+ *+ *  Additional calls to this function after successful initialization but before+ *  termination will return `GLFW_TRUE` immediately.+ *+ *  @return `GLFW_TRUE` if successful, or `GLFW_FALSE` if an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark @osx This function will change the current directory of the+ *  application to the `Contents/Resources` subdirectory of the application's+ *  bundle, if present.  This can be disabled with a+ *  [compile-time option](@ref compile_options_osx).+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref intro_init+ *  @sa glfwTerminate+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup init+ */+GLFWAPI int glfwInit(void);++/*! @brief Terminates the GLFW library.+ *+ *  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 application exits.  If initialization fails, there is no need to+ *  call this function, as it is called by @ref glfwInit before it returns+ *  failure.+ *+ *  @errors Possible errors include @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark This function may be called before @ref glfwInit.+ *+ *  @warning The contexts of any remaining windows must not be current on any+ *  other thread when this function is called.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref intro_init+ *  @sa glfwInit+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup init+ */+GLFWAPI void glfwTerminate(void);++/*! @brief Retrieves the version of the GLFW library.+ *+ *  This function retrieves the major, minor and revision numbers of the GLFW+ *  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`.+ *+ *  @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`.+ *+ *  @errors None.+ *+ *  @remark This function may be called before @ref glfwInit.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref intro_version+ *  @sa glfwGetVersionString+ *+ *  @since Added in version 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 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.  It should not be confused with the OpenGL or OpenGL+ *  ES version string, queried with `glGetString`.+ *+ *  __Do not use the version string__ to parse the GLFW library version.  The+ *  @ref glfwGetVersion function provides the version of the running library+ *  binary in numerical format.+ *+ *  @return The ASCII encoded GLFW version string.+ *+ *  @errors None.+ *+ *  @remark This function may be called before @ref glfwInit.+ *+ *  @pointer_lifetime The returned string is static and compile-time generated.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref intro_version+ *  @sa glfwGetVersion+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup init+ */+GLFWAPI const char* glfwGetVersionString(void);++/*! @brief Sets the error callback.+ *+ *  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.+ *+ *  @errors None.+ *+ *  @remark This function may be called before @ref glfwInit.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref error_handling+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup init+ */+GLFWAPI GLFWerrorfun glfwSetErrorCallback(GLFWerrorfun cbfun);++/*! @brief Returns the currently connected monitors.+ *+ *  This function returns an array of handles for all currently connected+ *  monitors.  The primary monitor is always first in the returned array.  If no+ *  monitors were found, this function returns `NULL`.+ *+ *  @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 no monitors were found or+ *  if an [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_monitors+ *  @sa @ref monitor_event+ *  @sa glfwGetPrimaryMonitor+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI GLFWmonitor** glfwGetMonitors(int* count);++/*! @brief Returns the primary monitor.+ *+ *  This function returns the primary monitor.  This is usually the monitor+ *  where elements like the task bar or global menu bar are located.+ *+ *  @return The primary monitor, or `NULL` if no monitors were found or if an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @remark The primary monitor is always first in the array returned by @ref+ *  glfwGetMonitors.+ *+ *  @sa @ref monitor_monitors+ *  @sa glfwGetMonitors+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI GLFWmonitor* glfwGetPrimaryMonitor(void);++/*! @brief Returns the position of the monitor's viewport on the virtual screen.+ *+ *  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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_properties+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI void glfwGetMonitorPos(GLFWmonitor* monitor, int* xpos, int* ypos);++/*! @brief Returns the physical size of the monitor.+ *+ *  This function returns the size, in millimetres, of the display area of the+ *  specified monitor.+ *+ *  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.+ *+ *  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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @remark @win32 calculates the returned physical size from the+ *  current resolution and system DPI instead of querying the monitor EDID data.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_properties+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+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.  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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_properties+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI const char* glfwGetMonitorName(GLFWmonitor* monitor);++/*! @brief Sets the monitor configuration callback.+ *+ *  This function sets the monitor configuration callback, or removes the+ *  currently set callback.  This is called when a monitor is connected to or+ *  disconnected from the system.+ *+ *  @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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_event+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI GLFWmonitorfun glfwSetMonitorCallback(GLFWmonitorfun cbfun);++/*! @brief Returns the available video modes for the specified monitor.+ *+ *  This function returns an array of all video modes supported by the specified+ *  monitor.  The returned array is sorted in ascending order, first by color+ *  bit depth (the sum of all channel depths) and then by resolution area (the+ *  product of width and height).+ *+ *  @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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_modes+ *  @sa glfwGetVideoMode+ *+ *  @since Added in version 1.0.+ *  @glfw3 Changed to return an array of modes for a specific monitor.+ *+ *  @ingroup monitor+ */+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 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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_modes+ *  @sa glfwGetVideoModes+ *+ *  @since Added in version 3.0.  Replaces `glfwGetDesktopMode`.+ *+ *  @ingroup monitor+ */+GLFWAPI const GLFWvidmode* glfwGetVideoMode(GLFWmonitor* monitor);++/*! @brief Generates a gamma ramp and sets it for the specified monitor.+ *+ *  This function generates a 256-element gamma ramp from the specified exponent+ *  and then calls @ref glfwSetGammaRamp with it.  The value must be a finite+ *  number greater than zero.+ *+ *  @param[in] monitor The monitor whose gamma ramp to set.+ *  @param[in] gamma The desired exponent.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_gamma+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI void glfwSetGamma(GLFWmonitor* monitor, float gamma);++/*! @brief Returns the current gamma ramp for 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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_gamma+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+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.  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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @remark Gamma ramp sizes other than 256 are not supported by all platforms+ *  or graphics hardware.+ *+ *  @remark @win32 The gamma ramp size must be 256.+ *+ *  @pointer_lifetime The specified gamma ramp is copied before this function+ *  returns.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref monitor_gamma+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup monitor+ */+GLFWAPI void glfwSetGammaRamp(GLFWmonitor* monitor, const GLFWgammaramp* ramp);++/*! @brief Resets all window hints to their default values.+ *+ *  This function resets all window hints to their+ *  [default values](@ref window_hints_values).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_hints+ *  @sa glfwWindowHint+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI void glfwDefaultWindowHints(void);++/*! @brief Sets the specified window hint to the desired value.+ *+ *  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.+ *+ *  This function does not check whether the specified hint values are valid.+ *  If you set hints to invalid values this will instead be reported by the next+ *  call to @ref glfwCreateWindow.+ *+ *  @param[in] hint The [window hint](@ref window_hints) to set.+ *  @param[in] value The new value of the window hint.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_INVALID_ENUM.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_hints+ *  @sa glfwDefaultWindowHints+ *+ *  @since Added in version 3.0.  Replaces `glfwOpenWindowHint`.+ *+ *  @ingroup window+ */+GLFWAPI void glfwWindowHint(int hint, int value);++/*! @brief Creates a window and its associated context.+ *+ *  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](@ref context_current).  For information about the `share`+ *  parameter, see @ref context_sharing.+ *+ *  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 query the actual attributes+ *  of the created window, framebuffer and context, see @ref+ *  glfwGetWindowAttrib, @ref glfwGetWindowSize and @ref glfwGetFramebufferSize.+ *+ *  To create a full screen window, you need to specify the monitor the window+ *  will cover.  If no monitor is specified, the window will be windowed mode.+ *  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.+ *+ *  For full screen windows, the specified size becomes the resolution of the+ *  window's _desired video mode_.  As long as a full screen window is not+ *  iconified, 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.+ *+ *  Once you have created the window, you can switch it between windowed and+ *  full screen mode with @ref glfwSetWindowMonitor.  If the window has an+ *  OpenGL or OpenGL ES context, it will be unaffected.+ *+ *  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.+ *+ *  As long as at least one full screen window is not iconified, 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.+ *  This must be greater than zero.+ *  @param[in] title The initial, UTF-8 encoded window title.+ *  @param[in] monitor The monitor to use for full screen mode, or `NULL` for+ *  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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM, @ref GLFW_INVALID_VALUE, @ref GLFW_API_UNAVAILABLE, @ref+ *  GLFW_VERSION_UNAVAILABLE, @ref GLFW_FORMAT_UNAVAILABLE and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @remark @win32 Window creation will fail if the Microsoft GDI software+ *  OpenGL implementation is the only one available.+ *+ *  @remark @win32 If the executable has an icon resource named `GLFW_ICON,` it+ *  will be set as the initial icon for the window.  If no such icon is present,+ *  the `IDI_WINLOGO` icon will be used instead.  To set a different icon, see+ *  @ref glfwSetWindowIcon.+ *+ *  @remark @win32 The context to share resources with must not be current on+ *  any other thread.+ *+ *  @remark @osx 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.+ *  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.+ *+ *  @remark @osx 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).+ *+ *  @remark @osx On OS X 10.10 and later the window frame will not be rendered+ *  at full resolution on Retina displays unless the `NSHighResolutionCapable`+ *  key is enabled in the application bundle's `Info.plist`.  For more+ *  information, see+ *  [High Resolution Guidelines for OS X](https://developer.apple.com/library/mac/documentation/GraphicsAnimation/Conceptual/HighResolutionOSX/Explained/Explained.html)+ *  in the Mac Developer Library.  The GLFW test and example programs use+ *  a custom `Info.plist` template for this, which can be found as+ *  `CMake/MacOSXBundleInfo.plist.in` in the source tree.+ *+ *  @remark @x11 Some window managers will not respect the placement of+ *  initially hidden windows.+ *+ *  @remark @x11 Due to the asynchronous nature of X11, it may take a moment for+ *  a window to reach its requested state.  This means you may not be able to+ *  query the final size, position or other attributes directly after window+ *  creation.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_creation+ *  @sa glfwDestroyWindow+ *+ *  @since Added in version 3.0.  Replaces `glfwOpenWindow`.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindow* glfwCreateWindow(int width, int height, const char* title, GLFWmonitor* monitor, GLFWwindow* share);++/*! @brief Destroys the specified window and its context.+ *+ *  This function destroys the specified window and its context.  On calling+ *  this function, no further callbacks will be called for that window.+ *+ *  If the context of the specified window is current on the main thread, it is+ *  detached before being destroyed.+ *+ *  @param[in] window The window to destroy.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @note The context of the specified window must not be current on any other+ *  thread when this function is called.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_creation+ *  @sa glfwCreateWindow+ *+ *  @since Added in version 3.0.  Replaces `glfwCloseWindow`.+ *+ *  @ingroup window+ */+GLFWAPI void glfwDestroyWindow(GLFWwindow* window);++/*! @brief Checks the close flag of the specified window.+ *+ *  This function returns the value of the close flag of the specified window.+ *+ *  @param[in] window The window to query.+ *  @return The value of the close flag.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function may be called from any thread.  Access is not+ *  synchronized.+ *+ *  @sa @ref window_close+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI int glfwWindowShouldClose(GLFWwindow* window);++/*! @brief Sets the close flag of the specified window.+ *+ *  This function sets the value of the close flag of the specified window.+ *  This can be used to override the user's attempt to close the window, or+ *  to signal that it should be closed.+ *+ *  @param[in] window The window whose flag to change.+ *  @param[in] value The new value.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function may be called from any thread.  Access is not+ *  synchronized.+ *+ *  @sa @ref window_close+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowShouldClose(GLFWwindow* window, int value);++/*! @brief Sets the title of the specified window.+ *+ *  This function sets the window title, encoded as UTF-8, of the specified+ *  window.+ *+ *  @param[in] window The window whose title to change.+ *  @param[in] title The UTF-8 encoded window title.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @remark @osx The window title will not be updated until the next time you+ *  process events.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_title+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowTitle(GLFWwindow* window, const char* title);++/*! @brief Sets the icon for the specified window.+ *+ *  This function sets the icon of the specified window.  If passed an array of+ *  candidate images, those of or closest to the sizes desired by the system are+ *  selected.  If no images are specified, the window reverts to its default+ *  icon.+ *+ *  The desired image sizes varies depending on platform and system settings.+ *  The selected images will be rescaled as needed.  Good sizes include 16x16,+ *  32x32 and 48x48.+ *+ *  @param[in] window The window whose icon to set.+ *  @param[in] count The number of images in the specified array, or zero to+ *  revert to the default window icon.+ *  @param[in] images The images to create the icon from.  This is ignored if+ *  count is zero.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @pointer_lifetime The specified image data is copied before this function+ *  returns.+ *+ *  @remark @osx The GLFW window has no icon, as it is not a document+ *  window, so this function does nothing.  The dock icon will be the same as+ *  the application bundle's icon.  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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_icon+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowIcon(GLFWwindow* window, int count, const GLFWimage* images);++/*! @brief Retrieves the position of the client area of the specified window.+ *+ *  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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_pos+ *  @sa glfwSetWindowPos+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+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 specified windowed mode window.  If the+ *  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.+ *+ *  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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_pos+ *  @sa glfwGetWindowPos+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowPos(GLFWwindow* window, int xpos, int ypos);++/*! @brief Retrieves the size of the client area of the specified window.+ *+ *  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 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+ *  client area, or `NULL`.+ *  @param[out] height Where to store the height, in screen coordinates, of the+ *  client area, or `NULL`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_size+ *  @sa glfwSetWindowSize+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+GLFWAPI void glfwGetWindowSize(GLFWwindow* window, int* width, int* height);++/*! @brief Sets the size limits of the specified window.+ *+ *  This function sets the size limits of the client area of the specified+ *  window.  If the window is full screen, the size limits only take effect+ *  once it is made windowed.  If the window is not resizable, this function+ *  does nothing.+ *+ *  The size limits are applied immediately to a windowed mode window and may+ *  cause it to be resized.+ *+ *  The maximum dimensions must be greater than or equal to the minimum+ *  dimensions and all must be greater than or equal to zero.+ *+ *  @param[in] window The window to set limits for.+ *  @param[in] minwidth The minimum width, in screen coordinates, of the client+ *  area, or `GLFW_DONT_CARE`.+ *  @param[in] minheight The minimum height, in screen coordinates, of the+ *  client area, or `GLFW_DONT_CARE`.+ *  @param[in] maxwidth The maximum width, in screen coordinates, of the client+ *  area, or `GLFW_DONT_CARE`.+ *  @param[in] maxheight The maximum height, in screen coordinates, of the+ *  client area, or `GLFW_DONT_CARE`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark If you set size limits and an aspect ratio that conflict, the+ *  results are undefined.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_sizelimits+ *  @sa glfwSetWindowAspectRatio+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowSizeLimits(GLFWwindow* window, int minwidth, int minheight, int maxwidth, int maxheight);++/*! @brief Sets the aspect ratio of the specified window.+ *+ *  This function sets the required aspect ratio of the client area of the+ *  specified window.  If the window is full screen, the aspect ratio only takes+ *  effect once it is made windowed.  If the window is not resizable, this+ *  function does nothing.+ *+ *  The aspect ratio is specified as a numerator and a denominator and both+ *  values must be greater than zero.  For example, the common 16:9 aspect ratio+ *  is specified as 16 and 9, respectively.+ *+ *  If the numerator and denominator is set to `GLFW_DONT_CARE` then the aspect+ *  ratio limit is disabled.+ *+ *  The aspect ratio is applied immediately to a windowed mode window and may+ *  cause it to be resized.+ *+ *  @param[in] window The window to set limits for.+ *  @param[in] numer The numerator of the desired aspect ratio, or+ *  `GLFW_DONT_CARE`.+ *  @param[in] denom The denominator of the desired aspect ratio, or+ *  `GLFW_DONT_CARE`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_VALUE and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark If you set size limits and an aspect ratio that conflict, the+ *  results are undefined.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_sizelimits+ *  @sa glfwSetWindowSizeLimits+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowAspectRatio(GLFWwindow* window, int numer, int denom);++/*! @brief Sets the size of the client area of the specified window.+ *+ *  This function sets the size, in screen coordinates, of the client area of+ *  the specified window.+ *+ *  For full screen windows, this function updates the resolution of its desired+ *  video mode and switches to the video mode closest to it, without affecting+ *  the window's context.  As the context is unaffected, the bit depths of the+ *  framebuffer remain unchanged.+ *+ *  If you wish to update the refresh rate of the desired video mode in addition+ *  to its resolution, see @ref glfwSetWindowMonitor.+ *+ *  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, in screen coordinates, of the window+ *  client area.+ *  @param[in] height The desired height, in screen coordinates, of the window+ *  client area.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_size+ *  @sa glfwGetWindowSize+ *  @sa glfwSetWindowMonitor+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowSize(GLFWwindow* window, int width, int height);++/*! @brief Retrieves the size of the framebuffer of the specified window.+ *+ *  This function retrieves the size, in pixels, of the framebuffer of the+ *  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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_fbsize+ *  @sa glfwSetFramebufferSizeCallback+ *+ *  @since Added in version 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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_size+ *+ *  @since Added in version 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 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_iconify+ *  @sa glfwRestoreWindow+ *  @sa glfwMaximizeWindow+ *+ *  @since Added in version 2.1.+ *  @glfw3 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) or maximized.  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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_iconify+ *  @sa glfwIconifyWindow+ *  @sa glfwMaximizeWindow+ *+ *  @since Added in version 2.1.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup window+ */+GLFWAPI void glfwRestoreWindow(GLFWwindow* window);++/*! @brief Maximizes the specified window.+ *+ *  This function maximizes the specified window if it was previously not+ *  maximized.  If the window is already maximized, this function does nothing.+ *+ *  If the specified window is a full screen window, this function does nothing.+ *+ *  @param[in] window The window to maximize.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @par Thread Safety+ *  This function may only be called from the main thread.+ *+ *  @sa @ref window_iconify+ *  @sa glfwIconifyWindow+ *  @sa glfwRestoreWindow+ *+ *  @since Added in GLFW 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwMaximizeWindow(GLFWwindow* window);++/*! @brief Makes the specified window visible.+ *+ *  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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_hide+ *  @sa glfwHideWindow+ *+ *  @since Added in version 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+ *  the window is already hidden or is in full screen mode, this function does+ *  nothing.+ *+ *  @param[in] window The window to hide.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_hide+ *  @sa glfwShowWindow+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI void glfwHideWindow(GLFWwindow* window);++/*! @brief Brings the specified window to front and sets input focus.+ *+ *  This function brings the specified window to front and sets input focus.+ *  The window should already be visible and not iconified.+ *+ *  By default, both windowed and full screen mode windows are focused when+ *  initially created.  Set the [GLFW_FOCUSED](@ref window_hints_wnd) to disable+ *  this behavior.+ *+ *  __Do not use this function__ to steal focus from other applications unless+ *  you are certain that is what the user wants.  Focus stealing can be+ *  extremely disruptive.+ *+ *  @param[in] window The window to give input focus.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_focus+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwFocusWindow(GLFWwindow* window);++/*! @brief Returns the monitor that the window uses for full screen mode.+ *+ *  This function returns the handle of the monitor that the specified window is+ *  in full screen on.+ *+ *  @param[in] window The window to query.+ *  @return The monitor, or `NULL` if the window is in windowed mode or an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_monitor+ *  @sa glfwSetWindowMonitor+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI GLFWmonitor* glfwGetWindowMonitor(GLFWwindow* window);++/*! @brief Sets the mode, monitor, video mode and placement of a window.+ *+ *  This function sets the monitor that the window uses for full screen mode or,+ *  if the monitor is `NULL`, makes it windowed mode.+ *+ *  When setting a monitor, this function updates the width, height and refresh+ *  rate of the desired video mode and switches to the video mode closest to it.+ *  The window position is ignored when setting a monitor.+ *+ *  When the monitor is `NULL`, the position, width and height are used to+ *  place the window client area.  The refresh rate is ignored when no monitor+ *  is specified.+ *+ *  If you only wish to update the resolution of a full screen window or the+ *  size of a windowed mode window, see @ref glfwSetWindowSize.+ *+ *  When a window transitions from full screen to windowed mode, this function+ *  restores any previous window settings such as whether it is decorated,+ *  floating, resizable, has size or aspect ratio limits, etc..+ *+ *  @param[in] window The window whose monitor, size or video mode to set.+ *  @param[in] monitor The desired monitor, or `NULL` to set windowed mode.+ *  @param[in] xpos The desired x-coordinate of the upper-left corner of the+ *  client area.+ *  @param[in] ypos The desired y-coordinate of the upper-left corner of the+ *  client area.+ *  @param[in] width The desired with, in screen coordinates, of the client area+ *  or video mode.+ *  @param[in] height The desired height, in screen coordinates, of the client+ *  area or video mode.+ *  @param[in] refreshRate The desired refresh rate, in Hz, of the video mode,+ *  or `GLFW_DONT_CARE`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_monitor+ *  @sa @ref window_full_screen+ *  @sa glfwGetWindowMonitor+ *  @sa glfwSetWindowSize+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowMonitor(GLFWwindow* window, GLFWmonitor* monitor, int xpos, int ypos, int width, int height, int refreshRate);++/*! @brief Returns an attribute of the specified window.+ *+ *  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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark Framebuffer related hints are not window attributes.  See @ref+ *  window_attribs_fb for more information.+ *+ *  @remark Zero is a valid value for many window and context related+ *  attributes so you cannot use a return value of zero as an indication of+ *  errors.  However, this function should not fail as long as it is passed+ *  valid arguments and the library has been [initialized](@ref intro_init).+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_attribs+ *+ *  @since Added in version 3.0.  Replaces `glfwGetWindowParam` and+ *  `glfwGetGLVersion`.+ *+ *  @ingroup window+ */+GLFWAPI int glfwGetWindowAttrib(GLFWwindow* window, int attrib);++/*! @brief Sets the user pointer of the specified window.+ *+ *  This function sets the user-defined pointer of the specified window.  The+ *  current value is retained until the window is destroyed.  The initial value+ *  is `NULL`.+ *+ *  @param[in] window The window whose pointer to set.+ *  @param[in] pointer The new value.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function may be called from any thread.  Access is not+ *  synchronized.+ *+ *  @sa @ref window_userptr+ *  @sa glfwGetWindowUserPointer+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI void glfwSetWindowUserPointer(GLFWwindow* window, void* pointer);++/*! @brief Returns the user pointer of the specified window.+ *+ *  This function returns the current value of the user-defined pointer of the+ *  specified window.  The initial value is `NULL`.+ *+ *  @param[in] window The window whose pointer to return.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function may be called from any thread.  Access is not+ *  synchronized.+ *+ *  @sa @ref window_userptr+ *  @sa glfwSetWindowUserPointer+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI void* glfwGetWindowUserPointer(GLFWwindow* window);++/*! @brief Sets the position callback for the specified window.+ *+ *  This function sets the position callback of the specified window, which is+ *  called when the window is moved.  The callback is provided with the screen+ *  position of the upper-left corner of the client area of the 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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_pos+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindowposfun glfwSetWindowPosCallback(GLFWwindow* window, GLFWwindowposfun cbfun);++/*! @brief Sets the size callback for the specified window.+ *+ *  This function sets the size callback of the specified window, which is+ *  called when the window is resized.  The callback is provided with the size,+ *  in screen coordinates, of the client area of the 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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_size+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter and return value.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindowsizefun glfwSetWindowSizeCallback(GLFWwindow* window, GLFWwindowsizefun cbfun);++/*! @brief Sets the close callback for the specified window.+ *+ *  This function sets the close callback of the specified window, which is+ *  called when the user attempts to close the window, for example by clicking+ *  the close widget in the title bar.+ *+ *  The close flag is set before this callback is called, but you can modify it+ *  at any time with @ref glfwSetWindowShouldClose.+ *+ *  The close callback is not triggered by @ref glfwDestroyWindow.+ *+ *  @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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @remark @osx Selecting Quit from the application menu will trigger the close+ *  callback for all windows.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_close+ *+ *  @since Added in version 2.5.+ *  @glfw3 Added window handle parameter and return value.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindowclosefun glfwSetWindowCloseCallback(GLFWwindow* window, GLFWwindowclosefun cbfun);++/*! @brief Sets the refresh callback for the specified window.+ *+ *  This function sets the refresh callback of the specified window, which is+ *  called when the client area of the window needs to be redrawn, for example+ *  if the window has been exposed after having been covered by another window.+ *+ *  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.+ *+ *  @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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_refresh+ *+ *  @since Added in version 2.5.+ *  @glfw3 Added window handle parameter and return value.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* window, GLFWwindowrefreshfun cbfun);++/*! @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 input focus.+ *+ *  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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_focus+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindowfocusfun glfwSetWindowFocusCallback(GLFWwindow* window, GLFWwindowfocusfun cbfun);++/*! @brief Sets the iconify callback for the specified window.+ *+ *  This function sets the iconification callback of the specified window, which+ *  is called when the window is iconified or restored.+ *+ *  @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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_iconify+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI GLFWwindowiconifyfun glfwSetWindowIconifyCallback(GLFWwindow* window, GLFWwindowiconifyfun cbfun);++/*! @brief Sets the framebuffer resize callback for the specified window.+ *+ *  This function sets the framebuffer resize callback of the specified window,+ *  which is called when the framebuffer of the specified window is resized.+ *+ *  @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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref window_fbsize+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup window+ */+GLFWAPI GLFWframebuffersizefun glfwSetFramebufferSizeCallback(GLFWwindow* window, GLFWframebuffersizefun cbfun);++/*! @brief Processes all pending events.+ *+ *  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.+ *+ *  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.+ *+ *  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.+ *+ *  Event processing is not required for joystick input to work.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref events+ *  @sa glfwWaitEvents+ *  @sa glfwWaitEventsTimeout+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup window+ */+GLFWAPI void glfwPollEvents(void);++/*! @brief Waits until events are queued and processes them.+ *+ *  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.+ *+ *  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.+ *+ *  On some platforms, certain callbacks may be called outside of a call to one+ *  of the event processing functions.+ *+ *  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.+ *+ *  Event processing is not required for joystick input to work.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref events+ *  @sa glfwPollEvents+ *  @sa glfwWaitEventsTimeout+ *+ *  @since Added in version 2.5.+ *+ *  @ingroup window+ */+GLFWAPI void glfwWaitEvents(void);++/*! @brief Waits with timeout until events are queued and processes them.+ *+ *  This function puts the calling thread to sleep until at least one event is+ *  available in the event queue, or until the specified timeout is reached.  If+ *  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.+ *+ *  The timeout value must be a positive finite number.+ *+ *  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.+ *+ *  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.+ *+ *  On some platforms, certain callbacks may be called outside of a call to one+ *  of the event processing functions.+ *+ *  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.+ *+ *  Event processing is not required for joystick input to work.+ *+ *  @param[in] timeout The maximum amount of time, in seconds, to wait.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref events+ *  @sa glfwPollEvents+ *  @sa glfwWaitEvents+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup window+ */+GLFWAPI void glfwWaitEventsTimeout(double timeout);++/*! @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 or @ref glfwWaitEventsTimeout 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref events+ *  @sa glfwWaitEvents+ *  @sa glfwWaitEventsTimeout+ *+ *  @since Added in version 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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_INVALID_ENUM.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa glfwSetInputMode+ *+ *  @since Added in version 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 `GLFW_TRUE` to+ *  enable sticky keys, or `GLFW_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+ *  `GLFW_TRUE` to enable sticky mouse buttons, or `GLFW_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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa glfwGetInputMode+ *+ *  @since Added in version 3.0.  Replaces `glfwEnable` and `glfwDisable`.+ *+ *  @ingroup input+ */+GLFWAPI void glfwSetInputMode(GLFWwindow* window, int mode, int value);++/*! @brief Returns the localized name of the specified printable key.+ *+ *  This function returns the localized name of the specified printable key.+ *  This is intended for displaying key bindings to the user.+ *+ *  If the key is `GLFW_KEY_UNKNOWN`, the scancode is used instead, otherwise+ *  the scancode is ignored.  If a non-printable key or (if the key is+ *  `GLFW_KEY_UNKNOWN`) a scancode that maps to a non-printable key is+ *  specified, this function returns `NULL`.          + *+ *  This behavior allows you to pass in the arguments passed to the+ *  [key callback](@ref input_key) without modification.+ *+ *  The printable keys are:+ *  - `GLFW_KEY_APOSTROPHE`+ *  - `GLFW_KEY_COMMA`+ *  - `GLFW_KEY_MINUS`+ *  - `GLFW_KEY_PERIOD`+ *  - `GLFW_KEY_SLASH`+ *  - `GLFW_KEY_SEMICOLON`+ *  - `GLFW_KEY_EQUAL`+ *  - `GLFW_KEY_LEFT_BRACKET`+ *  - `GLFW_KEY_RIGHT_BRACKET`+ *  - `GLFW_KEY_BACKSLASH`+ *  - `GLFW_KEY_WORLD_1`+ *  - `GLFW_KEY_WORLD_2`+ *  - `GLFW_KEY_0` to `GLFW_KEY_9`+ *  - `GLFW_KEY_A` to `GLFW_KEY_Z`+ *  - `GLFW_KEY_KP_0` to `GLFW_KEY_KP_9`+ *  - `GLFW_KEY_KP_DECIMAL`+ *  - `GLFW_KEY_KP_DIVIDE`+ *  - `GLFW_KEY_KP_MULTIPLY`+ *  - `GLFW_KEY_KP_SUBTRACT`+ *  - `GLFW_KEY_KP_ADD`+ *  - `GLFW_KEY_KP_EQUAL`+ *+ *  @param[in] key The key to query, or `GLFW_KEY_UNKNOWN`.+ *  @param[in] scancode The scancode of the key to query.+ *  @return The localized name of the key, or `NULL`.+ *+ *  @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+ *  glfwGetKeyName, or until the library is terminated.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_key_name+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup input+ */+GLFWAPI const char* glfwGetKeyName(int key, int scancode);++/*! @brief Returns the last reported state of a keyboard key for the specified+ *  window.+ *+ *  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 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 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.+ *+ *  __Do not use this function__ to implement [text input](@ref input_char).+ *+ *  @param[in] window The desired window.+ *  @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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_INVALID_ENUM.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_key+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup input+ */+GLFWAPI int glfwGetKey(GLFWwindow* window, int key);++/*! @brief Returns the last reported state of a mouse button for the specified+ *  window.+ *+ *  This function returns the last state reported for the specified mouse button+ *  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+ *  `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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_INVALID_ENUM.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_mouse_button+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter.+ *+ *  @ingroup input+ */+GLFWAPI int glfwGetMouseButton(GLFWwindow* window, int button);++/*! @brief Retrieves the position of the cursor relative to the client area of+ *  the 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+ *  a `double`.+ *+ *  The coordinate can be converted to their integer equivalents with the+ *  `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`.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_pos+ *  @sa glfwSetCursorPos+ *+ *  @since Added in version 3.0.  Replaces `glfwGetMousePos`.+ *+ *  @ingroup input+ */+GLFWAPI void glfwGetCursorPos(GLFWwindow* window, double* xpos, double* ypos);++/*! @brief Sets the position of the cursor, relative to the client area of the+ *  window.+ *+ *  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 have input focus.  If the window does not have+ *  input focus when this function is called, it fails silently.+ *+ *  __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.+ *  @param[in] xpos The desired x-coordinate, relative to the left edge of the+ *  client area.+ *  @param[in] ypos The desired y-coordinate, relative to the top edge of the+ *  client area.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_pos+ *  @sa glfwGetCursorPos+ *+ *  @since Added in version 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, non-premultiplied 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @pointer_lifetime The specified image data is copied before this function+ *  returns.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_object+ *  @sa glfwDestroyCursor+ *  @sa glfwCreateStandardCursor+ *+ *  @since Added in version 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_object+ *  @sa glfwCreateCursor+ *+ *  @since Added in version 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @reentrancy This function must not be called from a callback.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_object+ *  @sa glfwCreateCursor+ *+ *  @since Added in version 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_object+ *+ *  @since Added in version 3.1.+ *+ *  @ingroup input+ */+GLFWAPI void glfwSetCursor(GLFWwindow* window, GLFWcursor* cursor);++/*! @brief Sets the key callback.+ *+ *  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+ *  [key tokens](@ref keys) named after their values in the standard US keyboard+ *  layout.  If you want to input text, use the+ *  [character callback](@ref glfwSetCharCallback) instead.+ *+ *  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 queried with @ref glfwGetKey.+ *+ *  Sometimes GLFW needs to generate synthetic key events, in which case the+ *  scancode may be zero.+ *+ *  @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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_key+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter and return value.+ *+ *  @ingroup input+ */+GLFWAPI GLFWkeyfun glfwSetKeyCallback(GLFWwindow* window, GLFWkeyfun cbfun);++/*! @brief Sets the Unicode character callback.+ *+ *  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 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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_char+ *+ *  @since Added in version 2.4.+ *  @glfw3 Added window handle parameter and return value.+ *+ *  @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.+ *  @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](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_char+ *+ *  @since Added in version 3.1.+ *+ *  @ingroup input+ */+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 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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref input_mouse_button+ *+ *  @since Added in version 1.0.+ *  @glfw3 Added window handle parameter and return value.+ *+ *  @ingroup input+ */+GLFWAPI GLFWmousebuttonfun glfwSetMouseButtonCallback(GLFWwindow* window, GLFWmousebuttonfun cbfun);++/*! @brief Sets the cursor position callback.+ *+ *  This function sets the cursor position callback of the specified window,+ *  which is called when the cursor is moved.  The callback is provided with the+ *  position, in screen coordinates, relative to the upper-left corner of the+ *  client area of the 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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_pos+ *+ *  @since Added in version 3.0.  Replaces `glfwSetMousePosCallback`.+ *+ *  @ingroup input+ */+GLFWAPI GLFWcursorposfun glfwSetCursorPosCallback(GLFWwindow* window, GLFWcursorposfun cbfun);++/*! @brief Sets the cursor enter/exit callback.+ *+ *  This function sets the cursor boundary crossing callback of the specified+ *  window, which is called when the cursor enters or leaves the client area of+ *  the 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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref cursor_enter+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup input+ */+GLFWAPI GLFWcursorenterfun glfwSetCursorEnterCallback(GLFWwindow* window, GLFWcursorenterfun cbfun);++/*! @brief Sets the scroll callback.+ *+ *  This function sets the scroll callback of the specified window, which is+ *  called when a scrolling device is used, such as a mouse wheel or scrolling+ *  area of a touchpad.+ *+ *  The scroll callback receives all scrolling input, like that from a mouse+ *  wheel or a touchpad scrolling area.+ *+ *  @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 the+ *  library had not been [initialized](@ref intro_init).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref scrolling+ *+ *  @since Added in version 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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref path_drop+ *+ *  @since Added in version 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](@ref joysticks) to query.+ *  @return `GLFW_TRUE` if the joystick is present, or `GLFW_FALSE` otherwise.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref joystick+ *+ *  @since Added in version 3.0.  Replaces `glfwGetJoystickParam`.+ *+ *  @ingroup input+ */+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.+ *+ *  Querying a joystick slot with no device present is not an error, but will+ *  cause this function to return `NULL`.  Call @ref glfwJoystickPresent to+ *  check device presence.+ *+ *  @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 the joystick is not present or an error+ *  occurred.+ *  @return An array of axis values, or `NULL` if the joystick is not present or+ *  an [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref joystick_axis+ *+ *  @since Added in version 3.0.  Replaces `glfwGetJoystickPos`.+ *+ *  @ingroup input+ */+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`.+ *+ *  Querying a joystick slot with no device present is not an error, but will+ *  cause this function to return `NULL`.  Call @ref glfwJoystickPresent to+ *  check device presence.+ *+ *  @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 the joystick is not present or an error+ *  occurred.+ *  @return An array of button states, or `NULL` if the joystick is not present+ *  or an [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM and @ref GLFW_PLATFORM_ERROR.+ *+ *  @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.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref joystick_button+ *+ *  @since Added in version 2.2.+ *  @glfw3 Changed to return a dynamic array.+ *+ *  @ingroup input+ */+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.+ *+ *  Querying a joystick slot with no device present is not an error, but will+ *  cause this function to return `NULL`.  Call @ref glfwJoystickPresent to+ *  check device presence.+ *+ *  @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 or an [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_INVALID_ENUM 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 specified joystick is+ *  disconnected, this function is called again for that joystick or the library+ *  is terminated.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref joystick_name+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup input+ */+GLFWAPI const char* glfwGetJoystickName(int joy);++/*! @brief Sets the joystick configuration callback.+ *+ *  This function sets the joystick configuration callback, or removes the+ *  currently set callback.  This is called when a joystick is connected to or+ *  disconnected from the system.+ *+ *  @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).+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref joystick_event+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup input+ */+GLFWAPI GLFWjoystickfun glfwSetJoystickCallback(GLFWjoystickfun cbfun);++/*! @brief Sets the clipboard to the specified string.+ *+ *  This function sets the system clipboard to the specified, UTF-8 encoded+ *  string.+ *+ *  @param[in] window The window that will own the clipboard contents.+ *  @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 glfwGetClipboardString+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup input+ */+GLFWAPI void glfwSetClipboardString(GLFWwindow* window, const char* 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.  If the clipboard is empty or+ *  if its contents cannot be converted, `NULL` is returned and a @ref+ *  GLFW_FORMAT_UNAVAILABLE error is generated.+ *+ *  @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](@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+ *  glfwGetClipboardString or @ref glfwSetClipboardString, or until the library+ *  is terminated.+ *+ *  @thread_safety This function must only be called from the main thread.+ *+ *  @sa @ref clipboard+ *  @sa glfwSetClipboardString+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup input+ */+GLFWAPI const char* glfwGetClipboardString(GLFWwindow* window);++/*! @brief Returns the value of the GLFW timer.+ *+ *  This function returns the value of the GLFW timer.  Unless the timer has+ *  been set using @ref glfwSetTime, the timer measures time elapsed since GLFW+ *  was initialized.+ *+ *  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.+ *+ *  @return The current value, in seconds, or zero 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.  Reading and+ *  writing of the internal timer offset is not atomic, so it needs to be+ *  externally synchronized with calls to @ref glfwSetTime.+ *+ *  @sa @ref time+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup input+ */+GLFWAPI double glfwGetTime(void);++/*! @brief Sets the GLFW timer.+ *+ *  This function sets the value of the GLFW timer.  It then continues to count+ *  up from that value.  The value must be a positive finite number less than+ *  or equal to 18446744073.0, which is approximately 584.5 years.+ *+ *  @param[in] time The new value, in seconds.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_INVALID_VALUE.+ *+ *  @remark The upper limit of the timer is calculated as+ *  floor((2<sup>64</sup> - 1) / 10<sup>9</sup>) and is due to implementations+ *  storing nanoseconds in 64 bits.  The limit may be increased in the future.+ *+ *  @thread_safety This function may be called from any thread.  Reading and+ *  writing of the internal timer offset is not atomic, so it needs to be+ *  externally synchronized with calls to @ref glfwGetTime.+ *+ *  @sa @ref time+ *+ *  @since Added in version 2.2.+ *+ *  @ingroup input+ */+GLFWAPI void glfwSetTime(double time);++/*! @brief Returns the current value of the raw timer.+ *+ *  This function returns the current value of the raw timer, measured in+ *  1&nbsp;/&nbsp;frequency seconds.  To get the frequency, call @ref+ *  glfwGetTimerFrequency.+ *+ *  @return The value of the timer, or zero 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.+ *+ *  @sa @ref time+ *  @sa glfwGetTimerFrequency+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup input+ */+GLFWAPI uint64_t glfwGetTimerValue(void);++/*! @brief Returns the frequency, in Hz, of the raw timer.+ *+ *  This function returns the frequency, in Hz, of the raw timer.+ *+ *  @return The frequency of the timer, in Hz, or zero 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.+ *+ *  @sa @ref time+ *  @sa glfwGetTimerValue+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup input+ */+GLFWAPI uint64_t glfwGetTimerFrequency(void);++/*! @brief Makes the context of the specified window current for the calling+ *  thread.+ *+ *  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.+ *+ *  The specified window must have an OpenGL or OpenGL ES context.  Specifying+ *  a window without a context will generate a @ref GLFW_NO_WINDOW_CONTEXT+ *  error.+ *+ *  @param[in] window The window whose context to make current, or `NULL` to+ *  detach the current context.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref context_current+ *  @sa glfwGetCurrentContext+ *+ *  @since Added in version 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 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.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref context_current+ *  @sa glfwMakeContextCurrent+ *+ *  @since Added in version 3.0.+ *+ *  @ingroup context+ */+GLFWAPI GLFWwindow* glfwGetCurrentContext(void);++/*! @brief Swaps the front and back buffers of the specified window.+ *+ *  This function swaps the front and back buffers of the specified window when+ *  rendering with OpenGL or OpenGL ES.  If the swap interval is greater than+ *  zero, the GPU driver waits the specified number of screen updates before+ *  swapping the buffers.+ *+ *  The specified window must have an OpenGL or OpenGL ES context.  Specifying+ *  a window without a context will generate a @ref GLFW_NO_WINDOW_CONTEXT+ *  error.+ *+ *  This function does not apply to Vulkan.  If you are rendering with Vulkan,+ *  see `vkQueuePresentKHR` instead.+ *+ *  @param[in] window The window whose buffers to swap.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_NO_WINDOW_CONTEXT and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark __EGL:__ The context of the specified window must be current on the+ *  calling thread.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref buffer_swap+ *  @sa glfwSwapInterval+ *+ *  @since Added in version 1.0.+ *  @glfw3 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 OpenGL or OpenGL ES+ *  context, i.e. the 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,+ *  which allow the driver to swap even if a frame arrives a little bit late.+ *  You can check for the presence of these extensions using @ref+ *  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.+ *+ *  This function does not apply to Vulkan.  If you are rendering with Vulkan,+ *  see the present mode of your swapchain instead.+ *+ *  @param[in] interval The minimum number of screen updates to wait for+ *  until the buffers are swapped by @ref glfwSwapBuffers.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_NO_CURRENT_CONTEXT and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark This function is not called during context 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+ *  interval to be reset to zero once it has been set to a non-zero value.+ *+ *  @remark Some GPU drivers do not honor the requested swap interval, either+ *  because of a user setting that overrides the application's request or due to+ *  bugs in the driver.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref buffer_swap+ *  @sa glfwSwapBuffers+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup context+ */+GLFWAPI void glfwSwapInterval(int interval);++/*! @brief Returns whether the specified extension is available.+ *+ *  This function returns whether the specified+ *  [API extension](@ref context_glext) is supported by the current OpenGL or+ *  OpenGL ES context.  It searches both for client API extension and 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.+ *+ *  This function does not apply to Vulkan.  If you are using Vulkan, see @ref+ *  glfwGetRequiredInstanceExtensions, `vkEnumerateInstanceExtensionProperties`+ *  and `vkEnumerateDeviceExtensionProperties` instead.+ *+ *  @param[in] extension The ASCII encoded name of the extension.+ *  @return `GLFW_TRUE` if the extension is available, or `GLFW_FALSE`+ *  otherwise.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_NO_CURRENT_CONTEXT, @ref GLFW_INVALID_VALUE and @ref+ *  GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref context_glext+ *  @sa glfwGetProcAddress+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup context+ */+GLFWAPI int glfwExtensionSupported(const char* extension);++/*! @brief Returns the address of the specified function for the current+ *  context.+ *+ *  This function returns the address of the specified OpenGL or OpenGL ES+ *  [core 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.+ *+ *  This function does not apply to Vulkan.  If you are rendering with Vulkan,+ *  see @ref glfwGetInstanceProcAddress, `vkGetInstanceProcAddr` and+ *  `vkGetDeviceProcAddr` instead.+ *+ *  @param[in] procname The ASCII encoded name of the function.+ *  @return The address of the function, or `NULL` if an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_NO_CURRENT_CONTEXT and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remark The address of a given function is not guaranteed to be the same+ *  between contexts.+ *+ *  @remark This function may return a non-`NULL` address despite the+ *  associated version or extension not being available.  Always check the+ *  context version or extension string first.+ *+ *  @pointer_lifetime The returned function pointer is valid until the context+ *  is destroyed or the library is terminated.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref context_glext+ *  @sa glfwExtensionSupported+ *+ *  @since Added in version 1.0.+ *+ *  @ingroup context+ */+GLFWAPI GLFWglproc glfwGetProcAddress(const char* procname);++/*! @brief Returns whether the Vulkan loader has been found.+ *+ *  This function returns whether the Vulkan loader has been found.  This check+ *  is performed by @ref glfwInit.+ *+ *  The availability of a Vulkan loader does not by itself guarantee that window+ *  surface creation or even device creation is possible.  Call @ref+ *  glfwGetRequiredInstanceExtensions to check whether the extensions necessary+ *  for Vulkan surface creation are available and @ref+ *  glfwGetPhysicalDevicePresentationSupport to check whether a queue family of+ *  a physical device supports image presentation.+ *+ *  @return `GLFW_TRUE` if Vulkan is available, or `GLFW_FALSE` otherwise.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref vulkan_support+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup vulkan+ */+GLFWAPI int glfwVulkanSupported(void);++/*! @brief Returns the Vulkan instance extensions required by GLFW.+ *+ *  This function returns an array of names of Vulkan instance extensions required+ *  by GLFW for creating Vulkan surfaces for GLFW windows.  If successful, the+ *  list will always contains `VK_KHR_surface`, so if you don't require any+ *  additional extensions you can pass this list directly to the+ *  `VkInstanceCreateInfo` struct.+ *+ *  If Vulkan is not available on the machine, this function returns `NULL` and+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported+ *  to check whether Vulkan is available.+ *+ *  If Vulkan is available but no set of extensions allowing window surface+ *  creation was found, this function returns `NULL`.  You may still use Vulkan+ *  for off-screen rendering and compute work.+ *+ *  @param[out] count Where to store the number of extensions in the returned+ *  array.  This is set to zero if an error occurred.+ *  @return An array of ASCII encoded extension names, or `NULL` if an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_API_UNAVAILABLE.+ *+ *  @remarks Additional extensions may be required by future versions of GLFW.+ *  You should check if any extensions you wish to enable are already in the+ *  returned array, as it is an error to specify an extension more than once in+ *  the `VkInstanceCreateInfo` struct.+ *+ *  @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+ *  library is terminated.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref vulkan_ext+ *  @sa glfwCreateWindowSurface+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup vulkan+ */+GLFWAPI const char** glfwGetRequiredInstanceExtensions(uint32_t* count);++#if defined(VK_VERSION_1_0)++/*! @brief Returns the address of the specified Vulkan instance function.+ *+ *  This function returns the address of the specified Vulkan core or extension+ *  function for the specified instance.  If instance is set to `NULL` it can+ *  return any function exported from the Vulkan loader, including at least the+ *  following functions:+ *+ *  - `vkEnumerateInstanceExtensionProperties`+ *  - `vkEnumerateInstanceLayerProperties`+ *  - `vkCreateInstance`+ *  - `vkGetInstanceProcAddr`+ *+ *  If Vulkan is not available on the machine, this function returns `NULL` and+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported+ *  to check whether Vulkan is available.+ *+ *  This function is equivalent to calling `vkGetInstanceProcAddr` with+ *  a platform-specific query of the Vulkan loader as a fallback.+ *+ *  @param[in] instance The Vulkan instance to query, or `NULL` to retrieve+ *  functions related to instance creation.+ *  @param[in] procname The ASCII encoded name of the function.+ *  @return The address of the function, or `NULL` if an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref+ *  GLFW_API_UNAVAILABLE.+ *+ *  @pointer_lifetime The returned function pointer is valid until the library+ *  is terminated.+ *+ *  @thread_safety This function may be called from any thread.+ *+ *  @sa @ref vulkan_proc+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup vulkan+ */+GLFWAPI GLFWvkproc glfwGetInstanceProcAddress(VkInstance instance, const char* procname);++/*! @brief Returns whether the specified queue family can present images.+ *+ *  This function returns whether the specified queue family of the specified+ *  physical device supports presentation to the platform GLFW was built for.+ *+ *  If Vulkan or the required window surface creation instance extensions are+ *  not available on the machine, or if the specified instance was not created+ *  with the required extensions, this function returns `GLFW_FALSE` and+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref glfwVulkanSupported+ *  to check whether Vulkan is available and @ref+ *  glfwGetRequiredInstanceExtensions to check what instance extensions are+ *  required.+ *+ *  @param[in] instance The instance that the physical device belongs to.+ *  @param[in] device The physical device that the queue family belongs to.+ *  @param[in] queuefamily The index of the queue family to query.+ *  @return `GLFW_TRUE` if the queue family supports presentation, or+ *  `GLFW_FALSE` otherwise.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_API_UNAVAILABLE and @ref GLFW_PLATFORM_ERROR.+ *+ *  @thread_safety This function may be called from any thread.  For+ *  synchronization details of Vulkan objects, see the Vulkan specification.+ *+ *  @sa @ref vulkan_present+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup vulkan+ */+GLFWAPI int glfwGetPhysicalDevicePresentationSupport(VkInstance instance, VkPhysicalDevice device, uint32_t queuefamily);++/*! @brief Creates a Vulkan surface for the specified window.+ *+ *  This function creates a Vulkan surface for the specified window.+ *+ *  If the Vulkan loader was not found at initialization, this function returns+ *  `VK_ERROR_INITIALIZATION_FAILED` and generates a @ref GLFW_API_UNAVAILABLE+ *  error.  Call @ref glfwVulkanSupported to check whether the Vulkan loader was+ *  found.+ *+ *  If the required window surface creation instance extensions are not+ *  available or if the specified instance was not created with these extensions+ *  enabled, this function returns `VK_ERROR_EXTENSION_NOT_PRESENT` and+ *  generates a @ref GLFW_API_UNAVAILABLE error.  Call @ref+ *  glfwGetRequiredInstanceExtensions to check what instance extensions are+ *  required.+ *+ *  The window surface must be destroyed before the specified Vulkan instance.+ *  It is the responsibility of the caller to destroy the window surface.  GLFW+ *  does not destroy it for you.  Call `vkDestroySurfaceKHR` to destroy the+ *  surface.+ *+ *  @param[in] instance The Vulkan instance to create the surface in.+ *  @param[in] window The window to create the surface for.+ *  @param[in] allocator The allocator to use, or `NULL` to use the default+ *  allocator.+ *  @param[out] surface Where to store the handle of the surface.  This is set+ *  to `VK_NULL_HANDLE` if an error occurred.+ *  @return `VK_SUCCESS` if successful, or a Vulkan error code if an+ *  [error](@ref error_handling) occurred.+ *+ *  @errors Possible errors include @ref GLFW_NOT_INITIALIZED, @ref+ *  GLFW_API_UNAVAILABLE and @ref GLFW_PLATFORM_ERROR.+ *+ *  @remarks If an error occurs before the creation call is made, GLFW returns+ *  the Vulkan error code most appropriate for the error.  Appropriate use of+ *  @ref glfwVulkanSupported and @ref glfwGetRequiredInstanceExtensions should+ *  eliminate almost all occurrences of these errors.+ *+ *  @thread_safety This function may be called from any thread.  For+ *  synchronization details of Vulkan objects, see the Vulkan specification.+ *+ *  @sa @ref vulkan_surface+ *  @sa glfwGetRequiredInstanceExtensions+ *+ *  @since Added in version 3.2.+ *+ *  @ingroup vulkan+ */+GLFWAPI VkResult glfwCreateWindowSurface(VkInstance instance, GLFWwindow* window, const VkAllocationCallbacks* allocator, VkSurfaceKHR* surface);++#endif /*VK_VERSION_1_0*/   /*************************************************************************