PEXOCCComputeFillAreaSetShapeHint

Synopsis

 
   int PEXOCCComputeFillAreaSetShapeHint(
       PEXOCC context,
       unsigned int count,
       PEXListOfVertexData *vertex_lists
   )
 

Arguments

context

An OC context returned by a successful PEXCreateOCC call.

vertex_attributes (OCC)

A mask indicating the vertex attributes provided.

color_type (OCC)

The type of color data provided.

surface_vertex_fp_data_count (OCC)

The number of optional floating-point numbers for each vertex.

count

The number of fill areas in the set.

vertex_lists

A pointer to the list of vertex arrays defining each contour of the fill area set. See Facet / Vertex Data Formats.

data_model (OCC)

Specifies the data model used to represent the geometric data.

data_model_specs (OCC)

Offset and size data for the PEXDataStride or PEXDataUnpacked data models.

Returns

Shape hint; one of the following: PEXShapeComplex, PEXShapeNonConvex, PEXShapeConvex, PEXShapeUnknown.

Description

Invoke PEXOCCComputeFillAreaSetShapeHint to compute the shape hint for all fill areas of a fill area set and return it as the function return value.

If this function cannot determine a shape hint because of invalid or degenerate vertex data, the function will return the least optimistic hint, PEXShapeUnknown. If the shape hint for any two fill areas in the set is different, the function returns PEXShapeUnknown. This function does not perform a planarity check, so it returns a hint that may be invalid for non-planar fill area sets. This function does not compute a contour hint.

Errors

None.

See Also

For a list of utilities that compute shape hints, see Computing Shape Hints. For a list of related topics, see PEXlib Utilities.