Name

PEXGetRendererAttributes - Get Renderer Attribute Values

Synopsis

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

Arguments

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

rendererThe resource identifier of the renderer to be queried. 

value_maskA mask indicating attributes to be returned from the renderer. 

Returns

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

Description

This function returns 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 the following constants:

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

PEXlib allocates the memory for the returned renderer attribute values.  PEXFreeRendererAttributes should be called to deallocate the memory.

Data Structures

typedef XID             PEXRenderer;
See also the PEXStructuresman page.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadValueAn invalid bit is set in the value mask. 

See Also

PEXCreateRenderer, PEXChangeRenderer, PEXGetRendererDynamics,
PEXFreeRendererAttributes