Loop

Loop nodes repeat a section of the graph.

Inputs

  • geometry

    • Accepts a single geometry connection (unless the SHIFT key is held).

  • # of loops

    • The number of loops to iterate through.

  • iterator tag

  • cumulative

    • Sets whether the loop is cumulative or not. See the Notes section below for more information.

Outputs

  • geometry

    • Output primitives.

  • points

    • The list of points of the output primitives.

  • points.x

    • The list of x values of the points of the output primitives.

  • points.y

    • The list of y values of the points of the output primitives.

  • points.z

    • The list of z values of the points of the output primitives.

Notes

  • Loop types:

    • A non-cumulative loop (the default loop) is a type of loop that repeats the section of a graph between an iterator - loop node pair for the defined number of loops. The geometry output of the loop node with this type of loop is the result of every iteration/loop, acting similarly to the copy node.
    • A cumulative loop is a type of loop that also repeats a section of the graph for a defined number of loops. Only with a cumulative loop, the previous iteration is used to inform the next iteration, accumulating changes each iteration.
      • The current iteration of the loop as defined by the idling value of the relevant iterator node will only compute the nodes as though it were a non-cumulative loop. The full computation of a cumulative loop can only be seen from the final loop node.

  • To be used in conjunction with an iterator node assigned with the same tag.

  • Other names for this node include: Iterate.

Examples