Picture Control Extend - PictureControlExtend.js

Plugin desc : Picture manipulation extension plug-in

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/PictureControlExtend.js

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MZ-plugins/refs/heads/main/PictureControlExtend.js

File name : PictureControlExtend.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/PictureControlExtend.js
@plugindesc Picture manipulation extension plug-in
@author Triacontane
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/triacontane-MZ-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----

PictureControlExtend.js

Extends the functionality of picture-related event commands.
Executes dedicated plugin commands.
Command details can be found in Plugin Commands.

Various commands (*1) are only effective for pictures that are already
displayed.
Execute the commands after displaying the picture using ”Show Picture.”

*1 Except for bulk picture operations.

This plugin requires the base plugin ”PluginCommonBase.js.”
”PluginCommonBase.js” is located in the following folder under the RPG Maker
MZ installation folder:
dlc/BasicResources/plugins/official

Terms of Use:
You may modify and redistribute this plugin without permission， and there are
no restrictions on its use (commercial， R18+， etc.).
This plugin is now yours.

@command MULTI_CONTROL
@text Bulk operations on pictures
@desc Picture-related event commands can now operate on multiple targets.
@arg all
@text all
@desc All displayed pictures are the target of operation.
@type boolean
@default false
@arg startNumber
@text Starting Number
@desc The starting number of the picture to operate on.
@type number
@default 0
@arg endNumber
@text End Number
@desc The starting number of the picture to operate on.
@type number
@default 0
@arg list
@text Direct specification list
@desc A list that directly specifies the pictures to operate on.
@type number[]
@default []
@arg variable
@text variable
@desc The picture to be operated on can be obtained from the specified variable value.
@type variable
@default 0

@command MULTI_CONTROL_CLEAR
@text Cancel bulk operations on pictures
@desc Reverts the operation target of picture-related event commands.

@command PICTURE_SHAKE
@text Shake the Picture
@desc Shake the picture.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@type number
@default 1
@min 1
@arg power
@text Strength
@desc Shake strength
@type number
@default 1
@min 1
@max 9
@arg speed
@text Speed
@desc Shake speed
@type number
@default 1
@min 1
@max 9
@arg rotation
@text angle
@desc Shake angle (0-360)
@type number
@default 0
@min 0
@max 360
@arg duration
@text time
@desc Processing time (in frames).
@type number
@default 0
@min -1
@arg wait
@text Wait until completion
@desc Wait until the process is complete.
@type boolean
@default false

@command PICTURE_OUT_OF_SHAKE
@text Remove from screen shake target
@desc Exclude the picture from screen shake.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@type number
@default 1
@min 1
@arg value
@text Setting value
@desc This is the setting value. If enabled， the picture will be excluded from the screen shake target.
@type boolean
@default true

@command PICTURE_SPIN
@text Picture angle setting
@desc Specify the angle to rotate the picture to.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@type number
@default 1
@min 1
@arg rotation
@text angle
@desc The angle of the picture.
@type number
@default 0
@min 0
@max 360
@arg relative
@text Relative specification
@desc When enabled， the current picture will be rotated by the specified angle.
@type boolean
@default false
@arg duration
@text time
@desc Processing time (in frames).
@type number
@default 0
@min 0
@arg wait
@text Wait until completion
@desc Wait until the process is complete.
@type boolean
@default false

@command PICTURE_ORIGIN
@text Picture origin setting
@desc Specifies the origin of the picture in detail.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@type number
@default 1
@min 1
@arg ox
@text Origin X
@desc The origin of the picture’s X coordinate， expressed as a percentage.
@type number
@default 0
@min 0
@max 100
@arg oy
@text Origin Y
@desc The Y origin of the picture， specified as a percentage.
@type number
@default 0
@min 0
@max 100

@command PICTURE_TO_MAP
@text Align location to map
@desc The picture display position will be adjusted to match the map scroll.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@default 1
@arg toMap
@text Fit to Map
@desc The picture display position will be adjusted to the map scroll. Turn it OFF to return to normal.
@type boolean
@default true

@command PICTURE_COPY
@text Copying a Picture
@desc Copy a picture by specifying the source and destination picture numbers.
@arg srcPictureId
@text Source picture number
@desc The picture number to copy from.
@type number
@default 1
@min 1
@arg destPictureId
@text Destination picture number
@desc The picture number to copy to.
@type number
@default 2
@min 1

@command PICTURE_FLASH
@text Picture Flash
@desc Flash the picture.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@default 1
@arg red
@text Flash color (red)
@desc The red component of the flash.
@type number
@default 255
@min 0
@max 255
@arg green
@text Flash color (green)
@desc The green component of the flash.
@type number
@default 255
@min 0
@max 255
@arg blue
@text Flash color (blue)
@desc The blue component of the flash.
@type number
@default 255
@min 0
@max 255
@arg alpha
@text Flash Intensity
@desc The intensity of the flash.
@type number
@default 255
@min 0
@max 255
@arg duration
@text time
@desc Processing time (in frames).
@type number
@default 60
@min 0
@arg wait
@text Wait until completion
@desc Wait until the process is complete.
@type boolean
@default false

@command PICTURE_BLUR
@text Picture Blur
@desc Blurs the picture.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@type number
@default 1
@min 1
@arg value
@text Setting value
@desc Whether to enable blur.
@type boolean
@default true

@command PICTURE_HUE
@text Change the picture hue
@desc Change the hue of the picture.
@arg pictureId
@text Picture Number
@desc The picture number to operate on.
@type number
@default 1
@min 1
@arg hue
@text Setting value
@desc This is the setting value for the hue to be changed.
@type number
@default 0
@min 0
@max 360

munokura

Welcome to PGMZ! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.