es_bgmap

BGマップを初期化

es_bgmap p1,p2,p3,p4,p5,p6,p7,p8

p1=BGNo.(0~15)
p2=マップデータを格納する変数名
p3(16)=マップ全体のXサイズ
p4(16)=マップ全体のYサイズ
p5(16)=マップ表示部分のXサイズ
p6(16)=マップ表示部分のXサイズ
p7(0)=マップパーツを格納する画面バッファID
p8(0)=設定オプション

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

解説

任意のサイズを持つBGマップを初期化します。
p1で初期化するBGNo.を指定します。BGNo.は0~15までを指定可能です。
p2にマップデータを格納する変数を指定します。
この変数はあらかじめ、「マップ全体のXサイズ×マップ全体のYサイズ」の要素を持つ配列変数としてdim命令で初期化されている必要があります。
(p3,p4)でマップ全体のX,Yサイズを指定します。
(p5,p6)でマップを表示する部分のX,Yサイズを指定します。
p3~p6のパラメーターは、いずれもマップセルの単位となります。たとえば、全体サイズが4×4だった場合は、「dim map,4*4」で初期化した変数を指定することになります。
この変数は、直接マップデータの内容を持ち値が0の場合は、マップのセルNo.が0というように、セルNo.をそのまま格納します。(セルNo.は、celput命令で指定される分割画像No.と同じものです)<br>
p7で、マップパーツ(セル)の画像が読み込まれている画面バッファIDを指定します。このバッファには、あらかじめpicloadまたはcelload命令により画像を読み込んでおく必要があります。(マップセル画像は、celdiv命令によりセルサイズを設定してください。)
p8の設定オプションにより、BGマップの挙動を設定します。

     p8  マクロ名          内容
-----------------------------------------------------------------------
      1  ESBGOPT_NOTRANS   セル描画時に透過を行わない
  0x100  ESBGOPT_USEMASK   セル画像のマスクパターンを使用する(未実装)

es_bgmap命令はマップ表示に関する設定を行います。実際のマップ表示は、es_putbg命令で行います。

実行後にシステム変数statに値が返ります。正常に命令が完了した場合は0以上の値が返ります、何らかの理由でエラーになった場合はマイナス値が返ります。

関連項目

es_putbgBGマップを表示(HSP3Dish)
dim配列変数を作成
celload画像ファイルをバッファにロード
celdiv画像素材の分割サイズを設定

サンプル逆引き (7)

es_test11.hsp
es_test7.hsp
es_test8.hsp
maptest1.hsp
maptest2.hsp
maptest3.hsp
maptest4.hsp

情報

プラグイン / モジュールHSP3Dish
バージョン3.7
作成日2025/02/04
著作者onitama
URLhttps://hsp.tv/
備考hsp3dish.asをインクルードすること。
タイプ拡張命令
グループ拡張画面制御命令
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\sprite.hs