fglGenAsyncMarkersSGIX(3G)

NAME
     fglGenAsyncMarkersSGIX - reserve markers for tracking asynchronous
     commands


FORTRAN SPECIFICATION
     INTEGER*4 fglGenAsyncMarkersSGIX( INTEGER*4 range )


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

DESCRIPTION
     fglGenAsyncMarkersSGIX 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
     fglFinishAsyncSGIX or fglPollAsyncSGIX.

     fglGenAsyncMarkersSGIX 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.  fglGenAsyncMarkersSGIX 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 fglGenAsyncMarkersSGIX is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.


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


SEE ALSO
     fglAsyncMarkerSGIX, fglDeleteAsyncMarkersSGIX, fglFinishAsyncSGIX,
     fglIsAsyncMarkerSGIX, fglPollAsyncSGIX, fglDrawPixels, fglGet,
     fglReadPixels, fglTexImage1D, fglTexImage2D, fglTexImage3D,
     fglTexSubImage1D, fglTexSubImage2D, fglTexSubImage3D