Houdini 20.5 Nodes TOP nodes

Error TOP node

Issues warnings or errors when a condition is met.

On this page
Since 18.0

This node passes input work items through unchanged, and can optionally report a node warning, node error, or work item error. If this node is inside a subnet or digital asset, then its error messages are also displayed on that asset. You can use this node to report errors or warnings to the user of an asset. For example, like issuing an error message that indicates a parameter value is invalid.

Errors are reported when their Report Error When expression evaluates to 1, otherwise the error is not reported. This expression can also refer to work item attributes.

TOP Attributes

failure

str

If Error Type is set to Work Item Error, then this attribute is created and set to the Error Message value for all work items that have an error.

hasfailure

int

If Error Type is set to Work Item Error, then this attribute is created and set to 1 for all work items that have an error.

Parameters

Generate When

Determines when this node will generate work items. You should generally leave this set to “Automatic” unless you know the node requires a specific generation mode, or that the work items need to be generated dynamically.

All Upstream Items are Generated

This node will generate work items once all of the input nodes have generated their work items.

All Upstream Items are Cooked

This node will generate work items once all of the input nodes have cooked their work items.

Each Upstream Item is Cooked

This node will generate work items each time a work item in an input node is cooked.

Automatic

The generation mode is selected based on the generation mode of the input nodes. If any of the input nodes are generating work items when their inputs cook, this node will be set to Each Upstream Item is Cooked. Otherwise, it will be set to All Upstream Items are Generated.

Evaluate Errors During

Determines when the node evaluates error conditions and produces messages.

Generate

The node evaluates error conditions and issues messages when work items are being generated.

Cook (In-Process)

The node evaluates error conditions and issues messages when work items are cooking.

Number of Errors

The number of error conditions to evaluate.

Error Type

The type of message to produce for each error condition that is met.

Node Warning

Produce a warning message on the node.

Node Error

Produce an error message on the node and halts any further evaluation of the node chain.

Note

If you want to provide error information without stopping node graph evaluation, then you should set Error Type to “Node Warning” instead.

Work Item Error

Produce error message on work items rather than the entire node.

Error Message

The error message to produce.

Report Error When

If this expression evaluates to a non-zero value, then the node reports the error or warning message.

Examples

CreateError Example for Error TOP node

This example demonstrates how to use the Error TOP node to create warnings or errors based on an expression.

See also

TOP nodes