PEXCreatePipelineContext5_2 - Create Pipeline Context (5.0)


Synopsis

 
   PEXPipelineContext PEXCreatePipelineContext5_2(
       Display *display,
       unsigned long *value_mask,
       PEXPCAttributes5_2 *values
   )
 

 
   PEXPipelineContext PEXCreatePipelineContext(
        Display *display,
        unsigned long *value_mask,
        PEXPCAttributes *values
   )
 

Arguments

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

value_mask
A pointer to an array of three unsigned long.

values
A pointer to values to override default attribute values in the new pipeline context.

Returns

The resource identifier of the newly-created pipeline context.

Description

Invoke PEXCreatePipelineContext5_2 to create a pipeline context and obtain its resource identifier. You must use the 5.2 form of the function unless all aspects of the components you wish to supply 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 the value you want to create. If you do not specify attribute values, then the implementation initializes the attribute values to the default values. Invoke the PEXSetPCAttributeMask and PEXSetPCAttributeMaskAll functions to set up the value_mask.

Errors

BadAlloc
The implementation failed to allocate the resource.

BadPEXColorType
The specified color type is invalid or unsupported.

BadPEXNameSet
A specified name set 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.