hspdx
Version 0.12
Date 2002/12/01
Author Sinagawa(original by onitama)
拡張画面制御命令
es_adir
スプライト移動方向設定
スプライトを自動的に移動させるための設定をします。
p1でスプライトNo.、p2で方向を指定します。方向は、0~63までの数値で指定
します。0が真下となり、反時計回りに増加していきます。
p3で移動スピードを%で指定します。
es_aim
スプライト参照座標設定
es_aim命令は、 es_adir命令と同じく指定した方向にスプライトを移動させる
ためのものです。 es_aim命令では、方向の替わりに移動する目標となるX,Y座
標を指定します。スプライトは、現在の座標から、目標となる座標への方向を
計算し移動を開始します。
es_ang
角度取得
システム変数statに(p1,p2)から見た(p3,p4)の方向が返ります。
es_aimを使っても方向を得ることはできますが、この命令を使えばスプライト
を使わずに方向を得ることができます。
es_apos
スプライト移動設定
スプライトを自動的に移動させるための設定をします。
p1でスプライトNo.、p2,p3でX,Y方向の増分を指定します。
p4で移動スピードを%で指定します。
es_area
スプライト有効エリア設定
スプライトの有効エリアを設定します。
スプライト座標が (p1,p2)-(p3,p4) の範囲内にないものは、 自動的に削除さ
れます。
スプライトの表示範囲が設定されると (es_window命令)自動的に、スプライト
有効エリアも再設定されます。
es_boxf
矩形塗りつぶし
(p1,p2)-(p3,p4)の矩形範囲を現在選択されている色で塗りつぶします。 色の
選択は、color命令で行ないます。
es_buffer
VRAMイメージ転送
属性スイッチ=0 : オフスクリーンバッファをVRAMに取る、
失敗した場合は、メインメモリに取る
属性スイッチ=1 : オフスクリーンバッファをメインメモリに取る
属性スイッチ=2 : オフスクリーンバッファをVRAMに取る
es_bye
システム解放
HSPDX.DLLシステムの切り離しをします。
画面モードをウィンドウモードに戻し、確保されていたメモリをすべて解放し
ます。 これは、クリーンアップ関数としてHSP終了時に自動的に呼び出されま
す。
es_caps
DirectXシステム情報取得
DirectX のドライバが、どのような機能を持っているかを調べて、結果をp1で
指定する変数に代入します。
p2の情報IDと、p3の情報ビットについての詳細は、
「 HSPDX.DLL REFERENCE MANUAL 」 のDDCAPS一覧を参照してください。
es_check
衝突判定取得
スプライト同士の衝突判定を行ないます。
p2で指定されたスプライトNo. と衝突している (重なっている) スプライトを
検索して、p1で指定した変数に結果を代入します。
p3で衝突判定の対象となるtype値を指定することができます。
es_chr
chr値設定
p1で指定したスプライトのキャラクタNo.を変更します。
es_clear
複数スプライト削除
p1で指定したスプライトNo. 以降のスプライトが削除され未登録になります。
p2で削除されるスプライトの数を指定することができます。
p1とp2の指定を省略した場合は、すべてのスプライトが削除されます。
es_cls
画面クリア
この命令は、画面全体を指定した色でクリアします。
p1,p2,p3でクリアする色をRGBコードで指定可能です。
実際には、指定したRGBに最も近い色を持つパレットでクリアされます。
p1,p2,p3の指定を省略すると、黒でクリアします。
es_copy
画像コピー
es_copy命令では、pos命令で指定した座標に、 gmodeで指定したサイズとモー
ドでp1で指定したIDの(p2,p3)の座標から画像がコピーされます。
HSPの gcopy命令とは若干違いがありますが、 ほぼ同じ記述でコピーが可能で
す。
es_draw
スプライト描画
登録されているスプライトを画面に描画します。
通常は p1,p2のパラメータを省略して使用すれば、すべてのスプライトを描画
することが可能です。
登録されているスプライトの一部だけを描画したい場合は、p1に開始スプライ
トNo.、p2に描画する個数を指定してください。
es_fill
矩形塗りつぶし
es_boxf命令と同じく指定した矩形範囲を塗りつぶすための命令です。
異なる点は、 es_fill命令では、塗りつぶす色をパレット番号で指定します。
塗りつぶす大きさ(サイズ)は、gmode命令で指定したサイズになります。
es_find
スプライト検索
登録されているスプライトの中で指定した type値を持つもののスプライトNo.
を検索します。
p2のtype値には、複数のtypeを同時に指定することができます。
たとえば、type1とtype4を対象にする場合は、1+4で5を指定します。
es_flag
flag値設定
p1で指定したスプライトのflag値を変更します。
flag値は、スプライトが有効になっている場合は、 $100(256)が自動的に設定
されています。通常は特にいじる必要はありません。
es_fmes
フォント指定文字列表示
カレントポジション (pos命令で指定されたX,Y座標) から、指定した文字列を
表示します。文字の色は、現在選択されている色 (color命令で指定)になり、
フォントは font命令で選択されているものが使用されます。
es_get
スプライト情報取得
p1で指定した変数名に、p2のスプライトNo.の情報を代入します。
情報の種類は、 p3の info number で指定します。
es_getbuf
VRAMイメージ読み出し
DirectXが管理する画像バッファの内容を、HSPのウィンドウに読み出しコピー
します。読み出しは、現在 gsel命令で選択されているHSPのウィンドウIDに対
して行なわれます。
p1で、DirectXのバッファIDを指定します。
es_getfps
FPS取得
1秒間に es_sync命令が実行された回数を、p1で指定した変数に代入します。
es_ini
システムの初期化
HSPDX.DLLシステムの初期化を行ないます。
パラメータを省略すると、スプライトは512個まで、 キャラクタ定義数は1024
個までを最大としてスプライトを初期化します。es_ini命令は何度でも実行す
ることができるので、スプライトをすべてクリアしたい時などにも使用可能で
す。
es_kill
スプライト削除
p1で指定したスプライトNo.を削除します。
es_link
アニメーション設定
キャラクタのループアニメーションを設定するための命令です。
p1で指定したキャラクタNo.が、指定されたフレームだけ表示した後に、 p2で
指定したキャラクタNo.に戻るように設定を行ないます。
es_mes
文字列表示
カレントポジション (pos命令で指定されたX,Y座標) から、指定した文字列を
表示します。
es_fmes命令と似ていますが、 文字の色やフォントが選べないかわりに、こち
らの方が高速に処理されます。
文字の色は、常に白 (RGB=255) となり、標準フォントが使用されます。
es_new
新規スプライト取得
スプライトNo.の中で使われていないNo.を検索します。
p2で指定したNo.以降で空きのあるNo.を、p1で指定した変数に代入します。
es_offset
オフセット座標設定
すべてのスプライトの表示を、オフセット値で指定した数だけずらして表示し
ます。 この命令で設定したオフセット値は、es_draw命令で描画を行なった時
に反映されます。
es_opt
システムオプション設定
拡張機能のオプション値を設定する命令です。
es_palfade
パレットフェード
p1で画像の明るさを設定します。p1が0の時が通常 ( 設定パレットのまま )で
す。 p1がマイナス値になるほど画像は暗くなり、 プラス値になるほど明るく
なります。 p1が-256で完全な黒になり、256 で完全な白になります。
p2でフェードのスピードを指定することができます。
es_palset
パレット変更
パレットの色を設定します。p1で指定したパレット番号に、p2,p3,p4がそれぞ
れR,G,Bとなる色を設定します。
es_palset命令による設定変更は、命令実行時すぐには反映されません。
es_pat
キャラクタ画像定義
スプライトのキャラクタパターンを定義します。
p1はキャラクタNo.、(p2,p3) の座標から、es_sizeで設定した大きさのキャラ
クタが登録されます。ここで対象となる画像は、直前に es_buffer命令でVRAM
に転送された画像データとなります。
es_pos
スプライト座標設定
スプライトの座標を変更します。
p1でスプライトNo.を指定して、(p2,p3) でX,Y座標を設定します。
es_posは、設定済みのスプライトの座標だけを変更する命令です。
es_put
キャラクタ画面表示
スプライト用のキャラクタパターンとして登録されているデータを、指定した
座標に表示します。この命令は、スプライトとは関係なく画面にキャラクタを
転送する命令です。
es_screen
画面モードの変更
画面の解像度を変更し、DirectXが使用可能な状態にします。
(p1,p2)で解像度を指定します。通常は、(640,480)を指定します。
p3はカラーモードを指定します。 パレットモードを使用する場合は8、ハイカ
ラー以上を使用する場合は16,24,32のいずれかを指定します。
es_set
スプライト設定
スプライトを登録します。
p1は、スプライトNo.(0~511)、(p2,p3)は画面上でのスプライトの座標になり
ます。この座標を左上として、 p4で指定したキャラクタNo.が表示されます。
スプライト座標は、-32767~32767 までの範囲が設定可能です。
es_size
キャラクタサイズ指定
スプライトのキャラクタパターンを定義する際の、サイズを指定します。
(p1,p2)がキャラクタのX,Yサイズになります。
p3は当たり判定を行なう際のヒットチェック領域が、 何%になるかを指定しま
す。
es_sync
画面更新とウェイト
描画された画面を更新するとともに、以前の es_sync命令実行時から経過した
時間を測定して、システム変数statに返します。
p1で、最低でも何msのウェイトを取るかを指定することができます。
p1を省略するか、0を指定した場合は最低ウェイト時間はなくなります。
es_timer
タイマー取得
Windowsを起動してからの経過時間をミリ秒単位で、 p1に指定した変数に代入
します。精度は環境に依存します。
es_type
type値設定
p1で指定したスプライトのtype値を変更します。
type値についての詳細は、「HSPDX.DLL REFERENCE MANUAL」の「type値の設定に
ついて」を参照してください。
es_window
スプライト表示エリア設定
この命令により、スプライトを画面内の限られた範囲内にのみ表示することが
可能です。指定した範囲内がスプライトの表示エリアになります。
スプライト以外の描画命令には、この範囲は適用されません。
es_xfer
バッファ間画像コピー
es_copy命令と同じく画像イメージのコピーを行ないますが、 コピー先を画面
上だけではなく、別なバッファなども指定することができます。
p1で指定したバッファIDにp2で指定したバッファIDのイメージを転送します。
es_zoom
拡大縮小画像コピー
es_zoom命令では、 pos命令で指定した座標に、gmodeで指定したサイズとモー
ドでp1で指定したIDの(p2,p3)の座標から画像がコピーされます。
ただし、コピー先のサイズはobjsize命令で指定したサイズが使われます。