キャラクターマークアップフィルタープラグイン - MarkupCharacterFilter.js

シェア用テキスト：

▼キャラクターマークアップフィルタープラグイン（村人Ａ様作） - MarkupCharacterFilter.js
https://plugin-mz.fungamemake.com/archives/8639
キャラクターマークアップフィルタープラグイン

ふりがな：きゃらくたーまーくあっぷふぃるたーぷらぐいん

機能概要： キャラクターマークアップフィルタープラグイン

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

作者：村人Ａ

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

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

ファイル名：MarkupCharacterFilter.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc キャラクター（プレイヤーまたはイベント）にマークアップフィルターを適用します。
 * @author 村人Ａ
 *
 * @command onFilter
 * @text フィルターのON
 * @desc マークアップフィルターを適用開始します。
 *
 * @arg EventId
 * @text 対象ID
 * @desc フィルターをかける対象のイベントIDを指定します。0でプレイヤーになります。
 * @default 0
 * @type number
 *
 * @arg color1
 * @text 線の色１
 * @desc キャラクター周囲に表示する線の1色目（R，G，B形式、0~255）
 * @default 255，150，0
 *
 * @arg color2
 * @text 線の色２
 * @desc キャラクター周囲に表示する線の2色目（R，G，B形式、0~255）
 * @default 255，0，0
 *
 * @command offFilter
 * @text フィルターを終わる
 * @desc マークアップフィルターを終了させます。
 *
 * @arg EventId
 * @text 対象ID
 * @desc フィルターをはずす対象のイベントID。0でプレイヤーになります。
 * @default 0
 * @type number
 *
 * @help
 * ============================================================================
 * バージョン
 * ============================================================================
 * 
 * 24/12/14 ver1.1 不具合修正
 * 24/12/13 ver1.0 リリース
 * 
 * 
 * ============================================================================
 * 概要
 * ============================================================================
 * このプラグインは、プレイヤーまたは特定のイベントキャラクターに、
 * マークアップ用のラインエフェクトを付与するフィルターを適用します。
 *
 * フィルターON時、キャラクターの周囲に指定した2色のラインパターンが
 * 重ね描画され、キャラクターが強調されます。
 * 色はパラメータとしてR，G，Bで指定し、キャラクター外枠部分に複数ピクセル単位の
 * アウトライン的な効果が繰り返し描かれます。
 *
 * 注意：  
 * キャラチップ画像が余白を持たずにぴったり描かれている場合、
 * フィルターによるラインが一部切れて表示される場合があります。
 * 必要に応じて画像側に若干の余白（パディング）を持たせてください。
 *
 * ============================================================================
 * プラグインコマンド
 * ============================================================================
 * ### フィルターのON/OFF (onFilter)
 * 指定したキャラクター（イベントまたはプレイヤー）にマークアップフィルターを適用します。
 *
 * - **EventId**  
 *   0でプレイヤー、それ以外の場合、該当IDのイベントキャラが対象になります。
 *
 * - **color1， color2**  
 *   2つの色を「R，G，B」の形式で指定します。0~255の範囲内で設定し、
 *   フィルターとして適用される線の色合いとなります。
 *
 * ### フィルターを終わる (offFilter)
 * 指定したキャラクターに適用中のフィルターを終了します。
 *
 * - **EventId**  
 *   0でプレイヤー、それ以外の場合、該当IDのイベントキャラのフィルターを解除します。
 *
 * ============================================================================
 * 使い方
 * ============================================================================
 * 1. **プラグインの導入**  
 *    プラグインマネージャーで「villaA_MarkupCharacterFilter.js」を有効にします。
 *
 * 2. **フィルターの適用**  
 *    イベントコマンド「プラグインコマンド」から「フィルターのON/OFF (onFilter)」を選び、
 *    対象IDと2色のカラーコード（R，G，B）を指定します。
 *
 *    例：  
 *    EventId: 0（プレイヤー）  
 *    color1: 255，150，0  
 *    color2: 255，0，0  
 *
 *    実行後、対象キャラクターに色付きラインが表示され、強調されます。
 *
 * 3. **フィルターの解除**  
 *    「フィルターを終わる (offFilter)」を実行し、対象IDを指定すれば、
 *    指定キャラクターからラインエフェクトが外され、元の表示に戻ります。
 *
 * ============================================================================
 * 注意事項
 * ============================================================================
 * - キャラクター画像に余白がない場合、ラインが見切れる可能性があります。
 *   必要に応じて画像に余白を追加してください。
 * - フィルター適用中は、若干の描画負荷増加が考えられます。
 * - 他の描画系プラグインやフィルターとの併用時には動作テストをお勧めします。
 *
 * ============================================================================
 * 不具合報告
 * ============================================================================
 * 不具合はXやメールで報告してください。
 * Xアカウント：＠rpgmaker_villaA
 * メール：villaa.contact＠gmail.com
 *