/*============================================================================= PictureControlExtend.js ---------------------------------------------------------------------------- (C)2021 Triacontane This software is released under the MIT License. http://opensource.org/licenses/mit-license.php ---------------------------------------------------------------------------- Version 1.7.1 2024/12/14 ヘルプの記載をシンプルに修正し注意書きを追加 1.7.0 2024/08/27 ピクチャの色相変更機能を追加 1.6.1 2024/05/16 ピクチャのフラッシュをしたときに最終フレームの色味が維持されてしまう問題を修正 1.6.0 2024/04/29 ピクチャにぼかしを入れるコマンドを追加 1.5.0 2023/12/13 ピクチャの表示位置をマップのスクロールに連動させる機能を追加 1.4.1 2023/11/16 一括操作の対応プラグインに「ピクチャのボタン化プラグイン」を追加 1.4.0 2023/06/04 ピクチャをフラッシュさせるコマンドを追加 1.3.0 2023/05/25 ピクチャを複製できるコマンドを追加 1.2.0 2023/05/10 ピクチャのシェイクを時間指定無しでシェイクし続けられる機能を追加 1.1.2 2022/05/04 DirectivityShake.jsと併用してピクチャをシェイク無効にしたとき、縦方向のシェイクに対しても影響を受けなくなるよう修正 1.1.1 2021/06/03 ピクチャの変数指定が解除コマンドで正常に解除されない問題を修正 1.1.0 2021/05/29 ピクチャの原点を詳細指定できるコマンドを追加 1.0.0 2021/05/15 初版 ---------------------------------------------------------------------------- [Blog] : https://triacontane.blogspot.jp/ [Twitter]: https://twitter.com/triacontane/ [GitHub] : https://github.com/triacontane/ =============================================================================*/ /*: * @plugindesc ピクチャの操作拡張プラグイン * @target MZ * @url https://github.com/triacontane/RPGMakerMV/tree/mz_master/PictureControlExtend.js * @base PluginCommonBase * @orderAfter PluginCommonBase * @author トリアコンタン * * @command MULTI_CONTROL * @text ピクチャの一括操作 * @desc ピクチャ関連のイベントコマンドの操作対象を複数にします。 * * @arg all * @text 全て * @desc 全ての表示ピクチャを操作対象にします。 * @default false * @type boolean * * @arg startNumber * @text 開始番号 * @desc 操作対象のピクチャの開始番号です。 * @default 0 * @type number * * @arg endNumber * @text 終了番号 * @desc 操作対象のピクチャの開始番号です。 * @default 0 * @type number * * @arg list * @text 直接指定リスト * @desc 操作対象のピクチャを直接指定する一覧です。 * @default [] * @type number[] * * @arg variable * @text 変数 * @desc 操作対象のピクチャを指定した変数値から取得できます。 * @default 0 * @type variable * * @command MULTI_CONTROL_CLEAR * @text ピクチャの一括操作解除 * @desc ピクチャ関連のイベントコマンドの操作対象を元に戻します。 * * @command PICTURE_SHAKE * @text ピクチャのシェイク * @desc ピクチャを揺らします。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg power * @text 強さ * @desc シェイクの強さ * @default 1 * @type number * @max 9 * @min 1 * * @arg speed * @text 速さ * @desc シェイクの速さ * @default 1 * @type number * @max 9 * @min 1 * * @arg rotation * @text 角度 * @desc シェイクの角度(0-360) * @default 0 * @type number * @max 360 * @min 0 * * @arg duration * @text 時間 * @desc 処理時間(フレーム単位)です。 * ずっとシェイクし続けたい場合、-1を指定してください。 * @default 0 * @type number * @min -1 * * @arg wait * @text 完了までウェイト * @desc 処理が完了するまでウェイトします。 * @default false * @type boolean * * @command PICTURE_OUT_OF_SHAKE * @text 画面のシェイク対象から外す * @desc ピクチャを画面のシェイク対象から外します。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg value * @text 設定値 * @desc 設定値です。有効にした場合ピクチャを画面のシェイク対象から外します。 * @default true * @type boolean * * @command PICTURE_SPIN * @text ピクチャの角度設定 * @desc 角度を指定してその角度までピクチャを回転させます。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg rotation * @text 角度 * @desc ピクチャの角度です。 * @default 0 * @type number * @max 360 * @min 0 * * @arg relative * @text 相対指定 * @desc 有効にすると、現在のピクチャの角度から指定した角度ぶん回転させます。 * @default false * @type boolean * * @arg duration * @text 時間 * @desc 処理時間(フレーム単位)です。 * @default 0 * @type number * @min 0 * * @arg wait * @text 完了までウェイト * @desc 処理が完了するまでウェイトします。 * @default false * @type boolean * * @command PICTURE_ORIGIN * @text ピクチャの原点設定 * @desc ピクチャの原点を細かく指定します。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg ox * @text 原点X * @desc ピクチャのX座標の原点です。百分率で指定します。 * @default 0 * @type number * @max 100 * @min 0 * * @arg oy * @text 原点Y * @desc ピクチャのY座標の原点です。百分率で指定します。 * @default 0 * @type number * @max 100 * @min 0 * * @command PICTURE_TO_MAP * @text 位置をマップに合わせる * @desc ピクチャ表示位置がマップのスクロールに合わせられます。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * * @arg toMap * @text マップに合わせる * @desc ピクチャ表示位置がマップのスクロールに合わせられます。OFFにすると元に戻ります。 * @default true * @type boolean * * @command PICTURE_COPY * @text ピクチャのコピー * @desc コピー元、コピー先のピクチャ番号を指定してピクチャをコピーします。 * * @arg srcPictureId * @text コピー元ピクチャ番号 * @desc コピー元のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg destPictureId * @text コピー先ピクチャ番号 * @desc コピー先のピクチャ番号です。 * @default 2 * @type number * @min 1 * * @command PICTURE_FLASH * @text ピクチャのフラッシュ * @desc ピクチャをフラッシュさせます。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * * @arg red * @text フラッシュ色（赤） * @desc フラッシュの赤成分です。 * @default 255 * @type number * @max 255 * @min 0 * * @arg green * @text フラッシュ色（緑） * @desc フラッシュの緑成分です。 * @default 255 * @type number * @max 255 * @min 0 * * @arg blue * @text フラッシュ色（青） * @desc フラッシュの青成分です。 * @default 255 * @type number * @max 255 * @min 0 * * @arg alpha * @text フラッシュ強度 * @desc フラッシュの強度です。 * @default 255 * @type number * @max 255 * @min 0 * * @arg duration * @text 時間 * @desc 処理時間(フレーム単位)です。 * @default 60 * @type number * @min 0 * * @arg wait * @text 完了までウェイト * @desc 処理が完了するまでウェイトします。 * @default false * @type boolean * * @command PICTURE_BLUR * @text ピクチャのぼかし * @desc ピクチャをぼかします。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg value * @text 設定値 * @desc ぼかしを有効にするかどうかです。 * @default true * @type boolean * * @command PICTURE_HUE * @text ピクチャの色相変更 * @desc ピクチャの色相を変更します。 * * @arg pictureId * @text ピクチャ番号 * @desc 操作対象のピクチャ番号です。 * @default 1 * @type number * @min 1 * * @arg hue * @text 設定値 * @desc 変更する色相の設定値です。 * @default 0 * @type number * @min 0 * @max 360 * * @help PictureControlExtend.js * * ピクチャ関連のイベントコマンドの機能を拡張します。 * 専用のプラグインコマンドを実行します。 * コマンドの詳細はプラグインコマンドから確認できます。 * * 各種コマンド(※1)はすでに表示されているピクチャに対してのみ有効です。 * 「ピクチャの表示」で表示してから各種コマンドを実行します。 * * ※1 ピクチャの一括操作を除く *　 * このプラグインの利用にはベースプラグイン『PluginCommonBase.js』が必要です。 * 『PluginCommonBase.js』は、RPGツクールMZのインストールフォルダ配下の * 以下のフォルダに格納されています。 * dlc/BasicResources/plugins/official * * 利用規約： * 作者に無断で改変、再配布が可能で、利用形態（商用、18禁利用等） * についても制限はありません。 * このプラグインはもうあなたのものです。 */ (() => { 'use strict'; const script = document.currentScript; PluginManagerEx.registerCommand(script, 'MULTI_CONTROL', args => { $gameScreen.setupPictureTarget(args); }); PluginManagerEx.registerCommand(script, 'MULTI_CONTROL_CLEAR', args => { $gameScreen.clearPictureTarget(); }); PluginManagerEx.registerCommand(script, 'PICTURE_SHAKE', function(args) { $gameScreen.shakePicture(args.pictureId, args); if (args.wait) { this.wait(args.duration); } }); PluginManagerEx.registerCommand(script, 'PICTURE_SPIN', function(args) { if (args.relative) { $gameScreen.spinPictureRelative(args.pictureId, args); } else { $gameScreen.spinPicture(args.pictureId, args); } if (args.wait) { this.wait(args.duration); } }); PluginManagerEx.registerCommand(script, 'PICTURE_OUT_OF_SHAKE', function(args) { $gameScreen.setOutOfScreenShakePicture(args.pictureId, args); }); PluginManagerEx.registerCommand(script, 'PICTURE_ORIGIN', function(args) { $gameScreen.setPictureOrigin(args.pictureId, args); }); PluginManagerEx.registerCommand(script, 'PICTURE_COPY', function(args) { $gameScreen.copyPicture(args.srcPictureId, args.destPictureId); }); PluginManagerEx.registerCommand(script, 'PICTURE_FLASH', function(args) { $gameScreen.flashPicture(args.pictureId, args); if (args.wait) { this.wait(args.duration); } }); PluginManagerEx.registerCommand(script, 'PICTURE_TO_MAP', function(args) { $gameScreen.setPictureToMap(args.pictureId, args); }); PluginManagerEx.registerCommand(script, 'PICTURE_BLUR', function(args) { $gameScreen.setPictureBlur(args.pictureId, args.value); }); PluginManagerEx.registerCommand(script, 'PICTURE_HUE', function(args) { $gameScreen.setPictureHue(args.pictureId, args.hue); }); /** * Game_Screen */ Game_Screen.prototype.setupPictureTarget = function(target) { this._pictureTargets = this.findPictureTarget(target); this._pictureTragetVariable = target.variable; }; Game_Screen.prototype.clearPictureTarget = function() { this._pictureTargets = null; this._pictureTragetVariable = 0; }; Game_Screen.prototype.findPictureTarget = function(target) { const list = []; if (target.all) { this.appendPictureNumber(1, this.maxPictures(), list); } else { if (target.startNumber && target.endNumber) { this.appendPictureNumber(target.startNumber, target.endNumber, list); } if (target.list) { return list.concat(target.list); } } return list; }; Game_Screen.prototype.appendPictureNumber = function(start, end, list) { for (let i = start; i <= end; i++) { list.push(i); } }; Game_Screen.prototype.iteratePictures = function(callBack, args) { if (this._pictureTargets) { this._pictureTargets.forEach(id => { args[0] = id; callBack.apply(this, args); }); } else { callBack.apply(this, args); } if (this._pictureTragetVariable > 0) { args[0] = $gameVariables.value(this._pictureTragetVariable); callBack.apply(this, args); } }; Game_Screen.prototype.copyPicture = function(srcId, destId) { const src = this.picture(srcId); if (src) { this.showPicture(destId, src.name(), src.origin(), src.x(), src.y(), src.scaleX(), src.scaleY(), src.opacity(), src.blendMode()); } } const _Game_Screen_showPicture = Game_Screen.prototype.showPicture; Game_Screen.prototype.showPicture = function() { this.iteratePictures(_Game_Screen_showPicture, arguments); }; const _Game_Screen_movePicture = Game_Screen.prototype.movePicture; Game_Screen.prototype.movePicture = function() { this.iteratePictures(_Game_Screen_movePicture, arguments); }; const _Game_Screen_rotatePicture = Game_Screen.prototype.rotatePicture; Game_Screen.prototype.rotatePicture = function() { this.iteratePictures(_Game_Screen_rotatePicture, arguments); }; const _Game_Screen_tintPicture = Game_Screen.prototype.tintPicture; Game_Screen.prototype.tintPicture = function() { this.iteratePictures(_Game_Screen_tintPicture, arguments); }; const _Game_Screen_erasePicture = Game_Screen.prototype.erasePicture; Game_Screen.prototype.erasePicture = function(pictureId) { this.iteratePictures(_Game_Screen_erasePicture, arguments); }; Game_Screen.prototype.setOutOfScreenShakePicture = function(pictureId, args) { this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.setOutOfScreenShake(args.value); } }, arguments); }; Game_Screen.prototype.shakePicture = function(pictureId, args) { const duration = args.duration === -1 ? Infinity : args.duration; this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.shake(args.power, args.speed, args.rotation, duration); } }, arguments); }; Game_Screen.prototype.spinPicture = function(pictureId, args) { this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.spin(args.rotation, args.duration); } }, arguments); }; Game_Screen.prototype.spinPictureRelative = function(pictureId, args) { this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.spinRelative(args.rotation, args.duration); } }, arguments); }; Game_Screen.prototype.setPictureOrigin = function(pictureId, args) { this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.setCustomOrigin(args.ox, args.oy); } }, arguments); }; Game_Screen.prototype.setPictureToMap = function(pictureId, args) { this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.setPositionToMap(args.toMap); } }, arguments); }; Game_Screen.prototype.flashPicture = function(pictureId, args) { this.iteratePictures((pictureId, args) => { const picture = this.picture(pictureId); if (picture) { picture.flash([args.red, args.green, args.blue, args.alpha], args.duration); } }, arguments); }; Game_Screen.prototype.setPictureBlur = function(pictureId, value) { this.iteratePictures(pictureId => { const picture = this.picture(pictureId); if (picture) { picture.setBlur(value); } }, arguments); }; Game_Screen.prototype.setPictureHue = function(pictureId, hue) { this.iteratePictures(pictureId => { const picture = this.picture(pictureId); if (picture) { picture.setHue(hue); } }, arguments); } /** * Game_Picture */ const _Game_Picture_x = Game_Picture.prototype.x; Game_Picture.prototype.x = function() { let x = _Game_Picture_x.apply(this, arguments); if (this.isPositionToMap()) { const tile = $gameMap.tileWidth(); x = Math.round($gameMap.adjustX(x / tile) * tile); } x += this.getShakeX(); if (this._outOfScreenShake) { // for DirectivityShake.js if ($gameScreen.getShakeRotation) { const shakeRotation = $gameScreen.getShakeRotation(); const shakeDistance = Math.round($gameScreen.shake()); x -= Math.cos(shakeRotation) * shakeDistance; } else { x -= Math.round($gameScreen.shake()); } } return x; }; const _Game_Picture_y = Game_Picture.prototype.y; Game_Picture.prototype.y = function() { let y = _Game_Picture_y.apply(this, arguments); if (this.isPositionToMap()) { const tile = $gameMap.tileHeight(); y = Math.round($gameMap.adjustY(y / tile) * tile); } y += this.getShakeY(); if (this._outOfScreenShake) { // for DirectivityShake.js if ($gameScreen.getShakeRotation) { const shakeRotation = $gameScreen.getShakeRotation(); const shakeDistance = Math.round($gameScreen.shake()); y -= Math.sin(shakeRotation) * shakeDistance; } } return y; }; Game_Picture.prototype.setCustomOrigin = function(ox, oy) { this._customOrigin = {ox: ox / 100, oy: oy / 100}; }; Game_Picture.prototype.customOrigin = function() { return this._customOrigin; }; Game_Picture.prototype.setPositionToMap = function(value) { this._positionToMap = !!value; }; Game_Picture.prototype.isPositionToMap = function() { return this._positionToMap; } Game_Picture.prototype.setOutOfScreenShake = function(value) { this._outOfScreenShake = !!value; }; Game_Picture.prototype.spin = function(targetRotation, duration) { this._targetRotation = targetRotation; this._angle = (this._angle % 360); if (duration === 0) { this._angle = this._targetRotation; } else { this._spinDuration = duration; } }; Game_Picture.prototype.spinRelative = function(targetRelativeRotation, duration) { this._angle = (this._angle % 360); this.spin(this._angle + targetRelativeRotation, duration); }; Game_Picture.prototype.shake = function(power, speed, rotation, duration) { this.stopShake(); this._shakePower = power; this._shakeSpeed = speed; this._shakeDuration = duration; this._shakeRotation = rotation * Math.PI / 180; }; Game_Picture.prototype.stopShake = function() { this._shakeDirection = 1; this._shake = 0; }; Game_Picture.prototype.flash = function(color, duration) { this._flashColor = color.clone(); this._flashDuration = duration; }; Game_Picture.prototype.clearFlash = function() { this._flashColor = null; this._flashDuration = 0; }; Game_Picture.prototype.getFlash = function() { return this._flashColor; }; Game_Picture.prototype.setBlur = function(value) { this._blur = value; }; Game_Picture.prototype.isBlur = function() { return this._blur; }; Game_Picture.prototype.setHue = function(hue) { this._hue = hue; }; Game_Picture.prototype.getHue = function() { return this._hue; }; const _Game_Picture_update = Game_Picture.prototype.update; Game_Picture.prototype.update = function() { _Game_Picture_update.apply(this, arguments); this.updateSpin(); this.updateShake(); this.updateFlash(); }; Game_Picture.prototype.updateSpin = function() { if (this._spinDuration > 0) { const d = this._spinDuration; this._angle = (this._angle * (d - 1) + this._targetRotation) / d; this._spinDuration--; } }; Game_Picture.prototype.updateShake = function() { if (this._shakeDuration > 0 || this._shake !== 0) { const delta = (this._shakePower * this._shakeSpeed * this._shakeDirection) / 10; if (this._shakeDuration <= 1 && this._shake * (this._shake + delta) < 0) { this._shake = 0; } else { this._shake += delta; } if (this._shake > this._shakePower * 2) { this._shakeDirection = -1; } if (this._shake < -this._shakePower * 2) { this._shakeDirection = 1; } this._shakeDuration--; } else { this._shakeDuration = 0; } }; Game_Picture.prototype.updateFlash = function() { if (this._flashDuration > 0) { const d = this._flashDuration; this._flashColor[3] *= (d - 1) / d; this._flashDuration--; } else if (this._flashColor) { this.clearFlash(); } } Game_Picture.prototype.getShakeX = function() { return this._shake ? this._shake * Math.cos(this._shakeRotation) : 0; }; Game_Picture.prototype.getShakeY = function() { return this._shake ? this._shake * Math.sin(this._shakeRotation) : 0; }; const _Sprite_Picture_updateOrigin = Sprite_Picture.prototype.updateOrigin; Sprite_Picture.prototype.updateOrigin = function() { _Sprite_Picture_updateOrigin.apply(this, arguments); if (this.picture()) { const origin = this.picture().customOrigin(); if (origin) { this.anchor.x = origin.ox; this.anchor.y = origin.oy; } } }; const _Sprite_Picture_update = Sprite_Picture.prototype.update; Sprite_Picture.prototype.update = function() { _Sprite_Picture_update.apply(this, arguments); this.updateFlash(); this.updateBlur(); this.updateHue(); }; Sprite_Picture.prototype.updateFlash = function() { const picture = this.picture(); if (picture) { const flash = picture.getFlash(); if (flash) { this.setBlendColor(flash); } } }; Sprite_Picture.prototype.updateBlur = function() { const picture = this.picture(); if (picture && picture.isBlur()) { if (!this._blur) { this.addBlurFilter(); } } else if (this._blur) { this.removeBlurFilter(); } }; Sprite_Picture.prototype.updateHue = function() { const picture = this.picture(); if (picture) { const hue = picture.getHue(); if (hue !== undefined) { this.setHue(hue); } } }; Sprite_Picture.prototype.addBlurFilter = function() { if (!this.filters) { this.filters = []; } if (!this.filters.some(filter => filter instanceof PIXI.filters.BlurFilter)) { this.filters.push(new PIXI.filters.BlurFilter()); } this._blur = true; }; Sprite_Picture.prototype.removeBlurFilter = function() { if (this.filters) { this.filters = this.filters.filter(filter => !(filter instanceof PIXI.filters.BlurFilter)); } this._blur = false; } })();