QS1 while cmd

home/reference v1.x/<while>

<while name="(string)" start="{expr}" repeat="{expr}" step="{expr})" >

###Simple Example

<while name="whileLoop" init="{:whilevar = 0}" condition="{whilevar lt 100}" next="{whilevar = (whilevar + 1)}">
    <if true="{whilevar lt 50}">
        <print>inside while below 50: {whilevar}</print>
        <else>
            <print>inside while above 50: {whilevar}</print>
        </else>
    </if>
</while>
<wait anim="whileLoop"/>

Attributes

• name = if name is set, <while> will sends an anim-message once the loop has exited (condition == false). this message can be caught by a <wait anim="whileLoop"/> cmd.
• init = if used, its {expr} is evaluated first. Usefull to create a local variable inside the loop.
• condition = required. its {expr} has to be true (>= 1) to go into the loop
• next = if used, its {expr} is evaluated after each loop. Useful to increment a local variable inside the loop.

Child Commands

• <expr>
• <print>
• <send>
• <osc>
• <out>
• <if>
• <play>
• <stop>
• <shutdown>
• <pause>
• <resume>
• <fade>
• <trigger>
• <debugger>

Explained

the <while> cmd defines an loop like structure for an animation and works like 'while' or 'for' in classical languages

Notice

• if a name-attribute is used, once the condition is false the node will send an anim-message to be caught by a <wait anim="whileLoop"/> node.
• the init-attribute's expression {:whilevar = 0} sets the variable 'whilevar' to 0. the : at the beginning of the variable name indicates that if the variable doesn't exist yet, the script will create the 'whilevar' variable in the local variable scope. the <while> node (like the <anim> node) have a separate local variable scopes to the <que>. this way you can create variables that don't interfere with each other.