PEXOCCSequentialProcessing - Sequential Processing of Output Commands (5.2)


Synopsis

 
   void PEXOCCSequentialProcessing(
        PEXOCC context,
        int seq_proc
   )
 

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

display (OCC)
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

seq_proc
Flag to control sequential processing (PEXOn or PEXOff)

Returns

None.

Description

Invoke PEXOCCSequentialProcessing to create a sequential processing output command which, when encountered by a renderer, sets the sequential processing state of the renderer.

If seq_proc is PEXOn, then the renderer guarantees each individual output command for a given request (excluding Execute Structure, Conditional Execute Structure, Include Structure, Conditional Include Structure, GSE, GDP 3D, and GDP 2D output commands) is executed atomically and sequentially.

If seq_proc is PEXOff, then the renderer is released from the requirement to maintain strict atomic hierarchical order and may schedule parallel processing or reorder processing even though the pixels may arrive in the image buffer in a non-determined order. All attributes and transforms must naturally be correctly bound to the primitives to which they apply.

Errors

BadPEXOutputCommand
The seq_proc argument is not PEXOn or PEXOff.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

See Structure Control and Miscellaneous Functions for an overview.