.\" @(#)PEXGetRendererDynamics.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetRendererDynamics 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetRendererDynamics - Get Renderer Attribute Modification Dynamics
.SH SYNTAX
.HP
Status PEXGetRendererDynamics\^(\^Display *\fIdisplay\fP\^, PEXRenderer \fIrenderer\fP\^, unsigned long *\fItables_return\fP\^, unsigned long *\fIname_sets_return\fP\^, unsigned long *\fIattributes_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIrenderer\fP 1i
The resource identifier of the renderer.
.IP \fItables_return\fP 1i
Returns a mask describing dynamics of lookup tables associated with the
renderer.
.IP \fIname_sets_return\fP 1i
Returns a mask describing dynamics of name sets associated with the renderer.
.IP \fIattributes_return\fP 1i
Returns a mask describing dynamics of other attributes associated with the renderer.
.SH RETURNS
.LP
Zero if unsuccessful, non-zero otherwise.
.SH DESCRIPTION
.\" indexing
.IX PEXGetRendererDynamics
.IX "Rendering" "PEXGetRendererDynamics"
.LP
This function returns the modification dynamics for all of the
attributes of the specified
.I renderer resource.
Each bit, in the
returned bitmasks, indicates the dynamics for a particular renderer attribute.
For each bit, a value of
.B PEXDynamic
indicates that the
specified attribute may be modified at any time, and the change will
take place immediately.  A value of
.B 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
.BR PEXBeginRendering (3) .
.LP
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.
.LP
The bits in the tables bitmask are accessed with the following constants:
.LP
.RS
.nf
.B PEXRDTColorApproxContents
.B PEXRDTColorApproxTable
.B PEXRDTColorTable
.B PEXRDTColorTableContents
.B PEXRDTDepthCueTable
.B PEXRDTDepthCueTableContents
.B PEXRDTEdgeBundle
.B PEXRDTEdgeBundleContents
.B PEXRDTInteriorBundle
.B PEXRDTInteriorBundleContents
.B PEXRDTLightTable
.B PEXRDTLightTableContents
.B PEXRDTLineBundle
.B PEXRDTLineBundleContents
.B PEXRDTMarkerBundle
.B PEXRDTMarkerBundleContents
.B PEXRDTPatternTable
.B PEXRDTPatternTableContents
.B PEXRDTTextBundle
.B PEXRDTTextBundleContents
.B PEXRDTTextFontTable
.B PEXRDTTextFontTableContents
.B PEXRDTViewTable
.B PEXRDTViewTableContents
.RE
.fi
.LP
The bits in the name sets bitmask are accessed with the following constants:
.LP
.RS
.nf
.B PEXRDNHighlightNameSet
.B PEXRDNHighlightNameSetContents
.B PEXRDNInvisibilityNameSet
.B PEXRDNInvisibilityNameSetContents
.B PEXRDNPickNameSet
.B PEXRDNPickNameSetContents
.RE
.fi
.LP
The bits in the attributes bitmask are accessed with the following constants:
.LP
.RS
.nf
.B PEXRDAClipList
.B PEXRDAEchoMode
.B PEXRDAHLHSRMode
.B PEXRDANPCSubVolume
.B PEXRDAViewport
.RE
.fi
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified
.I renderer
resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateRenderer (3)
.BR PEXChangeRenderer (3)
.BR PEXBeginRendering (3)
.fi