Custom Menu Canvas

■ 立ち絵

メニューステータス :bust で使用されます。
画像は、Graphics/Pictures フォルダに保存してください。
ファイル名・サイズに制限はありません。
詳細はこちらをご覧ください。

■ 画像

メニューステータス :pict で使用されます。
画像は、Graphics/Pictures フォルダに保存してください。
ファイル名・サイズに制限はありません。
詳細はこちらをご覧ください。

■ 数字画像

メニューステータス :num で使用されます。
画像は、Graphics/Pictures フォルダに保存してください。
ファイル名・サイズに制限はありません。
詳細はこちらをご覧ください。

■ 残りＨＰで顔グラを変化させる

EXPRESSIVE_RATE = [50, 25, 0]

最大３要素の配列で設定します。空配列 [] にすると変化させません。

画像のように 100 以下、第１要素(A)以下、第２要素(B)以下、第３要素(C)以下の
最大４つの画像が使用できます。その場合、顔グラの編集が必要です。
ＨＰが100%の場合のみの画像を設定する場合は、第１要素に99を入れます。
戦闘不能の場合のみの画像を設定する場合は、最後の要素に0を入れてください。

■ 顔グラをまとめる

COLLECT_FACE = false

trueにすると、アクターの顔グラと同じ行を表情グラとして使用します。
falseにすると、顔グラと同じファイルの一行目を表情グラとして使用します。

■ 立ち絵のファイル名

PORTRAIT_NAME = "MActor%d"

個別にファイル名が設定されていない場合に使用される共通のファイル名です。
次の文字は、それぞれの値に置換されます。%1$d アクターＩＤ、%2$d 表情番号
表情番号は、EXPRESSIVE_RATE の設定によって、0～3 までの数値に変化します。

アクターごとにファイル名を設定する場合は、次のスクリプトを実行してください。

$game_actors[アクターＩＤ].portrait_name = "ファイル名"

この設定を解除して共通の設定に戻す場合は、次のスクリプトを実行してください。

$game_actors[アクターＩＤ].portrait_name = nil

■ 立ち絵の変更

$game_actors[n].portrait_name

ファイル名を文字列で代入してください。
n には、変更するアクターのＩＤが入ります。
例）$game_actors[1].portrait_name = "MActor1-1"

■ メニューステータスの設定

[識別子, x, y, パラメータ = デフォルト値] のように = が書かれたパラメータは
省略できます。複数ある場合は、間を飛ばして設定することはできません。
スクリプト中では、actorで描画中のアクターの情報が取得できます。

[:name, x, y, width = 124]

アクターの名前を表示します。

[:class, x, y, width = 124]

アクターのクラスを表示します。

[:nick, x, y, width = 124]

アクターの二つ名を表示します。

[:level, x, y, width = 64]

アクターのレベルを表示します。

[:lv_g, x, y, width = 64]

アクターのレベルをゲージ付きで表示します。

[:face, x, y, size = 96]

アクターの顔グラを表示します。
size を数値または配列で設定した場合、次のようになります。

数値

表示サイズが size になるように四方の縁を切り取ります。

[size]

画像を拡大縮小します。

[w, h]

[横幅, 縦幅]になるように拡大縮小します。

[x, y, w, h]

[x, y] の位置から [w, h] のサイズになるように縁を切り取ります。

※ 待機メンバーの顔グラも半透明にはなりません。
例）ITEM_PARAMS << [:face, 0, 0, [32,0,48,96]]

[:chara, x, y]

アクターの歩行グラを表示します。

[:icon, x, y]

アクターのアイコン(24x24)を表示します。

[:bust, x, y]

アクターの立ち絵を表示します。

[:state, x, y, width = 96, align = 0]

アクターのステートアイコンを表示します。
align が 0 なら左寄せ、1 なら中央寄せ、2 なら右寄せで表示します。

[:hp, x, y, width = 124]

アクターのＨＰゲージを表示します。

[:mp, x, y, width = 124]

アクターのＭＰゲージを表示します。

[:tp, x, y, width = 124]

アクターのＴＰゲージを表示します。

[:exp, x, y, width = 124]

アクターの経験値ゲージを表示します。

[:param, x, y, param_id, width = 124]

アクターのパラメータを表示します。

param_id
  0 : 最大ＨＰ    1 : 最大ＭＰ    2 : 攻撃力    3 : 防御力
  4 : 魔法力      5 : 魔法防御    6 : 敏捷性    7 : 運

[:fill, x, y, width, height, color, script = nil]

矩形で塗り潰します。
color は、「カラーの設定」のカラー番号以外での設定ができます。
script を設定した場合は、結果が真のときのみ描画します。

[:pict, x, y, file, script = nil]

ピクチャフォルダにある画像を表示します。

file

表示する画像のファイル名です。
文字列 "" か配列 [file1, file2] で設定します。

script

実際に描画する画像を判定するためのスクリプトです。

script を省略した場合は、評価をせずに画像を描画します。

評価結果が真偽値で file が文字列の場合、true のときのみ描画します。
file を配列で設定している場合は、true のとき file1 を false のとき file2 を描画します。
script を省略した場合は、"actor.battle_member?" を評価し、その結果を使用します。
つまり、戦闘メンバーなら file1 それ以外なら file2 の画像を描画します。

評価結果が真偽値以外で file が文字列の場合、評価結果を引数として sprintf(file, result) の画像を描画します。
file が配列の場合は、評価結果を添え字として file[result] の画像を描画します。

例）[:pict, 0, 0, "file"]
　画像 "file" を表示します。
例）[:pict, 0, 0, ["file"]]
　アクターが戦闘メンバーなら画像 "file" を表示します。
例）[:pict, 0, 0, ["file1","file2"]]
　アクターが戦闘メンバーなら "file1" を控えメンバーなら "file2" を表示します。
例）[:pict, 0, 0, "file", "script"]
　"script" が true のとき、画像 "file" を表示します。
例）[:pict, 0, 0, ["file1","file2"], "script"]
　"script" が true のとき "file1" を false のとき "file2" を表示します。
例）[:pict, 0, 0, ["file1","file2", ...], "script"]
　"script" の結果が数値のとき、番号の位置の file を表示します。0 から始まる。
例）[:pict, 0, 0, pattern, *"script"]
　sprintf(pattern, *"script"の結果) の結果の画像を表示します。
　[:pict, 0, 0, "Actor-%d", "actor.id"]

[:text, x, y, text]

文字を表示します。
ここでは特別な制御文字\{アクターのプロパティ}が使えます。
例）ID\{id}, Level\{level}, 名前\{name}, 現在HP\{hp}, 最大HP\{maxhp}

[:num, x, y, num, file]

数値を画像に置き換えて表示します。

num

数値か文字列(スクリプト)

file

文字列(ファイル名) 0-9+-αの１３種

数字と + と - と半角スペース以外の文字では、１３番目の画像が使われます。
そのため 12/23 としたい場合は / の画像にし 120% としたい場合は % の画像にしてください。
例）[:name, 0, 0, "'%04d'%actor.hp", "num"]

■ 制御文字

『スクリプト素材の使い方』で文字列の設定方法について確認してください。

\n

改行されます。

\\

バックスラッシュに置き換えられます。

\V[n]

変数 n 番の値に置き換えられます。

\S[n,on,off]

スイッチ n 番の値によって、その後の文字に置き換えられます。
例）\S[1,ＯＮ時,ＯＦＦ時]

\N[n]

アクター n 番の名前に置き換えられます。

\P[n]

パーティメンバー n 番の名前に置き換えられます。

\I[n]

アイコン n 番を描画します。

\C[n]

以降の文字を n 番の色で表示します。

\{

文字サイズを１段階大きくします。(デフォルトの半分の大きさ)
\{{ や \{{{ と記述すると、それぞれ \{\{ や \{\{\{ に置き換えられます。

\}

文字サイズを１段階小さくします。(デフォルトの半分の大きさ)
\}} や \}}} と記述すると、それぞれ \}\} や \}\}\} に置き換えられます。

\$

所持金に置き換えられます。

\G

通貨単位に置き換えられます。

\T
\T[format]

プレイ時間に置き換えられます。
format を省略した場合は、'%3d:%02d:%02d' となります。
%1$d 時間, %2$d 分, %3$d 秒, %4$d 経過分, %5$d 経過秒
例）\T[%4$3d分%3$02d秒]

\W

歩行数に置き換えられます。

\X[n]

文字の描画位置(ｘ座標)を設定します。
n が符号付きだった場合は、位置をずらします。

\Y[n]

文字の描画位置(ｙ座標)を設定します。
n が符号付きだった場合は、位置をずらします。

\L[width, size, opt]

ラインの描画を行います。
描画色は、現在の文字色と同じものになります。
width で長さ、size で太さ、opt でオプションを設定します。

オプションは、設定するオプションのアルファベットを並べて設定します。
AFH 長さ(width)を文字数で設定します。未設定時は、ピクセル単位です。

A 自動で文字幅を調節します。
F 全角文字での幅
H 半角文字での幅

TMB ラインの描画位置を設定します。

T 行の上に描画します。
M 行の中央に描画します。
B 行の下に描画します。(デフォルト)

X ラインの幅だけｘ座標を進めます。
S ラインの下に影を描画します。
例）\L[100,1], \L[5,2,AS]

\L[x, y, width, height, color]

矩形の描画を行います。
color を省略した場合は、描画色で塗りつぶされます。
color は、「カラーの設定」の文字列でのみ設定ができます。
ただし、先頭の 0x は省略できず、" や ' はいりません。
例）\L[0,0,100,1,0x08]

\I[filename, x, y]
\P[filename, x, y]

ピクチャフォルダにある画像を描画します。
例）\I[Actor1,0,0]

\F[actor_id, x, y]
\F[filename, face_index, x, y]

フェイスフォルダにある画像を描画します。
例）\I[1,0,0]

<%script%>

script を実行した結果に置き換えられます。

■ カラーの設定

カラー番号

ウィンドウスキンにあるカラーテーブルの番号です。
文章の表示などで使用する制御文字と同じ番号です。

数値

0xRRGGBBAA
※ 数値での指定では、一切の省略ができません。
0 は黒ではなく透明ですので注意してください。
アルファチャンネルの値が必要になるので黒は 255 になります。
※ よくわからない方は「カラーコード」や「色 16進数」などで検索してください。

シンボル、文字列

0 ～ 9 、A ～ F の文字でカラーを設定します。

0xX        -> 0xXXXXXXFF (0x0        -> 0x000000FF)
0xXA       -> 0xXXXXXXAA (0x08       -> 0x00000088)
0xRGB      -> 0xRRGGBBFF (0xF84      -> 0xFF8844FF)
0xRGBA     -> 0xRRGGBBAA (0xF848     -> 0xFF884488)
0xRRGGBB   -> 0xRRGGBBFF (0xFF2345   -> 0xFF2345FF)
0xRRGGBBAA -> 0xRRGGBBAA (0xFF234580 -> 0xFF234580)

※ 上記パターン以外は、数値として処理されます。
※ 先頭の 0 もしくは、0x は省略できます。

クラス

Color.new(red, green, blue[, alpha])

配列

[red, green, blue[, alpha]]

■