__header__
Description
The Loop Tool will take any collection (la set of lines, points,
etc.) and run a sequence on each object in that collection. If
the collection is a set of points, for example, the loop tool will run
a sequence on each point in that collection.
Using the Loop Tool
On the Loop Tool's inputs page two
settings need to be defined, the sequence and the collection. The
sequence determines which sequence will be run on every item that is
defined in the collection.
To set the sequence drag the
"Programs" icon off the ROT onto the "seq" section of the Loop Tool's
inputs page. Use the dropdown menu to select a sequence.
To
set the collection drag any tool that contains any collection off a
sequence onto the loop tool. Use the dropdown menu to select the
collection.
When the Loop Tool is run, the sequence selected in
the inputs page will be run one time for every item in the collection.
In addition three entries will be made in the global parameters,
loop_count, loop_index, loop_item. The loop prefix can be renamed
in the loop parameters page. The loop_count is the number of
items in the collection. The loop_index is the item's number in
the collection. The loop_item is the value of that item in the
collection.
When the loop tool is run it will enter the values for the first item in the collection
into the global parameters and then run the sequence defined on its
inputs page. Next, it will replace the values for the first item in the collection with the values for the second item in the collection and then run the sequence again. It will continue to loop in this way for every item in the collection.