PEXChangePipelineContext5_2 - Change Pipeline Context (5.0)

Synopsis 

 
   void PEXChangePipelineContext5_2(
        Display *display,
        PEXPipelineContext context,
        unsigned long *value_mask,
        PEXPCAttributes5_2 *values
   )
 


 
   void PEXChangePipelineContext(
        Display *display,
        PEXPipelineContext context,
        unsigned long *value_mask,
        PEXPCAttributes *values
   )

Arguments

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

context
The resource identifier of the pipeline context.

value_mask
A pointer to an array of three unsigned long.

values
A pointer to new values for attributes in the pipeline context.

Returns

None.

Description

Invoke PEXChangePipelineContext5_2 to change the components of the specified pipeline context to the values you specify. You must use the 5.2 form of the function unless all aspects of the components you wish to change were defined in PEX 5.0 or 5.1. Note that each of the two forms uses a different structure for the values parameter.

Use the value_mask to indicate which attribute values you want changed. Invoke the PEXSetPCAttributeMask and PEXSetPCAttributeMaskAll functions to set up the value_mask.

Errors

BadPEXColorType
The specified color type is invalid or unsupported.

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPipelineContext
The specified pipeline context resource identifier is invalid.

BadValue
A specified value is out of range, or an invalid bit is set in the value mask.

See Also

For related topics and a list of pipeline context functions, see Pipeline Contexts.