; ; HSP help manager用 HELPソースファイル ; (先頭が「;」の行はコメントとして処理されます) ; %type 拡張命令 %ver 3.7 %note hspcmp.asをインクルードすること。 %date 2025/03/11 %author onitama %dll hspcmp %url https://hsp.tv/ %port Win %index hsc_ini HSPCMP.DLLの初期化 %group 拡張入出力制御命令 %prm "filename" "filename" : コンパイルの対象となるファイル名 %inst HSPCMP.DLLの初期化を行ないます。 HSPCMP.DLLの機能を使用する場合は、最初に初期化をする必要があります。 "filename"で指定したファイルをコンパイルの対象とします。 ファイル名は、拡張子(asでなくても構いません)も含めて指定して下さい。 %index hsc_refname エラー表示ファイル名の指定 %group 拡張入出力制御命令 %prm "filename" "filename" : エラーメッセージで表示されるファイル名 %inst エラーメッセージで表示されるソーススクリプトファイル名を指定します。 これは、たとえば「test.as」という名前を一時的に「hsptmp」などの別名で保存してコンパイルする時にも、エラーメッセージには「test.as」ファイル内でエラーが起こっているということを表示させるためのものです。 ソーススクリプトファイル名が、hsc_iniで指定したファイルから変更する必要がない場合は、指定しなくても構いません。 %index hsc_objname 出力オブジェクトファイル名の指定 %group 拡張入出力制御命令 %prm "filename" "filename" : 出力オブジェクトファイル名 %inst 出力されるオブジェクトファイル名を指定します。 %index hsc_compath 共通ディレクトリの指定 %group 拡張入出力制御命令 %prm "pathname" "pathname" : 共通ディレクトリパス %inst #includeでサーチされる共通ディレクトリを指定します。 "pathname"は必ず「\」で終わる文字列である必要があります。 hsc_compathが指定されなかった場合は、hspcmp.dllを使用しているEXEの下にある「common」ディレクトリが参照されます。 %index hsc_comp HSP3ソースのコンパイル %group 拡張入出力制御命令 %prm p1,p2,p3 p1=0〜(0) : コンパイルの設定オプション p2=0〜(0) : プリプロセッサの設定オプション p3=0〜(0) : デバッグウィンドウ表示の有無 %inst HSPコードコンパイラで、ソースファイルをコンパイルして、オブジェクトファイルを作成します。 p1のパラメータで、デバッグ情報をオブジェクトファイルに出力するかを指定することができます。 p1が0かまたは省略されている場合は、エラー行表示などに必要なデバッグ情報がオブジェクトファイルに付加されません。 p1が1(bit0)の場合は、デバッグ情報が付加されます。 p1が2(bit1)の場合はプリプロセス処理のみ行います。 p1が4(bit2)の場合は文字列データをUTF-8コードに変換して出力します。 p1が8(bit3)の場合は使用している文字列データファイル(strmap)を出力します。 p1が16(bit4)の場合はソース解析リストを出力します。(あらかじめhsc3_analysis命令で設定をする必要があります) p1が32(bit5)の場合はソーススクリプトの文字コードをUTF-8として入力します。 p1が256(bit8)の場合はEmscripten(html5/js)向けソーススクリプトとしてコンパイルします。 p2が0の場合は「__hsp30__」マクロが定義された状態でコンパイルを行ないます。 p2が1の場合は、マクロは定義されません。これは、スクリプトエディタの 「HSP拡張マクロを使用する」フラグをコンパイラに渡すためのものです。 p2の値を+4(bit2)すると、ソースに含まれる実行ファイル自動作成のための命令(#pack,#epack,#packopt)をもとにpackfile作成を行ないます。 p3が0以外の場合は、デバッグウインドゥを表示するフラグをオブジェクトファイルに埋め込みます。 hsc_comp命令を実行するためには、必ずhsc_ini命令で初期化とファイルの指定をする必要があります。 また、必要があればhsc_objnameで出力されるオブジェクトファイル名を指定します。(出力ファイル名は、デフォルトではhdc_iniで指定したファイル名の拡張子が「.ax」になったものになります) さらに必要であれば、hsc_refname命令をあらかじめ実行しておいて下さい。コンパイルの手順としては、 ^p 1.「hsc_ini」 2.「hsc_refname」(省略可) 3.「hsc_objname」(省略可) 4.「hsc_comp」 ^p のようになります。 %href hsc_ini hsc_refname hsc_objname hsc3_analysis %index hsc_getmes エラーメッセージ出力先指定 %group 拡張入出力制御命令 %prm p1 p1 : エラーメッセージを受け取る文字列型変数 %inst p1で指定した文字列型の変数に、エラーなどHSPCMP.DLLが出力したメッセージを代入します。 %index hsc_clrmes エラーメッセージのクリア %group 拡張入出力制御命令 %inst コンパイラが出力したメッセージのデータをすべてクリアします。 %index hsc_ver コンパイラのバージョンを取得 %group 拡張入出力制御命令 %inst システム変数refstrに、HSPコードコンパイラのバージョン情報を文字列として返します。 %index hsc_bye コンパイラの終了処理 %group 拡張入出力制御命令 %inst HSPコードコンパイラの終了処理を行ないます。 この命令は自動的に実行されるので、通常は使用しません。 %index pack_ini PACKFILEマネージャの初期化 %group 拡張入出力制御命令 %prm "filename" "filename" : 操作対象ファイル名 %inst PACKFILEマネージャの初期化を行ないます。 PACKFILEの操作を行なう場合(「pack_」で始まる命令)は、最初に初期化をする必要があります。 "filename"で指定したファイルを操作の対象とします。 ファイル名は、拡張子のないものを指定して下さい。 %index pack_view PACKFILEの内容一覧を表示 %group 拡張入出力制御命令 %inst pack_iniで指定したファイルをDPMファイルとして内容一覧を表示します。pack_viewの結果は、hsc_getmes命令で取得して下さい。 %index pack_make DPMファイルを作成 %group 拡張入出力制御命令 %prm p1,p2 p1 : 作成モード( 0=標準EXEファイル用 / 1=外部DPMファイル用 ) p2 : 暗号化キー( 0=標準キーを使用する / その他=暗号化キー ) %inst pack_iniで指定したファイル名でDPMファイルを作成します。 p1で、標準EXEファイル用か、外部読み込み用のDPMファイルなのかを指定する必要があります。 また、DPMファイルを作成する場合は、p2で暗号化キーについての設定を行なうことができます。 p2に0を指定した場合は、標準の暗号化によるDPMファイル(2.61互換)を作成します。 p2に0以外を指定した場合は、その値をキーとする暗号化を施します。 この場合は、DPM読み込みの際にスクリプト側で同じ値のキーをchdpm命令によって指定しなければ、正しいファイルとして復号されなくなるので注意してください。 DPMファイルに含めるファイルは、カレントディレクトリの「PACKFILE」内のテキストで指定されたファイルになります。 %index pack_exe 実行ファイルを作成 %group 拡張入出力制御命令 %prm p1 p1 : 作成モード(0=標準 / 1=フルスクリーンモード / 2=スクリーンセーバー) %inst pack_iniで指定したファイル名でEXEファイルを作成します。 p1で3つのモード(標準・フルスクリーン・スクリーンセーバー)を指定することができます。 EXEファイルに含めるファイルは、カレントディレクトリの「PACKFILE」内のテキストで指定されたファイルになります。 また、HSPランタイムファイル(hsprt)が適切なディレクトリに置かれている必要があります。 %index pack_opt 実行ファイル作成オプションを指定 %group 拡張入出力制御命令 %prm p1,p2,p3 p1=0〜(640) : 画面Xサイズ p2=0〜(480) : 画面Yサイズ p3=0〜(0) : 起動時の動作スイッチ %inst pack_exe命令でEXEファイルを作成する場合のオプションを指定します。 pack_exe命令を実行する前に、指定をしておく必要があります。 p3で指定する起動時の動作スイッチには、以下の値を指定することで特殊な起動動作にすることができます。 ^p 1 = 初期ウィンドウ非表示 2 = ディレクトリ移動なし ^p 動作スイッチは、加算することで同時に機能を選択することが可能です。 特に特殊な動作が必要ない場合は、0を指定して下さい。 %index pack_rt HSPランタイムファイルを指定 %group 拡張入出力制御命令 %prm "filename" "filename" : HSPランタイムファイル(hsprt)のあるフルパス名 %inst pack_exe命令でEXEファイルを作成する場合に参照されるHSPランタイムファイル(hsprt)のあるフルパス名を指定します。 HSPランタイムファイルがカレントディレクトリにない場合は、指定をしておいてください。 (例: pack_rt "c:\hsp\hsprt") %index pack_get packfileからファイルを取り出す %group 拡張入出力制御命令 %prm "filename" "filename" : 取り出すファイル名 %inst pack_iniで指定したファイル名をDPMファイルとして、格納されているファイルを取り出します。 "filename"で指定したファイルが取り出され、カレントディレクトリにセーブされます。 %index hsc3_getsym シンボル名を取得 %group 拡張入出力制御命令 %inst コンパイラのメッセージバッファにHSPで使用されるシンボル名を出力します。 出力は、「シンボル名,sys[|var/func/macro][|1/2]」の形式になります。 %index hsc3_messize コンパイラメッセージのサイズを取得 %group 拡張入出力制御命令 %prm val val : サイズを受け取る数値型変数 %inst hsc_getmesで得られるメッセージ全体のサイズを、valで指定した変数に代入します。 %index hsc3_make 実行ファイルの自動作成 %group 拡張入出力制御命令 %prm "path",sw "path" : HSPランタイムライブラリのあるフルパス sw(0) : iconins使用フラグ(0=未使用/1=使用) %inst 実行ファイルの自動作成を行ないます。 あらかじめ、pack_iniによってPACKFILEマネージャの初期化を行なう必要があります。 "path"でHSPランタイムライブラリのあるフルパスを指定します。 packfileのオプションに従って実行ファイルを作成します。 swに1を指定した場合は、iconinsツールによるアイコンなどのリソース書き換えを実行します。 iconinsツールに渡すオプションについては、#packopt命令を参照してください。 オプション付きのpackfile作成は、hsc_compで行ないます。 %ref pack_ini #packopt %index hsc3_getruntime ランタイムファイルの取得 %group 拡張入出力制御命令 %prm val, "objfile" val : ランタイム名を取得する変数 "objfile" : オブジェクトファイル名 %inst "objfile"で指定したオブジェクトファイルが必要とする ランタイムファイル名をvalで指定した変数に取得します。 valの変数は文字列型で初期化されている必要があります。 ランタイムファイル名が空("")の場合は、デフォルトのランタイム(hsp3.exe)を使用することを示しています。 %index hsc3_run ランタイム実行 %group 拡張入出力制御命令 %prm "string" "string" : 実行コマンドライン %inst "string"の内容をランタイム実行用のコマンドラインとして処理します。 "string"には、「ランタイム名」「オブジェクトファイル名」「起動オプション」をそれぞれスペースで区切った形で指定する必要があります。 %index hsc3_analysis HSP3ソース解析の設定 %group 拡張入出力制御命令 %prm "keyword",mode,line "keyword" : 対象キーワード mode(0) : 解析モード line(0) : 解析ソース内の行番号指定 %inst hsc_comp命令でソース解析リストを出力する際の設定を行います。 ソース解析では、使用されている変数やラベルをまとめて列挙したものをテキストとして取得することができます。 "keyword"パラメーターで、対象となるキーワードを指定します。これにより、特定の名前を持ったものだけを出力することができます。すべての名前を出力する場合は空の文字列("")を指定してください。 modeパラメーターで、解析モードを指定することができます。 modeに指定できるマクロは以下の通りです。 ^p マクロ 値 内容 ------------------------------------------------------------------------ ANALYSIS_MODE_LABEL (0) ラベル・ユーザー定義命令/関数を列挙 ANALYSIS_MODE_VAR (1) 変数を列挙 ANALYSIS_MODE_ALL (2) すべての要素を列挙 ANALYSIS_MODE_REFERENCE (16) 参照を含めて列挙する ANALYSIS_MODE_PARTMATCH (32) 部分一致するキーワードを含めて列挙する ^p hsc3_analysis命令で設定を行った後に、hsc_comp命令でソース解析を行います。 結果は、hsc3_kwlbuf、hsc3_kwlsize、hsc3_kwlineinfo命令によって取得することができます。 また、ソース解析後はhsc3_kwlclose命令で解析結果を破棄する必要がありますので注意してください。 %href hsc_comp hsc3_kwlbuf hsc3_kwlsize hsc3_kwlineinfo hsc3_kwlclose %index hsc3_kwlbuf HSP3ソース解析結果の取得 %group 拡張入出力制御命令 %prm var,p1 var : 解析結果を取得する変数 p1(0) : 取得バッファの最大サイズ %inst hsc3_analysis命令で設定されたHSP3ソース解析の結果を取得します。 結果は、hsc_comp命令を実行した後で取得可能になります。 varで指定された変数はあらかじめ文字列型としてバッファを確保する必要があります。 p1パラメーターでバッファのサイズを指定することで、結果サイズに収まるかどうかをチェックします。 p1パラメーターが0か省略された場合は、バッファにそのままコピーを行います。 あらかじめ必要なバッファのサイズを調べる場合は、hsc3_kwlsize命令を使用してください。 %href hsc3_analysis hsc3_kwlsize %index hsc3_kwlsize HSP3ソース解析結果サイズの取得 %group 拡張入出力制御命令 %prm var var : 解析結果サイズを取得する変数 %inst hsc3_analysis命令で設定されたHSP3ソース解析の結果を取得するために必要なバッファサイズを取得します。 varで指定された整数型の変数にサイズが代入されます。 実際にデータを取得する場合は、hsc3_kwlbuf命令を使用してください。 %href hsc3_analysis hsc3_kwlbuf %index hsc3_kwlclose HSP3ソース解析結果の破棄 %group 拡張入出力制御命令 %prm %inst hsc3_analysis命令で設定されたHSP3ソース解析の結果を破棄します。 ソース解析後はhsc3_kwlclose命令で解析結果を破棄する必要がありますので注意してください。 %href hsc3_analysis hsc3_kwlbuf %index hsc3_kwlineinfo HSP3ソース行解析結果の取得 %group 拡張入出力制御命令 %prm var,type var : 解析結果を取得する変数 type(0) : 取得タイプ %inst hsc3_analysis命令で設定されたHSP3ソース解析の結果を取得します。 結果は、hsc_comp命令を実行した後で取得可能になります。 hsc3_analysis命令のlineパラメーターで指定された行に関する情報を取得します。 typeパラメーターで、取得する情報を指定することができます。 typeに指定できる値は以下の通りです。 ^p 値 内容 ------------------------------------------------- (0) 対象行が属するモジュール名(最大255byte) ^p varで指定された変数はあらかじめ文字列型としてバッファを確保する必要があります。 %href hsc3_analysis