'\" t
.\" @(#)PEXGetRendererAttributes.3 1.6 95/04/06 SMI;
.so man3/pex.macs
.TH PEXGetRendererAttributes 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetRendererAttributes - Get Renderer Attribute Values
.SH SYNTAX
.HP
PEXRendererAttributes *PEXGetRendererAttributes\^(\^Display *\fIdisplay\fP\^, PEXRenderer \fIrenderer\fP\^, unsigned long \fIvalue_mask\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 to be queried.
.IP \fIvalue_mask\fP 1i
A mask indicating attributes to be returned from the renderer.
.SH RETURNS
.LP
A pointer to the renderer attribute values; a null pointer if unsuccessful.
.SH DESCRIPTION
.\" indexing
.IX PEXGetRendererAttributes
.IX "Rendering" "PEXGetRendererAttributes"
.LP
This function returns attribute values from the specified
.I renderer
resource.
The value mask indicates the attribute values to be returned.
The value mask is constructed by OR'ing together the following constants:
.LP
.TS
center;
lfB lfB .
PEXRABackgroundColor	PEXRAInvisibilityIncl
PEXRAClearImage	PEXRALightTable
PEXRAClearZ	PEXRALineBundle
PEXRAClipList	PEXRAMarkerBundle
PEXRAColorApproxTable	PEXRANPCSubVolume
PEXRAColorTable	PEXRAPatternTable
PEXRACurrentPath	PEXRAPickExcl
PEXRADepthCueTable	PEXRAPickIncl
PEXRAEchoMode	PEXRAPickStartPath
PEXRAEdgeBundle	PEXRAPipelineContext
PEXRAHLHSRMode	PEXRARendererState
PEXRAHighlightExcl	PEXRATextBundle
PEXRAHighlightIncl	PEXRATextFontTable
PEXRAInteriorBundle	PEXRAViewTable
PEXRAInvisibilityExcl	PEXRAViewport
.TE
.LP
PEXlib allocates the memory for the returned
.I renderer
attribute values.
.BR PEXFreeRendererAttributes (3)
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXRenderer;
.fi
.sp .5
See also
.B PEXlib.h.
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified
.I renderer
resource identifier is invalid.
.TP
.SB BadValue
An invalid bit is set in the value mask.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateRenderer (3)
.BR PEXChangeRenderer (3)
.BR PEXGetRendererDynamics (3)
.BR PEXFreeRendererAttributes (3)
.fi