PEXGetRendererAttributes - Get Renderer Attribute Values (5.0)

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

Synopsis

 
   PEXRendererAttributes *PEXGetRendererAttributes(
       Display *display,
       PEXRenderer renderer,
       unsigned long value_mask
   )
 

Arguments

display

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

renderer

The resource identifier of the renderer to be queried.

value_mask

A mask indicating attributes to be returned from the renderer.

Returns

A pointer to the renderer attribute values; a null pointer if unsuccessful.

Description

Invoke PEXGetRendererAttributes to get the attribute values from the specified renderer resource.

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

• RAPipelineContext
• RACurrentPath
• RAMarkerBundle
• RATextBundle
• RALineBundle
• RAInteriorBundle
• RAEdgeBundle
• RAViewTable
• RAColorTable
• RADepthCueTable
• RALightTable
• RAColorApproxTable
• RAPatternTable
• RATextFontTable
• RAHighlightIncl
• RAHighlightExcl
• RAInvisibilityIncl
• RAInvisibilityExcl
• RARendererState
• RAHLHSRMode
• RANPCSubVolume
• RAViewport
• RAClipList
• RAPickIncl
• RAPickExcl
• RAPickStartPath
• RABackgroundColor
• RAClearImage
• RAClearZ
• RAEchoMode

PEXlib allocates the memory for the returned renderer attribute values. Invoke PEXFreeRendererAttributes to deallocate the memory.

Errors

BadPEXRenderer

The specified renderer resource identifier is invalid.

BadValue

An invalid bit is set in the value mask.

See Also

• PEXChangeRenderer
• PEXCreateRenderer
• PEXFreeRendererAttributes
• 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.