.\" @(#)PEXFillAreaSet.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXFillAreaSet 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXFillAreaSet - 3D Set of Fill Areas Primitive
.SH SYNTAX
.HP
void PEXFillAreaSet\^(\^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 \fIcount\fP\^, PEXListOfCoord *\fIpoint_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 (
.B PEXContourDisjoint,
.B PEXContourNested,
.B PEXContourIntersecting,
.B PEXContourUnknown
).
.IP \fIcount\fP 1i
The number of fill areas in the set.
.IP \fIpoint_lists\fP 1i
A pointer to the list of point arrays defining each contour of the
fill area set.
.SH RETURNS
None
.SH DESCRIPTION
.\" indexing
.IX PEXFillAreaSet
.IX "Fill Area" PEXFillAreaSet
.LP
This function creates a fill area set output primitive.
.LP
This function is similar to
.BR PEXFillArea (3) ,
but allows for the creation
of areas with
.I islands
or
.I holes.
.LP
If any fill area in the set has fewer than three vertices, or if there are
no contours defined, the primitive is considered degenerate.
The primitive is stored in a structure, but when rendered, the primitive
is ignored and has no visual effect.
.LP
A fill area set consists of an array of fill areas
that define "contours" (disjoint pieces or holes) making up
the primitive.  Each fill area, or contour, is defined by
a list of vertices joined together to form a planar surface.
.LP
The contour hint provides further information about the
relationships between contours in the fill area set.
If the contour hint is
.B PEXContourDisjoint,
all contours will be spatially disjoint.  No overlapping
or intersection occurs between any contours in the fill area set.  If
the contour hint is
.B PEXContourNested,
contours will either be disjoint or
wholly contained within another contour.  No contour will have edges
that intersect or are coincident with edges of any other contour.  If
the contour hint is
.B PEXContourIntersecting,
separated contours may have edges
that are coincident or overlap.  If the contour hint is
.B PEXContourUnknown
nothing is known about the interrelationships between contours.  Fill
area sets with contours that have higher complexity interrelationships
than that indicated by the contour hint are rendered in an
implementation-dependent manner.
.LP
The ignore edges flag is applied to each of the fill areas in the set.
.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