fglPollAsyncSGIX man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



fglPollAsyncSGIX(3G)	       OpenGL Reference		  fglPollAsyncSGIX(3G)

NAME
     fglPollAsyncSGIX - poll for completion of an asynchronous command

FORTRAN SPECIFICATION
     INTEGER*4 fglPollAsyncSGIX( CHARACTER*8 markerp )

PARAMETERS
     markerp  Returns a marker for a completed asynchronous command.

DESCRIPTION
     fglPollAsyncSGIX 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.

     Asynchronous commands are commands that may complete out-of-order with
     respect to other OpenGL commands.	An asynchronous command samples the
     OpenGL state vector when it is issued.  The sampled state includes the
     results from the complete execution of all synchronous (normal) commands
     issued prior to the asynchronous command.	However, the results of an
     asynchronous command (state changes or framebuffer updates) are not
     necessarily committed in order.  An asynchronous command may commit its
     results any time after the completion of all synchronous commands issued
     prior to the asynchronous command.	 An implementation may choose to
     execute asynchronous commands in parallel with subsequent commands or at
     some convenient time in the future.

     Implementations of asynchronous commands may also be non-blocking.	 For
     example, a non-blocking query command returns control to the program
     immediately rather than stalling the program until the results of the
     query are available.

     Note that this language allows any particular asynchronous command to
     behave exactly as if it were not asynchronous, if the implementation
     chooses.

     fglPollAsyncSGIX returns 1 when an asynchronous command has completed; in
     this case it writes the marker associated with the completed command into
     the integer referred to by markerp.  If there are no pending asynchronous
     commands, or if there are pending asynchronous commands but none have
     completed, fglPollAsyncSGIX returns 0 immediately and does not modify the
     integer referred to by markerp.

     Once OpenGL has reported the completion of an asynchronous command via
     either fglFinishAsyncSGIX or fglPollAsyncSGIX, the completion status of
     the command will not be reported again.  If several commands have the
     same marker associated with them, the completion status of each command
     will be reported separately, although these reports will be
     indistinguishable.	 The order in which asynchronous commands are reported
     is undefined.

									Page 1

fglPollAsyncSGIX(3G)	       OpenGL Reference		  fglPollAsyncSGIX(3G)

     A program may guarantee that all outstanding asynchronous commands have
     completed by calling fglFinish.  A call to fglFinish does not cause the
     completion status of outstanding commands to be reported, so subsequent
     calls to fglFinishAsyncSGIX or fglPollAsyncSGIX will report the status of
     such commands.

ERRORS
     GL_INVALID_OPERATION is generated if fglPollAsyncSGIX 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,
     fglGenAsyncMarkersSGIX, fglIsAsyncMarkerSGIX, fglDrawPixels,
     fglReadPixels, fglTexImage1D, fglTexImage2D, fglTexImage3D

									Page 2

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net