.\" @(#)PEXPolyline.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXPolyline 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXPolyline - 3D Polyline Primitive
.SH SYNTAX
.HP
void PEXPolyline\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, unsigned int \fIcount\fP\^, PEXCoord *\fIpoints\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIcount\fP 1i
The number of points.
.IP \fIpoints\fP 1i
An array of points defining the polyline.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXPolyline
.IX "Polyline" "PEXPolyline"
.LP
This function creates a polyline output primitive.
.LP
The
.I points,
specified in modeling coordinates,
are joined together by line segments.
The first point is joined to the second, the second to the third,
and so on.  The last point is not joined to the first.
.LP
The polyline colors are affected only by depth-cueing
and are mapped to device colors.  Polylines
are not displayed if they are outside the currently defined
clipping volume.  Polylines crossing the clipping volume are
clipped and only the portions inside the clipping volume
are displayed.
.LP
Depending on the ASF attributes, the line color, line type,
line width, and polyline interpolation method attributes are
obtained either directly from
the current attributes or from the line bundle.
.LP
A polyline with fewer than two points is considered degenerate.
It is stored in a structure, but when rendered, the primitive
is ignored and has no visual effect.
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp .5
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXSetLineType (3)
.BR PEXSetLineWidth (3)
.BR PEXSetLineColorIndex (3)
.BR PEXSetLineColor (3)
.BR PEXSetLineBundleIndex (3)
.fi