ピクチャ色相回転フィルタープラグイン - SimilarColorRotatePictureFilter.js

シェア用テキスト：

▼ピクチャ色相回転フィルタープラグイン（村人Ａ様作） - SimilarColorRotatePictureFilter.js
https://plugin-mz.fungamemake.com/archives/8656
ピクチャ色相回転フィルタープラグイン

ふりがな：ぴくちゃしきそうかいてんふぃるたーぷらぐいん

機能概要： ピクチャ色相回転フィルタープラグイン

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

作者：村人Ａ

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

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

ファイル名：SimilarColorRotatePictureFilter.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc 指定色について、縦方向（正規化したRGB比率＝同系統）と横方向（色相のずれ）の各許容差異を百分率で設定し、対象ピクセルの色相を指定角度だけ回転させるフィルターです。  
 * マップ開始時やセーブ＆ロード後も再適用されます。
 * @author 村人Ａ
 *
 * @command onFilter
 * @text フィルターのON
 * @desc 指定したピクチャ上で、対象色の同系統（縦方向）および色相ずれ（横方向）のピクセルに色相回転を適用します。
 *
 * @arg pictureId
 * @text 対象ID
 * @desc フィルターを適用するピクチャIDを指定します。
 * @default 1
 * @type number
 * @min 1
 *
 * @arg sourceColor
 * @text 対象色
 * @desc 色相回転の基準となる色を16進数（例: #8A5228）で指定します。
 * @default #8A5228
 *
 * @arg verticalTolerance
 * @text 縦方向許容差異
 * @desc 正規化したRGB各成分の比率の差の許容値を百分率で指定します（例: 10で10%）。
 * @default 10
 * @type number
 *
 * @arg horizontalTolerance
 * @text 横方向許容差異
 * @desc 色相のずれの許容値を百分率で指定します（例: 5で5%）。
 * @default 5
 * @type number
 *
 * @arg hueRotation
 * @text 色相回転
 * @desc 対象色と同系統または色相が近いピクセルの色相を回転させる角度（度数、例: 30）。
 * @default 30
 * @type number
 *
 * @command offFilter
 * @text フィルターのOFF
 * @desc 指定したピクチャからフィルターを解除します。
 *
 * @arg pictureId
 * @text 対象ID
 * @desc フィルター解除対象のピクチャIDを指定します。
 * @default 1
 * @type number
 * @min 1
 *
 * @help
 * ============================================================================
 * ■ プラグイン概要
 * ============================================================================
 * 本プラグインは、指定したピクチャ上で、  
 * ・【縦方向】：同系統の色の濃淡  
 * ・【横方向】：色相のずれ  
 * を、百分率の許容差異で判定し、  
 * 該当するピクセルの色相を指定の角度だけ回転させます。
 *
 * 例えば、指定色 **#8A5228** の場合、  
 * ・縦方向（RGB比率）：正規化するとほぼ同じRGB比率となる色（例：#D67F3F や #1F1209）  
 * ・横方向（色相）：色相がずれている色（例：#8A52A8 や #8A0028）  
 * が、それぞれユーザー指定の百分率（例：縦10%、横5%）以内で判定されます。
 *
 * マップ開始時やセーブ＆ロード後に自動的に再適用されます。
 *
 * ============================================================================
 * ■ プラグインコマンド
 * ============================================================================
 * ◇ フィルター適用（onFilter）
 *  ・対象ピクチャID  
 *  ・対象色（例: #8A5228）  
 *  ・縦方向許容差異（百分率、例: 10 → 10%）  
 *  ・横方向許容差異（百分率、例: 5 → 5%）  
 *  ・色相回転角度（度数、例: 30）
 *
 * ◇ フィルター解除（offFilter）
 *  ・対象ピクチャID
 *
 * ============================================================================
 * ■ 更新履歴
 * ============================================================================
 * - 2025/03/21 Ver.1.0.0: リリース
 *
 * ============================================================================
 * ■ お問い合わせ
 * ============================================================================
 * 不具合や要望は、以下までご連絡ください。  
 * Twitter: ＠rpgmaker_villaA  
 * Email: villaa.contact＠gmail.com