LiMeshingRefinementUnSetCriterion

FunctionLtStatus
LiMeshingRefinementUnSetCriterion( LtMeshingRefinement meshref
LtMeshingCriterion crit
)
Synopsis Ensure that for the given refinement, the given criterion is not set.
Locationligeops
Parameters
meshref The meshing refinement of interest.
crit An ID which specifies the meshing criterion that is being unset.
Return Value An indication of success, failure or error. This will return LI_STATUS_OK, unless a NULL refinement, or an unknown criterion, 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 the relevant refinement attached. If we subsequently wish to alter this situation, so that the relevant global value is picked up instead, we could simply set the criterion to be equal to the global value. However, when this global value changes, the local value will not.

If we wish to undo our first action, and ensure that the global value is always used by this refinement, then we call LiMeshingRefinementUnSetCriterion. Essentially, the function tells the refinement that the value corresponding to the specified criterion, should be found by examining LI_CONTROL_MESHING_REFINEMENT , and not by taking note of any value which has been stored with the refinement, via LiMeshingRefinementSetCriterion.

Example
/*
 * Use global triangulation method, for this refinement
 */
status = 
   LiMeshingRefinementUnSetCriterion(ref, 
                                     LI_MESH_CRIT_METHOD);
if ( status )
   /* ERROR */
See Also LiPrimitiveTriangulate
LiPrimitiveHierarchicalTriangulate
LiMeshingRefinementSetCriterion
LiMeshingRefinementGetCriterion
LiMeshingRefinementCriterionState
LiPrimitiveSetMeshingRefinement
LiPrimitiveGetMeshingRefinement
LiMeshingRefinementCreate
LiMeshingRefinementCopy
LiMeshingRefinementDebug
LiMeshingRefinementDestroy

Copyright © 1990-1998, 1999 LightWork Design Limited. All rights reserved