PEXCopyPCToPipelineState - Copy PC to Pipeline State (5.2)

Synopsis 

 
   void PEXCopyPCToPipelineState(
        Display *display,
        PEXRenderer renderer,
        PEXPipelineContext pc,
        unsigned long *mask
   )

Arguments

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

renderer
The resource identifier of the renderer.

pc
The resource identifier of the pipeline context, the values of which are copied into the renderer's pipeline state.

mask
A pointer to a three word bitmask indicating which pipeline context values are copied.

Returns

None.

Description

Invoke PEXCopyPCToPipelineState to copy selected fields of the pipeline context.

If the renderer state of the renderer specified by the renderer argument is not PEXIdle, then the renderer copies selected fields of the pipeline context specified by pc to the renderer's pipeline state. The mask argument indicates which fields the renderer copies. Other fields in the renderer's pipeline state are not affected. Invoke the PEXSetPCAttributeMask and PEXSetPCAttributeMaskAll functions to set up the mask.

If the renderer state is PEXIdle, then this function has no effect.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXPipelineContext
The specified pipeline context resource identifier is invalid.

BadValue
An invalid bit is set in mask.

See Also

For a list of all Renderer functions and related topics, see Rendering.