Name
PlayAnimDisk -- play an animation directly from disk (V1.5)
Synopsis
PlayAnimDisk(anim$[, x, y, frameskip, speed, transcolor, times])
Function
This function plays the animation specified by anim$ directly from disk. This is useful if you want to display large animations which do not fit into your memory. Of course, this function is a lot of slower than PlayAnim() which plays an animation from memory.

New in Hollywood 1.9 is the optional times argument which allows you to specify how many times the animation shall be played. This defaults to 1 which means that the animation is only played once. If you want to loop the animation indefinitely, specify 0.

Important note: Since Hollywood 2.5 it is better to use LoadAnim() with FromDisk set to True for disk anims. This gives you more flexibility because you can also use the other commands from the anim library (like ScaleAnim() etc.) and you can also access the anims as layers using NextFrame() - all of which is not possible with PlayAnimDisk().

See LoadAnim for supported animation formats.

Inputs
anim$
animation file to play
x
optional: x-position for the animation on the display (defaults to 0)
y
optional: y-position for the animation on the display (defaults to 0)
frameskip
optional: frame skip (defaults to 0)
speed
optional: delay after each frame in ticks (defaults to 0)
transcolor
optional: transparent color for the animation (defaults to #NOTRANSPARENCY)
times
optional: specifies how many times the animation should be played (defaults to 1) (V1.9)
Example
PlayAnimDisk("Animations/LargeAnim.gif", 0, 0, 3)
The above code plays the animation "Animations/LargeAnim.gif" and skips 3 frames per run.
Show TOC