image.png

This is a RPG Maker MV plugin that gives functionality to Show Picture events to display animated pictures. Animated pictures are shown in a sprite sheet format. There are looping controls and speed controls that can be used with these animated pictures.
這是一個RPG Maker MV插件，為Show Pictures事件提供顯示動畫圖片的功能。動畫圖片以精靈表格式顯示。有循環(huán)控制和速度控制可以與這些動畫圖片一起使用。

Plugin Parameters

image

Loop by Default: Animated pictures will loop back to beginning by default once it reaches the last frame.
默認(rèn)循環(huán)：動畫圖片一旦到達(dá)最后一幀，將默認(rèn)循環(huán)回到開頭。

image

Wait Frames Default: Default number of frames to wait before moving to next picture cell. The lower the number, the faster it goes (1 is the fastest). The higher the number, the slower it goes.
等待幀默認(rèn)值：在移動到下一個圖像單元之前要等待的默認(rèn)幀數(shù)。數(shù)字越小，越快（1越快）。數(shù)字越高，越慢。

Instructions

Save your animated picture into your game project's img/pictures folder. The filename must be named with the following format:
將動畫圖片保存到游戲項目的img / pictures文件夾中。必須使用以下格式命名文件名：

filename[HxV]

Replace H in the filename with the number of horizontal cells it has. Replace Vin the filename with the number of vertical cells it has. The number of total cells it has available is equal the multiplicative product of the horizontal and vertical cells.
將文件名中的H替換為它具有的水平單元格數(shù)。將文件名中的V替換為它具有的垂直單元格數(shù)。

For example:

Parrot[3x2]will have 3 horizontal cells and 2 vertical cells. This means there are a total of 6 cells that will be used for this animated picture.
Parrot [3x2]將有3個水平單元和2個垂直單元。這意味著總共有6個單元格將用于此動畫圖片。

Animations will be played from left to right, then up to down so please arrange them as such. For example, 4x5 will play like this:
動畫將從左到右播放，然后從上到下播放，所以請安排它們。例如，4x5將如下所示：

 1  2  3  4
 5  6  7  8
 9 10 11 12
13 14 15 16
17 18 19 20

Keep this in mind as you format your animated pictures.
在格式化動畫圖片時請記住這一點。

For a sample picture to try out, use this:
要試用示例圖片，請使用以下命令：

image

Save it as Parrot[3x2].png in your img/pictures folder and use a Show Picture to display it in-game.
將它保存為 你的img / pictures文件夾中的Parrot [3x2] .png并使用顯示圖片在游戲中顯示它。

Plugin Commands

If you want to change the settings of specific pictures like loop or speed, please use these plugin commands to change them:
如果要更改特定圖片的設(shè)置，如循環(huán)或速度，請使用這些插件命令進(jìn)行更改：

AnimatedPicture id NoLoop

• Replace id with the ID of the selected picture. The selected picture will not loop after this plugin command takes effect.
  將id替換為所選圖片的ID。此插件命令生效后，所選圖片不會循環(huán)播放。

AnimatedPicture id Loop

• Replace id with the ID of the selected picture. The selected picture will loop after this plugin command takes effect.
  將id替換為所選圖片的ID。此插件命令生效后，所選圖片將循環(huán)播放。

AnimatedPicture id Speed x

• Replace id with the ID of the selected picture. Replace x with the number of frames to wait in between animated cells. The higher the number, the faster the picture will animate. The lower the number, the slower the picture will animate. The lowest the speed can go is 1.
  將id替換為所選圖片的ID。將x替換為動畫單元格之間等待的幀數(shù)。數(shù)字越大，圖片的動畫效果就越快。數(shù)字越小，圖片的動畫就越慢。速度最低可達(dá)1。

AnimatedPicture id Reset

• Replace id with the ID of the selected picture. This will reset the loop and speed settings for that picture to whatever the value is in the plugin parameters set for default.
  將id替換為所選圖片的ID。這會將該圖片的循環(huán)和速度設(shè)置重置為默認(rèn)設(shè)置的插件參數(shù)中的值。

Good Practices

The plugin will perform at near 60 FPS if you follow the 5 practices below:
如果您遵循以下5種做法，該插件將以接近60 FPS的速度運行：

1. Use animated pictures sparingly if possible. RPG Maker MV's cache has a limited size to it, which means the more animated pictures you use, the faster it will fill up. And the faster it fills up, the more it needs to be emptied to allow other assets in your game to load at all.
   如果可能，請謹(jǐn)慎使用動畫圖片。RPG Maker MV的緩存尺寸有限，這意味著您使用的動畫圖片越多，填充的速度就越快。它填滿的速度越快，就越需要清空它以允許游戲中的其他資產(chǎn)加載。

2. If you do use animated pictures, trim down as much empty space as possible and keep picture cells to a minimum size to reduce bloating the cache.
   如果您確實使用了動畫圖片，請盡可能減少空白區(qū)域，并將圖片單元格保持在最小尺寸，以減少緩存膨脹。

3. If it is practical, make your sprite sheet cells work towards a power of 2 (ie: sizes of 32x32, 64x64, 128x128, 256x256, etc). Bitmaps render best when it works in this cell range. This is not necessary, but it is a thing to keep in mind.
   如果它是實用的，讓你的精靈表單元格的比例為2（即：32x32,64x64,128x128,256x256等的大小）。當(dāng)位圖在此單元格范圍內(nèi)工作時，位圖呈現(xiàn)效果最佳。這不是必要的，但要牢記這一點。

4. Limit the amount of colors used in the animated picture to reduce the filesize of the image and reduce the strain on the cache. Use more flat colors instead of gradients. These work better for the engine.
   限制動畫圖片中使用的顏色數(shù)量，以減少圖像的文件大小并減少緩存的壓力。使用更平滑的顏色而不是漸變。這些對游戲引擎很有效。

5. When you are done using the animated picture, use the Erase Picture command to clear the picture from use. This will stop the animation frame calculating and reduce strain on your game.
   使用完動畫后，使用“刪除圖片”命令清除使用中的圖片。這將停止計算動畫幀并減少游戲的壓力。

WARNING!!!

This plugin is made for RPG Maker MV versions 1.6.1 and below. If you update RPG Maker MV past that and this plugin breaks, I am NOT responsible for it.

Terms of Use

1. These plugins may be used in free or commercial games.

2. 'Fallen Angel Olivia' must be given credit in your games.

3. You are allowed to edit the code.

4. Do NOT change the filename, parameters, and information of the plugin.

5. You are NOT allowed to redistribute these Plugins.

6. You may NOT take code for your own released Plugins without credit.

Change Log History

• None