User manual

Automation Protocol Animation Commands
Miranda Technologies Ltd Page 99
Animation Commands
The animation control commands are used to control the playout of
animation sequences which have been loaded into the playout memory. They
can be used to trigger ‘single-shot’ animations, and make other types of
animation.
On Intuition units, animations occupy a template box rather than a full layer.
These commands imply a box number of 0. See also the Zf command on
page 232. Note that these commands are not supported on the DSK-3901.
Start Animation S0
This command starts or restarts an animation playing out. The animation
starts playing from the current field. To force playout from the beginning, set
the current field before issuing this command.
CMD Param_1
S0 %1x : Layer No.
Example:
void StartAnimation(int layer)
{
remote_send("S0%01x",layer);
}
Stop Animation S1
This command halts an animation. If the complete cycle flag is set, the
animation completes its cycle before halting. In some animations, this may
cause a special stop section of the animation to execute. If the immediate flag
is set, then animation halts immediately at the specified frame. Animations
always halt showing two frames to form a field. If there is much inter-field
motion, the image will flicker.
CMD Param_1 Param_2
S1 %1x: Layer No. %1x: 0 = Complete cycle, then stop. 1 = Immediate stop