HSP command help

mci

mci "strings"			[MCIにコマンドを送る]
"strings" : MCIコマンド文字列
説明

MCI（Multimedia Control Interface）にコマンド文字列を送ります。MCIに対応したMIDI再生、ムービー再生などを行なうことができます。

MCIコマンドの詳細については、Windows MCIの解説書をお読みください。ここでは簡単な使用法だけを紹介しておきます。
    mci "play filename"
で、"filename"のファイルを再生します。たとえば、 "play aaaa.mid"ならば、"aaaa.mid"というMIDIファイルを演奏します。拡張子がaviなら動画の再生、wavならPCMの再生、その他MCIに登録されているデバイスを再生することができます。
    mci "open filename alias abc"
で、"filename"のファイルをオープンして、これ以降"abc"という名前をエイリアスにすることができます。この後で、
    mci "play abc"		; デバイスの再生
    mci "stop abc"		; デバイスの再生ストップ
    mci "close abc"		; デバイスのクローズ
などの指定をすることができるようになります。 mciに命令を送った場合の結果はシステム変数statに反映されます。 statが-1の場合は、mci命令を解釈する時点でエラーが出ていることを示しています。また、mciでステータスを読み出すコマンドを送った場合も、statに結果が反映されます。
備考

ver2.55標準命令

memcpy

memcpy p1,p2,p3,p4,p5 [メモリブロックのコピー]

p1 : コピー先の変数
p2 : コピー元の変数
p3 : コピーするサイズ(1byte単位)
p4 : コピー先の変数メモリオフセット(省略時=0)
p5 : コピー元の変数メモリオフセット(省略時=0)

説明

p1で指定された変数に割り当てられているメモリ領域に、 p2で指定された変数に割り当てられているメモリの内容をコピーします。コピーするサイズ(1byte単位)は、p3で指定します。大きな領域を変数に割り当てている場合などに高速なメモリコピーを行なうことができます。 p4,p5で、コピー先、コピー元の開始位置を1byte単位で調整することができます。

備考

ver2.55標準命令

参照

 memset命令

memset

memset p1,p2,p3,p4 [メモリブロックのクリア]

p1 : 書き込み先の変数
p2 : クリアする値(1byte)
p3 : クリアするサイズ(1byte単位)
p4 : 書き込み先の変数メモリオフセット(省略時=0)

説明

1byteの固定値でメモリブロックを埋めます。 p1で指定された変数に割り当てられているメモリ領域に、 p2で指定された値を、p3のサイズだけ書き込みます。大きな領域に同じ値を書き込みたい時に有効です。 p4で、メモリ開始位置を1byte単位で調整することができます。

備考

ver2.55標準命令

参照

 memcpy命令

mes

mes "strings" [メッセージ表示]

"strings" : 表示するメッセージ、または変数

説明

ウインドゥ内に、指定されたメッセージを表示します。メッセージは、カレントポジションと呼ばれるウインドゥ上の仮想的なカーソル位置から表示され、カレントポジションが次の行に自動的に移動します。

表示されるメッセージのフォントは、font命令で選択することができます。また、メッセージを表示する速度をtext命令で設定することができます。

表示するメッセージに改行コードが含まれていた場合には、改行され次の行から表示を続けます。

printとmesはどちらも同じ意味になります。

備考

ver2.55標準命令

参照

 print命令
 font命令
 text命令

mesbox

mesbox p1,p2,p3,p4,p5			[メッセージボックス表示]
p1=変数 : 表示メッセージが代入された文字列型変数
p2,p3 : メッセージボックスのサイズ（ドット単位）
p4=0～(0) : メッセージボックスのスタイル
p5=0～ : 入力できる最大文字数
説明

ウインドゥ上にオブジェクトとして、メッセージボックス(メッセージ表示用の窓) を配置します。p2,p3で大きさを指定して、場所はカレントポジションからになります。メッセージボックスのスタイルに設定する値(p4)は、以下の通りになります。
         値    対応するキー
     ---------------------------------------------------------------
       0    スクロール可能なエディットボックス(書き換え不可)
       1    スクロール可能なエディットボックス(書き換え可能)
       2    スクロールなし、スタティックテキスト
       4    横スクロールバー付きエディットボックス(書き換え不可)
       5    横スクロールバー付きエディットボックス(書き換え可能)
書き換え可能なエディットボックスを作成すると、ユーザーが好きに文字を入力できる簡単なテキストエディタになります。

p5で、入力できる最大文字数を指定することができます。 p5が0の場合は、そのバージョンのWindowsで扱える最大文字数になります。 p5が省略された場合には、p1で指定された変数に格納できる最大文字数が自動的に割り当てられます。

また、スタティックテキストは指定された範囲に複数行の文字列を表示するだけの、メッセージ表示ボックスとなります。このメッセージは、後から objprm命令などで変更可能です。mes命令とは違い、すでに表示されている内容を消す必要がないので便利です。
備考

ver2.55標準命令

mkdir

mkdir "dirname"			[ディレクトリ作成]
"dirname" : 作成するディレクトリ名

説明

"dirname"で指定した名前でディレクトリを作成します。ディレクトリは１階層先までしか作成することができません。作成中にエラーが発生した場合はFile I/O errorとなります。

備考

ver2.55標準命令

mouse

mouse p1,p2			[マウスカーソル座標設定]
p1,p2 : 設定するX,Y座標

説明

マウスカーソルをp1,p2で指定した座標に変更します。指定する座標は、ウインドゥ内の座標ではなくディスプレイでの座標(X=0～dispx/Y=0～dispy) を指定します。p1または、p2が-1の場合は、マウスカーソルの表示をOFFにします。 p1やp2の指定を省略した場合は、現在の座標がそのまま適用されます。マウスカーソルの表示をOFFにした後は、p1とp2を省略した「mouse」のみを実行すると再び表示されるようになります。

備考

ver2.55標準命令

mouse_event

mouse_event n1,n2,n3			[マウス操作]
n1 : 操作タイプ
n2 : 水平方向の移動量
n3 : 垂直方向の移動量
( 拡張プラグイン[loadlib]が必要です )
説明

マウス操作を行います。 n1に指定するタイプでマウス操作を行うことができます。水平方向の移動量は、画面左から右へ移動させるときが正、その逆が負垂直方向の移動量は、画面上から下へ移動させるときが正、その逆が負であることに注意してください。

mouse_eventはHSPのプログラムがアクティブでないときでもマウス操作に影響します。

<>操作タイプ n1の値は以下のものを組み合わせて使用することができます。
    n1の値
    $1       マウス移動
    $2       左のボタンを押す
    $4       左のボタンを放す
    $8       右のボタンを押す
    $10      右のボタンを放す
    $20      中のボタンを押す
    $40      中のボタンを放す
備考

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

mref

mref p1,p2 [特殊なメモリを変数に割り当てる]

p1=変数名 : 割り当てられる変数名
p2=0～(0) : リソースID (割り当てるメモリ内容)
説明

p1で指定された変数に、p2で指定したメモリ内容を割り当てます。
値対応するリソース --------------------------------------------------------- 0～ 7 ローカルパラメータ#1～8(数値) 16 ローカルパラメータ#1(数値型変数) 17 ローカルパラメータ#2(数値型変数) 24 ローカルパラメータ#1(文字列型変数) 25 ローカルパラメータ#2(文字列型変数) 32 ローカルパラメータ#1(255文字以下の文字列) 33 ローカルパラメータ#2(255文字以下の文字列) 48 ローカルパラメータ#1(数値型配列変数) 49 ローカルパラメータ#2(数値型配列変数) 56 ローカルパラメータ#1(文字列型配列変数) 57 ローカルパラメータ#2(文字列型配列変数) 64 システム変数stat 65 システム変数refstr 66 ウインドゥ内画像データ(VRAM) 67 現在のウインドゥ情報(BMSCR構造体) 96～103 ウインドゥID0～7の情報(BMSCR構造体) 1024 ローカルパラメータ#1情報(PVAL構造体) 1025 ローカルパラメータ#2情報(PVAL構造体)
ローカルパラメータは、ユーザー定義命令(#deffunc)で新規に追加された命令のパラメータ内容が格納されています。パラメータのタイプ(数値、変数、文字列)に従って取得することが可能です。

リソースIDに「ローカルパラメータ」を指定した場合は、モジュールの呼び出し元(新規命令が実行された時)に指定されていた数値や変数のクローンとなります。たとえば、「newfunc a」というように変数aがパラメータとして受け渡された時に、モジュール側で、「mref i,16」を指定すると変数iが変数aと同等のものになります (dup命令と同様です)。

ローカルパラメータとして、変数をそのまま取得する場合は、ユーザー定義命令(#deffunc)で指定されたパラメータタイプも「変数」になっている必要があります。ローカルパラメータとして取得した変数に値を代入すれば、もとの指定された変数の値も変化することになります。また、ローカルパラメータに変数を指定した場合は、指定した変数の型(文字列か数値か)に強制的に変更されます。

リソースID48,49も、リソースID16,17と同様にローカルパラメータ変数を取得しますが、こちらは配列の構造を含めた完全なクローンになります。たとえば、「newfunc a.1」というように配列変数の一部をパラメータに指定した場合、「mref i,16」では変数iは、変数a.1と同じになり、配列変数aとは異なるものになります。これに対して、「mref i,48」の場合は変数iが配列変数aとまったく同等のものになります。

リソースID64,65のシステム変数は、たとえば「mref i,64」とした場合、変数aがシステム変数statと同等になり、値を代入することができるようになります。これにより、ユーザー定義命令内の計算結果などをシステム変数に反映して、呼び出し元に返すことができます。

リソース66のウインドウ内画像データ(VRAMデータ)は、表示されている画像を内容とする配列変数になります。これにより、poke,peek命令などで画像データに直接アクセスが可能になります。

また、67以降も同様にHSPの内部データに直接アクセスできるようにするものですが、通常は使う必要はありません。DLLへ渡すためのパラメータ準備のためなど、ごく限られた用途のために用意されているもので、ほとんどの人は使うことはないはずです。

備考

ver2.55標準命令

参照

 #deffunc命令

msgdlg

msgdlg "s1","s2",n3,n4			[拡張dialog(type 0～3 )]
s1 : メッセージが入った文字列変数または文字列
s2 : タイトルが入った文字列変数または文字列
n3 : タイプ
n4 : アイコンタイプ
( 拡張プラグイン[loadlib]が必要です )
説明

HSPのdialog命令の拡張版です。
    タイプ
     0 Ok
     1 Ok ｷｬﾝｾﾙ
     2 中止　再試行　無視
     3 はい　いいえ　ｷｬﾝｾﾙ
     4 はい　いいえ
     5 再開試行 ｷｬﾝｾﾙ



    アイコンタイプ
     0 アイコン無し
     1 エラー(x)
     2 クエスチョンマーク(?)
     3 警告(!)
     4 情報(i)
     5 EXEが持っているアイコン



    この命令を呼び出した後のstatの値
    値 選択されたボタン
     1 Ok
     2 ｷｬﾝｾﾙ
     3 中止
     4 再試行
     5 無視
     6 はい
     7 いいえ
    -1 エラー発生
タイプに以下の値を加えるとデフォルトボタンが変えられます。 0 ボタン1 $100 ボタン2 $200 ボタン3 アイコンタイプに以下の値を加えるとビープ音が変えられます。 0 高い音(ノーマル) $100 警告音
備考

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

multiopen

multiopen v1,v2,n3,n4			[複数のファイル名を取得]
v1 : 選択されたファイル名を受け取るための変数
v2 : 情報
n3 : フィルタのインデックス(1から)
n4 : Read Onlyボックスを付ける
( 拡張プラグイン[loadlib]が必要です )
説明

HSPのdialog(type 16,17)で複数のファイルを選択できるようにしたものです。 multiopen呼び出し時に、v1.0,v1.1にそれぞれv1,v2のサイズを代入しておきます。 v2には例のような形式でフィルタを代入します。 n3を省略、またはマイナスの値を使ったときの動作は備考参照。 n4を1にするとReadOnlyボックスを付けます。2にするとReadOnlyボックスをチェックした状態にします。

この命令を呼び出した後のstatの値
    0 キャンセルされた
    1 ファイルが選択されてOKボタンが押された
    2 ファイルが選択されてOKボタンが押された(ReadOnlyがチェックされている。ただし
    複数選択されていない場合のみ)
p3を0(省略)にしてp1,p2に文字列を入れるとp1がタイトルになり、p2は初期フォルダになります。 p3をマイナス値にすると保存するファイル名を得るときに使うことができます。(ただし複数選択はできません)

複数のファイルが選択されたかはnotesel,notemaxを使って調べます。ファイルが一つしか選択されなかった場合、p1にはファイル名のフルパスが代入され、 p2にはファイルの拡張子が代入されます。ファイルが複数選ばれた場合は、p1にnotegetで取得できる形式でファイル名が複数入っていて、p2には選択されたファイルがあるフォルダが代入されます。(p1のファイル名は'\r'($0d)で区切られています。)
備考

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

mxaconv

mxaconv val [MA形式ファイルを変換]

val : ファイルがメモリにロードされている変数名

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

説明

MAファイルをアニメーションデータに変換します。この命令は、mxload命令モジュール内で使用されています。通常は使う必要はありません。通常はmxload命令を使用してください。

備考

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

参照

 mxsend命令
 mxconv命令
 mxgetpoly命令
 mxgetname命令

mxconv

mxconv val [MX形式ファイルを変換]

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

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

説明

MXファイルをモデルに変換しますです。この命令は、mxload命令モジュール内で使用されています。通常は使う必要はありません。通常はmxload命令を使用してください。

備考

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

参照

 mxsend命令
 mxaconv命令
 mxgetpoly命令
 mxgetname命令

mxgetname

mxgetname val,id [テクスチャ名を取得]

val : 結果(文字列)が代入される変数名
id : ローカルのテクスチャID

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

説明

変換されたMXファイルで使用されるテクスチャ名を取得します。この命令は、mxload命令モジュール内で使用されています。通常は使う必要はありません。

備考

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

参照

 mxsend命令
 mxconv命令
 mxaconv命令
 mxgetpoly命令

mxgetpoly


mxgetpoly val			[ポリゴン数を取得]

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

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

説明

変換されたMXファイルのポリゴン数を取得します。この命令は、mxload命令モジュール内で使用されています。通常は使う必要はありません。

備考

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

参照

 mxsend命令
 mxconv命令
 mxaconv命令
 mxgetname命令

mxload

mxload "filename"			[モデルファイル読み込み]
"filename" : 読み込むモデルファイル(MX形式)
( 拡張プラグイン[hgimg]が必要です )
説明

"filename"で指定したmx形式のファイルをモデルとして読み込みます。作成されたモデルIDは、システム変数statに代入されます。

備考

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

mxsend

mxsend val [MX形式ファイルをパース]

val : ファイルがメモリにロードされている変数名

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

説明

MXファイル読み込みを初期化します。この命令は、mxload命令モジュール内で使用されています。通常は使う必要はありません。通常はmxload命令を使用してください。

備考

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

参照

 mxconv命令
 mxaconv命令
 mxgetpoly命令
 mxgetname命令

mci

"strings" : MCIコマンド文字列

memcpy

p1 : コピー先の変数
p2 : コピー元の変数
p3 : コピーするサイズ(1byte単位)
p4 : コピー先の変数メモリオフセット(省略時=0)
p5 : コピー元の変数メモリオフセット(省略時=0)

memset

p1 : 書き込み先の変数
p2 : クリアする値(1byte)
p3 : クリアするサイズ(1byte単位)
p4 : 書き込み先の変数メモリオフセット(省略時=0)

mes

"strings" : 表示するメッセージ、または変数

mesbox

p1=変数 : 表示メッセージが代入された文字列型変数
p2,p3 : メッセージボックスのサイズ（ドット単位）
p4=0～(0) : メッセージボックスのスタイル
p5=0～ : 入力できる最大文字数

mkdir

"dirname" : 作成するディレクトリ名

mouse

p1,p2 : 設定するX,Y座標

mouse_event

n1 : 操作タイプ
n2 : 水平方向の移動量
n3 : 垂直方向の移動量

mref

p1=変数名 : 割り当てられる変数名
p2=0～(0) : リソースID (割り当てるメモリ内容)

msgdlg

s1 : メッセージが入った文字列変数または文字列
s2 : タイトルが入った文字列変数または文字列
n3 : タイプ
n4 : アイコンタイプ

multiopen

v1 : 選択されたファイル名を受け取るための変数
v2 : 情報
n3 : フィルタのインデックス(1から)
n4 : Read Onlyボックスを付ける

mxaconv

val : ファイルがメモリにロードされている変数名

mxconv

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

mxgetname

val : 結果(文字列)が代入される変数名
id : ローカルのテクスチャID

mxgetpoly

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

mxload

"filename" : 読み込むモデルファイル(MX形式)

mxsend

val : ファイルがメモリにロードされている変数名

mci

"strings" : MCIコマンド文字列

memcpy

p1 : コピー先の変数 p2 : コピー元の変数 p3 : コピーするサイズ(1byte単位) p4 : コピー先の変数メモリオフセット(省略時=0) p5 : コピー元の変数メモリオフセット(省略時=0)

memset

p1 : 書き込み先の変数 p2 : クリアする値(1byte) p3 : クリアするサイズ(1byte単位) p4 : 書き込み先の変数メモリオフセット(省略時=0)

mes

"strings" : 表示するメッセージ、または変数

mesbox

p1=変数 : 表示メッセージが代入された文字列型変数 p2,p3 : メッセージボックスのサイズ（ドット単位） p4=0～(0) : メッセージボックスのスタイル p5=0～ : 入力できる最大文字数

mkdir

"dirname" : 作成するディレクトリ名

mouse

p1,p2 : 設定するX,Y座標

mouse_event

n1 : 操作タイプ n2 : 水平方向の移動量 n3 : 垂直方向の移動量

mref

p1=変数名 : 割り当てられる変数名 p2=0～(0) : リソースID (割り当てるメモリ内容)

msgdlg

s1 : メッセージが入った文字列変数または文字列 s2 : タイトルが入った文字列変数または文字列 n3 : タイプ n4 : アイコンタイプ

multiopen

v1 : 選択されたファイル名を受け取るための変数 v2 : 情報 n3 : フィルタのインデックス(1から) n4 : Read Onlyボックスを付ける

mxaconv

val : ファイルがメモリにロードされている変数名

mxconv

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

mxgetname

val : 結果(文字列)が代入される変数名 id : ローカルのテクスチャID

mxgetpoly

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

mxload

"filename" : 読み込むモデルファイル(MX形式)

mxsend

val : ファイルがメモリにロードされている変数名

p1 : コピー先の変数
p2 : コピー元の変数
p3 : コピーするサイズ(1byte単位)
p4 : コピー先の変数メモリオフセット(省略時=0)
p5 : コピー元の変数メモリオフセット(省略時=0)

p1 : 書き込み先の変数
p2 : クリアする値(1byte)
p3 : クリアするサイズ(1byte単位)
p4 : 書き込み先の変数メモリオフセット(省略時=0)

p1=変数 : 表示メッセージが代入された文字列型変数
p2,p3 : メッセージボックスのサイズ（ドット単位）
p4=0～(0) : メッセージボックスのスタイル
p5=0～ : 入力できる最大文字数

n1 : 操作タイプ
n2 : 水平方向の移動量
n3 : 垂直方向の移動量

p1=変数名 : 割り当てられる変数名
p2=0～(0) : リソースID (割り当てるメモリ内容)

s1 : メッセージが入った文字列変数または文字列
s2 : タイトルが入った文字列変数または文字列
n3 : タイプ
n4 : アイコンタイプ

v1 : 選択されたファイル名を受け取るための変数
v2 : 情報
n3 : フィルタのインデックス(1から)
n4 : Read Onlyボックスを付ける

val : 結果(文字列)が代入される変数名
id : ローカルのテクスチャID