19.0: Major Changes In The HDK

Table of Contents

• GU_Agent
• UT_Task and TBB
• UTisdigit() removed use SYSisdigit()

GU_Agent

GU_Agent now stores a list of current layers and collision layers. Previously, only a single current / collision layer could be assigned to the agent.

Several methods have been deprecated and replaced by new versions that provide access to the entire list of layers:

• GU_Agent::getCurrentLayer() should be replaced with GU_Agent::getCurrentLayers().
• GU_Agent::setCurrentLayer() should be replaced with GU_Agent::setCurrentLayers().
• GU_Agent::getCollisionLayer() should be replaced with GU_Agent::getCollisionLayers().
• GU_Agent::setCollisionLayer() should be replaced with GU_Agent::setCollisionLayers().

GU_AgentLayer now stores a non-uniform scale for the shape bindings. The GU_AgentLayer::construct() signatures that use a uniform scale value are deprecated.

UT_Task and TBB

Houdini now uses TBB 2020 and will be upgrading to oneTBB versions in the future that have deprecated APIs removed. Therefore, the wrapper for tbb::task, UT_Task has been deprecated and will be removed when the upgrading to oneTBB. For general migration help, please see the oneTBB migration documentation.

To replace the use of UT_Task, use UT_TaskGroup for running tasks that need to be waited upon. For tasks that do not need to be waited upon, use the static method UT_TaskArena::enqueue() .

To cancel within tasks (eg. inside UTparallelFor() functors), calls to tbb::task::self().cancel_group_execution() should be replaced with calls to UTparallelCancelGroupExection() .

UTisdigit() removed use SYSisdigit()

The UTisdigit() method has been removed, please use SYSdigit() instead which has been its replacement for awhile now.