Houdini 21.0 Nodes APEX nodes

graph::IfConnected<T>

Determines whether an input port to a subgraph or subnet is connected, and returns either that port’s value or a fallback value.

On this page
Since 21.0

This node is designed to be used within subgraphs and subnets. It determines whether a given input port of the subgraph/subnet is connected (in the parent graph). The connection status can then be used as an input for conditional operations. See graph::IsConnected for an example.

If the input is connected, the value of input is returned. Otherwise, a fallback value is returned.

Inputs

input: AnimChannel, AnimChannelCollection, AnimStack, ApexNodeID, ApexNodeIDArray, ApexPortID, ApexPortIDArray, Bool, BoolArray, ColorRamp, DataItem, Dict, DictArray, DynamicPath, DynamicPathArray, FBIKSkeleton, FBIKSkeletonArray, FBIKSolver, FBIKSolverArray, FBIKTarget, FBIKTargetArray, Float, FloatArray, FloatRamp, Geometry, GeometryArray, Int, IntArray, Matrix3, Matrix3Array, Matrix4, Matrix4Array, SimRootDataId, SimRootDataIdArray, String, StringArray, Vector2, Vector2Array, Vector3, Vector3Array, Vector4, Vector4Array

The input that is examined for its connection status.

fallback: AnimChannel, AnimChannelCollection, AnimStack, ApexNodeID, ApexNodeIDArray, ApexPortID, ApexPortIDArray, Bool, BoolArray, ColorRamp, DataItem, Dict, DictArray, DynamicPath, DynamicPathArray, FBIKSkeleton, FBIKSkeletonArray, FBIKSolver, FBIKSolverArray, FBIKTarget, FBIKTargetArray, Float, FloatArray, FloatRamp, Geometry, GeometryArray, Int, IntArray, Matrix3, Matrix3Array, Matrix4, Matrix4Array, SimRootDataId, SimRootDataIdArray, String, StringArray, Vector2, Vector2Array, Vector3, Vector3Array, Vector4, Vector4Array

The value that is used as a fallback when the input is not connected.

checkdefault: Bool

If set to True, the input is also considered to be connected if the corresponding input port in the parent graph is not at the default value.

Outputs

value: AnimChannel, AnimChannelCollection, AnimStack, ApexNodeID, ApexNodeIDArray, ApexPortID, ApexPortIDArray, Bool, BoolArray, ColorRamp, DataItem, Dict, DictArray, DynamicPath, DynamicPathArray, FBIKSkeleton, FBIKSkeletonArray, FBIKSolver, FBIKSolverArray, FBIKTarget, FBIKTargetArray, Float, FloatArray, FloatRamp, Geometry, GeometryArray, Int, IntArray, Matrix3, Matrix3Array, Matrix4, Matrix4Array, SimRootDataId, SimRootDataIdArray, String, StringArray, Vector2, Vector2Array, Vector3, Vector3Array, Vector4, Vector4Array

If the connection status of the input port is True (success is True), the input value is returned. Otherwise, the fallback value is returned.

success: Bool

The connection status of the input port. Returns True if the subgraph that contains the input port has a connection for input in the parent graph.

See also

APEX nodes