スプライト
SPSET スプライト番号,定義番号[,表示フラグ]
スプライトを作成する(定義テンプレートを利用)
SPSET共通要素
・SPSETによりスプライトは利用可能となる。
・SPSET実行により回転等の情報は全て初期化。
・スプライト変数はクリアされる。
・SPHIT系衝突判定を使う時はSPSET後にSPCOLを呼びます。
引数
スプライト番号
作成するスプライトの番号:0～4095
定義番号
SPDEFで定義したテンプレートの定義番号:0～8191
表示フラグ
作成したスプライトを表示するかどうかを指定する
・1で表示、0で表示しない。
・省略時は1。
例
SPSET 1,500
SPSET スプライト番号,U,V,W,H[,アトリビュート[,表示フラグ]]
スプライトを作成する(直接画像情報等を指定)
・SPDEFの値を使わずに独自に設定する場合に利用する。
引数
スプライト番号
作成するスプライトの番号:0～4095
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライトの大きさ:0～2048
アトリビュート
| b00 | ↑90度単位の回転(b00とb01の2ビットで指定) |
| b01 | ↓#A_ROT0、#A_ROT90、#A_ROT0180、#A_ROT270 |
| b02 | 横反転(0=OFF、1=ON)、#A_REVH |
| b03 | 縦反転(0=OFF、1=ON)、#A_REVV |
| b04 | 加算合成(0=OFF、1=ON)、#A_ADD |
・省略時は0。
表示フラグ
作成したスプライトを表示するかどうかを指定する
・1で表示、0で表示しない。
・省略時は1。
例
SPSET 54,0,0,32,32,1,0
SPSET(定義番号[,表示フラグ])
空いている番号を探してスプライトを作成し、番号を返す
・スプライト全体から空きを探す。
引数
定義番号
SPDEFで定義したテンプレートの定義番号: 0～8191
表示フラグ
作成したスプライトを表示するかどうかを指定する
・1で表示、0で表示しない。
・省略時は1。
返値
スプライト番号
生成されたスプライトの番号: 0～4095
・空きがなく生成できなかった時は-1が返る。
例
IX=SPSET(500)
SPSET(U,V,W,H,アトリビュート[,表示フラグ])
空いている番号を探してスプライトを作成し、番号を返す
・スプライト全体から空きを探す。
引数
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライトの大きさ:0～2048
アトリビュート
| b00 | ↑90度単位の回転(b00とb01の2ビットで指定) |
| b01 | ↓#A_ROT0、#A_ROT90、#A_ROT0180、#A_ROT270 |
| b02 | 横反転(0=OFF、1=ON)、#A_REVH |
| b03 | 縦反転(0=OFF、1=ON)、#A_REVV |
| b04 | 加算合成(0=OFF、1=ON)、#A_ADD |
表示フラグ
作成したスプライトを表示するかどうかを指定する
・1で表示、0で表示しない。
・省略時は1。
返値
スプライト番号
生成されたスプライトの番号:0～4095
・空きがなく生成できなかった時は-1が返る。
例
IX=SPSET(0,0,32,32,1)
SPSET(開始番号,終了番号,定義番号[,表示フラグ])
空いている番号を探してスプライトを作成し、番号を返す
・指定範囲内で空きを探す。
引数
開始番号,終了番号
空きを探す範囲(0～4095)
・開始番号の方を大きくすると、空き番号を降順で探す。
定義番号
SPDEFで定義したテンプレートの定義番号:0～8191
表示フラグ
作成したスプライトを表示するかどうかを指定する
・1で表示、0で表示しない。
・省略時は1。
返値
スプライト番号
生成されたスプライトの番号:0～4095
・空きがなく生成できなかった時は-1が返る。
例
IX=SPSET(100,120, 500)
SPSET(開始番号,終了番号,U,V,W,H,アトリビュート[,表示フラグ])
空いている番号を探してスプライトを作成し、番号を返す
・指定範囲内で空きを探す。
引数
開始番号,終了番号
空きを探す範囲(0～4095)
・開始番号の方を大きくすると、空き番号を降順で探す。
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライトの大きさ:0～2048
アトリビュート
| b00 | ↑90度単位の回転(b00とb01の2ビットで指定) |
| b01 | ↓#A_ROT0、#A_ROT90、#A_ROT0180、#A_ROT270 |
| b02 | 横反転(0=OFF、1=ON)、#A_REVH |
| b03 | 縦反転(0=OFF、1=ON)、#A_REVV |
| b04 | 加算合成(0=OFF、1=ON)、#A_ADD |
表示フラグ
作成したスプライトを表示するかどうかを指定する
・1で表示、0で表示しない。
・省略時は1。
返値
スプライト番号
生成されたスプライトの番号:0～4095
・空きがなく生成できなかった時は-1が返る。
例
IX=SPSET(100,120, 0,0,32,32,1)
SPCLR
全スプライトを削除する
・グラフィック表示用スプライト(4095)は削除されない。
例
SPCLR
SPCLR スプライト番号
指定スプライトを削除する
・利用後に削除しないとSPSETで指定できるスプライトの空きがなくなる。
引数
スプライト番号
削除するスプライトの番号:0～4095
例
SPCLR 56
SPCLR スプライト番号1,スプライト番号2
指定範囲のスプライトを削除する
引数
スプライト番号1
削除するスプライト範囲の番号開始位置:0～4095
スプライト番号2
削除するスプライト範囲の番号終了位置:0～4095
例
SPCLR 2,10
SPSHOW スプライト番号
SPSHOW スプライト番号,表示フラグ
スプライトを表示させる
・SPSET前に使うとエラー。
引数
スプライト番号
表示するスプライトの番号:0～4095
表示フラグ
表示する場合は1、表示しない場合は0
・省略時の値は1。
例
SPSHOW 43 SPSHOW 44, #TRUE
SPSHOW(スプライト番号)
スプライトが表示中かどうかを取得する
・SPSET前に使うとエラー。
引数
スプライト番号
確認するスプライトの番号:0～4095
返値
表示中であれば1,消えていたら0を返す
例
S = SPSHOW(43)
SPHIDE スプライト番号
SPHIDE スプライト番号,表示オフフラグ
スプライトの表示を隠す
・表示を隠すだけで、スプライトを削除するわけではない。
・SPSET前に使うとエラー。
引数
スプライト番号
表示を隠すスプライトの番号:0～4095
表示オフフラグ
表示を隠す場合1、表示する場合0
・省略時の値は1。
例
SPHIDE 43
SPHIDE(スプライト番号)
スプライトが消えているかどうかを取得する
・SPSET前に使うとエラー。
引数
スプライト番号
確認するスプライトの番号:0～4095
返値
表示中であれば0,消えていたら1を返す
例
H=SPHIDE(43)
SPHOME スプライト番号,座標X,座標Y
スプライトのホーム座標(座標基準点)を指定する
・ホーム座標はSPOFS(移動)、SPROT(回転)、SPSCALE(拡大・縮小)の基準点として使用する。
・SPCOL(衝突判定)では、始点X,Yを指定しない場合のデフォルト値としてSPHOMEの値を使用する。詳細はSPCOLの解説を参照。
・SPSET前に使うとエラー。
引数
スプライト番号
基準点を設定するスプライトの番号:0～4095
座標X,Y
スプライトの左上を原点(0,0)とした相対座標
・ハードウェアの仕様により、実数値を設定すると参照画像が1ピクセルずれる事がある。
例
SPHOME 34,16,16
SPHOME スプライト番号 OUT HX,HY
スプライトのホーム座標を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
スプライトの番号:0～4095
返値
HX,HY
ホーム座標
例
SPHOME 10 OUT HX,HY
SPOFS スプライト番号,[X],[Y][,Z]
スプライトを移動させる
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
X,Y
設定するスプライトの表示座標
・ハードウェアの仕様により、実数値を設定すると参照画像が1ピクセルずれる事がある。
Z
表示優先度：-4095～4095
・小さいほど手前に表示される。
例
SPOFS 23,50,80 SPOFS 23,,,1000 SPOFS 23,150,180,0
SPOFS スプライト番号[,座標系フラグ] OUT X,Y[,Z]
スプライトの表示座標を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
座標系フラグ
1の場合、スプライトの絶対座標を返す
0の場合、スプライトの相対座標を返す
・相対座標はSPOFSで設定した座標そのものを意味する。
・絶対座標はレイヤー上での表示座標を返す。
・両者はSPLINKを使用した時に異なる座標となる。
・省略時は0。
返値
X,Y
スプライトの座標
Z
表示優先順位
例
SPOFS 12 OUT X,Y,Z
SPROT スプライト番号,角度
スプライトを回転させる
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
角度
回転角度:0～360(時計回り)
・ハードウェアの仕様により、角度によって参照画像が1ピクセルずれる事がある。
例
SPROT 23,45
SPROT(スプライト番号)
スプライトの回転角度を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
DR
スプライトの角度
例
DR=SPROT(23)
SPSCALE スプライト番号,倍率X,倍率Y
スプライトのスケール(表示倍率)を変更する
・スケールを考慮した当たり判定は先にSPCOLを実行。
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
倍率X,Y
0.5(50%)～1.0(100%)～2.0(200%)～
・ハードウェアの仕様により、設定値によって参照画像が1ピクセルずれる事がある。
例
SPSCALE 56,0.75, 0.75
SPSCALE スプライト番号 OUT SX,SY
スプライトの表示倍率を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
SX,SY
スプライトの倍率
例
SPSCALE 45 OUT SX,SY
SPCOLOR スプライト番号,色コード
スプライトの表示色を設定する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
色コード
・実際の表示色は色コードに元のピクセル色を乗算した値。
例
SPCOLOR 1,RGB(16, 255,0,0) 'A=16,R=255,G=0,B=0
SPCOLOR(スプライト番号)
スプライトの表示色を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
色コード
スプライトに設定されている色コード
例
C=SPCOLOR(1)
SPCHR スプライト番号,定義番号
スプライトのキャラクタ定義を変更する
・SPSET前に使うとエラー。
引数
スプライト番号
定義を変更するスプライトの番号:0～4095
定義番号
SPDEF命令で登録したテンプレートの番号:0～8191
例
SPCHR 0,500
SPCHR スプライト番号,[U],[V],[W],[H],[アトリビュート]
スプライトのキャラクタ定義を変更する
・スプライト番号以外の引数は省略可能。
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライトの大きさ:0～2048
・省略時はW,Hとも16。
アトリビュート
| b00 | ↑90度単位の回転(b00とb01の2ビットで指定) |
| b01 | ↓#A_ROT0、#A_ROT90、#A_ROT0180、#A_ROT270 |
| b02 | 横反転(0=OFF、1=ON)、#A_REVH |
| b03 | 縦反転(0=OFF、1=ON)、#A_REVV |
| b04 | 加算合成(0=OFF、1=ON)、#A_ADD |
・省略時は0。
例
SPCHR 5,64,64,16,16,0 SPCHR 6,,,32,32,1 'UV skip
SPCHR スプライト番号 OUT U,V[,W,H[,ATR]]
スプライトのキャラクタ定義情報を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライトの画像サイズ
ATR
スプライトのアトリビュート
例
SPCHR 5 OUT U,V,W,H,ATR
SPCHR(スプライト番号)
スプライトのキャラクタ定義番号を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
定義番号
指定スプライトのキャラクタ定義番号
例
DEFNO=SPCHR(5)
SPPAGE スプライト番号,グラフィックページ
指定スプライトの参照グラフィックページを設定する
引数
スプライト番号
対象のスプライトの番号:0～4095
グラフィックページ
-1～5
・初期状態のスプライト用ページは4。
例
SPPAGE 100, 3
SPPAGE(スプライト番号)
指定スプライトの参照グラフィックページを取得する
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
グラフィックページ番号:-1～5
例
P=SPPAGE(100)
SPPAGE グラフィックページ
これから作成するスプライトに割り当てるグラフィックページを設定する
引数
グラフィックページ
-1～5(GRP-1～GRP5) 初期状態のスプライト用ページは4(GRP4)
例
SPPAGE 3
SPPAGE()
これから作成するスプライトに割り当てるグラフィックページを取得する
返値
グラフィックページ番号:-1～5
例
P=SPPAGE()
SPLAYER スプライト番号,レイヤーID
指定スプライトの所属レイヤーを設定する
引数
スプライト番号
対象のスプライトの番号:0～4095
レイヤーID
スプライトが所属するレイヤーのID:0～7
例
SPLAYER 100,3
SPLAYER(スプライト番号)
指定スプライトの所属レイヤーを取得する
引数
スプライト番号
対象のスプライトの番号:0～4095
返値
レイヤーID
例
P=SPLAYER(100)
SPLAYER レイヤーID
これから作成するスプライトが所属するレイヤーを設定する
引数
レイヤーID
0～7
・初期状態のレイヤーIDは0。
例
SPLAYER 3
SPLAYER()
これから作成するスプライトが所属するレイヤーを取得する
返値
レイヤーID
例
P=SPLAYER()
SPDEF 定義番号,U,V[,W,H[,原点X,原点Y]][,アトリビュート]
スプライトのキャラクタ定義用テンプレートを作成する
引数
定義番号
テンプレートの定義番号:0～8191
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライトの大きさ
・省略時はW,Hとも16。
原点X,Y
スプライトの座標基準点
・省略時はX,Yとも0。
アトリビュート
| b00 | ↑90度単位の回転(b00とb01の2ビットで指定) |
| b01 | ↓#A_ROT0、#A_ROT90、#A_ROT0180、#A_ROT270 |
| b02 | 横反転(0=OFF、1=ON)、#A_REVH |
| b03 | 縦反転(0=OFF、1=ON)、#A_REVV |
| b04 | 加算合成(0=OFF、1=ON)、#A_ADD |
・省略時は0。
例
SPDEF 0,192,352,32,32,16,16,1
SPDEF 数値配列[,定義番号オフセット[,Uオフセット,Vオフセット]]
スプライトのキャラクタ定義用テンプレートを配列から一括作成する
引数
数値配列
スプライトのテンプレートデータが格納された数値配列
・1個分の要素はU,V,W,H,原点X,原点Y,アトリビュートの7つ。
・要素数は7の倍数である必要がある。
・要素数/7個のスプライトテンプレートが0から順に定義される。
定義番号オフセット
定義開始番号を指定:0～8191
U,Vオフセット
画像の定義位置調整用として加算される(各0～4095)
例
SPDEF SRCDATA SPDEF SRCDATA 256,0,256
SPDEF "@ラベル文字列"[,定義番号オフセット[,Uオフセット,Vオフセット]]
スプライトのキャラクタ定義用テンプレートをDATA列から一括作成する
引数
@ラベル文字列
スプライトのテンプレートデータが列挙されたDATA命令のラベル
・@ラベル名は""でくくるか、文字列変数で指定する。
・先頭データは定義するスプライト数とし、。
続いて各スプライトのデータを列挙(1個につき7データ)
・1個分のデータはU,V,W,H,原点X,原点Y,アトリビュートの7つ。
定義番号オフセット
定義開始番号を指定:0～8191
U,Vオフセット
画像の定義位置調整用として加算されます(各0～4095)
例
SPDEF "@SRCDATA" SPDEF "@SRCDATA",256,0,256
SPDEF 定義番号 OUT U,V[,W,H[,HX,HY]][,A]
スプライトのキャラクタ定義テンプレートの情報を取得する
引数
定義番号
テンプレートの定義番号:0～8191
返値
U,V
参照する画像のグラフィックページ上の座標
W,H
スプライト定義の画像サイズ
HX,HY
スプライト定義の基準点座標
A
スプライト定義のアトリビュート
例
SPDEF 2 OUT U,V,ATR
SPDEF 定義番号,元になる定義番号,[U],[V],[W],[H],[原点X],[原点Y],[アトリビュート]
スプライトキャラクタ定義用テンプレートをコピーする
・コピー不要な要素は省略可能(区切りの','カンマは必要)。
・引数部分はコピーした上で調整する場合に利用。
引数
定義番号
テンプレートの定義番号:0～8191
ソース定義番号
コピー元になる定義番号:0～8191
U,V
参照する画像のグラフィックページ上の座標
W,H
定義するスプライトの大きさ
・省略時はW,Hとも16。
原点X,Y
スプライトの座標基準点
・省略時はX,Yとも0。
アトリビュート
| b00 | ↑90度単位の回転(b00とb01の2ビットで指定) |
| b01 | ↓#A_ROT0、#A_ROT90、#A_ROT0180、#A_ROT270 |
| b02 | 横反転(0=OFF、1=ON)、#A_REVH |
| b03 | 縦反転(0=OFF、1=ON)、#A_REVV |
| b04 | 加算合成(0=OFF、1=ON)、#A_ADD |
・省略時は0。
例
SPDEF 0,255,192,352,32,32,16,16,1 SPDEF 1,255,,,32,32,,,
SPDEF
スプライトキャラクタ定義用テンプレートを初期状態に戻す
例
SPDEF
SPLINK スプライト番号,リンク先スプライト番号[,リンクフラグ]
スプライトを別のスプライトにリンクさせる
・リンクすると座標がリンク先(親)に追従するようになる。
・子の表示座標と表示優先度は、親を基準とした相対座標となる。
・SPSET前に使うとエラー。
引数
スプライト番号
リンク元(子)のスプライトの番号: 0～4095
リンク先スプライト番号
リンク先(親)のスプライトの番号: 0～4095
・リンク元の子孫を指定するとエラー。
リンクフラグ
リンク先(親)の情報のどれを引き継ぐかを指定するビット値の組合わせ
・表示座標・表示優先度以外の属性を引き継ぎたい場合に指定する。
・bit0を指定した場合、親がSPCLRされてから1V経過後に子孫が消去される。
・省略時は0。
| bit0 | 1 | 表示ON/OFFや消去のタイミング |
| bit1 | 2 | 回転 |
| bit2 | 4 | スケーリング |
| bit3 | 8 | 色 |
| bit4 | 16 | レイヤーID |
例
SPLINK 15,4 SPLINK 2,0,3
SPLINK(スプライト番号[,リンク種別])
指定された番号スプライトのリンク先番号を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
リンク元(子)のスプライトの番号: 0～4095
リンク種別
取得したいリンク先種別・リンクフラグ
| 0 | 親 |
| 1 | 子 |
| 2 | 兄弟 |
| 3 | リンクフラグ |
・省略時は0
返値
リンク先の番号:0～4095(-1の時リンク無し)
例
'スプライトPARENTのすべての子供をひろう CHILD=SPLINK( PARENT,1 ) '一番最初の子供 WHILE CHILD!=-1 CHILD=SPLINK( CHILD, 2 ) '他の子供を順番に取得 WEND
SPUNLINK スプライト番号
スプライトのリンクを解除する
・SPSET前に使うとエラー。
引数
スプライト番号
リンクを解除するスプライトの番号:0～4095
例
SPUNLINK 15
SPANIM スプライト番号,アニメ対象,データ配列[,ループ]
スプライトにアニメーションを設定する
・SPSET前に使うとエラー。
スプライトアニメ共通仕様
・設定したアニメーションが自動的に再生される。
・アニメーションは値を設定して指定時間分待つという動作。
・アニメーション開始はSPANIMを実行した次フレームから。
・対象要素ごとに最大32個のデータを受け付ける。
・時間にマイナス値を指定すると直前の値から線形補間を行う(なめらかに動かす)。
引数
スプライト番号
アニメーションを設定するスプライトの番号:0～4095
アニメ対象
変化させる要素を管理する数値または文字列
| 0 | "XY" | XY座標 |
| 1 | "Z" | Z座標 |
| 2 | "R" | 回転角度 |
| 3 | "S" | 倍率XY |
| 4 | "C" | 表示色 |
| 5 | "V" | 変数(スプライト内部変数7の値) |
| 6 | "UV" | UV座標(定義元画像座標) |
| 7 | "I" | 定義番号 |
・文字列の末尾に"+"を付けるか、数値に8を加えるとアニメーション開始時点からの相対値となる。
・文字列の末尾に"."を付けるか、数値に16を加えるとアニメーション終了時にスプライトを削除する。
データ配列
アニメデータが格納された1次元数値配列
ループ
ループ回数: (1～)
・ 0を指定するとで無限ループとなる。
・ 省略時は1。
データ配列
・アニメデータは数値配列に次の順で用意(最大32個まで)。
・時間1, 項目1,[項目2,] 時間2,項目1,[項目2,]…。
例
DIM PANIM[6] PANIM[0]=-60 'frame(-60=smooth) PANIM[1]=200 'offset X,Y PANIM[2]=100 PANIM[3]=-30 'frame PANIM[4]=50 'offset PANIM[5]=20 SPSET 0,0 SPANIM 0,"XY",PANIM
SPANIM スプライト番号,アニメ対象,"@ラベル文字列"[,ループ]
スプライトにアニメーションを設定する(DATA命令で指定)
・SPSET前に使うとエラー。
引数
スプライト番号
アニメーションを設定するスプライトの番号:0～4095
アニメ対象
変化させる要素を管理する数値または文字列
| 0 | "XY" | XY座標 |
| 1 | "Z" | Z座標 |
| 2 | "R" | 回転角度 |
| 3 | "S" | 倍率XY |
| 4 | "C" | 表示色 |
| 5 | "V" | 変数(スプライト内部変数7の値) |
| 6 | "UV" | UV座標(定義元画像座標) |
| 7 | "I" | 定義番号 |
・文字列の末尾に"+"を付けるか、数値に8を加えるとアニメーション開始時点からの相対値となる。
・文字列の末尾に"."を付けるか、数値に16を加えるとアニメーション終了時にスプライトを削除する。
@ラベル文字列
・アニメデータが格納されたDATA命令の先頭ラベル。
・@ラベル名を""でくくって文字列として指定(または文字変数)。
ループ
ループ回数: (1～)
・ 0を指定するとで無限ループとなる。
・ 省略時は1。
データ
アニメデータはDATA命令に次の順で用意
DATA キーフレーム数(最大32)
DATA 時間1,項目1[,項目2]
DATA 時間2,項目1[,項目2]
:
例
@MOVDATA DATA 2 'counter DATA -60,200,100 'frame,offset DATA -30,50,20 'frame,offset SPSET 0,0 SPANIM 0,"XY",@MOVDATA
SPANIM スプライト番号,アニメ対象,時間1,項目1[,項目2][,時間2,項目1[,項目2]]…[,ループ]
スプライトにアニメーションを設定する(直接引数として指定)
・SPSET前に使うとエラー。
引数
スプライト番号
アニメーションを設定するスプライトの番号:0～4095
アニメ対象
変化させる要素を管理する数値または文字列
| 0 | "XY" | XY座標 |
| 1 | "Z" | Z座標 |
| 2 | "R" | 回転角度 |
| 3 | "S" | 倍率XY |
| 4 | "C" | 表示色 |
| 5 | "V" | 変数(スプライト内部変数7の値) |
| 6 | "UV" | UV座標(定義元画像座標) |
| 7 | "I" | 定義番号 |
・文字列の末尾に"+"を付けるか、数値に8を加えるとアニメーション開始時点からの相対値となる。
・文字列の末尾に"."を付けるか、数値に16を加えるとアニメーション終了時にスプライトを削除する。
時間,項目
・アニメデータそのもの(必要な数分並べる、最大32個)。
ループ
ループ回数:(1～)
・0を指定するとで無限ループとなる。
・省略時は1。
例
SPSET 0,0 SPANIM 0,"XY",-60,200,100,-30,50,20
SPANIM スプライト番号,アニメーション定義番号
スプライトにアニメーションを設定する(アニメーション定義番号で指定)
・ANIMDEFで定義したアニメーション定義を指定できる。
・SPSET前に使うとエラー。
引数
スプライト番号
アニメーションを設定するスプライトの番号:0～4095
アニメーション定義番号
ANIMDEF命令で定義済みの定義番号:0～1023
例
ANIMDEF 0,"XY",-60,100,0 SPSET 0,0 SPANIM 0,0
SPANIM [スプライト番号]
スプライトアニメーションをクリアする
引数
スプライト番号
アニメーションをクリアするスプライトの番号:0～4095
・SPSETしていない番号を指定するとエラー。
・省略時は全スプライトのアニメーションをクリアする。
例
SPANIM 0 SPANIM
SPSTOP [スプライト番号]
スプライトのアニメーションを停止させる
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号: 0～4095
・省略時は全スプライトのアニメーションを停止させる。
例
SPSTOP
SPSTART [スプライト番号]
スプライトのアニメーションを再開する
・SPSETの前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号:0～4095
・省略時は全スプライトのアニメーションを開始させる。
例
SPSTART
SPCHK(スプライト番号)
スプライトのアニメーション状態を取得する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライトの番号: 0～4095
返値
| b00 | XY座標 | 1 | #CHKXY |
| b01 | Z座標 | 2 | #CHKZ |
| b02 | 回転 | 4 | #CHKR |
| b03 | 倍率XY | 8 | #CHKS |
| b04 | 表示色 | 16 | #CHKC |
| b05 | 変数 | 32 | #CHKV |
| b06 | UV座標 | 64 | #CHKUV |
| b07 | 定義番号 | 128 | #CHKI |
ビットごとに対象割り当て(すべて0の時アニメ停止中)
例
ST=SPCHK(5) '|b00|#CHKXY| '|b01|#CHKZ| '|b02|#CHKR| '|b03|#CHKS| '|b04|#CHKC| '|b05|#CHKV| '|b06|#CHKUV| '|b07|#CHKI|
SPVAR スプライト番号,変数キー,値
スプライト変数を設定する
・すべてのスプライトはスプライト変数と呼ばれる特殊な変数を持っている。
・スプライト変数はプログラム実行開始時、SPSET,SPCLR呼び出し時にクリアされる。
引数
スプライト番号
対象のスプライト番号:0～4095
変数キー
スプライト変数の名前
・文字列または整数を名前として付ける事ができる。
値
内部変数に登録する値
・数値または文字列を登録する事ができる。
例
SPVAR 0,7,1 SPVAR 0,"NAME","VALUE"
SPVAR(スプライト番号,変数キー)
スプライト変数を読み出す
引数
スプライト番号
対象のスプライト番号:0～4095
変数キー
スプライト変数の名前。文字列または整数を名前として付ける事ができる
返値
SPVARで登録した値
SPVARで値を登録していない場合は、整数の0が返る。
例
V=SPVAR(54,0)
SPVAR スプライト番号[,変数キー]
スプライト変数を削除する
引数
スプライト番号
対象のスプライト番号:0～4095
変数キー
削除するスプライト変数の名前
・文字列または整数を名前として付ける事ができる。
・省略時は指定スプライトの全スプライト変数を削除する。
例
SPVAR 0,7 SPVAR 0,"NAME"
SPCOL スプライト番号[,スケール対応]
スプライト衝突判定情報を設定する
・SPHIT系の命令を使う前に必ず呼ぶこと。
・SPSET前に使うとエラー。
・SPCOLで始点X,始点Yを指定しない場合、その時のSPHOMEの情報が始点X,始点Yとして使用される。その後SPHOMEを変更しても始点X,始点Yは追従しない。
引数
スプライト番号
対象のスプライト番号:0～4095
スケール対応
1を指定するとSPSCALEやSPANIMでのスケール変更に合わせて衝突判定の大きさが変化する
0を指定するとスケール変更しても衝突判定の大きさは変化しない
・省略時は0。
例
SPCOL 3,1
SPCOL スプライト番号,[スケール対応],マスク
スプライト衝突判定情報を設定する(マスク指定付)
・SPHIT系の命令を使う前に必ず呼ぶこと。
・SPSET前に使うとエラー。
・SPCOLで始点X,始点Yを指定しない場合、その時のSPHOMEの情報が始点X,始点Yとして使用される。その後SPHOMEを変更しても始点X,始点Yは追従しない。
引数
スプライト番号
対象のスプライト番号:0～4095
スケール対応
1を指定するとSPSCALEやSPANIMでのスケール変更に合わせて衝突判定の大きさが変化する
0を指定するとスケール変更しても衝突判定の大きさは変化しない
・省略時は0。
マスク
0～&HFFFFFFFF(32ビット)
・衝突判定時に互いのビットのANDをとり0であれば衝突していないとみなす。
・省略時は&HFFFFFFFF。
例
SPCOL 3,1,31 SPCOL 3,,31
SPCOL スプライト番号,始点X,始点Y,幅,高さ[,スケール対応]
SPCOL スプライト番号,始点X,始点Y,幅,高さ,[スケール対応],マスク
スプライト衝突判定情報を設定する(範囲指定付)
・SPHIT系の命令を使う前に必ず呼ぶこと。
・SPSET前に使うとエラー。
・SPCOLで始点X,始点Yを指定する場合、SPHOMEの情報は全く使用しない。
引数
スプライト番号
対象のスプライト番号:0～4095
始点X,Y
・判定領域の始点座標:X,Y(-32768～32767)。
・スプライト左上を原点(0,0)とした相対座標。
幅,高さ
判定領域の幅と高さ:W,H(1～65535)
スケール対応
1を指定するとSPSCALEやSPANIMでのスケール変更に合わせて衝突判定の大きさが変化する
0を指定するとスケール変更しても衝突判定の大きさは変化しない
・省略時は0。
マスク
0～&HFFFFFFFF(32ビット)
・衝突判定時に互いのビットのANDをとり0であれば衝突していないとみなす。
・省略時は&HFFFFFFFF。
例
SPCOL 3,0,0,32,32,1,255 SPCOL 3,0,0,32,32,,255
SPCOL スプライト番号 OUT スケール対応[,マスク]
スプライト衝突判定情報を取得する(スケール対応とマスク)
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライト番号:0～4095
返値
スケール対応
スプライトに設定されているスケール対応フラグ
マスク
スプライトに設定されている衝突マスク値
例
SPCOL 3 OUT SC,MSK
SPCOL スプライト番号 OUT 始点X,始点Y,幅,高さ[,スケール対応[,マスク]]
スプライト衝突判定情報を取得する(すべて)
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライト番号:0～4095
返値
始点X,Y
衝突判定領域の始点座標
幅,高さ
衝突判定領域の幅と高さ
スケール対応
スプライトに設定されているスケール対応フラグ
マスク
衝突判定マスク値
例
SPCOL 3 OUT X,Y,W,H,SC,MSK
SPCOLVEC スプライト番号[,移動量X,移動量Y]
スプライト衝突判定用移動速度を設定する
・SPSET前に使うとエラー。
引数
スプライト番号
対象のスプライト番号:0～4095
移動量X,移動量Y
・省略時は次の要領で自動計算される。
・SPANIMのXYを線形補完で実行中:前フレームからの移動距離。
・それ以外の場合:0,0。
例
SPCOLVEC 93
SPHITSP(スプライト番号[,先頭ID,末尾ID])
スプライトの衝突判定結果を返す
・事前にSPCOLを呼び出しておくこと。
引数
スプライト番号
判定するスプライトの番号:0～4095
先頭ID,末尾ID
判定するスプライトの範囲(0～4095)
返値
衝突したスプライトの番号(衝突のないとき-1)
例
H=SPHITSP(0)
SPHITSP(スプライト番号,相手スプライト番号)
指定スプライトとのスプライト衝突判定結果を返す
・事前にSPCOLを呼び出しておくこと。
引数
スプライト番号
判定するスプライトの番号:0～4095
相手スプライト番号
相手側のスプライトの番号:0～4095
返値
0=衝突なし、1=衝突
例
H=SPHITSP(0,34)
SPHITSP()
直前に設定した情報からスプライトの衝突判定結果を返す
・引数付きのSPHITSPで衝突先が複数ある場合、引数を省略して再度呼び出す事で衝突先を全て取り出す事ができる。
・事前にSPCOLを呼び出しておくこと。
・事前に引数を省略しないSPHITSPを呼び出しておくこと。
返値
衝突したスプライトの番号(衝突のないとき-1)
例
H=SPHITSP(0) WHILE H>=0 H=SPHITSP() WEND
SPHITRC(始点X,始点Y,幅,高さ[,[マスク],移動量X,移動量Y])
動く四角形とすべてのスプライトの衝突判定結果を返す
・事前にSPCOLを呼び出しておくこと。
引数
始点X,Y
判定元の四角形の左上座標
幅,高さ
判定元の四角形の幅と高さ
マスク
0～&HFFFFFFFF(32ビット)
・衝突判定時に互いのビットのANDをとり0であれば衝突していないとみなす。
・省略時は&HFFFFFFFF。
移動量X,Y
判定元の四角形の移動量
返値
衝突したスプライトの番号(衝突のないとき-1)
例
H=SPHITRC(0,0,16,16)
SPHITRC(スプライト番号,始点X,始点Y,幅,高さ[,[マスク],移動量X,移動量Y])
指定したスプライトと四角形の衝突判定結果を返す
・事前にSPCOLを呼び出しておくこと。
引数
スプライト番号
衝突相手のスプライトの番号:0～4095
始点X,始点Y
判定元の四角形の左上座標
幅,高さ
判定元の四角形の幅と高さ
マスク
0～&HFFFFFFFF(32ビット)
・衝突判定時に互いのビットのANDをとり0であれば衝突していないとみなす。
・省略時は&HFFFFFFFF。
移動量X,Y
判定元の四角形の移動量
返値
0=衝突なし、1=衝突
例
H=SPHITRC(1,0,0,16,16)
SPHITRC(先頭ID,末尾ID,始点X,始点Y,幅,高さ[,[マスク],移動量X,移動量Y])
指定範囲のスプライトと四角形の衝突判定結果を返す
・事前にSPCOLを呼び出しておくこと。
引数
先頭ID,末尾ID
判定するスプライトの範囲(0～4095)
始点X,Y
判定元の四角形の左上座標
幅,高さ
判定元の四角形の幅と高さ
マスク
0～&HFFFFFFFF(32ビット)
・衝突判定時に互いのビットのANDをとり0であれば衝突していないとみなす。
・省略時は&HFFFFFFFF。
移動量X,Y
判定元の四角形の移動量
返値
衝突したスプライトの番号(衝突のないとき-1)
例
H=SPHITRC(0,0,16,16)
SPHITRC()
直前に設定した情報からスプライトの衝突判定結果を返す
・引数付きのSPHITRCで衝突先が複数ある場合、引数を省略して再度呼び出す事で衝突先を全て取り出す事ができる。
・事前にSPCOLを呼び出しておくこと。
返値
衝突したスプライトの番号(衝突のないとき-1)
例
H=SPHITRC(0,0,16,16) WHILE (H >= 0) H=SPHITRC() WEND
SPHITINFO()
衝突判定結果の詳細情報取得(衝突時間)
返値
衝突時間
・衝突時間: 0～1の実数値。
・判定時の座標＋速度×衝突時間が衝突座標と一致。
例
TM=SPHITINFO()
SPHITINFO OUT TM,X1,Y1,X2,Y2
衝突判定結果の詳細情報取得(衝突時間と座標)
返値
TM
・衝突時間: 0～1の実数値。
・判定時の座標＋速度×衝突時間が衝突座標と一致。
X1,Y1
衝突時の物体1の座標
X2,Y2
衝突時の物体2の座標
例
SPHITINFO OUT TM,X1,Y1,X2,Y2
SPHITINFO OUT TM,X1,Y1,VX1,VY1,X2,Y2,VX2,VY2
衝突判定結果の詳細情報を取得する(衝突時間と座標と速度)
返値
衝突時間
・衝突時間: 0～1の実数値。
・判定時の座標＋速度×衝突時間が衝突座標と一致。
X1,Y1
衝突時の物体1の座標
VX1,VY1
衝突時の物体1の速度
X2,Y2
衝突時の物体2の座標
VX2,VY2
衝突時の物体2の速度
例
SPHITINFO OUT TM,X1,Y1,VX1,VY1,X2,Y2,VX2,VY2
SPFUNC スプライト番号,"@ラベル" 
SPFUNC スプライト番号,"ユーザー定義命令名"
スプライトごとにコールバック処理を割り当てる
・コールバック処理が必要な上級者向けの命令。
・GOSUBでジャンプしてきてほしいラベルか、実行してほしいDEF命令名のどちらかを指定できる。
・CALL SPRITE により全スプライトのコールバック処理を一度に実行する。
・コールバック先ではCALLIDX()関数で番号を取得できる。
引数
スプライト番号
対象のスプライト番号:0～4095
@ラベル
呼び出される処理先のラベル
ユーザー定義命令名
呼び出されるユーザー定義命令の名前
例
SPFUNC 0,"@PROG" SPFUNC 1,"USERDEF"
SPFUNC スプライト番号
スプライトに割り当てたコールバック処理をクリアする
引数
スプライト番号
クリア対象のスプライト番号:0～4095
例
SPFUNC 0
SPUSED(スプライト番号)
指定されたスプライトが使われているか調査する
引数
スプライト番号
対象のスプライト番号:0～4095
返値
0=空き、1=使用中
例
S=SPUSED(4)