HSP command help

gcopy

( 画面制御命令 )
gcopy p1,p2,p3,p4,p5 [画面コピー]

p1=0～31(0): ウインドゥID
p2,p3 : コピー元の左上X,Y座標
p4,p5 : コピーする大きさX,Y（ドット単位）

説明

gcopy命令は、指定したウインドゥIDの画面の一部を、現在の描画先カレントポジションにコピーします。コピー元のウインドゥIDは、自分のウインドゥIDと同じかまたは、screen命令やbuffer命令で初期化されたウインドゥ IDでなければなりません。

gcopy命令でコピーする場合は、gmode命令によってコピーするモードをいくつか選ぶことができます。

gcopy命令でパレットモード画面の画像をコピーする際には注意が必要です。コピーする２つのウインドゥのパレットを共通にするか、またはコピー元の画像が使っているパレットカラーと同じものが、コピー先にも存在しなければ正しくない色でコピーされおかしな画像になってしまいます。

備考

ver2.61標準命令

参照

 gmode
gzoom

get_fileicon

( 拡張入出力制御命令 )
get_fileicon v1,"s2",n3 [ファイルに使用されているアイコンの取得]

v1 : 取得したアイコンを入れる変数
s2 : ファイル名
n3 : 取得するもの

説明

s2に指定したファイルに使われるアイコンを取得します。

n3の値 0 s2のファイルに使われているアイコン 1 s2のファイルに使われている小さいアイコン 2 ツリービューで選択されているときのアイコン(s2がフォルダなどの場合) 4 リストビューで選択されている状態のアイコン 8 アイコンにリンクのマークを付ける $10 s2のファイルに使われるアイコンが含まれているファイル名 $20 s2のファイルが表示されるときに使われる名前(s2に"B:\\"などを使ったとき) $40 s2のファイルの種類

0,1,2,4,8は組み合わせて使うことができます。

備考

llmod.as,img.asをインクルードする

参照

 get_icon
draw_icon

get_icon

( 拡張入出力制御命令 )
get_icon v1,"s2",n3,n4 [アイコンの取得]

v1 : 取得したアイコンを入れる数値変数
s2 : アイコンを含むファイル名
n3 : アイコンの番号
n4 : 小さいアイコンを取得するかどうかのフラグ

説明

s2に指定したファイルから、n3番目のアイコンを取得します。もしn3番目のアイコンが小さいアイコンをもっているときはn4を1にすると小さいアイコンの方を取得します。取得したアイコンはdraw_iconで描画できます。アイコン取得に失敗したときは変数に0が代入されます。

n3を-1にすると、s2がもっているアイコンの数がstatに代入されます。 n3を-2にすると、s2がもっているアイコン全てを取得します。ただしファイルs2が 16個以上のアイコンを持っているときは、変数v1を alloc v1,'アイコンの数'×4 として拡張しておかないとエラーになります。

備考

llmod.as,img.asをインクルードする

参照

 draw_icon
get_fileicon

getbg

( 拡張画面制御命令 )
getbg val,modelID [BGマップを取得]

val : クローンが作成される変数名
modelID : モデルID

( 拡張プラグイン[hgimg]が必要です )

説明

BGマップに割り当てられたメモリ空間を変数valにクローンで割り当てます。以降は、変数valのメモリ空間としてBGマップを書き換えることができます。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 addbg
setbg
setmap

getcoli

( 拡張画面制御命令 )
getcoli val,id,distance [オブジェクトのコリジョン判定]

val : 結果が代入される変数名
id : オブジェクトID
distance : 衝突を検出する範囲(float値)

( 拡張プラグイン[hgimg]が必要です )

説明

指定したオブジェクトが持つコリジョン情報をもとに、そのオブジェクトが衝突している別なオブジェクトのIDを調べます。 distanceは、衝突する範囲(半径)をfloat値で指定します。衝突が検出された場合は、変数にオブジェクトIDが代入されます。何も衝突が検出されなかった場合は、-1が代入されます。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 setcoli
findobj
nextobj

getdebug

( 拡張画面制御命令 )
getdebug val			[デバッグ情報取得]
val : 結果が代入される変数名
( 拡張プラグイン[hgimg]が必要です )
説明

HGIMGのデバッグ情報が代入されます。通常の使用では必要ありません。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

getkey

( 基本入出力制御命令 )
getkey p1,p2 [キー入力チェック]

p1=変数 : 読み込むための変数
p2=1～(1) : キーコード
説明

キーボード及びマウスボタンの状態をチェックして変数に代入します。指定したボタンが押されていれば、1を代入し、押されていなければ0が代入されます。キーコードで指定する値の詳細は、以下の通りです。
キーコード実際のキー ------------------------------------------ 1 マウスの左ボタン 2 マウスの右ボタン 3 キャンセル（[CTRL]+[BREAK]） 4 ３ボタンマウスのまん中のボタン 8 [BACKSPACE]（PC98の[BS]） 9 [TAB] 13 [ENTER] 16 [SHIFT] 17 [CTRL] 18 [ALT]（PC98の[GRPH]） 20 [CAPSLOCK] 27 [ESC] 32 スペースキー 33 [PAGEUP]（PC98の[ROLLDOWN]） 34 [PAGEDOWN]（PC98の[ROLLUP]） 35 [END]（PC98の[HELP]） 36 [HOME]（PC98の[HOMECLR]） 37 カーソルキー[←] 38 カーソルキー[↑] 39 カーソルキー[→] 40 カーソルキー[↓] 48～57 [0]～[9]（メインキーボード） 65～90 [A]～[Z] 96～105 [0]～[9]（テンキー） 112～121 ファンクションキー [F1]～[F10]

備考

ver2.61標準命令

参照

 stick

getmchild

( 拡張画面制御命令 )
getmchild val,id,sub_id [指定した階層の子を取得]

val : 結果が代入される変数名
id : モデルID
sub_id : モデルサブID

( 拡張プラグイン[hgimg]が必要です )

説明

指定したモデル階層が持つ、子のサブIDを取得します。結果は、valで指定した変数に代入されます。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 getmsibling

getmfv

( 拡張画面制御命令 )
getmfv fv,model_id,sub_id,type [階層パラメータを取得]

fv : FV値が代入される変数名
model_id : モデルID
sub_id : モデルサブID
type : タイプID

( 拡張プラグイン[hgimg]が必要です )
説明

指定した階層のFV値を取得します。タイプIDで指定できるものは以下の通りです。
タイプID | ------------------------------------------- 0 | 階層の移動(trans) 1 | 階層の角度(angle) 2 | 階層のスケール(scale)

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 setmfv

getmodel

( 拡張画面制御命令 )
getmodel val,model_id,sub_id [モデル情報を読み出し]

val : 情報が代入される変数名
model_id : モデルID
sub_id : モデルサブID

( 拡張プラグイン[hgimg]が必要です )
説明

モデル情報の読み出しを行ないます。 valで指定された変数に、指定モデルID、サブIDの情報が代入されます。変数に代入される値は、以下のC構造体のイメージがコピーされます。これらのデータの中には、通常HSPで内容を書き換えたり参照することが難しいものも含まれています。イメージ全体として読み書きを行なうような場合に使用されるもので、通常は使用されません。
// シーンモデル情報 typedef struct { VECTOR pos; // local Position VECTOR ang; // local Angle VECTOR scale; // local Scale short id; // Model ID short opt; // option (no use) short num; // num of NODE short nummax; // Maximum num of NODE(0=none) PNODE **node; // Node ptr void *sibling; // Sibling Object void *child; // Child Object float bound; // Bounding Box Max Length short aindex; // Animation Max Index ( 0 = No Anim) short anum; // Animation Frame Max ( 0 = No Anim ) ANMINF *ani; // Animation Data Array (option) short anifr[16]; // Animation Frame Start Index (option) short animax[16]; // Animation Frame Max Index (option) } MODEL;

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 putmodel

getmpoly

( 拡張画面制御命令 )
getmpoly val,id,node_id,mode [ポリゴン頂点情報の取得]

val : 頂点情報が代入される変数名
model_id : モデルID
node_id : ノードID
mode : 頂点の種類(0=座標/1=法線)

( 拡張プラグイン[hgimg]が必要です )
説明

ポリゴン単位の頂点情報を取得します。 model_idで指定されたモデル内の、node_idで指定されたポリゴンが持つ頂点情報をvalで指定された変数に読み出します。変数valは、浮動小数値が格納される配列変数となります。
val.0 , val.1 , val.2 , val.3 頂点1(X,Y,Z,W) val.4 , val.5 , val.6 , val.7 頂点2(X,Y,Z,W) val.8 , val.9 , val.10, val.11 頂点3(X,Y,Z,W) val.12, val.13, val.14, val.15 頂点4(X,Y,Z,W)
modeで、頂点の種類(0=座標/1=法線)を指定することが可能です。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 setmpoly

getmsibling

( 拡張画面制御命令 )
getmsibling val,id,sub_id [指定した階層の兄弟を取得]

val : 結果が代入される変数名
id : モデルID
sub_id : モデルサブID

( 拡張プラグイン[hgimg]が必要です )

説明

指定したモデル階層が持つ、兄弟のサブIDを取得します。結果は、valで指定した変数に代入されます。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 getmchild

getmtex

( 拡張画面制御命令 )
getmtex val, modelid, nodeid [モデルのテクスチャを取得]

val : 結果が代入される変数名
ModelID : モデルID
NodeID : ノードID

( 拡張プラグイン[hgimg]が必要です )

説明

指定したモデルIDの管理するポリゴン、スプライトなどが持つテクスチャID情報を取得します。ノードIDは通常0ですが、mxファイルなどから取得した1つのモデルに複数のポリゴンが含まれている場合には、0以上のノードIDを使用することができます。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 setmtex

getmuv

( 拡張画面制御命令 )
getmuv val,model_id,node_id [UV情報の取得]

val : 情報が代入される変数名
model_id : モデルID
node_id : ノードID

( 拡張プラグイン[hgimg]が必要です )
説明

ポリゴン単位のUV値を取得します。 model_idで指定されたモデル内の、node_idで指定されたポリゴンが持つUV値をvalで指定された変数に読み出します。ポリゴンは４角形の情報が保存されています。valは、配列変数に格納された整数値で、以下のように設定されます。
val.0 , val.1 UV0 val.2 , val.3 UV1 val.4 , val.5 UV2 val.6 , val.7 UV3

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 setmuv

getobjsize

( オブジェクト制御命令 )
getobjsize v1,n2 [オブジェクトのサイズと位置取得]

v1 : オブジェクトのサイズ、位置を取得するための数値変数
n2 : オブジェクトのID
説明

オブジェクトのサイズと位置を取得します。 n2にはbuttonやlistviewなどのIDを代入します。 v1にはオブジェクトのサイズ、位置が以下のように代入されます。
v1.0 幅 v1.1 高さ v1.2 左上のx座標 v1.3 左上のy座標 v1.4 右下のx座標 v1.5 右下のy座標
各座標はウィンドウ座標系です。

備考

llmod.as,obj.asをインクルードする

参照

 resizeobj

getpal

( 画面制御命令 )
getpal p1			[パレット読み出し]
p1=0～255(0) : パレットコード

説明

現在の画面に設定されているパレットの色データを読みだします。指定したパレットコードのRGB輝度が、rval,gval,bval の変数に自動的に代入されます。

備考

ver2.61標準命令

getpath

( 文字列操作命令 )
getpath p1,p2,p3 [パスの一部を取得]

p1=変数名 : 結果を格納する変数名
p2=文字列 : 取り出す元の文字列
p3=0～(0) : 情報のタイプ指定
説明

p2で指定した変数に格納されているファイルパスなどを示す文字列を p3で指定したタイプの情報に変換して、p1に指定された変数に代入します。
例: a="c:\\disk\\test.bmp" getpath b,a,8+1 mes b ↓(結果) "test"となる
タイプ指定の詳細は以下の通りです。
タイプ内容 ----------------------------------------------------------- 0 文字列のコピー(操作なし) 1 拡張子を除くファイル名 2 拡張子のみ(.???) 8 ディレクトリ情報を取り除く 16 文字列を小文字に変換する 32 ディレクトリ情報のみ
タイプ値は、合計することで複数指定を行なうことが可能です。タイプ16が指定された場合は、すべての英文字列を小文字に変換します。

備考

ver2.61標準命令

参照

 getstr
instr

getptr

( メモリ管理命令 )
getptr v1,v2			[変数のポインタを取得する]
v1 : ポインタを代入する変数
v2 : ポインタを取得する変数

説明

変数v2のポインタを取得し、変数v1に代入します。取得したポインタはdllへ渡すパラメータなどに使用できます。

備考

llmod.asをインクルードする

getreg

( OSシステム制御命令 )
getreg p1,"section",p2,p3 [レジストリ読み出し]

p1=変数名　: 読み出すための変数名
"section"　: セクション名指定
p2=0～1(0) : タイプ指定
p3=1～(64) : 読み出しサイズ指定

( 拡張プラグイン[hspext]が必要です )
説明

指定されたセクションの内容をp1で指定した変数に読み出します。

あらかじめregkey命令でアクセスするレジストリの位置を指定してから使う必要があります。対象となるレジストリ位置が指定されていない時は、エラーが表示されます。 p2でタイプを指定します、タイプのコードは以下の通りです。
p2 type code -------------------------------- 0 : 数値(32bit) 1 : 文字列 2 : バイナリデータ
p3で読み出しサイズを指定します。これは、文字列かバイナリのタイプを選んだ場合に有効になります。

命令の実行後は、システム変数statに結果が返ります。システム変数statが0以外の場合は、何らかのエラーが起こっていることを示しています。

備考

hspext.asをインクルードすること。

参照

 regkey

gets

( 拡張入出力制御命令 )
gets v1,n2 [コンソールから文字列を読み込む]

v1 : コンソールからの文字列を取得する変数
n2 : 取得する文字の数

説明

コンソールから文字列を取得します。 n2を省略したときの値は63です。

備考

llmod.asをインクルードする。必要に応じてabout.as,msgdlg.as,multiopen.as,console.as,unicode.as,dragdrop.as,input.asをインクルードする

参照

 puts
console

getstr

( 文字列操作命令 )
getstr p1,p2,p3,p4 [バッファから文字列読み出し]

p1=変数 : 内容を読み出す先の変数名
p2=変数 : バッファを割り当てた変数名
p3=0～ : バッファのインデックス(Byte単位)
p4=0～255 : 区切りキャラクタのASCIIコード
説明

メモリ上のバッファの任意の場所にある内容を文字列として変数に読み出します。文字列は、00というコードか、改行コードがあるまで読み出されます。改行コードは文字列には含まれません。

また、区切りキャラクタコードを指定することができ任意の文字で区切られた文字列を取り出すこともできます。

この命令で読み出されたByte数は自動的にstrsizeというシステム変数に代入されます。strsizeは、次のインデックスまでの移動量を得る時に使用します。

たとえば、変数bのバッファに 'A' 'B' 'C' ',' 'D' 'E' 'F' 00(終了コード) というデータが入っている場合、
getstr a,b,0,','
を実行すると、変数aの内容は、 'A' 'B' 'C' の部分が読み出されて"ABC"という文字列になり、strsizeは4になります。

この命令は、複数行を含むテキスト文字列データや、特定の文字で区切られたデータを効率よく切り出すためのものです。複数行を含むテキストを扱うためには、他にもメモリノートパッド命令セットがあります。また、文字列から特定数の文字を取り出すためには、 strmid命令が用意されています。

備考

ver2.61標準命令

参照

 strmid

getsync

( 拡張画面制御命令 )
getsync val,mode [時間待ち情報を取得]

val : 情報が代入される変数名
mode : 取得モード( 0=現在のタイマ / 1=タイマ分解能 )

( 拡張プラグイン[hgimg]が必要です )

説明

modeで指定した種類の情報を取得してvalで指定した変数に代入します。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 sync
hgsync

gettex

( 拡張画面制御命令 )
gettex val [テクスチャIDを取得]

val : テクスチャIDが代入される変数名

( 拡張プラグイン[hgimg]が必要です )

説明

次に登録されるものに割り当てられるテクスチャIDを取得します。ここで得たテクスチャIDが、次にtexload命令、またはtexloadbg命令、 settex命令で割り当てたテクスチャと同義になります。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 settex
texload
texloadbg

gettime

( 基本入出力制御命令 )
gettime p1,p2			[日付・時刻を取得]
p1=変数 : 読み込むための変数
p2=0～(0) : 取得するパラメータのタイプ
説明

p1で指定した変数に、p2で指定したタイプの日付・時刻情報を代入します。 gettimeパラメータタイプは以下の通りです。
    0    年(Year)
    1    月(Month)
    2    曜日(DayOfWeek)
    3    日(Day)
    4    時(Hour)
    5    分(Minute)
    6    秒(Second)
    7    ミリ秒(Milliseconds)
たとえば、
    例：
    gettime a,4	; いま何時?
は、変数aに現在時刻が何時かを代入します。
備考

ver2.61標準命令

gettree

( 拡張画面制御命令 )
gettree val,id [指定モデル階層構造をテキストで取得]

val : 情報が代入される変数名
id : モデルID

( 拡張プラグイン[hgimg]が必要です )

説明

指定されたモデルIDが持つ階層構造の情報を複数行テキストの形で取得します。 valで文字列型の変数を指定することで、idのモデル情報が代入されます。取得されたテキストは、関連モデルのサブIDが行ごとに示され、深い階層になるほど行頭にスペースが挿入されます。これにより、子供のモデルか、兄弟のモデルであることを知ることができます。

備考

hgimg.as(DirectX使用時はhgimgx.as)をインクルードすること。

参照

 setmfv
getmfv
getmchild
getmsibling
setmchild
setmsibling

gfcopy

( 拡張画面制御命令 )
gfcopy p1 [半透明コピー]

p1=0～100(0) : 半透明コピーレート(%)

( 拡張プラグイン[hspext]が必要です )

説明

p1で指定したレートで画面イメージをコピーします。

コピー先は、gfini命令で設定した画面になります。コピー元は、gfcopy命令が実行された時点に、描画先に設定されている画面のカレントポジションになります。 p1のレートは0～100(%)で、100%は普通のコピーになります。この命令を実行しただけでは実際の画面は更新されません。「redraw 1」などで画面の更新を行なって初めて反映されます。

備考

hspext.asをインクルードすること。

参照

 gfini

gfdec

( 拡張画面制御命令 )
gfdec p1,p2,p3 [画面の色減算]

p1,p2,p3=0～255(0) : 色コード（R,G,Bの輝度)

( 拡張プラグイン[hspext]が必要です )

説明

gfini命令で設定した画面内のすべてのドットに対して、 p1,p2,p3で指定した数値を減算します。

p1はR、p2はG、p3はBに対して行なわれます。これはフルカラーモードにおいて、ゆっくりと色を落としていく(フェードアウト)の効果を出す時に有効です。この命令を実行しただけでは実際の画面は更新されません。「redraw 1」などで画面の更新を行なって初めて反映されます。

備考

hspext.asをインクルードすること。

参照

 gfini

gfinc

( 拡張画面制御命令 )
gfinc p1,p2,p3 [画面の色加算]

p1,p2,p3=0～255(0) : 色コード（R,G,Bの輝度)

( 拡張プラグイン[hspext]が必要です )

説明

gfini命令で設定した画面内のすべてのドットに対して、 p1,p2,p3で指定した数値を加算します。

p1はR、p2はG、p3はBに対して行なわれます。これはフルカラーモードにおいて、ゆっくりと色を白にしていく(ホワイトアウト)の効果を出す時に有効です。この命令を実行しただけでは実際の画面は更新されません。「redraw 1」などで画面の更新を行なって初めて反映されます。

備考

hspext.asをインクルードすること。

参照

 gfini

gfini

( 拡張画面制御命令 )
gfini p1,p2			[対象画面を設定]
p1=0～(0) : 画面操作を行なうXサイズ(dot単位)
p2=0～(0) : 画面操作を行なうYサイズ(dot単位)
( 拡張プラグイン[hspext]が必要です )
説明

フルカラー画面操作命令を行なう対象の画面を設定します。

必ずgfini命令で対象の画面を設定してから、他のフルカラー画面操作命令を使用してください。 gfini命令では、現在gsel命令で選択されているウインドゥのカレントポジションから、p1,p2で指定したサイズを描画対象とします。必ずフルカラーモードで初期設定をした画面に対して行なってください。

備考

hspext.asをインクルードすること。

ginfo

( 基本入出力制御命令 )


ginfo p1			[各種情報を取得する]

p1=0～(0) : 情報タイプ設定

説明

マウスやウインドゥについての特殊な情報を取得して、システム変数prmx,prmyに代入します。情報のタイプはp1で指定します。省略した場合は0になります。情報タイプとそれに対応した内容は以下の通りです。

タイプ0 : スクリーン上のマウスカーソル座標

    prmx,prmyには、スクリーン座標系でマウスカーソル位置が代入され
    ます。スクリーン座標系は、pos命令などで使用するウインドゥ内の
    座標ではなく、デスクトップ画面全体から見た座標になります。

タイプ1 : アクティプなウインドゥIDと、操作先ウインドゥID

    prmxには、現在アクティブになっているウインドゥIDが代入されます。
    もし、アクティブになっているウインドゥがHSP以外の場合は-1が
    代入されます。
    prmyには、gsel命令で指定した画面の操作先ウインドゥIDが代入
    されます。

タイプ2 : ウインドゥの左上座標

    prmx,prmyには、スクリーン座標系で現在のウインドゥの左上座標が
    代入されます。スクリーン座標系は、pos命令などで使用するウイン
    ドゥ内の座標ではなく、デスクトップ画面全体から見た座標になり
    ます。

タイプ3 : ウインドゥの右下座標

    prmx,prmyには、スクリーン座標系で現在のウインドゥの右下座標が
    代入されます。スクリーン座標系は、pos命令などで使用するウイン
    ドゥ内の座標ではなく、デスクトップ画面全体から見た座標になり
    ます。

タイプ4 : ウインドゥのスクロール座標

    prmx,prmyには、現在の操作先ウインドゥのスクロール座標が代入され
    ます。これは、スクロールバーがついているウインドゥにおいて、
    どれだけスクロールされているかを示す値です。
    スクロールさせていない通常の状態では、prmx,prmyは(0,0)になります。
    スクロールバーによって、画面の内容をずらすとprmxは、右に何ドット
    ずれているか、prmyは下に何ドットずれているかを示します。

タイプ5 : ウインドゥ全体のサイズ

    prmx,prmyには、現在の操作先ウインドゥの横幅、縦幅が代入されます。
    これは、ウインドゥの枠やタイトルバーなども含めたサイズになります。

タイプ6 : 画面の初期化サイズ

    prmx,prmyには、現在の操作先ウインドゥの初期化サイズが代入されます。
    最初にscreen、bgscr、buffer命令で初期化された画面サイズになります。
    (現在のウインドゥ内の描画エリアサイズはシステム変数winx,winyで取得できます)

タイプ7 : メッセージの出力サイズ

    prmx,prmyには、最後にmes、print命令により出力されたメッセージのサイズ
    が代入されます。
    サイズは、X,Y座標にどれだけのドット数で描画されたかを示します。
    画面上の絶対座標ではないので注意してください。また、複数行ある文字列を
    出力した場合は、最後の行にあたるサイズが取得されます。

備考

ver2.61標準命令

gmode

( 画面制御命令 )
gmode p1,p2,p3,p4 [画面コピーモード設定]

p1=0～6(0) : 画面コピーモード
p2,p3 : コピーする大きさX,Y（ドット単位）
p4=0～256(0) : 半透明合成時のブレンド率
説明

gcopyで使用されるモードおよび、サイズ、ブレンド率などを設定します。それぞれのコピーモード動作は以下の通りです。

・モード0 = 通常のコピー(bitblt)
WindowsのシステムAPIを使った画像コピーを行ないます。最も標準的なモードです。
・モード1 = メモリ間コピー
画像バッファ間のメモリコピーを行ないます。コピー元とコピー先は、同じ画像モード(パレットあり・なし) でなければなりません。モード0よりも速度面で有利な場合があります。
・モード2 = 透明色付きコピー
モード1と同様の方法でコピーを行ないますが、RGBが0のドットは透明色とみなされコピーされません。
・モード3 = 半透明合成コピー
フルカラーモード時のみ使用することができます。 gmodeの4番目のパラメーターで指定したブレンド率による半透明合成コピーを行ないます。ブレンド率は0～256の値となり、256で完全なコピーになります。ブレンド率が0の場合はコピーは実行されません。また、ブレンド率が256以上はメモリ間コピーが実行されます。
・モード4 = 透明色付き半透明合成コピー
モード3と同様の方法でコピーを行ないますが、RGB値が color命令で設定された色と同じドットは透明色とみなされコピーされません。ブレンド率が0の場合はコピーは実行されません。
・モード5 = 色加算合成コピー
フルカラーモード時のみ使用することができます。 gmodeの4番目のパラメーターで指定したブレンド率による色加算合成コピーを行ないます。色加算では、コピー先のRGB値に、コピー元のRGB値を加算します。加算時に輝度が255を越える場合は、255にクランプされます。
・モード6 = 色減算合成コピー
フルカラーモード時のみ使用することができます。 gmodeの4番目のパラメーターで指定したブレンド率による色減算合成コピーを行ないます。色減算では、コピー先のRGB値から、コピー元のRGB値を減算します。減算時に輝度が0を下回る場合は、0にクランプされます。
これらのモードは、gzoom命令では使用されません。あくまでもgcopy命令使用時なので注意してください。また、gmodeは現在gsel命令で選択されているウインドゥID のモードが変更されます。gmodeの設定後に、別なウインドゥIDで gcopy命令を実行しても設定が反映されないので注意してください。

また、モード0以外でコピーを行なう場合には、コピー元やコピー先の画面初期化Xサイズ(横サイズ)が4の倍数になるように注意してください。 HSPでは、高速化のためXサイズが4の倍数でないコピーをサポートしていません。Xサイズが4の倍数でない場合にモード0以外でコピーを行なうとは画像が斜めに崩れるなどの不具合が起こることがあります。

(p2,p3)はコピーサイズのデフォルトを設定します。この値は、gcopy,gzoom命令でコピーする大きさの値を省略した場合にデフォルトで使われるサイズです。

備考

ver2.61標準命令

参照

 gcopy

gosub

( プログラム制御命令 )
gosub *label [指定ラベルにサブルーチンジャンプ]

*label : ラベル名

説明

サブルーチンジャンプをします。 gosub命令は、*labelで指定した場所にジャンプをします。その後、return命令があるとgosub命令の次の行に復帰して実行を続けます。 gosub～returnは最大32重までネスティングが可能です。

備考

ver2.61標準命令

参照

 goto
return

goto

( プログラム制御命令 )
goto *label [指定ラベルにジャンプ]

*label : ラベル名

説明

指定したラベルに無条件でジャンプします。以降は、ラベル名で指定された場所から実行を続けます。

備考

ver2.61標準命令

参照

 gosub

grect

( 拡張画面制御命令 )
grect p1,p2,p3,p4,p5,p6 [回転する矩形で塗りつぶす]

p1=0～(0) : 矩形の中心X座標
p2=0～(0) : 矩形の中心Y座標
p3=0～(0) : 回転角度(4096=360度)
p4=0～(?) : Xサイズ
p5=0～(?) : Yサイズ
p6=0～(0) : パレットコード

( 拡張プラグイン[hspext]が必要です )

説明

(p1,p2)で指定した座標を中心として、(p4,p5)で指定したサイズの矩形(長方形)を描画します。描画される色は、color命令またはpalcolor命令で指定されているものとなります。 p3で回転角度を指定することができます。角度は、0から始まって、4096で一周(360度)します。 grect命令は、gmodeで設定されたコピーモードの指定が反映されます。

gmodeが0,1の場合は、通常の塗りつぶし。 gmodeが3の場合は、指定されたレートで半透明になります。 gmodeが5,6の場合は、それぞれ色加算、色減算処理となります。また、(p4,p5)のサイズ指定を省略した場合には、gmode命令で設定されているコピーサイズが使用されます。

パレットモード時には、p6で指定したパレットコードで塗りつぶしが行なわれます。また、パレットモード時には半透明処理は実行されません。

備考

hspext.asをインクルードすること。

参照

 grotate
gsquare
gmode

grotate

( 拡張画面制御命令 )
grotate p1,p2,p3,p4,p5,p6 [矩形画像を回転してコピー]

p1=0～(0) : コピー元のウインドゥID
p2=0～(0) : コピー元の左上X座標
p3=0～(0) : コピー元の左上Y座標
p4=0～(0) : 回転角度(4096=360度)
p5=0～(?) : Xサイズ
p6=0～(?) : Yサイズ

( 拡張プラグイン[hspext]が必要です )

説明

grotate命令は、gcopy命令に回転を含めた処理を行ないます。 p1で、コピー元のウインドゥIDを指定、(p2,p3)でコピーされる元の画像にあたる座標を指定します。(gcopy命令と同様です) コピー先は、現在の描画先に指定されているウインドゥIDで、 pos命令で設定された場所を中心とした座標にコピーを行ないます。その際に、p3で回転角度を指定することができます。角度は、0から始まって、4096で一周(360度)します。 (p5,p6)で、コピーされた後のX,Yサイズを指定します。また、コピー元のX,Yサイズはgmode命令で設定されたデフォルトのコピーサイズが使用されます。つまり、gmode命令で指定されたサイズよりも大きなサイズを(p5,p6) で指定した場合には、拡大されることになります。 (p5,p6)を省略した場合には、コピー元と同じサイズ、つまり等倍でコピーが行なわれます。

grotate命令は、gmodeで設定されたコピーモードの指定がすべて反映されます。透明色の設定や、半透明の設定はすべてgcopy命令でコピーした場合と同等に機能します。(詳しくはgmode命令のリファレンスを参照)

パレットモード時には半透明処理は実行されません。また、異なる画面モード(パレットモードとフルカラーモード)間でのコピーはエラーになります。

備考

hspext.asをインクルードすること。

参照

 grect
gsquare
gmode

gsel

( 画面制御命令 )
gsel p1,p2			[グラフィック操作先指定]
p1=0～31(0) : ウインドゥID
p2=0～1(0) : ウインドゥアクティブスイッチ
説明

画面制御命令の描画先を指定したウインドゥIDの画面に変更します。これ以降は、p1で指定したウインドゥIDの画面に対して、 mes命令やpicload命令などの画面描画に関する命令が実行されるようになります。

p2でオプションのスイッチが指定できます。p2の値が、
    -1 : 指定したウインドゥを非表示にする
    0 : 指定したウインドゥに特に影響はない
    1 : 指定したウインドゥがアクティブになる
    2 : 指定したウインドゥがアクティブになり、さらに常に最前面になる
のようにウインドゥの状態を変更することができます。 p2の指定を省略した場合は、特に何も影響はありません。

p2=-1で非表示にした場合は、指定したウインドゥが消えますが完全に消去されるわけではありません。再びp2=1か2でアクティブにすると復帰します。
備考

ver2.61標準命令

gsquare

( 拡張画面制御命令 )
gsquare p1,p2,p3,p4,p5 [任意の四角形画像をコピー]

p1=0～(0) : コピー元のウインドゥID (マイナス値ならば塗りつぶし)
p2=変数名 : コピー先X座標が格納される数値型配列変数名
p3=変数名 : コピー先Y座標が格納される数値型配列変数名
p4=変数名 : コピー元X座標が格納される数値型配列変数名
p5=変数名 : コピー元Y座標が格納される数値型配列変数名

( 拡張プラグイン[hspext]が必要です )

説明

任意の４点を持つ四角形をコピーまたは塗りつぶします。 p1で、画像コピー元のウインドゥIDを指定します。 p1に-1などマイナス値を指定した場合は、画像コピーではなく塗りつぶしが行なわれます。その際、フルカラーモード時にはcolor、palcolor命令で指定された色による塗りつぶしとなります。パレットモード時は、p1で指定した値-1をパレットコードとして塗りつぶしを行ないます。 (-1～-256がパレットコード0～255に対応します)

p2,p3にはコピー先の座標４つを配列に格納した変数を指定します。 p4,p5にはコピー元の座標４つを配列に格納した変数を指定します。配列変数には、左上(0),右上(1),右下(2),左下(3)の順番に座標を入れておく必要があります。塗りつぶしを行なう場合には、(p4,p5)を指定する必要はありません。

gsquare命令は、gmodeで設定されたコピーモードの指定がすべて反映されます。透明色の設定や、半透明の設定はすべてgcopy命令でコピーした場合と同等に機能します。(詳しくはgmode命令のリファレンスを参照)

パレットモード時には半透明処理は実行されません。また、異なる画面モード(パレットモードとフルカラーモード)間でのコピーはエラーになります。

備考

hspext.asをインクルードすること。

参照

 grect
grotate
gmode

gval

( システム変数 )
[RGB カラーの G (緑) 輝度情報]

説明

RGB カラーの G (緑) 輝度情報が代入されます。この値は、pget, getpal, dialog (カラー選択ダイアログ) 命令で取得されます。

備考

ver2.61標準

参照

 rval
bval
pget
dialog
getpal

gzoom

( 画面制御命令 )
gzoom p1,p2,p3,p4,p5,p6,p7 [変倍して画面コピー]

p1,p2 : 画面にコピーする時の大きさX,Y（ドット単位）
p3=0～31(0): ウインドゥID
p4,p5 : コピー元の左上X,Y座標
p6,p7 : コピーする大きさX,Y（ドット単位）

説明

gzoom命令は、指定したウインドゥIDの画面の一部を、現在の描画先カレントポジションに、任意の大きさに変倍してコピーします。コピー元のウインドゥIDは、自分のウインドゥIDと同じかまたは、screen命令やbuffer命令で初期化されたウインドゥ IDでなければなりません。

gzoom命令でパレットモード画面の画像をコピーする際には注意が必要です。コピーする２つのウインドゥのパレットを共通にするか、またはコピー元の画像が使っているパレットカラーと同じものが、コピー先にも存在しなければ正しくない色でコピーされおかしな画像になってしまいます。

備考

ver2.61標準命令

参照

 gcopy

gcopy

p1=0～31(0): ウインドゥID p2,p3 : コピー元の左上X,Y座標 p4,p5 : コピーする大きさX,Y（ドット単位）

get_fileicon

v1 : 取得したアイコンを入れる変数 s2 : ファイル名 n3 : 取得するもの

get_icon

v1 : 取得したアイコンを入れる数値変数 s2 : アイコンを含むファイル名 n3 : アイコンの番号 n4 : 小さいアイコンを取得するかどうかのフラグ

getbg

val : クローンが作成される変数名 modelID : モデルID

getcoli

val : 結果が代入される変数名 id : オブジェクトID distance : 衝突を検出する範囲(float値)

getdebug

val : 結果が代入される変数名

getkey

p1=変数 : 読み込むための変数 p2=1～(1) : キーコード

getmchild

val : 結果が代入される変数名 id : モデルID sub_id : モデルサブID

getmfv

fv : FV値が代入される変数名 model_id : モデルID sub_id : モデルサブID type : タイプID

getmodel

val : 情報が代入される変数名 model_id : モデルID sub_id : モデルサブID

getmpoly

val : 頂点情報が代入される変数名 model_id : モデルID node_id : ノードID mode : 頂点の種類(0=座標/1=法線)

getmsibling

val : 結果が代入される変数名 id : モデルID sub_id : モデルサブID

getmtex

val : 結果が代入される変数名 ModelID : モデルID NodeID : ノードID

getmuv

val : 情報が代入される変数名 model_id : モデルID node_id : ノードID

getobjsize

v1 : オブジェクトのサイズ、位置を取得するための数値変数 n2 : オブジェクトのID

getpal

p1=0～255(0) : パレットコード

getpath

p1=変数名 : 結果を格納する変数名 p2=文字列 : 取り出す元の文字列 p3=0～(0) : 情報のタイプ指定

getptr

v1 : ポインタを代入する変数 v2 : ポインタを取得する変数

getreg

p1=変数名 : 読み出すための変数名 "section" : セクション名指定 p2=0～1(0) : タイプ指定 p3=1～(64) : 読み出しサイズ指定

gets

v1 : コンソールからの文字列を取得する変数 n2 : 取得する文字の数

getstr

p1=変数 : 内容を読み出す先の変数名 p2=変数 : バッファを割り当てた変数名 p3=0～ : バッファのインデックス(Byte単位) p4=0～255 : 区切りキャラクタのASCIIコード

getsync

val : 情報が代入される変数名 mode : 取得モード( 0=現在のタイマ / 1=タイマ分解能 )

gettex

val : テクスチャIDが代入される変数名

gettime

p1=変数 : 読み込むための変数 p2=0～(0) : 取得するパラメータのタイプ

gettree

val : 情報が代入される変数名 id : モデルID

gfcopy

p1=0～100(0) : 半透明コピーレート(%)

gfdec

p1,p2,p3=0～255(0) : 色コード（R,G,Bの輝度)

gfinc

p1,p2,p3=0～255(0) : 色コード（R,G,Bの輝度)

gfini

p1=0～(0) : 画面操作を行なうXサイズ(dot単位) p2=0～(0) : 画面操作を行なうYサイズ(dot単位)

ginfo

p1=0～(0) : 情報タイプ設定

gmode

p1=0～6(0) : 画面コピーモード p2,p3 : コピーする大きさX,Y（ドット単位） p4=0～256(0) : 半透明合成時のブレンド率

gosub

*label : ラベル名

goto

*label : ラベル名

grect

p1=0～(0) : 矩形の中心X座標 p2=0～(0) : 矩形の中心Y座標 p3=0～(0) : 回転角度(4096=360度) p4=0～(?) : Xサイズ p5=0～(?) : Yサイズ p6=0～(0) : パレットコード

grotate

p1=0～(0) : コピー元のウインドゥID p2=0～(0) : コピー元の左上X座標 p3=0～(0) : コピー元の左上Y座標 p4=0～(0) : 回転角度(4096=360度) p5=0～(?) : Xサイズ p6=0～(?) : Yサイズ

gsel

p1=0～31(0) : ウインドゥID p2=0～1(0) : ウインドゥアクティブスイッチ

gsquare

gval

gzoom

p1,p2 : 画面にコピーする時の大きさX,Y（ドット単位） p3=0～31(0): ウインドゥID p4,p5 : コピー元の左上X,Y座標 p6,p7 : コピーする大きさX,Y（ドット単位）

p1=0～31(0): ウインドゥID
p2,p3 : コピー元の左上X,Y座標
p4,p5 : コピーする大きさX,Y（ドット単位）

v1 : 取得したアイコンを入れる変数
s2 : ファイル名
n3 : 取得するもの

v1 : 取得したアイコンを入れる数値変数
s2 : アイコンを含むファイル名
n3 : アイコンの番号
n4 : 小さいアイコンを取得するかどうかのフラグ

val : クローンが作成される変数名
modelID : モデルID

val : 結果が代入される変数名
id : オブジェクトID
distance : 衝突を検出する範囲(float値)

p1=変数 : 読み込むための変数
p2=1～(1) : キーコード

val : 結果が代入される変数名
id : モデルID
sub_id : モデルサブID

fv : FV値が代入される変数名
model_id : モデルID
sub_id : モデルサブID
type : タイプID

val : 情報が代入される変数名
model_id : モデルID
sub_id : モデルサブID

val : 頂点情報が代入される変数名
model_id : モデルID
node_id : ノードID
mode : 頂点の種類(0=座標/1=法線)

val : 結果が代入される変数名
id : モデルID
sub_id : モデルサブID

val : 結果が代入される変数名
ModelID : モデルID
NodeID : ノードID

val : 情報が代入される変数名
model_id : モデルID
node_id : ノードID

v1 : オブジェクトのサイズ、位置を取得するための数値変数
n2 : オブジェクトのID

p1=変数名 : 結果を格納する変数名
p2=文字列 : 取り出す元の文字列
p3=0～(0) : 情報のタイプ指定

v1 : ポインタを代入する変数
v2 : ポインタを取得する変数

p1=変数名　: 読み出すための変数名
"section"　: セクション名指定
p2=0～1(0) : タイプ指定
p3=1～(64) : 読み出しサイズ指定

v1 : コンソールからの文字列を取得する変数
n2 : 取得する文字の数

p1=変数 : 内容を読み出す先の変数名
p2=変数 : バッファを割り当てた変数名
p3=0～ : バッファのインデックス(Byte単位)
p4=0～255 : 区切りキャラクタのASCIIコード

val : 情報が代入される変数名
mode : 取得モード( 0=現在のタイマ / 1=タイマ分解能 )

p1=変数 : 読み込むための変数
p2=0～(0) : 取得するパラメータのタイプ

val : 情報が代入される変数名
id : モデルID

p1=0～(0) : 画面操作を行なうXサイズ(dot単位)
p2=0～(0) : 画面操作を行なうYサイズ(dot単位)

p1=0～6(0) : 画面コピーモード
p2,p3 : コピーする大きさX,Y（ドット単位）
p4=0～256(0) : 半透明合成時のブレンド率

p1=0～(0) : 矩形の中心X座標
p2=0～(0) : 矩形の中心Y座標
p3=0～(0) : 回転角度(4096=360度)
p4=0～(?) : Xサイズ
p5=0～(?) : Yサイズ
p6=0～(0) : パレットコード

p1=0～(0) : コピー元のウインドゥID
p2=0～(0) : コピー元の左上X座標
p3=0～(0) : コピー元の左上Y座標
p4=0～(0) : 回転角度(4096=360度)
p5=0～(?) : Xサイズ
p6=0～(?) : Yサイズ

p1=0～31(0) : ウインドゥID
p2=0～1(0) : ウインドゥアクティブスイッチ

p1,p2 : 画面にコピーする時の大きさX,Y（ドット単位）
p3=0～31(0): ウインドゥID
p4,p5 : コピー元の左上X,Y座標
p6,p7 : コピーする大きさX,Y（ドット単位）