PEXFillAreaSet2D - 2D Set of Fill Areas Primitive (5.0)


Note: This function has been superseded by the PEXOCCFillAreaSet function, but is maintained here for backwards compatibility with PEXlib 5.1

Synopsis

 
     void PEXFillAreaSet2D(
          Display *display,
          XID resource_id,
          PEXOCRequestType req_type,
          int shape_hint,
          int ignore_edges,
          int contour_hint,
          unsigned int count,
          PEXListOfCoord2D *point_lists
     )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id
The resource identifier of the renderer or structure.

req_type
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

shape_hint
The shape which describes all of the contours (PEXShapeComplex, PEXShapeNonConvex, PEXShapeConvex or PEXShapeUnknown).

ignore_edges
A flag that determines if surface edges are rendered (True or False).

contour_hint
A flag that indicates whether contours are disjoint or overlapping (PEXContourDisjoint, PEXContourNested, PEXContourIntersecting or PEXContourUnknown).

count
The number of fill areas in the set.

point_lists
A pointer to the list of vertex arrays defining each contour of the fill area set.

Returns

None.

Description

Invoke PEXFillAreaSet2D to create a two-dimensional fill area set output primitive.

This primitive is similar to the PEXFillAreaSet primitive, except that you only need to specify x- and y-components for the vertices. The z-component is always assumed to be zero. This primitive is two-dimensional only in that the z-components are implied. PEXlib carries out the geometry transformations in three dimensions.

Errors

BadPEXOutputCommand
The output command contains an invalid value.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview, see Output Command Functions.