LiMeshingCallBacksDestroy

FunctionLtStatus
LiMeshingCallBacksDestroy( LtMeshingCallBacks destroy_me
)
Synopsis Destroy the specified meshing callbacks.
Locationligeops
Parameters
destroy_me The meshing callbacks which are to be destroyed.
Return Value An indication of success, error or failure.

Description Allows us to destroy a meshing refinement that has previously been created using either LiMeshingCallBacksCreate or LiMeshingCallBacksCopy. This is so that application programmers are able to manage the memory they take up when they utilise meshing callbacks.

Attempting to destroy a NULL meshing callbacks, will result in failure. Similarly for callbacks that have already been destroyed.

Meshing callbacks make use of a `use count', not visible to the ADS user, which ensures that they are only wiped from memory when they are no longer being used anywhere. So, if a meshing callbacks is created, and attached to 4 meshing refinements, its use count will be 5. When these 4 refinements are destroyed, its use count will drop to 1, at which point we can use LiMeshingCallBacksDestroy to tidy up the allocated memory.

Example
/*
 * Destroy meshing callbacks that I am finished with
 */
status = LiMeshingCallBacksDestroy(calls);
if ( not status )
   /* error */
See Also LiPrimitiveTriangulate
LiPrimitiveHierarchicalTriangulate
LiMeshingCallBacksSetCall
LiMeshingCallBacksGetCall
LiMeshingCallBacksCallState
LiMeshingCallBacksCreate
LiMeshingCallBacksCopy
LiMeshingCallBacksDebug
LiMeshingInsertBridge
LiMeshingEdgeSplit
LiMeshingEdgeSwap
LiMeshingTriProperties

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