Filters
Filters are logical tests applied to one or both of the rigid bodies in a colliding pair, used to describe conditions that must be satisied in order for a collision event to be triggered. All filters must evaluate to true for the event to be triggered and the script to execute.
Contents |
trigger filter
Allow a rigid body to participate in this event either repeatedly or only once.
Allow
type | enum |
---|---|
default | repeated |
indices | once : repeated |
Limit the number of times this event may be triggered for each object. Requires the script to set "trigger:"+$thisPlug. |
chance filter
Returns true a certain percentage of the time.
Filter which
type | enum |
---|---|
default | first OR second |
indices | first : second : first OR second : first AND second |
Since the ground plane never passed this filter it normally appropriate to leave this attribute at its default. |
Probability of true
type | float |
---|---|
default | 0.5 |
min | 0.0 |
max | 1.0 |
Chance for each fragment passing through the filter to evaluate to True. A value of 1.0 will mean all fragments will evaluate True and a value of 0.0 would mean none of the fragments would evaluate to True. |
Seed
type | int |
---|---|
default | 0 |
Changing the seed would vary the fragments that test True. |
DG filter
Compares the values of custom data on both colliding bodies.
Operator
Data Type
Truncate
object filter
Tests if a rigid body is derived from a particular input mesh.
object_set filter
Evaluates to true if a body is derived from an input mesh which is a member of a particular maya set.
difference filter
Returns true if the two colliding rigid bodies are from different input meshes.
time filter
Returns true if the current time is within a range.
contact filter
Tests the position, normal or force (in the normal direction) at the contact point between two colliding bodies.
data filter
Compares the value of custom data attached to a body, with some constant value. The test may be applied to the first or second body, either (logical OR), or both (logical AND). If the body doesn't have the data attached, the filter evaluates to false.
ground_plane filter
Tests if a body is the built-in ground plane.