108 lines
4.1 KiB
JavaScript
108 lines
4.1 KiB
JavaScript
/*:
|
||
* @target MZ
|
||
* @plugindesc v1.0.3 ピクチャのフェード切り替えを実現するプラグイン
|
||
* @author なｚな
|
||
* @help
|
||
* このプラグインを使用すると、表示中のピクチャを別のピクチャに
|
||
* フェード効果で切り替えることができます。
|
||
*
|
||
* @command PictureFadeSwitch
|
||
* @text ピクチャフェード切り替え
|
||
* @desc ピクチャをフェード効果で別のピクチャに切り替えます。
|
||
*
|
||
* @arg targetPictureId
|
||
* @text 切り替え対象ピクチャID
|
||
* @desc 切り替える対象のピクチャID
|
||
* @type number
|
||
* @min 1
|
||
*
|
||
* @arg dummyPictureId
|
||
* @text ダミーピクチャID
|
||
* @desc フェードに使用する前面のピクチャID
|
||
* @type number
|
||
* @min 1
|
||
* @desc 切り替え対象より前面に表示するため、切り替え対象ピクチャIDより大きい値を指定してください
|
||
*
|
||
* @arg newPicturePath
|
||
* @text 切り替え先ピクチャのパス
|
||
* @desc 切り替え先の画像ファイルパス
|
||
* @type file
|
||
* @dir img/pictures
|
||
*
|
||
* @arg fadeDuration
|
||
* @text フェード時間
|
||
* @desc フェードにかける時間（フレーム数）
|
||
* @type number
|
||
* @min 1
|
||
* @default 30
|
||
*
|
||
* @arg waitForCompletion
|
||
* @text 完了までウェイト
|
||
* @desc フェード処理が完了するまでウェイトするかどうか
|
||
* @type boolean
|
||
* @on はい
|
||
* @off いいえ
|
||
* @default true
|
||
*
|
||
* @license MIT
|
||
*
|
||
* @help
|
||
* プラグイン作者: なｚな
|
||
*
|
||
* 概要:
|
||
* 「ピクチャの表示」などで予め通常通り表示したピクチャIDに対し、フェードで切り替えをします。
|
||
*
|
||
* 使い方:
|
||
* 「プラグインコマンド」から、各パラメータを指定して実行してください。
|
||
*
|
||
*
|
||
* 利用規約:
|
||
* MITライセンスです。
|
||
* https://licenses.opensource.jp/MIT/MIT.html
|
||
* 作者に無断で改変、再配布が可能で、
|
||
* 利用形態（商用、18禁利用等）についても制限はありません。
|
||
*/
|
||
|
||
(() => {
|
||
const pluginName = "PictureFadeSwitch";
|
||
|
||
PluginManager.registerCommand(pluginName, "PictureFadeSwitch", args => {
|
||
const targetPictureId = Number(args.targetPictureId);
|
||
const dummyPictureId = Number(args.dummyPictureId);
|
||
const newPicturePath = args.newPicturePath;
|
||
const fadeDuration = Number(args.fadeDuration);
|
||
const waitForCompletion = args.waitForCompletion === "true";
|
||
|
||
// 元のピクチャの情報を取得
|
||
const picture = $gameScreen.picture(targetPictureId);
|
||
const xPosition = picture ? picture.x() : 0;
|
||
const yPosition = picture ? picture.y() : 0;
|
||
const scaleX = picture ? picture.scaleX() : 100;
|
||
const scaleY = picture ? picture.scaleY() : 100;
|
||
const oldPicturePath = picture ? picture._name : "";
|
||
|
||
// 前面に新しいピクチャを表示（透明度0で開始）
|
||
$gameScreen.showPicture(dummyPictureId, newPicturePath, 0, xPosition, yPosition, scaleX, scaleY, 0, 0);
|
||
|
||
// ピクチャの移動処理 (フェードイン)
|
||
$gameScreen.movePicture(dummyPictureId, 0, xPosition, yPosition, scaleX, scaleY, 255, 0, fadeDuration);
|
||
|
||
if (waitForCompletion) {
|
||
// ウェイトを行う場合
|
||
$gameMap._interpreter.wait(fadeDuration);
|
||
}
|
||
|
||
// フェードイン完了後にピクチャを切り替える
|
||
setTimeout(() => {
|
||
// 競合を防ぐため、切り替え対象のピクチャがまだ同じか確認
|
||
const currentPicture = $gameScreen.picture(targetPictureId);
|
||
if (currentPicture && currentPicture._name === oldPicturePath) {
|
||
// 切り替え対象のピクチャを新しいピクチャに切り替え
|
||
$gameScreen.showPicture(targetPictureId, newPicturePath, 0, xPosition, yPosition, scaleX, scaleY, 255, 0);
|
||
}
|
||
|
||
// ダミーピクチャを消去
|
||
$gameScreen.erasePicture(dummyPictureId);
|
||
}, fadeDuration * 16.67); // 1フレーム = 16.67ms
|
||
});
|
||
})();
|