Previous:The #switch, #case, #range and #break Directives   Main Index   Next:User Message Directives

The #while...#end Directive

The #while directive is a looping feature that makes it easy to place multiple objects in a pattern or other uses.

#while ( Cond ) TOKENS... #end

The TOKENS are any number of POV-Ray keyword, identifiers, or punctuation marks which are the body of the loop. The #while directive is followed by a float expression that evaluates to a boolean value. A value of 0.0 is false and any non-zero value is true. Note that extremely small values of about 1e-10 are considered zero in case of round off errors. The parentheses around the expression are required. If the condition is true parsing continues normally until an #end directive is reached. At the end, POV-Ray loops back to the #while directive and the condition is re-evaluated. Looping continues until the condition fails. When it fails, parsing continues after the #end directive. Note it is possible for the condition to fail the first time and the loop is totally skipped. It is up to the user to insure that something inside the loop changes so that it eventually terminates. Here is a properly constructed loop example:

 #declare Count=0;

 #while (Count < 5)

  object{MyObject translate x*3*Count}

  #declare Count=Count+1;


This example places five copies of MyObject in a row spaced three units apart in the x-direction.

Previous:The #switch, #case, #range and #break Directives   Main Index   Next:User Message Directives