.\" @(#)PEXFillAreaSetWithData.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXFillAreaSetWithData 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXFillAreaSetWithData - 3D Set of Fill Areas Primitive With Additional Data
.SH SYNTAX
.HP
void PEXFillAreaSetWithData\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, int \fIshape_hint\fP\^, int \fIignore_edges\fP\^, int \fIcontour_hint\fP\^, unsigned int \fIfacet_attributes\fP\^, unsigned int \fIvertex_attributes\fP\^, int \fIcolor_type\fP\^, unsigned int \fIcount\fP\^, PEXFacetData *\fIfacet_data\fP\^, PEXListOfVertex *\fIvertex_lists\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
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 contours (
.B PEXShapeComplex,
.B PEXShapeNonConvex,
.B PEXShapeConvex,
.B PEXShapeUnknown
).
.IP \fIignore_edges\fP 1i
A flag that determines if surface edges are rendered (
.B True
or
.B False
).
.IP \fIcontour_hint\fP 1i
A flag that indicates whether contours are disjoint or overlapping
.br
.B ( PEXContourDisjoint,
.B PEXContourNested,
.B PEXContourIntersecting,
.B PEXContourUnknown
).
.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,
.B PEXGAEdges
).
.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 fill areas in the set.
.IP \fIfacet_data\fP 1i
A pointer to facet data.
.IP \fIvertex_lists\fP 1i
A pointer to the list of vertex arrays defining each contour of the
fill area set.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXFillAreaSetWithData
.IX "Fill Area" PEXFillAreaSetWithData
.LP
This function creates a fill area set output primitive.
.LP
This function is like
.BR PEXFillAreaSet (3)
except that it allows
additional information to be specified for each fill area and for each vertex.
It is similar to
.BR PEXFillAreaWithData (3)
but allows for the creation
of areas with 
.I islands
or
.I holes.
Color values passed must be of the specified color type.
.LP
The facet attributes indicate the content of the facet data.
This data may be a color, a normal, or a color followed by a normal.
Use the constants
.B PEXGANone,
.B PEXGAColor
and
.B PEXGANormal
to construct a mask indicating the data provided.
If specified, the
facet color takes precedence over the
surface color.
If specified, the facet normal is used to
determine whether the fill area is back-facing.
.LP
The vertex attributes indicate the content of each fill area vertex.
In addition to the coordinate (x,y,z), applications may specify
a color, a normal, an edge flag, or any combination of the three specified in
the order given.
Use the constants
.B PEXGANone,
.B PEXGAColor,
.B PEXGANormal
and
.B PEXGAEdges
to construct a mask indicating the data provided.
If specified, vertex colors will override facet color or the current
surface color.
If specified, vertex normals are taken to be normals at the vertices of
the fill area.
.LP
The reflection model and the surface interpolation will
affect how the additional data is used in rendering the surface.
Edge controls are used to indicate those edges rendered if the surface edges
are enabled.  The edge control for vertex i indicates whether or
not to render the edge between vertex i and vertex i+1.
Surface edges are always rendered with the surface edge color and are not
affected by the facet or vertex colors.
.LP
Normals are assumed to be unit length vectors.  The effect if the normal
is not unit length is implementation-dependent.
.LP
All other aspects of this primitive are the same as
.BR PEXFillAreaSet (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