制御文字を拡張するプラグイン – FTKR_ExEscapeCharacters.js

タイトル
制御文字を拡張するプラグイン
作者名
ヘルプ
-----------------------------------------------------------------------------
概要
-----------------------------------------------------------------------------
文章の表示等に使用できる制御文字に、以下の制御文字を追加します。

1. 画像の表示
\IMG[画像ファイル名(, 画像番号, 画像幅, 画像高さ, 画像拡大率, 表示位置)]

2. 行の高さの変更
\LH[行の高さ]

-----------------------------------------------------------------------------
設定方法
-----------------------------------------------------------------------------
1.「プラグインマネージャー(プラグイン管理)」に、本プラグインを追加して
ください。


-----------------------------------------------------------------------------
「画像の表示」機能
-----------------------------------------------------------------------------
以下の制御文字で画像を表示できます。

\IMG[画像ファイル名(, 画像番号, 画像幅, 画像高さ, 画像拡大率, 表示位置)]

画像ファイル名
:表示させたい画像のファイル名を指定します。
:画像ファイルは、/img/systemフォルダに保存してください。(1)

画像番号
:画像ファイル内の何番目の画像を表示するか指定します。
:アイコン画像のように、左上の画像を 0番、右上の画像を 15番、
:左上から一段下の画像を 16番として数えます。
:入力しない場合は、0番目の画像を表示します。

画像幅
:画像の幅を指定します。
:0を指定、または入力しない場合は、プラグインパラメータ<Image Width>の値を
:使用します。

画像高さ
:画像の高さを指定します。
:0を指定、または入力しない場合は、プラグインパラメータ<Image Height>の値を
:使用します。
:プラグインパラメータ<Enabled Adjust Height>を有効にした場合、
:画像の高さに合わせて以降の行の高さを自動で調整します。

画像拡大率
:100を基準として、画像の拡大率を指定します。
:入力しない場合は、元のサイズのまま表示します。

表示位置
:行の高さよりも、画像高さが小さい場合に、画像を表示する位置を設定できます。
: 中央(middle) - 中央揃えで表示
: 下揃え(bottom) - 下揃えで表示
:入力しない場合は、上揃えで表示します。

入力例)
\IMG[file]
画像ファイル file.png の 0番目の画像を表示する。
画像の幅と高さは、プラグインパラメータの値を使用する。

\IMG[file, 1, 48, 48, 80, 中央]
4848 の画像の画像ファイル file.png の 1番目の画像を80%に
縮小して表示する。
このとき、1行が48よりも大きい場合に中央揃えで表示する。

(1):画像ファイルは、プラグインパラメータ<Advance Load File>に
ファイル名を入力することで、ゲーム起動時に事前に読み込むことが
できます。
事前に読み込んでいない画像の場合、ゲーム起動後の最初の画像表示の際に
正しく表示できない場合があります。


-----------------------------------------------------------------------------
「行の高さの変更」機能
-----------------------------------------------------------------------------
以下の制御文字で行の高さの変更できます。

\LH[行の高さ]

行の高さ
:この制御文字以降の1行の高さを、pixel単位で指定します。
:MV標準の行の高さは 36 です。
:0 を指定すると、標準の高さに変更します。

入力例)
\LH[48]


-----------------------------------------------------------------------------
本プラグインのライセンスについて(License)
-----------------------------------------------------------------------------
本プラグインはMITライセンスのもとで公開しています。
This plugin is released under the MIT License.

Copyright (c) 2017 Futokoro
http://opensource.org/licenses/mit-license.php


-----------------------------------------------------------------------------
変更来歴
-----------------------------------------------------------------------------

v1.0.2 - 2017/03/28 : 不具合修正

v1.0.1 - 2017/03/27 : 機能追加
1. 制御文字「行の高さの変更」を追加
2. 制御文字「画像の表示」に、行の高さと表示位置の調整機能を追加

v1.0.0 - 2017/03/27 : 初版作成

-----------------------------------------------------------------------------
パラメータ
param -- 画像の表示 --
desc

param Advance Load Files
desc ゲーム起動時に読み込む画像ファイル名を指定
複数ある場合は、カンマ(,)で区切ること
default

param Enabled Adjust Height
desc 画像高さに合わせて、行の高さを自動調整する
0 - 無効にする, 1 - 有効にする
default 0

param Image Width
desc 制御文字\IMG[]で表示する画像の幅
default

param Image Height
desc 制御文字\IMG[]で表示する画像の高さ
default

ライセンス表記
本プラグインのライセンスについて(License)
本プラグインはMITライセンスのもとで公開しています。
This plugin is released under the MIT License.
Copyright (c) 2017 Futokoro
http://opensource.org/licenses/mit-license.php
//=======↓本プラグインを改変した場合でも、この欄は消さないでください↓===============
//=======↑本プラグインを改変した場合でも、この欄は消さないでください↑===============

紹介ページ https://github.com/futokoro/RPGMaker