Adds blendshape inputs to a shape’s geometry. This sets up the required detail attributes (blendshape_shapenames and blendshape_channels) on the base shape’s geometry. For an existing agent shape, blendshape inputs can also be added using hou.AgentShape.addBlendshapeInputs().

Adds in-between shapes to a blendshape input. This sets up the required detail attributes (blendshape_shapenames and blendshape_inbetweenweights) on the primary shape’s geometry. For an existing agent shape, in-between shapes can also be added using hou.AgentShape.addInBetweenShapes().

Converts transforms from world space to local space using the provided rig.

Converts transforms from local space to world space using the provided rig.

Computes rotation limits for the specified joint based on the range of motion in the provided clips.

The return value is a dictionary with the following keys:

• anchor_pos: A hou.Vector3 containing the cone’s anchor position.

• rotation: A hou.Vector3 containing the cone’s orientation.

• child_rotation: A hou.Vector3 containing the child’s orientation.

• twist_limits: A hou.Vector2 containing the rotation limits for the twist axis.

• up_limits: A hou.Vector2 containing the rotation limits for the up axis.

• out_limits: A hou.Vector2 containing the rotation limits for the out axis.

Returns a list of the unique agent definitions in the geometry.

This is equivalent to the following code, but is significantly faster.

definitions = set()
for prim in geometry.globPrims(group):
    if prim.type() == hou.primType.Agent:
        definitions.add(prim.definition())

return definitions

Finds the shape deformer with the specified name, or None if no such deformer exists.

Replaces agent definitions in the geometry with new versions. This is a useful convenience function when modifying each agent definition in the geometry, particularly when also using hou.crowds.findAgentDefinitions().

For example:

defns = hou.crowds.findAgentDefinitions(geo, group)
new_defn_map = {}
for defn in defns:
    new_defn = defn.freeze()
    new_defn_map[defn] = new_defn

    # Add a clip to the new agent definition.
    new_defn.addClip(...)

# Switch all agents in the group to their respective new agent definition.
hou.crowds.replaceAgentDefinitions(geo, new_defn_map, group)

Adds attributes to the geometry to specify parameters for the blendshapes deformer. This creates the following detail attributes: blendshape_attribs, blendshape_ptidattr, and blendshape_primidattr. For an existing agent shape, the deformer parameters can be set using hou.AgentShape.setBlendshapeDeformerParms().

Returns a list of the available shape deformers.