agentclipsampleworld

matrix [] agentclipsampleworld(<geometry>geometry, int prim, string clipname, float time)

matrix [] agentclipsampleworld(<geometry>geometry, int prim, int clipindex, float time)

matrix  agentclipsampleworld(<geometry>geometry, int prim, string clipname, float time, int transform)

matrix  agentclipsampleworld(<geometry>geometry, int prim, int clipindex, float time, int transform)

在给定时间评估动画片段，并返回代理骨骼的世界变换矩阵。 如果clipname不是代理的动画片段之一，prim超出范围，prim不是代理图元，或者transform超出范围，则返回空数组。 对于采样单个变换，matrix签名比matrix[]签名更高效。

<geometry>

在节点上下文（如wrangle SOP）中运行时，此参数可以是表示输入编号（从0开始）的整数，用于读取几何体。

或者，该参数可以是指定要读取的几何文件（例如.bgeo）的字符串。在Houdini内部运行时，可以是op:/path/to/sop引用。

prim

图元编号。

clipname

动画片段的名称。

clipindex

代理定义中片段的索引。 可以通过agentfindclip获取片段的索引。

time

评估片段的时间（以秒为单位）。如果该时间超过片段长度，将会循环播放。

transform

代理骨骼中变换的索引。

示例

采样行走片段在1.2秒后的世界变换矩阵。

matrix xforms[] = agentclipsampleworld(0, @primnum, "agent1_clip.walk", 1.2);