.\" @(#)PEXBeginRendering.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXBeginRendering 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXBeginRendering \- Begin Rendering
.SH SYNTAX
.HP
void PEXBeginRendering\^(\^Display *\fIdisplay\fP\^, Drawable \fIdrawable\fP\^,
PEXRenderer \fIrenderer\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
\fIrenderer\fP
The resource identifier of a renderer.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXBeginRendering
.IX "Rendering" "PEXBeginRendering"
.LP
This function initializes the specified
.I renderer
and binds the
specified
.I drawable
to it.  Subsequent output primitive commands
sent to
.I renderer
produce output to the specified drawable.
The renderer's pipeline state is initialized to the values
in its pipeline context, or to default values
if there is no pipeline context.  This function causes the
renderer's renderer state to be set to
.B PEXRendering
and its
current path to be set to <0,0>.  The renderer's
HLHSR mode is used to initialize hidden surface computations.
(For example, the z-buffer is initialized if the HLHSR mode is
set to
.B PEXHLHSRZBuffer
or
.B PEXHLHSRZBufferID.)
.LP
If the renderer's state is
.B PEXRendering
or
.B PEXPicking
when this request is received, an implicit end rendering or picking
request is performed before the begin rendering request is executed.
Output commands received by a renderer are ignored if the state is
not
.B PEXRendering
or
.B PEXPicking.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXRenderer;
.fi
.sp
.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 renderer resource was
not created with a compatible drawable.
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXRendererState
The specified renderer was in an invalid state.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateRenderer (3)
.BR PEXEndRendering (3)
.fi