__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.

Inputs

Collection

The Collection to loop through

Seq

The sequence determines which sequence will be run on every item that is defined in the collection.

Parameters

Parameters

Global_Loop_Name

Loop name in the parameters. Three entries will be made in these parameters

RunAsynchronous

If set the loop is run in a separate thread __footer__