Houdini 20.5 Nodes APEX nodes

geo::ForEachPrimBegin

Defines the start of a for-each loop that iterates over the primitives in a geometry.

On this page
Since 20.0

Defines the start of a for-each loop that loops over the primitives in a geometry, and executes the block of nodes sandwiched between this node and its corresponding geo::ForEachPrimEnd node (connected via their scope ports). An optional pattern, group, can be used to match a subset of primitives to loop over.

The geo ports of this node are in-place ports, which means that the geometry is updated without creating a copy.

Inputs

*geo: Geometry Required

The geometry whose primitives to iterate over.

group: String

An optional pattern to use for matching a subset of primitives to loop over.

The pattern format is the same as that used by the group parameters on various SOP nodes. Elements in the pattern are separated by spaces, and can be primitive numbers, primitive number ranges, or group names. See group syntax for more information.

__spare__

Extra inputs for use within the block. If a spare input on the geo::ForEachPrimBegin node matches the name of a spare input on the corresponding geo::ForEachPrimEnd node, the value is fed back each iteration.

Outputs

scope: undefined

Used to define the scope of the for-each loop. Must be wired to the scope input of the corresponding geo::ForEachPrimEnd node.

*geo: Geometry

The geo input whose primitives are iterated over.

element: Int

The primitive number of the primitive that is being iterated over.

__spare__

Pass-through of the corresponding input, for use within the block.

See also

APEX nodes