Name

PEXGetRendererDynamics - Get Renderer Attribute Modification Dynamics

Synopsis

Status PEXGetRendererDynamics(Display ∗display, PEXRenderer renderer, unsigned long ∗tables_return, unsigned long ∗name_sets_return, unsigned long ∗attributes_return)

Arguments

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

rendererThe resource identifier of the renderer. 

tables_returnReturns a mask describing dynamics of lookup tables associated with the renderer. 

name_sets_return
Returns a mask describing dynamics of name sets associated with the renderer.

attributes_return
Returns a mask describing dynamics of other attributes associated with the renderer.

Returns

Zero if unsuccessful, non-zero otherwise. 

Description

This function returns the modification dynamics for all of the attributes of the specified renderer resource.  Each bit, in the returned bitmasks, indicates the dynamics for a particular renderer attribute.  For each bit, a value of PEXDynamic indicates that the specified attribute may be modified at any time, and the change will take place immediately.  A value of PEXNotDynamic indicates that the specified attribute may not be modified dynamically.  In this case, the change is "pending" and will take effect at the next explicit or implicit PEXBeginRendering.

The pipeline context, pick start path, background color, clear image and clear z renderer attributes all take effect only at the time of "begin rendering or picking", and so do not have dynamics associated with them. 

The bits in the tables bitmask are accessed with the following constants:

PEXRDTMarkerBundle
PEXRDTTextBundle
PEXRDTLineBundle
PEXRDTInteriorBundle
PEXRDTEdgeBundle
PEXRDTViewTable
PEXRDTColorTable
PEXRDTDepthCueTable
PEXRDTLightTable
PEXRDTColorApproxTable
PEXRDTPatternTable
PEXRDTTextFontTable
PEXRDTMarkerBundleContents
PEXRDTTextBundleContents
PEXRDTLineBundleContents
PEXRDTInteriorBundleContents
PEXRDTEdgeBundleContents
PEXRDTViewTableContents
PEXRDTColorTableContents
PEXRDTDepthCueTableContents
PEXRDTLightTableContents
PEXRDTColorApproxContents
PEXRDTPatternTableContents
PEXRDTTextFontTableContents

The bits in the name sets bitmask are accessed with the following constants:

PEXRDNHighlightNameSet
PEXRDNInvisibilityNameSet
PEXRDNPickNameSet
PEXRDNHighlightNameSetContents
PEXRDNInvisibilityNameSetContents
PEXRDNPickNameSetContents

The bits in the attributes bitmask are accessed with the following constants:

PEXRDAHLHSRMode
PEXRDANPCSubVolume
PEXRDAViewport
PEXRDAClipList
PEXRDAEchoMode

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

See Also

PEXCreateRenderer, PEXChangeRenderer, PEXBeginRendering