PEXGetRendererDynamics - Get Renderer Attribute Modification Dynamics (5.0)

Note: This function is not useful with PEX 5.2 implementations because all renderer attributes are defined to be dynamic in PEX 5.2. The function is maintained here for applications that work with PEX 5.0 and 5.1 implementations.

Synopsis

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

Arguments

display: A pointer to a display structure returned by a successful XOpenDisplay call.
renderer: The resource identifier of the renderer.
tables_return: Returns 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

Invoke PEXGetRendererDynamics to get 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. PEXlib defines the following bit values:

PEXDynamic -: indicates that the specified attribute may be modified at any time, and the change will take place immediately.
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:

RDTMarkerBundle
RDTTextBundle
RDTLineBundle
RDTInteriorBundle
RDTEdgeBundle
RDTViewTable
RDTColorTable
RDTDepthCueTable
RDTLightTable
RDTColorApproxTable
RDTPatternTable
RDTTextFontTable
RDTMarkerBundleContents
RDTTextBundleContents
RDTLineBundleContents
RDTInteriorBundleContents
RDTEdgeBundleContents
RDTViewTableContents
RDTColorTableContents
RDTDepthCueTableContents
RDTLightTableContents
RDTColorApproxContents
RDTPatternTableContents
RDTTextFontTableContents

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

RDNHighlightNameSet
RDNInvisibilityNameSet
RDNPickNameSet
RDNHighlightNameSetContents
PEXRDNInvisibilityNameSetContents
PEXRDNPickNameSetContents

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

PEXRDAHLHSRMode
RDANPCSubVolume
RDAViewport
RDAClipList
RDAEchoMode

Errors