Filters

From Fracture FX
Revision as of 04:03, 1 August 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

Lets a rigid body trigger the event once, instead of repeatedly. Without it the RB can participate in the event any number of times. The Trigger filter used for one-time edits to properties of an RB. Usage examples would be if you want to add onto the velocity on a single frame. or you want to stop fragments in mid-air. The time filter will let you limit the event to a particular period of time. The duration filter will restrict how long the event can keep executing after the first time it runs (whenever than happens to be). The trigger filter will let things run once. Without any of the aforementioned filters an event will trigger repeatedly.

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


Filter

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


Operator

type enum
default >
indices < : <= : == : != : >= : >
Conditional operator to use on the values.

Data Type

type enum
default float
indices bool,int :float
Data type to set the input fields to.

Truncate

type bool
default False
Truncate both float inputs before comparing. Not available when the data type set to bool,int

object filter

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

Object filter.png


Filter

type enum
default first OR second
indices first : second : first OR second : first AND second
Filter one or both of the colliding pairs.

Operator

type enum
default ==
indices == : !=
Conditional operator to use on the filtered and a connected input object.

Object name

type string
Name of a connected input object. Clicking on the Choose... label will open a popup menu in which a connected input object can be selected.

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


Filter

type enum
default first OR second
indices first : second : first OR second : first AND second
Filter one or both of the colliding pairs.

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


Frame (Operator)

type enum
default >
indices < : <= : == : != : >= : >
Conditional operator to use on the values.

Source

data
value

contact filter

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

Contact filter.png


Impact force operator

type enum
default >
indices < : >
Conditional operator to use on the values.

Impact force threshold

type float
default 1000.0000

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


Filter

type enum
default first OR second
indices first : second : first OR second : first AND second
Filter one or both of the colliding pairs.

Name

type string
Custom data name. This data can be derived from either the Dynamic parameters or Custom data. The Choose... menu displays available data types from connected input nodes and when used will set the data type correctly.

Operator

type enum
default ==
indices < : <= : == : != : >= : >
Conditional operator to use on the values.

Data value

type int, float, string
default 0 (int)
The type of field changes based on the data type.

Data type

type enum
default bool,int
indices vector : vec2(unimplemented) : float : bool,int : color(unimplemented) : string
This data should match the type of data selected. This is not necessary with the data name is set with the Choose... menu.

ground_plane filter

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

Ground plane filter.png


Filter

type enum
default first OR second
indices first : second : first OR second : first AND second
Filter one or both of the colliding pairs for the ground plane.

Is plane

type enum
default true
indices false : true
What the filter condition must evaluate to.

size filter

Size filter.png


Filter

type enum
default first OR second
indices first : second : first OR second : first AND second
Filter one or both of the colliding pairs.

Operator

type enum
default >
indices < : >
Conditional operator to use on the values.

Threshold

type float
default 1.000
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox