Filters

From Fracture FX
(Difference between revisions)
Jump to: navigation, search
(object_set filter)
(data filter)
Line 217: Line 217:
  
 
[[File:Data filter.png]]
 
[[File:Data filter.png]]
 +
 +
 +
==== Filter ====
 +
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| enum
 +
|-
 +
! scope="row" width="75" | default
 +
| first OR second
 +
|-
 +
! scope="row" width="75" | indices
 +
| first : second : first OR second : first AND second
 +
|-
 +
! scope="row" width="75" |
 +
| Filter one or both of the colliding pairs.
 +
|}
  
 
= ground_plane filter =
 
= ground_plane filter =

Revision as of 04:53, 31 July 2012

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


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

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


Filter

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

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