FirstValidNode

Introduced

7.0

UI Location

• Execution

Description

The First Valid node passes through the data of the first input port connected to a tree branch that is not in error. All other input ports are ignored.

Often when designing ICE trees and compounds, you want a fallback case if something is not working. For example, you want to use the point normals in your calculations in a compound. However, you might want the compound you're building to work for point clouds as well. Since point clouds do not have point normals you might like to use an attribute called "Direction" instead. And if there is no such attribute you might want to default to a zero vector. To do this, connect the graphs that implement each of these cases. The first case should be connected to the first port. The first fallback should be to the second port, etc.

Note: First Valid only considers graph errors, such as an attribute or object does not exist or is of the wrong type. The node does not consider execution (or runtime) errors such as a division by zero. To treat the latter, use graph logic such as IfNode statements.

Port Description

Inputs

Group ID | Instance s | Port Name | Connection Info | Description
0 | 1..N | in | • Type: siICENodeDataAny • Structure: siICENodeStructureAny • Context: siICENodeContextAny | The data of the first of these ports that is valid is passed to the output.

Outputs

Port Name | Connection Info | Description
out | • Type: siICENodeDataAny • Structure: siICENodeStructureAny • Context: siICENodeContextAny | The data of the first valid input port.

Restrictions

• These types must match: in, out

• These structures must match: in, out

• These contexts must match: in, out

See Also

ExecuteNode | FilterNode | IfNode | PassThroughNode
RepeatNode | SelectCaseNode | WhileNode |

Autodesk Softimage v7.5