HSP command help

length

length (p1) [配列の要素数を返す(1次元)]

p1 : 配列を調べる変数

説明

p1で指定された変数が持つ配列要素数(1次元)を返します。配列要素数が５だった場合は、p1(0)～p1(4)が存在することになります。

備考

ver3.0標準関数

参照

 length2命令
 length3命令
 length4命令

length2

length2 (p1) [配列の要素数を返す(2次元)]

p1 : 配列を調べる変数

説明

p1で指定された変数が持つ配列要素数(2次元)を返します。配列要素数が５だった場合は、p1(0,0)～p1(?,4)が存在することになります。配列の次元が存在しない場合は、0が返ります。

備考

ver3.0標準関数

参照

 length命令
 length3命令
 length4命令

length3

length3 (p1) [配列の要素数を返す(3次元)]

p1 : 配列を調べる変数

説明

p1で指定された変数が持つ配列要素数(2次元)を返します。配列要素数が５だった場合は、p1(0,0,0)～p1(?,?,4)が存在することになります。配列の次元が存在しない場合は、0が返ります。

備考

ver3.0標準関数

参照

 length命令
 length2命令
 length4命令

length4

length4 (p1) [配列の要素数を返す(4次元)]

p1 : 配列を調べる変数

説明

p1で指定された変数が持つ配列要素数(4次元)を返します。配列要素数が５だった場合は、p1(0,0,0,0)～p1(?,?,?,4)が存在することになります。配列の次元が存在しない場合は、0が返ります。

備考

ver3.0標準関数

参照

 length命令
 length2命令
 length3命令

libptr

libptr (p1) [外部呼出しコマンドの情報アドレスを得る]

p1 : アドレスを調べるコマンド
説明

p1に指定したコマンドの情報アドレスを取得して整数値として返します。外部DLL呼び出しコマンドや関数をパラメーターとして指定することで、コマンドに関する情報が格納されているSTRUCTDAT構造体のアドレスを取得することができます。 STRUCTDAT構造体は、HSPSDK内で以下のように定義されています。
typedef struct STRUCTDAT { short index; // base LIBDAT index short subid; // struct index int prmindex; // STRUCTPRM index(MINFO) int prmmax; // number of STRUCTPRM int nameidx; // name index (DS) int size; // struct size (stack) int otindex; // OT index(Module) / cleanup flag(Dll) union { void *proc; // proc address int funcflag; // function flags(Module) }; } STRUCTDAT;
p1にCOM呼び出しコマンドやユーザー定義命令、ユーザー定義関数を指定した場合も同様にSTRUCTDAT構造体のアドレスが取得されます。 libptr関数は、HSPが使用している内部データへのアクセスを補助するもので、ここで扱う情報の内容について十分な知識を持った上で使用するようにしてください。通常の使用範囲では、この関数を利用したり覚えておく必要はありません。

STRUCTDAT構造体を参照することで、外部呼出しDLLのアドレスや、DLLハンドルなどの情報を得ることが可能です。

備考

ver3.0標準関数

参照

 varptr命令

limit

limit (p1,p2,p3) [一定範囲内の整数を返す]

p1 : 対象となる値
p2 : 最小値
p3 : 最大値

説明

p1に指定した値を、p2～p3の範囲内に収まる整数に変換したものを返します。 p1の値がp2よりも小さい場合は、p2の値が返され、p1の値がp3よりも大きい場合にはp3の値が返されます。これにより、limit関数が返す値は、必ずp2～p3の範囲内となります。実数の範囲を求める場合には、limitf関数を使用してください。

備考

ver3.0標準関数

参照

 limitf命令

limitf

limitf (p1,p2,p3) [一定範囲内の実数を返す]

p1= : 対象となる値
p2= : 最小値
p3= : 最大値

説明

p1に指定した値を、p2～p3の範囲内に収まる実数に変換したものを返します。 p1の値がp2よりも小さい場合は、p2の値が返され、p1の値がp3よりも大きい場合にはp3の値が返されます。これにより、limitf関数が返す値は、必ずp2～p3の範囲内となります。整数の範囲を求める場合には、limit関数を使用してください。

備考

ver3.0標準関数

参照

 limit命令

line

line p1,p2,p3,p4 [直線を描画]

p1,p2 : ラインの終点X,Y座標
p3,p4 : ラインの始点X,Y座標

説明

画面上に、(p1,p2)と(p3,p4)を結ぶ直線を描画します。 (p3,p4)を省略した場合は、カレントポジションから(p1,p2)まで、現在設定されている色で直線が描画されます。

line命令実行後は、(p1,p2)の座標がカレントポジションになります。これにより、連続した直線を描画していくことが可能です。

備考

ver3.0標準命令

参照

 pos命令
 color命令
 palcolor命令
 boxf命令
 circle命令

listbox

listbox p1,p2,p3 [リストボックス表示]

p1=変数 : リストボックスの状態を保持する数値型変数
p2=0～(100) : 拡張Yサイズ
p3="strings" : リストボックスの内容を示す文字列

説明

カレントポジションにオブジェクトとして、リストボックスを配置します。リストボックスは、複数の文字列要素の中から１つを選択させることのできる入力オブジェクトです。オブジェクトの大きさは、objsize命令で設定した大きさになります。ただし、 p2パラメータで選択時のリスト表示のためのYサイズを指定しなければなりません。 (通常は100～150程度が適当です)

「\n」で区切った文字列をp3で指定することで、選択する要素を設定することができます。たとえば、「APPLE\nORANGE\nGRAPE」という文字列を指定すると、「APPLE」「ORANGE」「GRAPE」の中から１つを選択するリストボックスになります。それぞれの要素には、0から順番にインデックス番号がついています。前の例では、「APPLE」はインデックス0、「ORANGE」はインデックス1、「GRAPE」はインデックス2というふうに番号がついていきます。

この「\n」で区切るというデータ形式は、メモリノートパッド命令で扱う複数行テキストデータと同じです。メモリノートパッド命令で作成したデータをそのままlistbox命令にも使用できます。

ユーザーが選択をすると、p1で指定した数値型変数にインデックス番号が代入されます。最初にリストボックスが配置される際には、p1で設定した変数が示すインデックスが選ばれた状態になります。 (インデックス番号が-1の時は非選択の状態になります)

備考

ver3.0標準命令

参照

 objsize命令

loadtoon

loadtoon p1,"filename" [トゥーンテクスチャをファイルから登録]

p1 : モデルID
"filename" : 登録するテクスチャの画像ファイル

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

説明

p1で指定したモデルに対してトゥーンシェーディングのモードを設定し、色の情報を持つテクスチャファイルを読み込みます。

あらかじめ、addxfile命令によりX形式の3Dモデルが読み込まれている必要があります。トゥーンシェーディングを設定する場合には、あらかじめトゥーンテクスチャと呼ばれる色情報を持った画像データを作成しておかなければなりません。 (トゥーンテクスチャは、maketoon命令によって作成することが可能です。)

備考

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

参照

 maketoon命令

logf

logf (p1) [対数を返す]

p1=0.0～(0.0) : 対数を求める値

説明

p1の対数(log)値を、実数で返します。 p1に0を指定した場合は無限大(INF)を返します。

備考

ver3.0標準関数

参照

 expf命令

logmes

logmes "message" [デバッグメッセージ送信]

"message" : ログに記録するメッセージ

説明

デバッグウィンドウ表示時に、"message"の内容をデバッグログに記録します。ある時点での変数の内容や、通過チェックなどに利用できます。スクリプトエディタからデバッグウィンドウの表示モードを設定するか、 assert命令によってデバッグウィンドウを表示させておく必要があります。実行ファイル作成時は、この命令は無効になります。

備考

ver3.0標準命令

参照

 assert命令

loop


[ループの始まりに戻る]

説明

repeat命令で指定したループの終わりを指定します。詳しくはrepeat命令の項を参照してください。

備考

ver3.0標準命令

参照

 repeat命令
 foreach命令

looplev


[repeat～loop のネストレベル]

説明

repeat～loop のネストレベルが代入されます。

備考

ver3.0標準

参照

 repeat命令
 foreach命令
 loop命令

lparam


[割り込み時の lParam]

説明

割り込み時に保存される Windows のシステム値 (lParam) が代入されます。

備考

ver3.0標準

参照

 onkey命令
 onclick命令
 onerror命令
 iparam命令
 wparam命令
 onerror命令
 oncmd命令

lpeek

lpeek (p1,p2) [バッファから4byte読み出し]

p1=変数 : 内容を読み出す元の変数名
p2=0～ : バッファのインデックス(Byte単位)

説明

変数に保存されたデータメモリ上の任意の場所にある4バイト(32bit)の内容を数値として返します。関数の戻り値は、0～$ffffffffまでの整数値になります。

備考

ver3.0標準関数

参照

 peek命令
 wpeek命令

lpoke

lpoke p1,p2,p3 [バッファに4byte書き込み]

p1=変数 : バッファを割り当てた変数名
p2=0～ : バッファのインデックス(Byte単位)
p3=0～(0) : バッファに書き込む値(32bit整数値)

説明

変数に保存されたデータメモリ上の任意の場所にある 4バイトの内容を書き換えます。

p1で指定した変数のバッファ上で、p2で指定したインデックスの場所にp3の値を書き込みます。値は0～$ffffffffまでの4バイト(32bit)値になります。

備考

ver3.0標準命令

参照

 poke命令
 wpoke命令

lzcopy

lzcopy "name"			[圧縮解凍コピー]
"name" : 圧縮ファイル名
( 拡張プラグイン[hspext]が必要です )
説明

Microsoftの compress.exe形式の圧縮ファイルを解凍しながらコピーを行ないます。

カレントディレクトリにある"name"で指定された圧縮ファイルを、lzdist命令で指定したディレクトリに解凍された形でコピーします。 "name"には、拡張子を含まない名前(8文字まで)を指定してください。 lzcopy命令を実行する場合は、必ずlzdist命令でコピー先をあらかじめ指定しておく必要かあります。

指定に誤りがあったり、エラーが発生するとシステム変数 statに1が代入されます。正常に終了するとシステム変数 statは0になります。

備考

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

lzdist

lzdist "path"			[圧縮解凍先ディレクトリ指定]
"path" : lzcopy命令の解凍コピー先ディレクトリ
( 拡張プラグイン[hspext]が必要です )
説明

lzcopy命令の解凍コピー先ディレクトリを指定します。

lzcopy命令を実行する場合は、必ずlzdist命令でコピー先をあらかじめ指定しておく必要かあります。

備考

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

length

p1 : 配列を調べる変数

length2

p1 : 配列を調べる変数

length3

p1 : 配列を調べる変数

length4

p1 : 配列を調べる変数

libptr

p1 : アドレスを調べるコマンド

limit

p1 : 対象となる値
p2 : 最小値
p3 : 最大値

limitf

p1= : 対象となる値
p2= : 最小値
p3= : 最大値

line

p1,p2 : ラインの終点X,Y座標
p3,p4 : ラインの始点X,Y座標

listbox

p1=変数 : リストボックスの状態を保持する数値型変数
p2=0～(100) : 拡張Yサイズ
p3="strings" : リストボックスの内容を示す文字列

loadtoon

p1 : モデルID
"filename" : 登録するテクスチャの画像ファイル

logf

p1=0.0～(0.0) : 対数を求める値

logmes

"message" : ログに記録するメッセージ

loop

looplev

lparam

lpeek

p1=変数 : 内容を読み出す元の変数名
p2=0～ : バッファのインデックス(Byte単位)

lpoke

p1=変数 : バッファを割り当てた変数名
p2=0～ : バッファのインデックス(Byte単位)
p3=0～(0) : バッファに書き込む値(32bit整数値)

lzcopy

"name" : 圧縮ファイル名

lzdist

"path" : lzcopy命令の解凍コピー先ディレクトリ

length

p1 : 配列を調べる変数

length2

p1 : 配列を調べる変数

length3

p1 : 配列を調べる変数

length4

p1 : 配列を調べる変数

libptr

p1 : アドレスを調べるコマンド

limit

p1 : 対象となる値 p2 : 最小値 p3 : 最大値

limitf

p1= : 対象となる値 p2= : 最小値 p3= : 最大値

line

p1,p2 : ラインの終点X,Y座標 p3,p4 : ラインの始点X,Y座標

listbox

p1=変数 : リストボックスの状態を保持する数値型変数 p2=0～(100) : 拡張Yサイズ p3="strings" : リストボックスの内容を示す文字列

loadtoon

p1 : モデルID "filename" : 登録するテクスチャの画像ファイル

logf

p1=0.0～(0.0) : 対数を求める値

logmes

"message" : ログに記録するメッセージ

loop

looplev

lparam

lpeek

p1=変数 : 内容を読み出す元の変数名 p2=0～ : バッファのインデックス(Byte単位)

lpoke

p1=変数 : バッファを割り当てた変数名 p2=0～ : バッファのインデックス(Byte単位) p3=0～(0) : バッファに書き込む値(32bit整数値)

lzcopy

"name" : 圧縮ファイル名

lzdist

"path" : lzcopy命令の解凍コピー先ディレクトリ

p1 : 対象となる値
p2 : 最小値
p3 : 最大値

p1= : 対象となる値
p2= : 最小値
p3= : 最大値

p1,p2 : ラインの終点X,Y座標
p3,p4 : ラインの始点X,Y座標

p1=変数 : リストボックスの状態を保持する数値型変数
p2=0～(100) : 拡張Yサイズ
p3="strings" : リストボックスの内容を示す文字列

p1 : モデルID
"filename" : 登録するテクスチャの画像ファイル

p1=変数 : 内容を読み出す元の変数名
p2=0～ : バッファのインデックス(Byte単位)

p1=変数 : バッファを割り当てた変数名
p2=0～ : バッファのインデックス(Byte単位)
p3=0～(0) : バッファに書き込む値(32bit整数値)