glGenAsyncMarkersSGIX(3G)

NAME
     glGenAsyncMarkersSGIX - reserve markers for tracking asynchronous
     commands


C SPECIFICATION
     GLuint glGenAsyncMarkersSGIX( GLsizei range )


PARAMETERS
     range  Specifies the number of contiguous marker values to reserve.

DESCRIPTION
     glGenAsyncMarkersSGIX is part of the SGIX_async extension.  This
     extension provides a framework within which particular sets of OpenGL
     commands can become "asynchronous" via specific further OpenGL
     extensions.  Currently the SGIX_async_pixel extension is the only such
     defined extension.

     A marker for asynchronous commands is "in use" if it is the current value
     of GL_ASYNC_MARKER_SGIX, or if it is associated with any asynchronous
     command that has been issued but has not been queried using
     glFinishAsyncSGIX or glPollAsyncSGIX.

     glGenAsyncMarkersSGIX returns an integer n such that the markers n, n+1,
     n+2, ..., n+s-1 are not previously reserved or in use, where s is the
     value of range.  glGenAsyncMarkersSGIX also records that each of the
     markers in the returned range is reserved.

     Note that the marker name space is never shared across contexts, as the
     name spaces for texture objects and display lists may be.

ERRORS
     GL_INVALID_OPERATION is generated if glGenAsyncMarkersSGIX is executed
     between the execution of glBegin and the corresponding execution of
     glEnd.


MACHINE DEPENDENCIES
     The SGIX_async and SGIX_async_pixel extensions are implemented only on
     Octane2 VPro systems.


SEE ALSO
     glAsyncMarkerSGIX, glDeleteAsyncMarkersSGIX, glFinishAsyncSGIX,
     glIsAsyncMarkerSGIX, glPollAsyncSGIX, glDrawPixels, glGet, glReadPixels,
     glTexImage1D, glTexImage2D, glTexImage3D, glTexSubImage1D,
     glTexSubImage2D, glTexSubImage3D