Typedefs | Functions
Context handling

Typedefs

typedef void(* GLFWglproc) (void)
 Client API function pointer type. More...
 

Functions

GLFWAPI int glfwExtensionSupported (const char *extension)
 Returns whether the specified extension is available. More...
 
GLFWAPI GLFWwindowglfwGetCurrentContext (void)
 Returns the window whose context is current on the calling thread. More...
 
GLFWAPI GLFWglproc glfwGetProcAddress (const char *procname)
 Returns the address of the specified function for the current context. More...
 
GLFWAPI void glfwMakeContextCurrent (GLFWwindow *window)
 Makes the context of the specified window current for the calling thread. More...
 
GLFWAPI void glfwSwapInterval (int interval)
 Sets the swap interval for the current context. More...
 

Detailed Description

This is the reference documentation for context related functions. For more information, see the Context handling.

Typedef Documentation

typedef void(* GLFWglproc) (void)

Client API function pointer type.

Generic function pointer used for returning client API function pointers without forcing a cast from a regular pointer.

Definition at line 706 of file glfw3.h.

Function Documentation

GLFWAPI int glfwExtensionSupported ( const char *  extension)

Returns whether the specified extension is available.

This function returns whether the specified client API extension 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 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.

Parameters
[in]extensionThe ASCII encoded name of the extension.
Returns
GL_TRUE if the extension is available, or GL_FALSE otherwise.
Thread Safety
This function may be called from any thread.
See also
context_glext
glfwGetProcAddress
Since
Added in GLFW 1.0.

Definition at line 564 of file context.c.

GLFWAPI GLFWwindow* glfwGetCurrentContext ( void  )

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.

Returns
The window whose context is current, or NULL if no window's context is current.
Thread Safety
This function may be called from any thread.
See also
context_current
glfwMakeContextCurrent
Since
Added in GLFW 3.0.

Definition at line 538 of file context.c.

GLFWAPI GLFWglproc glfwGetProcAddress ( const char *  procname)

Returns the address of the specified function for the current context.

This function returns the address of the specified core or extension function, 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 GLFW_NO_CURRENT_CONTEXT error.

Parameters
[in]procnameThe ASCII encoded name of the function.
Returns
The address of the function, or NULL if an [error](error_handling) occurred.
Remarks
The address of a given function is not guaranteed to be the same between contexts.
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.
See also
context_glext
glfwExtensionSupported
Since
Added in GLFW 1.0.

Definition at line 628 of file context.c.

GLFWAPI void glfwMakeContextCurrent ( GLFWwindow window)

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 window hint.

Parameters
[in]windowThe window whose context to make current, or NULL to detach the current context.
Thread Safety
This function may be called from any thread.
See also
context_current
glfwGetCurrentContext
Since
Added in GLFW 3.0.

Definition at line 531 of file context.c.

GLFWAPI void glfwSwapInterval ( int  interval)

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 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 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 GLFW_NO_CURRENT_CONTEXT error.

Parameters
[in]intervalThe minimum number of screen updates to wait for until the buffers are swapped by 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.
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.
See also
buffer_swap
glfwSwapBuffers
Since
Added in GLFW 1.0.

Definition at line 551 of file context.c.



librealsense
Author(s): Sergey Dorodnicov , Mark Horn , Reagan Lopez
autogenerated on Fri Mar 13 2020 03:16:18