TSK's AnimatePicture

[The Shadow Knight]

AnimatePicture v1.1
By TSK



Introduction
This plug-in extends the basic picture functionality by allowing the display of animated pictures.

Features
All standard picture display parameters are supported. New parameters include setting the animated picture to loop or to keep the last animation frame on screen after the animation.

What it looks like
This plug-in is used in this showcase video to animate the dustclouds and impact explosion for the summon:










How to Use
Drop the .js file into your plugins folder. This script requires no parameters.


An animation should be stored in your picture folder as separate frames following the name scheme of baseNamexxxx, where xxxx is a number like "0001". This number identifies which animation frame that image represents. So a full animation of 4 frames would be stored as: animation0001, animation0002, animation0003, animation0004. This of course limits the maximum amount of frames for a single animation to 9999, which should be plenty.


The plugin command syntax is like this:


animatePicture <imageNumber> <imageBaseName> <startFrame> <endFrame> <origin> <x> <y> <scaleX> <scaleY> <opacity> <blendmode> <eraseWhenDone> <loop>


The parameters new to this command are:


<startFrame>: The number for the first frame of the animation


<endFrame>: The number for the last frame of the animation


<eraseWhenDone>: If set to 1 the animation will be cleared when done playing, otherwise the last frame remains on screen


<loop>: If set to 1 the animation loops forever, this overrides <eraseWhenDone>

<fpf>: Number of engine frames for each animation frames. E.g. the number of frames the individual pictures of the animation stay on screen.

A full example looks like this:


animatePicture 64 earthExplosion 0 30 0 -180 -60 300 300 255 0 1 0 1




Pictures created using this command can be erased like regular pictures: erasePicture <imageNumber>


Credit


- TSK


Terms


- free for use in commercial games


Notes


I suppose this counts as my introduction to the community, hi all!


Please let me know if you encounter any issues.



Plugin

 

[Harken_W]

Exactly what I need! Thanks!

 

[Jonforum]

not work for me 


Nothing appen ?!!!

 

[cekobico]

Is it possible for you to make a video tutorial on how to set it up? 

 

[pyrogoth]

Hello! Is it possible to modify the script to find pictures from img/pictures/(new folder) ? Just to make organisation of many image files easier :') Thank you very much for this plugin!