.\" @(#)PEXPolylineSetWithData.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXPolylineSetWithData 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXPolylineSetWithData - 3D Set of Polylines Primitive
.SH SYNTAX
.HP
void PEXPolylineSetWithData\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, unsigned int \fIvertex_attributes\fP\^, int \fIcolor_type\fP\^, unsigned int \fIcount\fP\^, PEXListOfVertex *\fIvertex_lists\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 \fIvertex_attributes\fP 1i
A mask indicating the vertex attributes provided (
.B PEXGANone
or
.B PEXGAColor
).
.IP \fIcolor_type\fP 1i
The type of color data provided (
.B PEXColorTypeIndexed,
.B PEXColorTypeRGB,
.B PEXColorTypeCIE,
.B PEXColorTypeHSV,
.B PEXColorTypeHLS,
.B PEXColorTypeRGB8,
.B PEXColorTypeRGB16
).
.IP \fIcount\fP 1i
The number of polylines.
.IP \fIvertex_lists\fP 1i
A pointer to a list of vertex arrays defining each polyline in the set.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXPolylineSetWithData
.IX "Polyline" "PEXPolylineSetWithData"
.LP
This function creates a polyline set output primitive.
.LP
This function is similar to
.BR PEXPolyline (3)
except that it allows
applications to specify a number of polylines as well as additional data.
These polylines may contain a color value at each vertex.
The vertex attributes indicate the content of the additional data.
Color values passed must be of the specified color type.
.LP
If colors are passed for each vertex, they are used instead of
the line color attribute.
The polyline interpolation method, which depending on the ASF attribute is
obtained directly from the current polyline interpolation attribute or from
the line bundle, controls how the polylines are shaded.
.LP
All other aspects of this primitive are the same as
.BR PEXPolyline (3) .
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp .5
.SH ERRORS
.TP
.SB BadPEXOutputCommand
The output command contains an invalid value.
.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 PEXSetPolylineInterpMethod (3)
.BR PEXSetLineBundleIndex (3)
.fi