Package org.lwjgl.opengl

Class KHRContextFlushControl

java.lang.Object
org.lwjgl.opengl.KHRContextFlushControl
public final class KHRContextFlushControl extends Object
Native bindings to the KHR_context_flush_control extension.

OpenGL and OpenGL ES have long supported multiple contexts. The semantics of switching contexts is generally left to window system binding APIs such as WGL, GLX and EGL. Most of these APIs (if not all) specify that when the current context for a thread is changed, the outgoing context performs an implicit flush of any commands that have been issued to that point. OpenGL and OpenGL ES define a flush as sending any pending commands for execution and that this action will result in their completion in finite time.

This behavior has subtle consequences. For example, if an application is rendering to the front buffer and switches contexts, it may assume that any rendering performed thus far will eventually be visible to the user. With recent introduction of shared memory buffers, there become inumerable ways in which applications may observe side effects of an implicit flush (or lack thereof).

In general, a full flush is not the desired behavior of the application. Nonetheless, applications that switch contexts frequently suffer the performance consequences of this unless implementations make special considerations for them, which is generally untenable.

This extension allows querying the context flush behavior.

Promoted to core in OpenGL 4.5.

  • Field Details

    • GL_CONTEXT_RELEASE_BEHAVIOR

      public static final int GL_CONTEXT_RELEASE_BEHAVIOR
      Accepted by the pname parameter of GetIntegerv, GetFloatv, GetBooleanv GetDoublev and GetInteger64v.
      See Also:

    • GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH

      public static final int GL_CONTEXT_RELEASE_BEHAVIOR_FLUSH
      Returned in data by GetIntegerv, GetFloatv, GetBooleanv GetDoublev and GetInteger64v when pname is CONTEXT_RELEASE_BEHAVIOR.
      See Also: