HSP command help

maketoon


maketoon p1,p2			[トゥーンテクスチャを作成]

p1 : モデルID
p2(0) : 作成モード

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

説明

p1で指定したモデルの情報をもとにトゥーンテクスチャの作成を行ないます。 p2で、作成モードを指定することができます。

    作成モード  内容
    --------------------------------------------------------------
      1         作成されたトゥーンテクスチャをモデルに適用する
      2         作成されたトゥーンテクスチャをファイルにセーブする

maketoon命令は、モデルの持つマテリアル色を抽出し、標準的なトゥーンテクスチャを作成します。作成モードに2を指定した場合は、「toon.bmp」という名前でトゥーンテクスチャを保存します。保存されたトゥーンテクスチャは、loadtoon命令で読み込んで使用することが可能なほか、画像を編集することにより、より細かいトゥーンシェーディングの表現を行なうことが可能になります。

備考

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

参照

 loadtoon命令

mcall

mcall p1,p2,p3… [メソッドの呼び出し]

p1 : 変数名
p2 : メソッド名
p3 : パラメーター

説明

p1で指定された変数の型に応じてメソッドを呼び出します。 p1の変数にCOMオブジェクト型を指定することで、COMオートメーションのメソッドを呼び出すことが可能です。 p2でメソッド名(文字列)または、ディスパッチID(DISPID)を指定して、p3以降に引数を指定します。 p3以降のパラメーター数や、型はそのまま適切に変換されメソッドに渡されます。メソッドを実行した結果の返値は、comres命令で設定された変数に代入されます。また、メソッド実行が成功した場合にはシステム変数 statは0になり、実行エラーが起こった場合には、システム変数statに結果コード(HRESULT)が代入されます。 mcall命令は、拡張された変数の型を用意することで、新しい機能を提供することが可能です。標準では、COMオブジェクト型のみに対応しています。

備考

ver3.0標準命令

参照

 #usecom命令
 newcom命令
 delcom命令
 querycom命令
 comres命令

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 に結果が反映されます。
備考

ver3.0標準命令

memcpy

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

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

説明

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

備考

ver3.0標準命令

参照

 memset命令
 memexpand命令

memexpand

memexpand p1,p2 [メモリブロックの再確保]

p1 = 変数 : 対象となる変数
p2 = 0～(64) : 再確保サイズ(1byte単位)

説明

p1で指定された変数が持つメモリ領域の再確保を行ないます。代入時などのメモリ領域確保はシステムが自動的に行なっていますが、明示的にサイズを変更する場合に使用します。再確保を行なった場合でも、以前までの内容は保持されます。 p2で、再確保サイズを指定します。p2の値が64より小さい場合は自動的に64に合わせられます。すでに確保されているサイズよりも小さな値を指定した場合は何も行われません。 p1で指定される変数は、文字列型(str)のように動的にメモリ確保量を変更することが可能な型である必要があります。再確保ができない型の場合には、エラーになります。

備考

ver3.0標準命令

参照

 memcpy命令
 memset命令
 alloc命令

memfile

memfile p1,p2,p3 [メモリストリーム設定]

p1=変数 : ストリーム対象となる変数名
p2=0～(0) : バッファのオフセット
p3=0～(MAX) : バッファのサイズ

説明

メモリストリーム機能によってファイルの替わりとして扱うメモリ空間を持った変数を設定します。 p1で指定された変数は、これ以降に「MEM:ファイル名」で指定されたファイルの読み出し元となります。 p2で、オフセット(読み出す際の先頭位置)を指定します。 0が指定されるか省略された場合は、バッファの先頭から読み出されます。 p3で、読み出す対象となるサイズを指定します。 0が指定されるか、省略された場合は、変数のバッファ全体が対象となります。メモリストリーム機能を使うことで、「picload "MEM:a.jpg"」と指定すれば変数バッファの内容を画像ファイルとして扱うことが可能です。ただし、picload命令など拡張子をファイル種別として判断している場合には、ダミーのファイル名 (「MEM:a.jpg」など)を指定するようにしてください。また、拡張プラグインに渡すファイル名に関しては、メモリストリーム機能は適用されませんので注意してください。

メモリストリーム機能は、独自形式のアーカイブや暗号形式を用意してその内容を読み出して画像として展開する場合など、特殊な場面でのみ使われることを想定したものです。

備考

ver3.0標準命令

参照

 bload命令
 picload命令

memset

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

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

説明

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

備考

ver3.0標準命令

参照

 memcpy命令
 memexpand命令

mes

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

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

説明

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

表示されるメッセージのフォントは、font命令で指定することができます。表示するメッセージに改行コードが含まれていた場合には、改行され次の行から表示を続けます。

備考

ver3.0標準命令

参照

 print命令
 font命令

mesbox

mesbox p1,p2,p3,p4,p5 [メッセージボックス表示]

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

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

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

備考

ver3.0標準命令

参照

 input命令

mkdir

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

説明

"dirname"で指定した名前でディレクトリを作成します。ディレクトリは１階層先までしか作成することができません。作成中にエラーが発生した場合はエラー12(「ファイルが見つからないか無効な名前です」)となります。 mkdir命令を実行する前に必ずdirlist命令でフォルダの有無を確認するようにしてください。

備考

ver3.0標準命令

mmload

mmload "filename",p1,p2 [サウンドファイル読み込み]

p1=0～(0) : 割り当てるバッファの番号
p2=0～2(0) : 割り当てるモード
説明

メディアデータのファイルを登録します。読み込むことができる形式は以下の通りです。
WAV形式 : 拡張子 WAV : Windows標準のPCM音声データ。 AVI形式 : 拡張子 AVI : Windows標準の動画データ MID形式 : 拡張子 MID : 標準MIDIファイルデータ。 MP3形式 : 拡張子 MP3 : MP3形式音声データ ASF形式 : 拡張子 ASF,WMV,WMA : Windows Media形式音声データ MPEG形式 : 拡張子 MPG : MPEG形式動画データオーディオCD : ファイル名 "CD : トラック番号" : (CDの音声トラック部分が対象になります)
たとえば、オーディオCDのトラック3を指定する場合は、
mmload "CD:3",1
のようにします。 p1は、割り当てるバッファの番号となります。これは、再生する時に必要となる0以上の整数値です。複数のメディアファイルを取り扱うには、別々のバッファ番号に割り当てをしておく必要があります。 mmload命令は、指定されたファイルが2MB以下の音声(WAV)ファイルの場合は、メモリに内容を読み込んでおきリアルタイムに再生可能な状態にします。それ以外の場合は、ファイル名だけが登録され、実際のファイルの読み出しはメディア再生時(mmplay実行時)に行なわれることになります。

p2はモードを設定します。以下の値を指定することができます。
モード0 : 指定したファイルは通常の再生を行うモード1 : 指定したファイルは無限ループで再生を行うモード2 : 指定したファイルは再生終了まで待つモード3 : (CDのみ)指定されたトラック以降を再生するモード+16 : (AVIのみ)対象ウィンドウ全体で再生
モード２を指定すると、指定したファイルが再生された場合、 HSPはその再生が終了するまで次の命令を実行しなくなります。 mmload命令はデータの情報をメモリ上にストックしておくだけで、すぐに演奏が始まるわけではありません。

モード+16は、AVI(動画)ファイルでのみ使用できるモードです。モード0～2に16を足した値を指定することで、表示対象になっているウインドゥのサイズいっぱいに動画が再生されます。動画ファイルの判断は拡張子によって行なっています。

MP3形式、およびASF形式はOSがサポートしている場合にのみ再生が可能です。 (初期のWindows95、Windows98ではWindows Media Player 5.2以降がインストールされている必要があります。)

実際の再生は、mmplay命令によって行ないます。

備考

ver3.0標準命令

参照

 mmplay命令
 mmstop命令

mmplay

mmplay p1 [サウンド再生]

p1=0～(0) : 再生するバッファの番号

説明

mmload命令によって読み込まれたメディアを再生します。 p1でバッファの番号を指定することで、mmload命令によって読み込まれた複数のメディアから、どれを再生するかを選びます。

mmplay命令は、通常サウンドの再生がスタートするとともにHSPは次の命令へと進みます。ただし、mmload命令で読み込みモード２を指定している場合は、サウンドの再生が終了するまで次の命令へは進まなくなります。

すでにサウンドが再生されている状態で、さらにmmplay命令を実行すると、前のサウンド再生を終了してから、新しく指定したサウンドの再生を始めます。ただし、MIDIの再生中にPCMを再生するなど異なるデバイスの場合は、再生が中止されることはありません。

AVI(動画)の再生は、 mmplay命令が実行された時点で操作先となっているウインドゥのカレントポジションを左上として表示されます。ただし、 mmload命令のモードに+16(ウィンドウ全体で再生)が指定されている場合は、ウィンドウの表示面いっぱいに再生されます。この場合、画面サイズや縦横の比率には関係なくウィンドウのサイズに変倍されるので、あらかじめ動画の画面サイズや縦横比を考えた上で利用して下さい。

備考

ver3.0標準命令

参照

 mmload命令
 mmstop命令

mmstop


[サウンド停止]

説明

mmplay命令によるメディア再生を停止します。

備考

ver3.0標準命令

参照

 mmplay命令
 mmload命令

modelscale

modelscale id,x,y,z [モデルのサイズを変更する]

id : モデルID
(x,y,z) : X,Y,Z倍率(実数値)

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

説明

指定したモデル全体を指定したスケール値で拡大縮小します。これによりモデルそのもののサイズ自体を変えることが可能になります。

備考

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

参照

 modelmove命令

modelspeed

modelspeed p1,p2 [アニメーション再生速度の設定(2)]

p1(0) : モデルID
p2(0) : １フレームあたりの再生速度(実数値)

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

説明

p1で指定されたモデルIDが持つ標準のアニメーション再生速度を設定します。 p2で１フレームあたりの再生速度(ms)を実数値で指定することができます。以降は、指定されたモデルを使用するオブジェクト初期化時のアニメーション再生速度として設定されます。 modelspeed命令によって標準のアニメーション再生速度が設定されなかった場合は、 15(ms)がオブジェクト初期化時に設定されます。

備考

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

参照

 objspeed命令
 objact命令

mouse

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

説明

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

備考

ver3.0標準命令

mousew


[マウスカーソルのホイール値]

説明

ホイール付きマウスの移動量が代入されます。

備考

ver3.0標準

参照

 mousex命令
 mousey命令

mousex


[マウスカーソルの X 座標]

説明

マウスカーソルの X 座標が代入されます。

備考

ver3.0標準

参照

 mouse命令
 mousey命令
 mousew命令
 ginfo_mx命令

mousey


[マウスカーソルの Y 座標]

説明

マウスカーソルの Y 座標が代入されます。

備考

ver3.0標準

参照

 mouse命令
 mousex命令
 mousew命令
 ginfo_my命令

mref

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

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

p1で指定された変数に、p2で指定したメモリ内容を割り当てます。
値 : 対応するリソース -------------------------------------------------- 0～ 7 : ローカルパラメータ#1～8(数値) 64 : システム変数stat 65 : システム変数refstr 66 : ウィンドウ内画像データ(VRAM) 67 : 現在のウィンドウ情報(BMSCR構造体) 68 : HSPのシステム情報(HSPCTX構造体) 69 : パレット情報 96～ : ウィンドウID0～の情報(BMSCR構造体)
リソースID64,65のシステム変数は、たとえば「mref i,64」とした場合、変数 aがシステム変数 statと同等になり、値を代入することができるようになります。これにより、ユーザー定義命令内の計算結果などをシステム変数に反映して、呼び出し元に返すことができます。

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

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

ローカルパラメータは、ユーザー定義命令(#deffunc)で新規に追加された命令のパラメータ内容を取得するためのものです。パラメータのタイプ(数値、変数、文字列)に従って取得することが可能です。ローカルパラメータ取得は、HSP2.xまでのパラメーター取得方法との互換のために用意されています。(一部のリソースタイプには互換性がありません。) HSP3.0以降では、ユーザー定義命令(#deffunc)のエイリアス機能を使用することを推奨しています。

備考

ver3.0標準命令

参照

 dup命令
 dupptr命令
 #deffunc命令

msgothic


[MSゴシックフォント]

説明

MSゴシックを示すフォントを示すキーワードです。 font命令で指定するフォント名として使用することができます。

※このシステム変数は、マクロとしてhspdef.as内で定義されています。

備考

ver3.0標準

参照

 msmincho命令

msmincho


[MS明朝フォント]

説明

MS明朝を示すフォントを示すキーワードです。 font命令で指定するフォント名として使用することができます。

※このシステム変数は、マクロとしてhspdef.as内で定義されています。

備考

ver3.0標準

参照

 msgothic命令

maketoon

p1 : モデルID
p2(0) : 作成モード

mcall

p1 : 変数名
p2 : メソッド名
p3 : パラメーター

mci

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

memcpy

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

memexpand

p1 = 変数 : 対象となる変数
p2 = 0～(64) : 再確保サイズ(1byte単位)

memfile

p1=変数 : ストリーム対象となる変数名
p2=0～(0) : バッファのオフセット
p3=0～(MAX) : バッファのサイズ

memset

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

mes

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

mesbox

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

mkdir

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

mmload

p1=0～(0) : 割り当てるバッファの番号
p2=0～2(0) : 割り当てるモード

mmplay

p1=0～(0) : 再生するバッファの番号

mmstop

modelscale

id : モデルID
(x,y,z) : X,Y,Z倍率(実数値)

modelspeed

p1(0) : モデルID
p2(0) : １フレームあたりの再生速度(実数値)

mouse

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

mousew

mousex

mousey

mref

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

msgothic

msmincho

maketoon

p1 : モデルID p2(0) : 作成モード

mcall

p1 : 変数名 p2 : メソッド名 p3 : パラメーター

mci

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

memcpy

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

memexpand

p1 = 変数 : 対象となる変数 p2 = 0～(64) : 再確保サイズ(1byte単位)

memfile

p1=変数 : ストリーム対象となる変数名 p2=0～(0) : バッファのオフセット p3=0～(MAX) : バッファのサイズ

memset

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

mes

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

mesbox

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

mkdir

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

mmload

p1=0～(0) : 割り当てるバッファの番号 p2=0～2(0) : 割り当てるモード

mmplay

p1=0～(0) : 再生するバッファの番号

mmstop

modelscale

id : モデルID (x,y,z) : X,Y,Z倍率(実数値)

modelspeed

p1(0) : モデルID p2(0) : １フレームあたりの再生速度(実数値)

mouse

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

mousew

mousex

mousey

mref

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

msgothic

msmincho

p1 : モデルID
p2(0) : 作成モード

p1 : 変数名
p2 : メソッド名
p3 : パラメーター

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

p1 = 変数 : 対象となる変数
p2 = 0～(64) : 再確保サイズ(1byte単位)

p1=変数 : ストリーム対象となる変数名
p2=0～(0) : バッファのオフセット
p3=0～(MAX) : バッファのサイズ

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

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

p1=0～(0) : 割り当てるバッファの番号
p2=0～2(0) : 割り当てるモード

id : モデルID
(x,y,z) : X,Y,Z倍率(実数値)

p1(0) : モデルID
p2(0) : １フレームあたりの再生速度(実数値)

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