Cleanup

The main purpose of the cleanup phase is to free the memory resources allocated for your characters during the initialization phase. You should carry out this phase only when you have finished using HumanIK for a character.

For each HIKCharacter you created during the initialization phase, you must call the HIKCharacterDestroy() function.
For each HIKCharacterState you created during the initialization phase, you must call the HIKCharacterStateDestroy() function.
For each HIKPropertySetState you created during the initialization phase, you must call the HIKPropertySetStateDestroy() function.
For each HIKEffectorSetState you created during the initialization phase, you must call the HIKEffectorSetStateDestroy() function.

All of these methods accept two arguments:

A pointer to the object to destroy.
A callback function that will be invoked to free the memory allocated for that object. You can specify the standard free function, or any custom memory de-allocation method that satisfies the same type definition as free. See also HumanIK Objects and Memory Management.

For example:

HIKCharacterDestroy(HIKChar1, &free);
HIKCharacterStateDestroy(HIKChar1State, &free);
HIKPropertySetStateDestroy(HIKChar1PropertyState, &free);
HIKEffectorSetStateDestroy(HIKChar1EffectorState, &free);

As HIKCharacterDefinitions are only needed at initialization time in order to create HIKCharacters, they are typically created on the stack, as shown under Initialization. Therefore, there is no corresponding method to destroy the HIKCharacterDefinition.