.\" @(#)PEXBeginStructure.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXBeginStructure 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXBeginStructure \- Save Rendering Pipeline State
.SH SYNTAX
.HP
void PEXBeginStructure\^(\^Display *\fIdisplay\fP\^, PEXRenderer \fIrenderer\fP\^, long \fIstructure_id\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 a renderer.
.TP
\fIstructure_id\fP
A value to be used as an application-specified structure identifier.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXBeginStructure
.IX "Rendering" "PEXBeginStructure"
.LP
Application programs can use this function to simulate the
effects of the execute structure output command.  This request
saves the rendering pipeline attributes in the specified
.I renderer.
This request also increments the element offset
of the last entry in the renderer's current path.
The function then adds the structure id and an element offset
of zero to the renderer's current path.
.LP
The rendering pipeline's global transform attribute is set to the
matrix computed by concatenating the current local transform
and current global transform matrices.  The local transform
matrix is then set to the identity matrix.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXRenderer;
.fi
.sp
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXEndStructure (3)
.BR PEXExecuteStructure (3)
.BR PEXCreateRenderer (3)
.fi