.\" @(#)PEXChangeRenderer.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXChangeRenderer 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXChangeRenderer \- Change Renderer Attributes
.SH SYNTAX
.HP
void PEXChangeRenderer\^(\^Display *\fIdisplay\fP\^, PEXRenderer \fIrenderer\fP\^, unsigned long \fIvalue_mask\fP\^, PEXRendererAttributes *\fIvalues\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
\fIrenderer\fP
The resource identifier of the renderer.
.TP
\fIvalue_mask\fP
A mask indicating the renderer attributes to be changed.
.TP
\fIvalues\fP
A pointer to new values for the renderer attributes.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXChangeRenderer
.IX "Rendering" "PEXChangeRenderer"
.LP
This function modifies attributes of the specified
.I renderer
resource.
The value mask indicates the attribute
.I values
to be modified.
The value mask is constructed by OR'ing together the following constants:
.\"@
.\" start equation_nroff_version
.if t .ig xx
.sp
.nf
PEXRABackgroundColor    PEXRAInvisibilityIncl
PEXRAClearImage         PEXRALightTable
PEXRAClearZ             PEXRALineBundle
PEXRAClipList           PEXRAMarkerBundle
PEXRAColorApproxTable   PEXRANPCSubVolume
PEXRAColorTable         PEXRAPatternTable
PEXRADepthCueTable      PEXRAPickExcl
PEXRAEchoMode           PEXRAPickIncl
PEXRAEdgeBundle         PEXRAPickStartPath
PEXRAHLHSRMode          PEXRAPipelineContext
PEXRAHighlightExcl      PEXRATextBundle
PEXRAHighlightIncl      PEXRATextFontTable
PEXRAInteriorBundle     PEXRAViewTable
PEXRAInvisibilityExcl   PEXRAViewport
.fi
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.sp .5
.TS
center;
lfB lfB.
PEXRABackgroundColor	PEXRAInvisibilityIncl
PEXRAClearImage	PEXRALightTable
PEXRAClearZ	PEXRALineBundle
PEXRAClipList	PEXRAMarkerBundle
PEXRAColorApproxTable	PEXRANPCSubVolume
PEXRAColorTable	PEXRAPatternTable
PEXRADepthCueTable	PEXRAPickExcl
PEXRAEchoMode	PEXRAPickIncl
PEXRAEdgeBundle	PEXRAPickStartPath
PEXRAHLHSRMode	PEXRAPipelineContext
PEXRAHighlightExcl	PEXRATextBundle
PEXRAHighlightIncl	PEXRATextFontTable
PEXRAInteriorBundle	PEXRAViewTable
PEXRAInvisibilityExcl	PEXRAViewport
.TE
.yy
.LP
Note that the renderer's current path and renderer state
attributes cannot be set explicitly using this function.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXRenderer;
.fi
.sp .5
See also
.B PEXlib.h.
.SH ERRORS
.TP
.SB BadMatch
The specified lookup table resource was not created with a drawable compatible
with the drawable used to create the renderer resource.
.TP
.SB BadPEXLookupTable
The specified lookup table resource identifier is invalid.
.TP
.SB BadPEXNameSet
The specified name set resource identifier is invalid.
.TP
.SB BadPEXPipelineContext
The specified pipeline context resource identifier is invalid.
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadValue
A specified value is out of range, or an invalid bit is set in the value mask.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateRenderer (3)
.BR PEXGetRendererAttributes (3)
.BR PEXGetRendererDynamics (3)
.fi