NRP 文章の表示時に立ち絵を表示 - NRP_MessagePicture.js

シェア用テキスト：

▼NRP 文章の表示時に立ち絵を表示（砂川赳様作） - NRP_MessagePicture.js
https://plugin-mz.fungamemake.com/archives/6038
文章の表示時に立ち絵となるピクチャを表示します。名前欄の文字列を参照し、自動で表示することが可能です。また、差分なども想定した作りになっています。衣装や表情などの差分だけを差し替えることも可能です。

ふりがな：ぶんしょうのひょうじじにたちえをひょうじ

機能概要： 文章の表示時に立ち絵となるピクチャを表示します。名前欄の文字列を参照し、自動で表示することが可能です。また、差分なども想定した作りになっています。衣装や表情などの差分だけを差し替えることも可能です。

利用規約（ライセンス）：
・著作権：保持
・商用利用：許可
・追加改変：許可
・再配布：許可
・詳細はダウンロードページ・プラグイン内を確認

作者：砂川赳

作者サイト：https://newrpg.seesaa.net//

解説ページ：https://newrpg.seesaa.net/article/489210228.html

ファイル名：NRP_MessagePicture.js

プラグインのヘルプ：

/*:ja
 * @target MZ
 * @plugindesc v1.08 文章の表示時に立ち絵を表示する。
 * @author 砂川赳（http://newrpg.seesaa.net/）
 * @url http://newrpg.seesaa.net/article/489210228.html
 *
 * @help 文章の表示時に立ち絵となるピクチャを表示します。
 * 名前欄の文字列を参照し、自動で表示することが可能です。
 * 
 * また、差分なども想定した作りになっています。
 * 衣装や表情などの差分だけを差し替えることも可能です。
 * 
 * ピクチャの複数表示やアニメーションといった
 * 既存のプラグインに匹敵するような高度な機能はありません。
 * あくまでシンプルなものを目指しています。
 * 
 * -------------------------------------------------------------------
 * ■名前欄で自動認識
 * -------------------------------------------------------------------
 * 『ピクチャリスト』の『対象文字列』に条件とする名前を設定し、
 * ピクチャを紐づけてください。
 * 
 * 対象文字列の例：リード、n[1]
 * ※制御文字や制御文字を変換した名前も有効です。
 * 
 * これだけでＯＫです。
 * 文章の表示時に指定したピクチャが表示されるようになります。
 * 
 * なお、ピクチャを表示する座標などはプラグインパラメータで設定できます。
 * ピクチャ毎に調整することも可能です。
 * 
 * -------------------------------------------------------------------
 * ■登録ＩＤで指定
 * -------------------------------------------------------------------
 * 名前で識別できない場合はＩＤで指定することもできます。
 * （例えば、名前が判明していない初登場のキャラクターなど。）
 * 
 * まずピクチャリストに『登録ＩＤ』を指定してください。
 * 形式は数値でも文字列でも構いません。
 * 
 * 後は名前欄の制御文字で登録ＩＤを指定すればＯＫです。
 * 登録ＩＤがAならば
 * 
 * - MP[A]
 * 
 * となります。
 * 
 * ※制御文字（MP）の部分は変更できます。
 * ※大文字小文字は問いません。mp[A]も有効です。
 * 
 * 名前を表示する場合も、
 * 
 * - 謎の少年MP[A]
 * 
 * というように表示名の前後に付ければＯＫです。
 * 
 * -------------------------------------------------------------------
 * ■ピクチャを表示しない
 * -------------------------------------------------------------------
 * ピクチャを自動表示したくない場合は、
 * 
 * - リードMP[0]
 * 
 * というように0を指定すれば、ピクチャが非表示になります。
 * 
 * また『ピクチャ無効スイッチ』をオンにすれば、ずっと非表示にできます。
 * 
 * -------------------------------------------------------------------
 * ■差分の表示
 * -------------------------------------------------------------------
 * 『ピクチャリスト』内の『差分リスト』を開き、
 * 『差分ＩＤ』と差分用のピクチャを紐づけてください。
 * 
 * 対象文字列がリードで差分ＩＤが『sad』とすると、
 * 名前欄を
 * 
 * - リードMPD[sad]
 * 
 * とすれば、差分が表示されます。
 * 
 * また、MPD[]に関しては本文内でも有効です。
 * 文章内で何度も表情を変えたい場合などに使えます。
 * 
 * -------------------------------------------------------------------
 * ■付属ピクチャの表示
 * -------------------------------------------------------------------
 * 付属ピクチャを指定すれば、
 * ベースとなるピクチャの上にさらにピクチャを重ねられます。
 * 
 * 例えば、スイッチと組み合わせれば、
 * 状況によって会話時のキャラクターの衣装を変更できます。
 * 
 * 付属ピクチャは『ピクチャリスト』『差分リスト』のいずれにも設定できます。
 * 特に『差分リスト』の場合は、ベースとなるピクチャを空欄にすれば、
 * 付属ピクチャのみを変更できます。
 * 
 * -------------------------------------------------------------------
 * ■利用規約
 * -------------------------------------------------------------------
 * 特に制約はありません。
 * 改変、再配布自由、商用可、権利表示も任意です。
 * 作者は責任を負いませんが、不具合については可能な範囲で対応します。
 * 
 * @------------------------------------------------------------------
 * @ プラグインパラメータ
 * @------------------------------------------------------------------
 * 
 * @param PictureList
 * @text ピクチャリスト
 * @type struct<Picture>[]
 * @desc 立ち絵の表示を行うピクチャの一覧です。
 * 
 * @param <PictureSetting>
 * @text ＜ピクチャ設定＞
 * 
 * @param PictureId
 * @parent <PictureSetting>
 * @text ピクチャ番号
 * @type number @min 0
 * @default 101
 * @desc 立ち絵のピクチャに使用する番号です。
 * 付属ピクチャはこれに続く連番となります。
 * 
 * @param Origin
 * @parent <PictureSetting>
 * @text 原点
 * @type select
 * @option 0:左上 @value 0
 * @option 1:中央 @value 1
 * @default 1
 * @desc ピクチャを表示する原点です。
 * 
 * @param X
 * @parent <PictureSetting>
 * @text Ｘ座標
 * @type number
 * @default 700
 * @desc ピクチャを表示するＸ座標です。
 * 
 * @param Y
 * @parent <PictureSetting>
 * @text Ｙ座標
 * @type number
 * @default 300
 * @desc ピクチャを表示するＹ座標です。
 * 
 * @param ScaleX
 * @parent <PictureSetting>
 * @text 拡大率（幅）
 * @type number
 * @default 100
 * @desc 横方向の拡大率です。
 * 100を基準に設定してください。
 * 
 * @param ScaleY
 * @parent <PictureSetting>
 * @text 拡大率（縦）
 * @type number
 * @default 100
 * @desc 縦方向の拡大率です。
 * 100を基準に設定してください。
 * 
 * @param Opacity
 * @parent <PictureSetting>
 * @text 不透明度
 * @type number @min 0 @max 255
 * @default 255
 * @desc ピクチャの不透明度です。
 * 255で完全な不透明になります。
 * 
 * @param BlendMode
 * @parent <PictureSetting>
 * @text 合成方法
 * @type select
 * @option 0:通常 @value 0
 * @option 1:加算 @value 1
 * @option 2:乗算 @value 2
 * @option 3:スクリーン @value 3
 * @default 0
 * @desc ピクチャを描画する合成方法です。
 * 
 * @param FadeInDuration
 * @parent <PictureSetting>
 * @text フェードイン時間
 * @type number
 * @desc ピクチャのフェードイン時間です。
 * 60が一秒に相当します。
 * 
 * @param ShowAboveWindow
 * @parent <PictureSetting>
 * @text ウィンドウより上に表示
 * @type boolean
 * @default false
 * @desc ピクチャをメッセージウィンドウより上に表示します。
 * 
 * @param LimitMessageWidth
 * @parent <PictureSetting>
 * @text 文章の横幅制限
 * @type number
 * @desc ピクチャ表示時、文章の横幅を指定した値に制限します。文字は自動的に縮小されます。
 * 
 * @param ShowBelowMessages
 * @parent <PictureSetting>
 * @text 文章より下に表示
 * @type boolean
 * @default false
 * @desc 『ウィンドウより上に表示』がオンの場合に、ピクチャを文章より下に表示します。
 * 
 * @param AdjustMessageX
 * @parent ShowBelowMessages
 * @text 文章のＸ座標調整
 * @type number
 * @default 16
 * @desc 『文章より下に表示』がオンの場合に、文章のＸ座標を調整します。
 * 
 * @param AdjustMessageY
 * @parent ShowBelowMessages
 * @text 文章のＹ座標調整
 * @type number
 * @default 20
 * @desc 『文章より下に表示』がオンの場合に、文章のＹ座標を調整します。
 * 
 * @param <Control>
 * @text ＜制御＞
 * 
 * @param ControlCharacterPicture
 * @parent <Control>
 * @text ピクチャ用制御文字
 * @type string
 * @default MP
 * @desc ピクチャ表示用の制御文字です。
 * デフォルトでは、MP[登録ID]のように使います。
 * 
 * @param ControlCharacterDifference
 * @parent <Control>
 * @text 差分用制御文字
 * @type string
 * @default MPD
 * @desc ピクチャの差分表示用の制御文字です。
 * デフォルトでは、MPD[差分ID]のように使います。
 * 
 * @param DisableSwitch
 * @parent <Control>
 * @text ピクチャ無効スイッチ
 * @type switch
 * @desc ピクチャの表示を無効化するスイッチです。
 */