Upgrade Requirements for HumanIK 2012

This section describes all the changes you must make to your existing code in order to upgrade to each 2012.x release from the previous release.

Note that if you are not upgrading from the release immediately preceding this one, you may also need to follow the steps listed in the upgrade requirements for the intermediate releases.

Version 2012.0.2

No code changes are required in order to upgrade to this release.

However, applications that link against the hikdrawobject library, including the HumanIK samples, now have a compile-time linking dependency on redistributable libraries from Intel.

See Libraries for details.

Version 2012.0.1

No code changes are required in order to upgrade to this release.

Version 2012 (original release)

Changes to HIKCharacter loading

The HIKLoadCharacter() function defined in hikdump.h used to retrieve runtime license credentials automatically from values defined in the autodeskmw.h file. As of this release, this is no longer the case. You must now provide your customer identification string and numeric license key as arguments in your call to HIKLoadCharacter().

Preventing invalid HIKCharacters

The HIKCharacterCreate() and HIKCharacterCreateInPlace() functions will now return a null pointer if initialization of the character fails.

Similarly, HIKCharacterizeGeometry() now returns a Boolean value that indicates whether or not the characterization was successful. This usually indicates a problem with the T-stance.

These changes are intended to avoid the possibility of accidentally using a character that has not been properly initialized and characterized, a situation that typically creates unexpected results that are difficult to debug.

Library directories changed

The switch from the Microsoft Visual Studio compiler to the Intel C++ compiler has resulted in a change in the naming of the directories that contain the HumanIK libraries. You must update your project configuration accordingly.

hikdebugger removed

The hikdebugger tool shipped with previous versions of HumanIK is now considered deprecated, and has been removed from this release. If a visual debugging tool for HumanIK characters would be useful for your development, contact Autodesk Support. You may be able to take advantage of the debugging system used internally by support engineers.