.\" @(#)PEXFillAreaWithData.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXFillAreaWithData 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXFillAreaWithData - 3D Fill Area Primitive With Additional Data
.SH SYNTAX
.HP
void PEXFillAreaWithData\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^,
PEXOCRequestType \fIreq_type\fP\^, int \fIshape_hint\fP\^, int \fIignore_edges\fP\^, unsigned int \fIfacet_attributes\fP\^, unsigned int \fIvertex_attributes\fP\^, int \fIcolor_type\fP\^, PEXFacetData *\fIfacet_data\fP\^, unsigned int \fIcount\fP\^, PEXArrayOfVertex \fIvertices\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 of the fill area (
.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 \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
A pointer to facet data.
.IP \fIcount\fP 1i
The number of vertices.
.IP \fIvertices\fP 1i
An array of vertices defining the fill area.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXFillAreaWithData
.IX "Fill Area" PEXFillAreaWithData
.LP
This function creates a fill area output primitive.
.LP
This function is like
.BR PEXFillArea (3)
except that it allows
additional information to be specified for the fill area and for each vertex.
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, or a color followed by a normal for each vertex.
Use the constants
.B PEXGANone,
.B PEXGAColor
and
.B PEXGANormal
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.
.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 PEXFillArea (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