.\" @(#)PEXTriangleStrip.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXTriangleStrip 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXTriangleStrip - 3D Triangle Strip Primitive
.SH SYNTAX
.HP
void PEXTriangleStrip\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, unsigned int \fIfacet_attributes\fP\^, unsigned
int \fIvertex_attributes\fP\^, int \fIcolor_type\fP\^, PEXArrayOfFacetData \fIfacet_data\fP\^, unsigned int \fIcount\fP\^, PEXArrayOfVertex \fIvertices\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 \fIfacet_attributes\fP 1i
A mask indicating the facet attributes provided (
.B PEXGANone,
.B PEXGAColor,
.B PEXGANormal
).
.IP \fIvertex_attributes\fP 1i
A mask indicating the vertex attributes provided (
.B PEXGANone,
.B PEXGAColor,
.B PEXGANormal
).
.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 \fIfacet_data\fP 1i
An array of facet data.
.IP \fIcount\fP 1i
The number of vertices.
.IP \fIvertices\fP 1i
An array of vertices defining the triangle strip.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXTriangleStrip
.LP
This function creates a triangle strip output primitive.
.LP
The triangle strip is created from the array of
.I vertices.
There are two less facets in the strip than the number of
.I vertices.
The first triangle in the strip
is formed from the first three
.I vertices
in the list, the second
triangle is formed by the second through the fourth
.I vertices
in
the list, etc., up to the last triangle, which is formed by the
last three
.I vertices
in the list.
There must be an entry in the facet data array for each facet, if facet data
is indicated by the facet attributes.
.LP
Normals are assumed to be unit length vectors.  If not unit length, the
result is implementation-dependent.
.LP
A triangle strip with fewer than
three
.I vertices
is considered degenerate.
It is stored in a structure, but when rendered, the primitive
is ignored and has no visual effect.
.LP
All other aspects of this primitive are the same as
.BR PEXFillAreaWithData (3) .
.SH DATA STRUCTURES
.LP
See
.B PEXlib.h.
.sp
.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 PEXSetInteriorStyle (3)
.BR PEXSetInteriorStyleIndex (3)
.BR PEXSetSurfaceColorIndex (3)
.BR PEXSetSurfaceColor (3)
.BR PEXSetReflectionAttributes (3)
.BR PEXSetReflectionModel (3)
.BR PEXSetSurfaceInterpMethod (3)
.BR PEXSetBFInteriorStyle (3)
.BR PEXSetBFInteriorStyleIndex (3)
.BR PEXSetBFSurfaceColorIndex (3)
.BR PEXSetBFSurfaceColor (3)
.BR PEXSetBFReflectionAttributes (3)
.BR PEXSetBFReflectionModel (3)
.BR PEXSetBFSurfaceInterpMethod (3)
.BR PEXSetFacetCullingMode (3)
.BR PEXSetFacetDistinguishFlag (3)
.BR PEXSetPatternSize (3)
.BR PEXSetPatternAttributes (3)
.BR PEXSetPatternAttributes2D (3)
.BR PEXSetInteriorBundleIndex (3)
.BR PEXSetSurfaceEdgeFlag (3)
.BR PEXSetSurfaceEdgeType (3)
.BR PEXSetSurfaceEdgeWidth (3)
.BR PEXSetSurfaceEdgeColor (3)
.BR PEXSetSurfaceEdgeColorIndex (3)
.BR PEXSetEdgeBundleIndex (3)
.fi