QS0 anim cmd

home/reference v0.x/<anim>

<anim name="(string)" duration="time|{expr})" fadeout="time|{expr})" loop="no|normal|palindrome">

Simple Example

<anim name="simpleRamp" duration="5s" fadeout="2s">
    <track name="t1">0. 1.</track>
    <send>/address ramp {t1}</send>
</anim>
<wait anim="simpleRamp"/>

Attributes

• name = required. name of animation
• duration = the duration of the animation. 1)
• fadeout = the fadeout time of the animation. 1)
• loop = loop mode: no|normal|palindrome

Child Commands

• <track>
• <keys> 2)
• <expr>
• <print>
• <send>
• <osc>
• <out>
• <if>
• <debugger>

Explained

<anim> creates key-based animations. It needs at least one <track> cmnd and one message (<print>, <send>, <osc>, <out>). <track> defines a set of simple ramps that are interpolated during the specified duration of the animation. with <keys> it is possible to adjust the timing of those ramps.

if <anim> has no loop and has reached its target, it will send an internal anim-message with its name, which can be picked up by a <wait> cmnd. this way it is possible to let the quescript wait until an anim has finished until it continues.

if <anim> is fading out and has reached its end, it will send an internal faded-message with its name, which can be picked up by a <wait> cmnd. this way it is possible to let the quescript wait until an anim has finished fading out until it continues.

Notice 1)

When using {expr} inside 'duration' and 'fadeout', the evaluated number is interpreted as milliseconds.

Notice 2)

Only maximal one <keys> cmnd is allowed and applies to all <track> cmnds. This means the number of <track> values must be n+2 of the <keys> values.