.\" @(#)PEXCreateRenderer.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCreateRenderer 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCreateRenderer \- Create Renderer
.SH SYNTAX
.LP
PEXRenderer PEXCreateRenderer\^(\^Display *\fIdisplay\fP\^, Drawable \fIdrawable\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
\fIdrawable\fP
The resource identifier of a drawable.
.TP
\fIvalue_mask\fP
A mask indicating the attribute values specified.
.TP
\fIvalues\fP
A pointer to values used to override default values in the new renderer
resource.
.SH RETURNS
The resource identifier of the newly-created renderer resource.
.SH DESCRIPTION
.\" indexing
.IX PEXCreateRenderer
.LP
This function creates a renderer and returns the resource identifier of the
newly-created renderer resource.
The value mask indicates which attribute values are specified.
Attribute values not specified will be initialized to the default
values shown in the table below.
.\"@
.\" start equation_nroff_version
.if t .ig xx
.sp
.nf
PEXRAPipelineContext    NULL
PEXRAMarkerBundle       NULL
PEXRATextBundle         NULL
PEXRALineBundle         NULL
PEXRAInteriorBundle     NULL
PEXRAEdgeBundle         NULL
PEXRAViewTable          NULL
PEXRAColorTable         NULL
PEXRADepthCueTable      NULL
PEXRALightTable         NULL
PEXRAColorApproxTable   NULL
PEXRAPatternTable       NULL
PEXRATextFontTable      NULL
PEXRAHighlightIncl      NULL
PEXRAHighlightExcl      NULL
PEXRAInvisibilityIncl   NULL
PEXRAInvisibilityExcl   NULL
PEXRAHLHSRMode          PEXHLHSROff
PEXRANPCSubVolume       {(0.0, 0.0, 0.0), (1.0, 1.0, 1.0)}
PEXRAViewport           {imp.dep., imp.dep., True}
PEXRAClipList           NULL
PEXRAPickIncl           NULL
PEXRAPickExcl           NULL
PEXRAPickStartPath      NULL
PEXRABackgroundColor    {PEXColortypeIndexed, 0}
PEXRAClearImage         False
PEXRAClearZ             True
PEXRAEchoMode           PEXNoEcho
.fi
.xx
.\"@
.\" start equation_troff_version
.if n .ig yy
.sp
.TS H
center, box;
lfB lfB
l l.
Attribute Name	Default Value
_
.TH
PEXRAPipelineContext	NULL
PEXRAMarkerBundle	NULL
PEXRATextBundle	NULL
PEXRALineBundle	NULL
PEXRAInteriorBundle	NULL
PEXRAEdgeBundle	NULL
PEXRAViewTable	NULL
PEXRAColorTable	NULL
PEXRADepthCueTable	NULL
PEXRALightTable	NULL
PEXRAColorApproxTable	NULL
PEXRAPatternTable	NULL
PEXRATextFontTable	NULL
PEXRAHighlightIncl	NULL
PEXRAHighlightExcl	NULL
PEXRAInvisibilityIncl	NULL
PEXRAInvisibilityExcl	NULL
PEXRAHLHSRMode	PEXHLHSROff
PEXRANPCSubVolume	{(0.0, 0.0, 0.0), (1.0, 1.0, 1.0)}
PEXRAViewport	{imp.dep., imp.dep., True}
PEXRAClipList	NULL
PEXRAPickIncl	NULL
PEXRAPickExcl	NULL
PEXRAPickStartPath	NULL
PEXRABackgroundColor	{PEXColortypeIndexed, 0}
PEXRAClearImage	False
PEXRAClearZ	True
PEXRAEchoMode	PEXNoEcho
.TE
.yy
.LP
The renderer resource may only be used in conjunction
with drawables that have the same root and depth as specified drawable.
.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 BadAlloc
The server failed to allocate the resource.
.TP
.SB BadDrawable
The specified drawable resource identifier is invalid.
.TP
.SB BadMatch
The specified drawable is unsupported, or the specified lookup table resource
was not created with a drawable compatible with the specified drawable.
.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 PEXFreeRenderer (3)
.fi