.\" @(#)PEXEndStructure.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXEndStructure 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXEndStructure - Restore Rendering Pipeline State
.SH SYNTAX
.HP
void PEXEndStructure\^(\^Display *\fIdisplay\fP\^, PEXRenderer \fIrenderer\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.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXEndStructure
.IX "Rendering" "PEXEndStructure"
.LP
Application programs can use this function to simulate the side effects
of the return from an "execute structure" output command.  This request
restores the last-saved rendering pipeline attributes in
.I renderer.
This request also removes the last element reference in the renderer's
current path.  Subsequent output commands cause the element
offset of the element reference at the end of the list to be
incremented.
.SH ERRORS
.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 PEXBeginStructure (3)
.BR PEXExecuteStructure (3)
.BR PEXCreateRenderer (3)
.fi