Moving from HumanIK 3.6 to HumanIK 4.0
This section describes the changes that you must make in your existing code to upgrade to version 4.0 of HumanIK.
Licensing
HumanIK now requires you to provide a customer identification string and a license key in order to create an HIKCharacter or to load an HIKCharacter from a file. For detailed information, see Setting Up the HumanIK License Key.
Deprecated functions
The following functions are no longer necessary, and have been removed from HumanIK:
- HIKSolveForCharacterHips()
- HIKCharacterStateFix()
You must remove from your code any calls to these functions.
Changes to function prototypes
In this release of HumanIK, objects of the HIKCharacterState class no longer maintain pointers to their associated HIKCharacters. Therefore, several HumanIK functions that accept HIKCharacterStates as arguments and that previously depended on those internal pointers now require that you provide as an additional argument a pointer to the HIKCharacter for which your HIKCharacterState was created.
The following functions are affected:
- HIKAddQuadripedOffset() HIKSubQuadripedOffset()
- HIKSetCharacterStateTransform() HIKGetCharacterStateTransform()
- HIKSetCharacterStateTransformTQS() HIKGetCharacterStateTransformTQS()
- HIKSetCharacterStateTransformTQ() HIKGetCharacterStateTransformTQ()
- HIKGetCharacterStateTransformQ()
- HIKSetCharacterStateTransformTQS_SoA() HIKGetCharacterStateTransformTQS_SoA()
- HIKSetNodeStatefv() HIKGetNodeStatefv()
- HIKSetNodeStatedv() HIKGetNodeStatedv()
- HIKSetNodeStateTQSfv() HIKGetNodeStateTQSfv()
- HIKSetNodeStateTQSdv() HIKGetNodeStateTQSdv()
- HIKSetNodeStateTQfv() HIKGetNodeStateTQfv()
- HIKSetNodeStateTQSAlignfv() HIKGetNodeStateTQSAlignfv()
- HIKSetNodeStateTQAlignfv() HIKGetNodeStateTQAlignfv()
- HIKSetNodeStateTQNonUniformSfv() HIKGetNodeStateTQNonUniformSfv()
- HIKSetNodeNormalizedStatefv() HIKGetNodeNormalizedStatefv()
- HIKSetNodeNormalizedStatedv() HIKGetNodeNormalizedStatedv()
- HIKSetNodeNormalizedStateTQSfv() HIKGetNodeNormalizedStateTQSfv()
- HIKSetNodeNormalizedStateTQSdv() HIKGetNodeNormalizedStateTQSdv()
- HIKSetNormalizedCharacterStateTransformTQS() HIKGetNormalizedCharacterStateTransformTQS()
- HIKNodeStatePreMultTQSfv()
- HIKNodeStatePreMultTQSdv()
- HIKNodeStatePreMultTQSUpfv()
- HIKNodeStatePreMultTQSUpdv()
- HIKGetCharacterSpaceEffectorStateFromCharacterfv()
- HIKGetCharacterSpaceEffectorStateFromCharacterdv()
- HIKGetCharacterSpaceEffectorStateFromCharacterTQSfv()
- HIKGetCharacterSpaceEffectorStateFromCharacterTQSdv()
If you call any of these functions in your game, you must update your code accordingly.
New non-const arguments
The HIKBlendState() function has been changed to accept only non-const Character States. Its HIKCharacterState * pStateIn1 and HIKCharacterState * pStateIn2 arguments are no longer const.
If you call this function in your game, and you pass as arguments any HIKCharacterState objects that have been declared as const, you must update your code accordingly.
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.