int [] agentlayerbindings(<geometry>geometry, int prim, string layername, string shapetype)
int [] agentlayerbindings(<geometry>geometry, int prim, int layerindex, string shapetype)
Returns an empty array if layername
is not one of the agent’s layers, shapetype
is invalid, prim
is out of range, or prim
is not an agent primitive.
<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.
layername
The name of one of the agent’s layers.
layerindex
Index of a layer in the agent’s definition. A layer’s index can be obtained via agentfindlayer.
shapetype
Whether to inspect "static"
, "deforming"
, or "all"
shapes from the specified layer.
Examples ¶
Find the current world transform of each static shape in the collision layer.
string layer = agentcollisionlayer(0, @primnum); int[] bindings = agentlayerbindings(0, @primnum, layer, "static"); matrix xforms[] = agentworldtransforms(0, @primnum); foreach (int idx; bindings) { matrix xform = xforms[idx]; }
See also | |
crowds | |
layer |