Filters
(→data filter) |
(→data filter) |
||
Line 252: | Line 252: | ||
|} | |} | ||
− | ==== | + | ==== Name ==== |
+ | {| class="wikitable" style="width: 100%" | ||
+ | |- | ||
+ | ! scope="row" width="75" | type | ||
+ | | string | ||
+ | |- | ||
+ | ! scope="row" width="75" | | ||
+ | | Custom data name. This data can be derived from either the [[Dynamics_parameters|Dynamic parameters]] or [[Custom_data|Custom data]]. The '''Choose...''' menu displays available data types from connected input nodes and when used will set the data type correctly. | ||
+ | |} | ||
+ | |||
+ | ==== Operator ==== | ||
{| class="wikitable" style="width: 100%" | {| class="wikitable" style="width: 100%" | ||
|- | |- | ||
Line 259: | Line 269: | ||
|- | |- | ||
! scope="row" width="75" | default | ! scope="row" width="75" | default | ||
− | | | + | | == |
|- | |- | ||
! scope="row" width="75" | indices | ! scope="row" width="75" | indices | ||
− | | | + | | < : <= : == : != : >= : > |
|- | |- | ||
! scope="row" width="75" | | ! scope="row" width="75" | | ||
− | | | + | | Conditional operator to use on the values. |
|} | |} | ||
− | ==== | + | ==== Data type ==== |
{| class="wikitable" style="width: 100%" | {| class="wikitable" style="width: 100%" | ||
|- | |- | ||
! scope="row" width="75" | type | ! scope="row" width="75" | type | ||
− | | string | + | | enum |
+ | |- | ||
+ | ! scope="row" width="75" | default | ||
+ | | bool,int | ||
+ | |- | ||
+ | ! scope="row" width="75" | indices | ||
+ | | vector : vec2(unimplemented) : float : bool,int : color(unimplemented) : string | ||
|- | |- | ||
! scope="row" width="75" | | ! scope="row" width="75" | | ||
− | | | + | | This data should match the type of data selected. This is not necessary with the data name is set with the '''Choose...''' menu. |
|} | |} | ||
Revision as of 05:15, 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.
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
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
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.
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.
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.
time filter
Returns true if the current time is within a range.
Frame (Operator)
type | enum |
---|---|
default | > |
indices | < : <= : == : != : >= : > |
Conditional operator to use on the values. |
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.
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 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.
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
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 |