マップ画面のノイズフィルタープラグイン - SimpleMapNoiseFilter.js

シェア用テキスト：

▼マップ画面のノイズフィルタープラグイン（村人Ａ様作） - SimpleMapNoiseFilter.js
https://plugin-mz.fungamemake.com/archives/8657
マップ画面のノイズフィルタープラグイン

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

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

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

作者：村人Ａ

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

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

ファイル名：SimpleMapNoiseFilter.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc マップ画面にノイズ(ざらつき)を加えるフィルター効果を適用します。徐々に指定強度までノイズが増していきます。
 * @author 村人Ａ
 *
 * @command switchFilter
 * @text フィルターのON
 * @desc ノイズフィルターを適用します。指定したフレーム数かけて段階的にノイズ強度が増します。
 *
 * @arg str
 * @text ノイズの強さ
 * @desc ノイズ強度を0～100で指定します。0でノイズなし、100で最大ノイズ。
 * @type number
 * @default 100
 * @min 0
 * @max 100
 *
 * @arg count
 * @text フレーム数
 * @desc 指定ノイズ強度に達するまでに要するフレーム数を指定します。
 * フレームが多いほどゆっくりノイズが強まります。
 * @type number
 * @default 60
 * @min 0
 * @max 9999
 *
 * @command offFilter
 * @text フィルターを終わる
 * @desc 現在適用中のノイズフィルターを解除して、元の表示に戻します。
 *
 * @help
 * ============================================================================
 * 概要
 * ============================================================================
 * このプラグインはマップ画面にノイズ（ざらついた映像）のフィルターを追加します。
 * フィルターのONコマンド（switchFilter）でノイズ強度(0～100)と時間(フレーム数)を
 * 指定すると、その時間をかけて徐々にノイズが強くなります。
 * 
 * offFilterコマンドでフィルターを解除するとノイズがなくなり、
 * もとのクリアな画面表示に戻ります。
 *
 * ============================================================================
 * プラグインコマンド
 * ============================================================================
 * ### フィルターのON (switchFilter)
 * ノイズフィルターを適用し、指定フレーム数をかけてノイズ強度が増加します。
 *
 * - **ノイズの強さ（str）**
 *   0～100で指定。100が最大ノイズです。
 *
 * - **フレーム数（count）**
 *   ノイズ強度が指定値に達するまでにかける時間（フレーム）を指定します。
 *   大きいほど、徐々にノイズがかかっていく演出ができます。
 *
 * ### フィルターを終わる (offFilter)
 * 現在適用中のノイズフィルターを即座に解除します。
 * これによりノイズはなくなり、画面は通常表示に戻ります。
 *
 * ============================================================================
 * 使い方
 * ============================================================================
 * 1. **プラグイン導入**
 *    プラグインマネージャーで「SimpleMapNoiseFilter.js」を有効にしてください。
 *
 * 2. **ノイズフィルター適用**
 *    プラグインコマンド「フィルターのON (switchFilter)」で
 *    ノイズの強さとフレーム数を指定します。
 *
 *    例:
 *    ノイズの強さ:50， フレーム数:120  
 *    実行後、120フレームかけてノイズ強度が0から50に徐々に増加します。
 *
 * 3. **フィルター解除**
 *    プラグインコマンド「フィルターを終わる (offFilter)」でノイズを解除します。
 *    これによりノイズは消え、クリアな画面表示に戻ります。
 *
 * 例：
 * ```
 * ◆プラグインコマンド：SimpleMapNoiseFilter， フィルターのON
 * ：ノイズの強さ: 100， フレーム数: 60
 * （60フレームかけてノイズが徐々に最大までかかる）
 *
 * --- 時間経過後またはイベント進行後 ---
 *
 * ◆プラグインコマンド：SimpleMapNoiseFilter， フィルターを終わる
 * （ノイズが取り除かれ、元の画面へ戻る）
 * ```
 *
 * ============================================================================
 * 注意事項
 * ============================================================================
 * - ノイズフィルター適用中は描画負荷が増加する場合があります。
 * - 他のフィルターや描画系プラグインと併用する場合は事前に動作確認を行ってください。
 *
 * ============================================================================
 * 不具合報告
 * ============================================================================
 * 不具合はXやメールで報告してください。
 * Xアカウント：＠rpgmaker_villaA
 * メール：villaa.contact＠gmail.com
 *