PEXCopyPipelineStateToPC - Copy Pipeline State To PC (5.2)

Synopsis 

 
   void PEXCopyPipelineStateToPC(
        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, into which the values of the renderer's pipeline state are copied.

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

Returns

None.

Description

Invoke PEXCopyPipelineStateToPC to copy selected fields of the renderer's pipeline state.

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

If the mask indicates that the pipeline state's current name set is to be copied, the pipeline context must contain the resource identifier of a valid name set resource into which the pipeline state's current name set values are copied. Any names existing in the name set resource prior to the copy operation are deleted.

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.

BadPEXNameSet
The name set resource ID of the pipeline context is invalid.

BadValue
An invalid bit is set in mask.

See Also

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