Filters

From Fracture FX
Revision as of 03:59, 30 July 2012 by Ed (Talk | contribs)

Jump to: navigation, search

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.

Trigger filter.png


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.

Chance filter.png


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. Dg filter.png

object filter

Tests if a rigid body is derived from a particular input mesh.

Object filter.png

object_set filter

Evaluates to true if a body is derived from an input mesh which is a member of a particular maya set.

Object set filter.png

difference filter

Returns true if the two colliding rigid bodies are from different input meshes.

Difference filter.png

time filter

Returns true if the current time is within a range.

Time filter.png

contact filter

Tests the position, normal or force (in the normal direction) at the contact point between two colliding bodies.

Contact filter.png

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.

Data filter.png

ground_plane filter

Tests if a body is the built-in ground plane.

Ground plane filter.png

size filter

Size filter.png

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox