.\" @(#)PEXRenderElements.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXRenderElements 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXRenderElements - Render Elements
.SH SYNTAX
.HP
void PEXRenderElements\^(\^Display *\fIdisplay\fP\^, PEXRenderer \fIrenderer\fP\^, PEXStructure \fIstructure\fP\^, int \fIwhence1\fP\^, long \fIoffset1\fP\^, int \fIwhence2\fP\^, long \fIoffset2\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 a renderer resource.
.IP \fIstructure\fP 1i
The resource identifier of a structure resource.
.IP \fIwhence1\fP 1i
A value specifying, with \fIoffset1\fP, the first limit of the element range
.br
(
.B PEXBeginning,
.B PEXCurrent
.B PEXEnd
).
.IP \fIoffset1\fP 1i
An offset from \fIwhence1\fP specifying the first limit of the element range.
.IP \fIwhence2\fP 1i
A value specifying, with \fIoffset2\fP, the second limit of the element range
.br
(
.B PEXBeginning,
.B PEXCurrent
.B PEXEnd
).
.IP \fIoffset2\fP 1i
An offset from \fIwhence2\fP specifying the second limit of the element range.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXRenderElements
.IX "Rendering" "PEXRenderElements"
.LP
This function processes all output commands in the specified element range
of the specified
.I structure.
Output primitives in
.I structure
are rendered using the specified
.I renderer.
If the
.I renderer
is not rendering or picking, the request will be ignored.
Structures referenced through execute structure
output commands are also processed.
.LP
The first limit of the range is defined by
.I whence1
and
.I offset1
and the second limit of the range is defined by
.I whence2
and
.I offset2.
The whence values describe how to interpret the corresponding offset.
.B PEXBeginning
means the element position is the value of offset (i.e. the offset from the
beginning of the structure).
.B PEXCurrent
means the element position is the value of the current element pointer position
plus the value of offset (i.e. the offset from the current element pointer).
.B PEXEnd
means the element position is the value of the last element position in the
structure plus the value of offset (i.e. the offset from the end of the
structure).
Offsets can be negative values.
If after computing an element position, it
is less than zero, the position will be set to zero.
If after computing an element position, it
is greater than the number of elements in the
.I structure,
it will be set to the last structure element in the
.I structure.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXRenderer;
typedef  XID	PEXStructure;
.fi
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.TP
.SB BadValue
The specified value for \fIwhence\fP was invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXBeginRendering (3)
.BR PEXCreateStructure (3)
.BR PEXCreateRenderer (3)
.fi