VXAce - Animated Pictures

About this Script:

RPG Maker VX Ace doesn't have a good way to handle picture animations by default and other scripts that exist rely on having multiple pictures. This script allows you to create animated pictures using spritesheets which means you are relying on one single sprite instead of a sequence of sprites.

This script was originally designed for PHLiM2's Project, Searching for Mother and he needed help with it, so I wrote this script. We now have a script that others animated pictures with functionality similar to normal pictures.

How it Works:

When you download the script, you place it above Main and below everything else and you are ready to use. There are three scripts that you will be able to use, these scripts are Show, Move and Erase. More extensions are planned for the future, but these are the main three. These are all called from the "Script..." event.

show_animated_picture(id, filename, x, y, cell_width, cell_height, animation_speed, max_frames, looping = true, origin = 0, opacity = 255)

move_animated_picture(id, x, y, opacity, duration, origin = 0)

erase_animated_picture(id)

ID is the unique number for the animation. This means you can have more than 1 animated picture on the screen at any one time.

Filename is the name of the file located in the "Pictures" folder.

X & Y refers to the position of the picture. In the Move command, it refers to the target X and Y position

Cell Width and Height refers to the size of each frame. You will be having a consistent size with frames. This value helps calculate which sprite to use. 

Animation Speed refers to the speed of the animation. The lower the number the slower the animation. RPG Maker VX Ace runs at 60fps so the animation speed is used in (FPS / Speed)

Max Frames refers to the maximum number of frames in the spritesheet. You can do less frames than there are actually in the spritesheet, but make sure you don't do more. 

Looping refers to if the animation should loop, almost all the time this will be true so by default this is true and is an optional parameter

Origin refers to where the origin of the picture is, the value is either 0 or 1. 0 is top left corner and 1 is the middle of the picture. This works similar to pictures but it bases the origin on the middle of the current frame

Opacity refers to the transparency of the picture. A value of 0 means it is completely transparent while 255 means it is opaque. A value between makes it a translucent picture. 

Duration refers to how long it takes to complete the action. 60 tends to be the default time. The lower the value the quicker the action takes place.

Sample Picture:

This is a 3x3 Spritesheet with a cell width and height of 32. Here is an example of the show script in use.

show_animated_picture(1, "AnimatedPicture", 0, 0, 32, 32, 4, 9)

Terms of Use:

This script can be used in both commercial and non-commercial projects. If you are using commercial, I would appreciate it if you donated for the use of this script, but that is up to you. 

Please provide credit if you do use the script making clear the following two names:
Fool Studios
FoolsLynx

You do not have permission to redistribute, modify, sell, share this script with anyone else. If someone wants to use this script, please provide them with a link to this page.