es_putbg

BGマップを表示

es_putbg p1,p2,p3,p4,p5

p1=BGNo.(0～15)
p2(0)=表示開始X座標
p3(0)=表示開始Y座標
p4(0)=表示開始マップX位置
p5(0)=表示開始マップY位置

(プラグイン / モジュール : HSP3Dish)

解説

指定されたBGNo.のBGマップを表示します。
あらかじめes_bgmap命令でBGマップのサイズやセル情報などを初期化する必要があります。
(p2,p3)パラメーターで画面上の表示開始位置(左上)を指定します。
(p4,p5)パラメーターでマップの表示開始位置(左上)をドット単位で指定します。
通常は、マップ全体の中で(0,0)の位置からマップを表示します。
マップの表示開始位置を指定することにより、全体マップの一部を表示している時の、左上にあたるマップの位置を変更することができます。
広いマップをスクロール表示させるような場合に、マップの表示開始位置(p4,p5)を利用することができます。
命令実行後、システム変数statに表示されたマップパーツ(セル)に含まれていたイベントアトリビュートの個数が返ります。
イベントアトリビュートの情報は、es_getbghit命令で取得することができます。
取得されるイベントアトリビュート情報は、ESMAPHIT_NOTICE、ESMAPHIT_EVENTのみになります。

es_bgparam命令により、アトリビュートグループ値(ESMAP_PRM_GROUP)が設定されている場合は、特定のグループが設定されているセルNo.のみを表示します。
また、アトリビュート値にアニメーションのフラグが設定されている場合は、セルNo.にアニメーションインデックス値(ESMAP_PRM_ANIM)が加算されたものが表示されます。

何らかの理由でマップ表示に失敗した場合は、システム変数statにマイナス値が返ります。

関連項目

サンプル逆引き (7)

情報