Function: LiMeshingRefinementSetCriterion

LiMeshingRefinementSetCriterion

Function

LtStatus

LiMeshingRefinementSetCriterion(	`LtMeshingRefinement`	meshref
	`LtMeshingCriterion`	crit
	`LtData *`	data
	)

Synopsis Associate a value with the given meshing criterion, of the given meshing refinement.

Location ligeops

Parameters

`meshref`	The meshing refinement of interest.
`crit`	An ID which specifies the meshing criterion that is being set.
`data`	The address of the LtData which is holding the user's value.

Return Value

An indication of success, failure or error. This will return LI_STATUS_OK, unless a NULL refinement, an unknown criterion, or other invalid data, is supplied.

Description

Setting a meshing criterion to a particular value, will ensure that this value is used whenever LiPrimitiveTriangulate is dealing with a primitive that has this refinement attached to it. LiMeshingRefinementSetCriterion allows the user to accomplish this.

Possible meshing criteria are:

All names should be prefixed `LI_MESH_CRIT_`

Name	Comment
`METHOD`	How should I triangulate?
`POLY_COUNT`	How many triangles should I generate?
`MAX_EDGE_LENGTH`	Ideal triangle edge length.
`MAX_EDGE_VERTS`	Should I split long edges before triangulation?
`EDGE_SWAPPING`	Must I preserve input edges?
`CALLBACKS`	For advanced users.

Members of the enumerated type LtMeshingCriterion

Example

/*
 * Allow edge swapping, for this refinement
 */
data = LiDataCreate();
LiDataSetEnum(data, LI_EDGE_SWAP_ALL);
status = LiMeshingRefinementSetCriterion(ref, LI_MESH_CRIT_EDGE_SWAPPING, data);
if ( status )
   /* ERROR */

See Also LiPrimitiveTriangulate
LiPrimitiveHierarchicalTriangulate
LiMeshingRefinementUnSetCriterion
LiMeshingRefinementCriterionState
LiMeshingRefinementGetCriterion
LiPrimitiveSetMeshingRefinement
LiPrimitiveGetMeshingRefinement
LiMeshingRefinementCreate
LiMeshingRefinementCopy
LiMeshingRefinementDebug
LiMeshingRefinementDestroy