matrix [] agentcliplayersampleworld(<geometry>geometry, int prim, string clip_names[], float clip_times[], float clip_weights[], string clip_transform_groups[], int clip_layer_ids[], int layer_blend_modes[], float layer_weights[], int layer_parent_ids[])
matrix [] agentcliplayersampleworld(<geometry>geometry, int prim, int clip_ids[], float clip_times[], float clip_weights[], int clip_transform_group_ids[], int clip_layer_ids[], int layer_blend_modes[], float layer_weights[], int layer_parent_ids[])
matrix agentcliplayersampleworld(<geometry>geometry, int prim, int transform, string clip_names[], float clip_times[], float clip_weights[], string clip_transform_groups[], int clip_layer_ids[], int layer_blend_modes[], float layer_weights[], int layer_parent_ids[])
matrix agentcliplayersampleworld(<geometry>geometry, int prim, int transform, int clip_ids[], float clip_times[], float clip_weights[], int clip_transform_group_ids[], int clip_layer_ids[], int layer_blend_modes[], float layer_weights[], int layer_parent_ids[])
Evaluates a set of layered animation clips and returns the blended world transforms.
Returns an empty array if prim is out of range, prim is not an agent primitive, or the layered animation clips describe an invalid hierarchy.
The matrix signature is more efficient than the matrix[] signature for sampling a single transform.
<geometry>
When running in the context of a node (such as a wrangle SOP), this argument can be an integer representing the input number (starting at 0) to read the geometry from.
Alternatively, the argument can be a string specifying a geometry file (for example, a .bgeo) to read from. When running inside Houdini, this can be an op:/path/to/sop reference.
prim
The primitive number.
transform
Index of a transform in the agent’s rig to sample.
clip_names
A list of animation clip names.
clip_ids
A list of animation clip indices in the agent definition. A clip’s index can be obtained via agentfindclip.
clip_times
A list of times that the clips should be sampled at.
clip_weights
A list of blend weights for the animation clips.
clip_transform_groups
A list of transform groups, which specify the joints that each clip should be applied to.
clip_transform_group_ids
A list of transform group indices in the agent definition. A transform group’s index can be obtained via agentfindtransformgroup.
clip_layer_ids
A list containing the layer that each animation clip is an input for.
layer_blend_modes
A list of blend modes for each layer. The available blend modes are defined in $HH/vex/include/crowd_cliplayers.h.
layer_weights
A list of blend weights for each layer. The blend weight is not used for the topmost layer.
layer_parent_ids
A list containing the parent layer for each layer (or -1 for the topmost layer). This specifies a tree of animation layers.
| See also | |
| clip |
|
| crowds |