Condition

The members of this class provide nodes for comparisons to make a decision. The result of a comparison is "True" or "False" or, in a bit-wise notation, 0 and 1; it determines which route the graph will follow. When you create a condition you compare two values against each other with an operator. Operators are, for example, "equal to'", "greater than", or "less than or equal to". Conditions cannot only be used with single elements, but also data types which support more than one value – these types are called arrays. A typical array are the position of the data of an emitter's particles. The "FilterBy" nodes have been designed for exactly this purpose. When the condition is fulfilled, the array will only contain the elements that satisfy the given condition. The other, "false", elements are removed.

Nodes

NameDescription
ConditionEqualToCondition is evaluated as true if the reference value is equal to the input 'value'.
ConditionEqualToConstantCondition is evaluated as true if the reference value is equal to the input 'value'.
ConditionFilterByFilters the input values according to the 'condition'.
ConditionFilterByEqualToFilters the input value according to the 'condition'.
ConditionFilterByGreaterOrEqualFilters the input values and returns an array containing only the 'value0' input values, which are greater or equal than the reference 'value1' at the same position.
ConditionFilterByGreaterThanFilters the input values and returns an array containing only the 'value0' input values, which are greater than the reference 'value1' at the same position.
ConditionFilterByLessOrEqualFilters the input value according to the 'condition'.
ConditionFilterByLessThanFilters the input value according to the 'condition'.
ConditionFilterByNotEqualToFilters the input value according to the 'condition'.
ConditionGenericCondition is evaluated as true if the other value is strictly greater than the input 'value'.
ConditionGreaterOrEqualCondition is evaluated as true if the other value is greater or equal than the input 'value'.
ConditionGreaterOrEqualConstantCondition is evaluated to true, if the other value is greater or equal than the input 'value'.
ConditionGreaterThanCondition is evaluated as true if the other value is strictly greater than the input 'value'.
ConditionGreaterThanConstantCondition is evaluated as true if the other value is strictly greater than the input 'value'.
ConditionIfThis node sets its output 'value' to the input 'true value' if the condition bit is set to 'true'.
ConditionIsZeroChecks if the input elements are zero with respect to the input 'tolerance' value.
ConditionLessOrEqualCondition is evaluated as true if the other value is less or equal than the input 'value'.
ConditionLessOrEqualConstantCondition is evaluated as true if the other value is less or equal than the input 'value'.
ConditionLessThanCondition is evaluated as true if the other value is strictly less than the input 'value'.
ConditionLessThanConstantCondition is evaluated as true if the other value is strictly less than the input 'value'.
ConditionNotEqualToCondition is evaluated as true if the other value is not equal to the input 'value'.
ConditionNotEqualToConstantCondition is evaluated as true if the other value is not equal to the input 'value'.

 

ConditionEqualTo

Condition is evaluated as true if the reference value is equal to the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionEqualToConstant

Condition is evaluated as true if the reference value is equal to the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric (1)

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionFilterBy

Filters the input values according to the 'condition'.

The 'result' is an array reduced by the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Real
Vector3
Color4
Matrix4

 Optional

result

The value to check the condition against

conditionCondition 

The condition

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Real
Vector3
Color4
Matrix4

 Optional

value

The result after applying the condition

maskBit 

A mask to apply to other array with the same size to apply the same filter without the need of reevaluation

 

ConditionFilterByEqualTo

Filters the input value according to the 'condition'.

The comparison is performed for as many elements as it contains the 'value0' input. If 'value1' size is smaller it's last element is used for the comparison of the remaining elements.

The 'result' is an array without the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value0
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The left side of the comparison operation

value1
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The right side of the comparison operation

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

value0
value1

The result after applying the condition

maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionFilterByGreaterOrEqual

Filters the input values and returns an array containing only the 'value0' input values, which are greater or equal than the reference 'value1' at the same position.

The comparison is performed for all elements within the 'value0' input. If the size of 'value1' is smaller than 'value0', the last element is used for the comparison of the remaining elements.

The 'result' is an array reduced by the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value0
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The left side of the comparison operation

value1
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The right side of the comparison operation

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

value0
value1

The result after applying the condition

maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionFilterByGreaterThan

Filters the input values and returns an array containing only the 'value0' input values, which are greater than the reference 'value1' at the same position.

The comparison is performed for all elements within the 'value0' input. If the size of 'value1' is smaller than 'value0', the last element is used for the comparison of the remaining elements.

The 'result' is an array reduced by the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value0
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The left side of the comparison operation

value1
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The right side of the comparison operation

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

value0
value1

The result after applying the condition

maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionFilterByLessOrEqual

Filters the input value according to the 'condition'.

The comparison is performed for as many elements as it contains the 'value0' input. If 'value1' size is smaller it's last element is used for the comparison of the remaining elements.

The 'result' is an array without the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value0
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The left side of the comparison operation

value1
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The right side of the comparison operation

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

value0
value1

The result after applying the condition

maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionFilterByLessThan

Filters the input value according to the 'condition'.

The comparison is performed for as many elements as it contains the 'value0' input. If 'value1' size is smaller it's last element is used for the comparison of the remaining elements.

The 'result' is an array without the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value0
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The left side of the comparison operation

value1
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The right side of the comparison operation

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

value0
value1

The result after applying the condition

maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionFilterByNotEqualTo

Filters the input value according to the 'condition'.

The comparison is performed for as many elements as it contains the 'value0' input. If 'value1' size is smaller it's last element is used for the comparison of the remaining elements.

The 'result' is an array without the elements that evaluate the condition as false.

Inputs

NameTypesPassThroughDescription
value0
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The left side of the comparison operation

value1
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

result

The right side of the comparison operation

Outputs

NameTypesPassThroughDescription
result
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 Optional

value0
value1

The result after applying the condition

maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionGeneric

Condition is evaluated as true if the other value is strictly greater than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

type
 List

equal to
not equal to
less than
less or equal than
greater than
greater or equal than

 

The type

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionGreaterOrEqual

Condition is evaluated as true if the other value is greater or equal than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionGreaterOrEqualConstant

Condition is evaluated to true, if the other value is greater or equal than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric (1)

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionGreaterThan

Condition is evaluated as true if the other value is strictly greater than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionGreaterThanConstant

Condition is evaluated as true if the other value is strictly greater than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric (1)

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionIf

This node sets its output 'value' to the input 'true value' if the condition bit is set to 'true'.

Otherwise, the output is set to 'false'.

Inputs

NameTypesPassThroughDescription
conditionBit 

The condition

true valueAll 

The true value

false valueAll 

The false value

Outputs

NameTypesPassThroughDescription
valueAll 

The value

 

ConditionIsZero

Checks if the input elements are zero with respect to the input 'tolerance' value.

For every input position equal to zero the output mask's bit is set to 1.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Color4
Matrix4

 

The value to check if is zero

toleranceReal 

The tolerance

Outputs

NameTypesPassThroughDescription
maskBit 

A mask to apply to other same size array to apply the same filter without the need of reevaluation

 

ConditionLessOrEqual

Condition is evaluated as true if the other value is less or equal than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionLessOrEqualConstant

Condition is evaluated as true if the other value is less or equal than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric (1)

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionLessThan

Condition is evaluated as true if the other value is strictly less than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionLessThanConstant

Condition is evaluated as true if the other value is strictly less than the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric (1)

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionNotEqualTo

Condition is evaluated as true if the other value is not equal to the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition

 

ConditionNotEqualToConstant

Condition is evaluated as true if the other value is not equal to the input 'value'.

Inputs

NameTypesPassThroughDescription
value
 Numeric (1)

Integer
Integer64
Real
Vector3
Matrix4
Color4

 

The value

Outputs

NameTypesPassThroughDescription
conditionCondition 

The condition