【HSPプログラミング講座#19】スプライト機能を表示してみよう

今回のＨＳＰ言語プログラミング講座では、実際にスプライトを表示するところまでやってみたいと思います。　前回のプログラミング講座でもあったように、意味がわからない部分が多いのでワタクシも色々なテストプログラムを書いて、実行して、直してを繰り返しながら進めて行きますね！

スプライトを表示する最小プログラム

説明書を読んだり、他の人のプログラムを読みながら「スプライトを表示するために最低限必要なプログラムは何だろう？」という視点でやってみた結果、下記のようなプログラムが完成しました。　とにかく必要最低限の状態にしないと、どのような動きになっているのかを理解するのが大変ですからね。

上記のプログラムが、スプライトを表示するための最小限のプログラムだと思いますが、今まで勉強してきた命令が見当たらなくて、新しい命令ばかりで嫌になりそうですよね。。　ワタクシも同感でございます。。　でもまぁ調べてみて、わかったところを解説していきますね。

１行目は前回のプログラミング講座でも出てきた「インクルード」です。　前回これを宣言するだけで意味不明になりましたね（涙）　未だによくわかりませんが、スプライト機能を利用するために必要らしいので、あまり深いことは考えずに「準備」だと割り切ってしまいましょう。　そして自動的にウインドウのサイズが横幅３２０ドット、縦幅４８０ドットになってしまうという謎の現象も起きるんでしたね！　覚えていますよね！？

３行目は、スプライトの初期化をしています。と言っても全然意味がわかりませんよね。　これもインクルードと同じように、とりあえず書かないと動作してくれません。　この「 es_ini 」をすることで、自動的に取り扱いできるスプライトの数が５１２個分確保されるようです。　それから前回も少し説明していますが、バッファと呼ばれる領域（表示されない裏の画面）に画像を置いて、そこからスプライトとして扱いたい部分を切り出して、キャラクタとして登録するということでした。　そのキャラクタの取り扱いできる数として１０２４個分確保されます。

５行目はもはや「呪文」のようですが、ここではバッファと呼ばれる領域（表示されない裏の画面）に画像を貼り付ける作業をしています。「 celload 」という命令の読み方は「セルロード」ですかね？　たぶんセル画の「セル」のことだと思いますが、そこに画像を読み込む（ロードする）という意味になるのでしょう。

“C:\\hsp36\\sample\\game\\mapbg.bmp”,1

celload命令の右側に上記の青色部分は、「Cドライブの中にある【hsp36】フォルダの中にある【sample】フォルダの中にある【game】フォルダの中にある「mapbg.bmp」というファイルを読み込みなさい」という内容が書いてあります。　書き方としては、フォルダとフォルダの間に「\\」を入れて、全体を「”」ダブルクォーテーションで囲います。　なんとなくの理解で構いませんよ。　そしてこのmapbg.bmpファイルは下記のRPGのマップのような画像ファイルです。　現時点（2023/06/10）でのHSP言語の最新版がインストールされていれば、このファイルはあなたのパソコンにも入っていると思います。　ちなみに、このファイルの場所を示している文を「パス」と言いますよ。　そして、このパスのあとに続く赤色部分の「1」は、読み込み先ウインドウIDを指定します。　これは上記で説明している、バッファと呼ばれる領域（表示されない裏の画面）または仮想画面（非表示のウィンドウ）などとも表現しますが、全部同じことを指しています。　今回は番号に１番を指定しています。　現時点でわかったことは０番以外なら良さそうです。　０番は表示が見える表の画面のようです。

７行目の「 es_size 」はキャラクタの横幅と縦幅を決めています。下記のRPGのマップのような画像は１つが横幅６４ドット、縦幅６４ドットになっているので、es_size 64,64 と書いています。　これは比較的わかりやすいですよね。

９行目の「 es_pat 」はキャラクタを登録する命令です。 se_pat のあとに続く「 0,128,0,0,1 」を順番に説明していきます。　ちなみに、何かの命令の右側に入れる文字や数字のことを「パラメータ」と言いますので、頭の片隅にでも置いといてください。　第１パラメータは「キャラクタ番号」です。　プログラムの最初の方で書いた「 es_ini 」で１０２４個分の場所が確保されています。　数字で表すと０～１０２３個となります。　なので今回は一番先頭のキャラクタ番号０を登録先とします。　その後の第２パラメータと第３パラメータは下記のRPGのマップのような画像のx座標とy座標を表しています。　１つの絵柄は横幅６４ドット、縦幅６４ドットと説明しましたね。　下記の画像のx座標１２８ドット、y座標０ドットの位置を指定していますが、これは「家の画像の左上」の位置を指しています。　ここをスタート位置として横幅６４ドット、縦幅６４ドットの大きさで、キャラクタ番号０番の中に登録します。という意味になりますよ。　ちょっとややこしいですが、わからなければ何度も読み返してみてくださいね。　第４パラメータは今のところ０を入れると覚えておいてください（一定時間で自動的にキャラクタをチェンジするために使うようです）　第５パラメータはウインドウバッファIDです。　これも繰り返しですが上記で説明している、バッファと呼ばれる領域（表示されない裏の画面）または仮想画面（非表示のウィンドウ）のことで、下記のRPGのマップのような画像が入っている場所を示しています。　今回は１番を使っていましたね。　まとめると「１番の仮想画面に貼り付けた下記の画像のx座標１２８ドット、y座標０ドットの位置を基準にして、横幅６４ドット、縦幅６４ドットを切り抜いて、キャラクタ番号０番に登録する」という、とてつもなく長い意味になります。　わかります？

１１行目の「 gcel命令 」は操作したいウインドウIDを指示する命令です。　ここでは０を指定しているので「見える方の画面」つまり仮想画面ではなく、表示されて目に見える画面をこれから操作しますよ。という意味になります。

１３行目の「 es_set命令 」は「キャラクタ番号とスプライト番号を紐づけてx座標とy座標に配置する」という意味の命令になります。　第１パラメータがスプライト番号、第２と第３パラメータがx座標とy座標です。　第４パラメータがキャラクタ番号となります。　ここで注意するのは「配置」しただけで「表示」はまだされません。　ホント難しいですね～

１５行目の「 es_draw命令 」で、登録された全てのスプライトを描きなさい。という命令です。　今回は１つしかスプライトを登録していないので、１つだけ描かれます。　と言っても上記と同じ注意点が出てきます。　スプライトを描いていますが、まだ表示（見える状態）にはなっていません（汗）　まだかよっ！（怒）　はい。その気持、よ～くわかります。

１７行目の「 redraw命令 」で１を指定することでやっと画面に表示（見える状態）にしれくれます。　

いやぁ～、ココまで長かったですね～　説明するのも非常に大変でした。　しかも説明が本当にこれで良いのか不安だし。　ただとりあえずワタクシが調べて、色々試してみた結果、これがスプライトを表示するために必要な最低限のプログラムでした。

最後に実行してみましょう！

いかがでしょうか？　たぶん一度に理解するのは難しいと思いますから、頭を整理しながら、紙と鉛筆で絵を描いたりしながら理解を進めて行ってくださいね。　まぁとにかくスプライトが表示できてよかったぁ～