.\" @(#)PEXQuadrilateralMesh.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXQuadrilateralMesh 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXQuadrilateralMesh - 3D Quadrilateral Mesh Primitive
.SH SYNTAX
.HP
void PEXQuadrilateralMesh\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIshape_hint\fP\^, unsigned int \fIfacet_attributes\fP\^, unsigned int \fIvertex_attributes\fP\^, int \fIcolor_type\fP\^, PEXArrayOfFacetData \fIfacet_data\fP\^, unsigned int \fIcol_count\fP\^, unsigned int \fIrow_count\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 \fIshape_hint\fP 1i
The shape which describes all of the quadrilaterals (
.B PEXShapeComplex,
.B PEXShapeNonConvex,
.B PEXShapeConvex,
.B PEXShapeUnknown
).
.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 \fIcol_count\fP 1i
The number of columns in the vertex array.
.IP \fIrow_count\fP 1i
The number of rows in the vertex array.
.IP \fIvertices\fP 1i
A two-dimensional (row-major) array of vertices defining the quadrilateral mesh.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXQuadrilateralMesh
.LP
This function creates a quadrilateral mesh output primitive.
.LP
The quadrilateral mesh surface is created from the vertices.
The vertex array is accessed in row major order (i.e. the column
number varies fastest as vertices are accessed).
The (ith, jth), (i+1th, jth), (i+1th, j+1th), and (ith, j+1th)
vertices are connected to create a single facet.  Adjacent vertices
are interconnected until the entire facet network is processed.
.LP
Normals for quadrilaterals, if not provided explicitly, are computed by taking
the cross product of the diagonals.  For a quadrilateral with the above
vertices, the cross product would be formed as follows:
.IP
normal(i,j) = (point(i+1, j+1) - point(i, j)) X (point(i, j+1) - point(i+1, j))
.LP
Normals are assumed to be unit length vectors.  If not unit length, the
result is implementation-dependent.
.LP
There must be an entry in the facet data array for each facet, if facet data
is indicated by the facet attributes.
.LP
All other aspects of this primitive are the same as
.BR PEXFillAreaSetWithData (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 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