マップ画面の蜃気楼フィルタープラグイン - MirageFilter.js

シェア用テキスト：

▼マップ画面の蜃気楼フィルタープラグイン（村人Ａ様作） - MirageFilter.js
https://plugin-mz.fungamemake.com/archives/8644
マップ画面の蜃気楼フィルタープラグイン

ふりがな：まっぷがめんのかいやぐらふぃるたーぷらぐいん

機能概要： マップ画面の蜃気楼フィルタープラグイン

利用規約（ライセンス）：https://www.rpgmaker-script-wiki.xyz/kiyaku.php

作者：村人Ａ

作者サイト：https://www.rpgmaker-script-wiki.xyz/index.php

解説ページ：https://rpgmaker-script-wiki.xyz/MirageFilter_mzplugin.…

ファイル名：MirageFilter.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc マップ画面に蜃気楼のような歪み効果を与えるフィルターを適用します。
 * @author 村人Ａ
 *
 * @param amp
 * @text 揺れ幅
 * @desc 波の幅を指定します(初期値:5)。値が大きいほど揺れが強くなります。
 * @default 5
 * @type number
 *
 * @param frequency
 * @text 振動の速さ
 * @desc 波の振動の速さを指定します(初期値:2)。
 * 2を基準として、大きいほど振動が速く、小さいほど遅くなります。
 * @default 2
 * @type number
 *
 * @command switchFilter
 * @text フィルターのON/OFF
 * @desc 蜃気楼フィルターを適用開始します。
 *
 * @command fadeoutFilter
 * @text フィルターを終わる
 * @desc 蜃気楼フィルターを徐々に弱め、自然な形で終了させます。
 *
 * @help
 * ============================================================================
 * バージョン管理
 * ============================================================================
 * 24/12/10 ver 1.0 リリース
 *
 * ============================================================================
 * 概要
 * ============================================================================
 * このプラグインは、マップ画面に蜃気楼(ミラージュ)のようなゆらめく歪み効果を
 * 付与するフィルターを適用します。フィルターをONにすると、地面や背景が波打つ
 * ような視覚効果が追加され、暑い砂漠や異世界の雰囲気を演出することができます。
 * また、フェードアウト機能を使うことで、揺らめきを自然に収束させ、違和感なく
 * 効果を終了させることが可能です。
 *
 * ============================================================================
 * パラメータ
 * ============================================================================
 * - **揺れ幅（amp）**
 *   波の振幅（ゆらめきの強さ）を指定します。
 *   値が大きいほどゆらめきが激しくなります。
 *
 * - **振動の速さ（frequency）**
 *   揺れが進行する速さを指定します。2が基準値で、それより大きくすれば速く、
 *   小さくすれば遅くなります。
 *
 * これらの値を調整することで、マップ上の蜃気楼表現を微調整できます。
 *
 * ============================================================================
 * プラグインコマンド
 * ============================================================================
 * ### フィルターのON/OFF (switchFilter)
 * 蜃気楼フィルターを適用開始します。
 * 実行後、マップ上に揺らめく歪み効果が発生します。
 *
 * ### フィルターを終わる (fadeoutFilter)
 * 適用中の蜃気楼フィルターを自然に収束させます。
 * 実行後、ゆらめきは徐々に弱まり、最終的にフィルターが自動的に解除されます。
 *
 * ============================================================================
 * 使い方
 * ============================================================================
 * 1. **プラグインの導入**
 *    プラグインマネージャーで「MirageFilter.js」を有効にしてください。
 *
 * 2. **パラメータ設定**
 *    - `揺れ幅（amp）`でゆらめきの強さを調節します。
 *    - `振動の速さ（frequency）`で揺れが進行する速度を変更します。
 *
 * 3. **フィルターの適用・解除**
 *    イベントで「プラグインコマンド」を使用します。
 *    - 「フィルターのON/OFF (switchFilter)」で蜃気楼効果を開始
 *    - 「フィルターを終わる (fadeoutFilter)」で徐々に収束させて終了
 *
 * 例:
 * ```
 * ◆プラグインコマンド：MirageFilter， フィルターのON/OFF
 * （マップが蜃気楼状態に）
 *
 * --- イベント進行後またはしばらく待った後 ---
 *
 * ◆プラグインコマンド：MirageFilter， フィルターを終わる
 * （ゆらめきがゆっくりと収まる）
 * ```
 *
 * ============================================================================
 * 注意事項
 * ============================================================================
 * - フィルター適用中は描画負荷が若干増加する場合があります。
 * - 他の描画系プラグインやフィルターとの併用時には挙動を確認してください。
 * - 利用規約は以下からご確認ください。
 *   https://www.rpgmaker-script-wiki.xyz/kiyaku.php
 *
 * ============================================================================
 * 不具合報告
 * ============================================================================
 * 不具合はXやメールで報告してください。
 * Xアカウント：＠rpgmaker_villaA
 * メール：villaa.contact＠gmail.com
 *