agentclipsamplelocal

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

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

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

matrix  agentclipsamplelocal(<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[] = agentclipsamplelocal(0, @primnum, "agent1_clip.walk", 1.2);