PEXChangeRenderer - Change Renderer Attributes (5.0)

Note: This function has been superseded by the PEXChangeRendererExtAttributes function, but is maintained here for backwards compatibility with PEXlib 5.1.

Synopsis

 
   void PEXChangeRenderer(
        Display *display,
        PEXRenderer renderer,
        unsigned long value_mask,
        PEXRendererAttributes *values
   )
 

Arguments

display

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

renderer

The resource identifier of the renderer.

value_mask

A mask indicating the renderer attributes to be changed.

values

A pointer to new values for the renderer attributes.

Returns

None.

Description

Invoke PEXChangeRenderer to modify attributes of the specified renderer resource.

The value mask indicates the attribute values to be modified. The value mask is constructed by or'ing together some of the following constants:

• PEXRAPipelineContext
• PEXRAMarkerBundle
• PEXRATextBundle
• PEXRALineBundle
• PEXRAInteriorBundle
• PEXRAEdgeBundle
• PEXRAViewTable
• PEXRAColorTable
• PEXRADepthCueTable
• PEXRALightTable
• PEXRAColorApproxTable
• PEXRAPatternTable
• PEXRATextFontTable
• PEXRAHighlightIncl
• PEXRAHighlightExcl
• PEXRAInvisibilityIncl
• PEXRAInvisibilityExcl
• PEXRAHLHSRMode
• PEXRANPCSubVolume
• PEXRAViewport
• PEXRAClipList
• PEXRAPickIncl
• PEXRAPickExcl
• PEXRAPickStartPath
• PEXRABackgroundColor
• PEXRAClearImage
• PEXRAClearZ
• PEXRAEchoMode

You cannot explicitly set the renderer's current path and renderer state attributes using this function.

Errors

BadMatch

The specified lookup table resource was not created with a drawable compatible with the drawable used to create the renderer resource.

BadPEXLookupTable

The specified lookup table resource identifier is invalid.

BadPEXNameSet

The specified name set resource identifier is invalid.

BadPEXPipelineContext

The specified pipeline context resource identifier is invalid.

BadPEXRenderer

The specified renderer resource identifier is invalid.

BadValue

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

See Also

• PEXCreateRenderer
• PEXGetRendererAttributes
• PEXGetRendererDynamics

For a list of compatibility functions, see Renderer Requests for PEXlib 5.0 and 5.1 Compatibility. For a list of all Renderer functions and related topics, see Rendering.