PEXOCCComputeQuadrilateralMeshShapeHint

Synopsis

 
   int PEXOCCComputeQuadrilateralMeshShapeHint(
       PEXOCC context,
       unsigned int col_count,
       unsigned int row_count,
       PEXPointer vertex_data
   )
 

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.

col_count

The number of columns in the vertex array.

row_count

The number of rows in the vertex array.

vertex_data

A pointer a the vertex data which is interpreted as a two-dimensional (row-major) array defining the quadrilateral mesh. 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 PEXOCCComputeQuadrilateralMeshShapeHint to compute the shape hint for all quads of a quadrilateral mesh 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 quads in the mesh 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.

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.