User Tools

Site Tools


visual3d:documentation:pipeline:pipeline_commands:for_each_and_end_for_each

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
visual3d:documentation:pipeline:pipeline_commands:for_each_and_end_for_each [2024/07/16 19:31] – created sgrangervisual3d:documentation:pipeline:pipeline_commands:for_each_and_end_for_each [2024/09/03 13:57] (current) – [Command Syntax] wikisysop
Line 1: Line 1:
-====== For_Each_and_End_For_Each ======+====== For Each and End For Each ======
  
 Executes pipeline commands multiple times for each item in a list of items. It is not identical with a "for loop" or "do loop" in a programming language because the items must be explicitly defined as ITEMS in the command. This has some powerful consequences because it means that you can "loop" through disconnected items or strings as easily as using a structured list. Executes pipeline commands multiple times for each item in a list of items. It is not identical with a "for loop" or "do loop" in a programming language because the items must be explicitly defined as ITEMS in the command. This has some powerful consequences because it means that you can "loop" through disconnected items or strings as easily as using a structured list.
Line 5: Line 5:
 ==== Command Syntax ==== ==== Command Syntax ====
  
-**For_Each**+<code> 
 +For_Each
 /Iteration_Parameter_Name= INDEX /Iteration_Parameter_Name= INDEX
 !/ITERATION_PARAMETER_COUNT_NAME= !/ITERATION_PARAMETER_COUNT_NAME=
 /Items= ITEM1+ITEM2+ITEM3 /Items= ITEM1+ITEM2+ITEM3
-**;**+; 
 ! Starting from the For_Each command and ending at the End_For_Each command ! Starting from the For_Each command and ending at the End_For_Each command
 ! the loop is repeated once for each item in the For_Each command at each ! the loop is repeated once for each item in the For_Each command at each
 ! loop INDEX is a pipeline command this is identified as ::INDEX in any other command ! loop INDEX is a pipeline command this is identified as ::INDEX in any other command
-**End_For_Each**+ 
 +End_For_Each
 /Iteration_Parameter_Name=INDEX /Iteration_Parameter_Name=INDEX
-**;**+; 
 +</code> 
 As of version 5.02.17, a new parameter "ITERATION_PARAMETER_COUNT_NAME" count was added. A pipeline parameter name (ex. INDEX_COUNT) can be placed here. Any where the parameter INDEX_COUNT is referenced, will return the iteration number (the result will be 1 based, so the first loop through will return 1, and the second will return 2). As of version 5.02.17, a new parameter "ITERATION_PARAMETER_COUNT_NAME" count was added. A pipeline parameter name (ex. INDEX_COUNT) can be placed here. Any where the parameter INDEX_COUNT is referenced, will return the iteration number (the result will be 1 based, so the first loop through will return 1, and the second will return 2).
  
Line 56: Line 61:
 Visual3D doesn't have a WHILE command, so there is no option but to use a kludge. You will need to set the option to make Visual3D stop processing the pipeline on the first error. The Visual 3D solution for the following algorithm can be found on [[|Example: Implementing a //while// loop]]. Visual3D doesn't have a WHILE command, so there is no option but to use a kludge. You will need to set the option to make Visual3D stop processing the pipeline on the first error. The Visual 3D solution for the following algorithm can be found on [[|Example: Implementing a //while// loop]].
  
 +<code>
 Variable blnContinue = true Variable blnContinue = true
-**While** Continue = true+While Continue = true
 Prompt user for variable blnContinue (true or false) Prompt user for variable blnContinue (true or false)
 FileCounter = FileCounter +1 FileCounter = FileCounter +1
 [load and process another file (e.g. filename_filecounter)] [load and process another file (e.g. filename_filecounter)]
-**End while**+End while 
 +</code>
 ==== Example: Processing many files ==== ==== Example: Processing many files ====
  
visual3d/documentation/pipeline/pipeline_commands/for_each_and_end_for_each.1721158268.txt.gz · Last modified: 2024/07/16 19:31 by sgranger