emueraリファレンス_命令
差分
このページの2つのバージョン間の差分を表示します。
| emueraリファレンス_命令 [2026/07/02 14:12] – 作成 - 外部編集 127.0.0.1 | emueraリファレンス_命令 [2026/10/03 19:15] (現在) – 外部編集 127.0.0.1 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ---- | + | ~~NOTOC~~ |
| - | ====== 命令 ====== | + | このページの内容は[[erabasicリファレンス_総索引|eraBASICリファレンス]]に統合しました。 |
| - | ===== PRINT系 ===== | + | |
| - | ==== PRINT(|V|S|FORM|FORMS)(|K|D)(|L|W) ==== | + | |
| - | PRINT系の基本となる命令です。\\ | + | |
| - | 1つ目の括弧内のキーワードは引数タイプを指定します。\\ | + | |
| - | * なし - (< | + | [[erabasicリファレンス|リファレンストップ]] · [[erabasicリファレンス_総索引|名前の総索引]] |
| - | * V - (< | + | |
| - | * S - < | + | |
| - | * FORM - (< | + | |
| - | * FORMS - < | + | |
| - | 2つ目の括弧内のキーワードの" | + | |
| - | * なし - FORCEKANAを無視し、SETCOLORで指定された色で描画します。 | + | ====== 命令 ====== |
| - | * K - FORCEKANAを適用して描画します。 | + | [[erabasicリファレンス_総索引|この項目の説明を開く]] |
| - | * D - SETCOLORを無視してコンフィグで指定されたディフォルト色で描画します。 | + | |
| - | * 3つ目の括弧内のキーワードは描画後の改行、WAITの有無を指定します。 | + | |
| - | * なし - PRINTのみで改行やWAITは行いません。 | + | ===== PRINT系 ===== |
| - | * L - PRINT後、改行します。 | + | [[erabasicリファレンス_総索引|この項目の説明を開く]] |
| - | * W - PRINT後、改行しWAIT命令を行います。 | + | |
| - | これらの組み合わせにより、例えばPRINTSDWであれば、引数として< | + | ==== PRINT(|V|S|FORM|FORMS)(|K|D)(|L|W) ==== |
| + | [[erabasicリファレンス_文字表示・入力# | ||
| ==== PRINTSINGLE(|V|S|FORM|FORMS)(|K|D) ==== | ==== PRINTSINGLE(|V|S|FORM|FORMS)(|K|D) ==== | ||
| - | PRINTSINGLE系はPRINTLとほぼ同じですが、PRINTSINGLE系は文字列を折り返さず、必ず1行で表示します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 画面端を超えた文字は描画されません。\\ | + | |
| - | また、自動的に改行が付与されるため、(|L|W)キーワードはありません。\\ | + | |
| - | 他のキーワードの意味はPRINT系と同じです。\\ | + | |
| ==== PRINT(|FORM)(C|LC)(|K|D) ==== | ==== PRINT(|FORM)(C|LC)(|K|D) ==== | ||
| - | PRINTC系命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | コンフィグ" | + | |
| - | なお、EmueraではPRINTされた文字列のボタン化処理の中でPRINTC系命令を多少特別扱いしています。\\ | + | |
| - | 1つ目の括弧内のキーワードは引数タイプを指定します。\\ | + | |
| - | * なし - < | + | |
| - | * FORM - < | + | |
| - | 2つ目の括弧内のキーワードは揃える位置を指定します。\\ | + | |
| - | + | ||
| - | * C - 右に揃えます(左側に半角スペースを追加します) | + | |
| - | * LC - 左に揃えます。 | + | |
| - | 3つ目の括弧内のK, | + | |
| ==== PRINTDATA(|K|D)(|L|W) ==== | ==== PRINTDATA(|K|D)(|L|W) ==== | ||
| - | PRINTDATA系命令です。 私家改造版readmeによれば、\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | =|BOX|\\ | + | |
| - | 書式:PRINTDATA (数値変数:省略可)\\ | + | |
| - | DATA (文字)\\ | + | |
| - | DATAFORM (FORM文字列)\\ | + | |
| - | DATALIST\\ | + | |
| - | (DATA or DATAFORMの羅列)\\ | + | |
| - | ENDLIST\\ | + | |
| - | ENDDATA\\ | + | |
| - | 内容:DATA、DATAFORMおよびDATALIST〜ENDLISTで指定した文字列を確率均一でランダムで表示\\ | + | |
| - | IFとRANDを使わずにランダム表示を実装可能\\ | + | |
| - | 引数に数値変数を指定した場合は表示された変数DATAの番号が入ります\\ | + | |
| - | 表示された文字列によって後の処理をいじりたい場合にどうぞ\\ | + | |
| - | DATALIST〜ENDLIST内ではDATAorDATAFORM1個が1行に相当します\\ | + | |
| - | | | = | | + | |
| - | とのことです。\\ | + | |
| - | K、D、L、Wキーワードの効果はPRINT系と同じです。\\ | + | |
| - | PRINTDATA系〜ENDDATAの内部にDATA系による表示データが与えられてない場合、何もせずに次に進みます。\\ | + | |
| - | PRINTDATA系〜ENDDATA、およびDATALIST〜ENDLIST内に上記の文法以外の記述をすることはできません。\\ | + | |
| ==== PRINTBUTTON(|C|LC) < | ==== PRINTBUTTON(|C|LC) < | ||
| - | PRINTBUTTON命令はマウスでクリックできるボタンを生成するための命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 書式としてはPRINTS命令に近いですが、第二引数としてクリックされたときに入力する数字または文字を指定します。 第一引数に改行コードが入っている場合オミットされ改行されません。\\ | + | |
| - | Emueraは" | ||
| - | このようなボタンを自動ではなく強制的に生成するための命令がPRINTBUTTONです。\\ | ||
| - | この命令は例えば以下のような場合に有用です。\\ | ||
| - | =|BOX|\\ | ||
| - | PRINT これでいい? [0] はい | ||
| - | INPUT\\ | ||
| - | | | = | | ||
| - | このような行についてはEmueraはボタンを正しく認識できず、" | ||
| - | PRINTBUTTONを用いて書き直すと以下のようになります。\\ | ||
| - | =|BOX|\\ | ||
| - | PRINTS " | ||
| - | PRINTBUTTON "[0] はい", | ||
| - | PRINTS " | ||
| - | PRINTBUTTON "[1] いいえ", | ||
| - | INPUT\\ | ||
| - | | | = | | ||
| - | (PRINT命令の代わりにPRINTSを使っていますがこれは半角スペースの数を明らかにするためです)\\ | ||
| - | このようにすると" | ||
| - | なお、PRITNBUTTON命令では表示する文字列に[0]や[1]などが含まれていることは必須ではありませんが、対応する数字を全く表示しないとテンキーなどで操作している方を戸惑わせることになるでしょう。 従来通り[0]などを表記することを勧めます。\\ | ||
| - | また、PRINTBUTTON命令では数字だけでなく文字列を入力するボタンを作成することができます。 そうして作成したボタンはINPUTS命令の実行時にクリックすることができます。\\ | ||
| - | =|BOX|\\ | ||
| - | |||
| - | PRINTL 名前を入力してください。\\ | ||
| - | PRINTBUTTON " | ||
| - | PRINTBUTTON " | ||
| - | PRINTBUTTON " | ||
| - | INPUTS\\ | ||
| - | |||
| - | | | = | | ||
| - | 括弧内のキーワードは文字を揃える位置を指定します。\\ | ||
| - | * なし - 揃えません | ||
| - | * C - PRINTCと同様に右側に揃えます | ||
| - | * LC - PRINTLCと左に揃えます | ||
| ==== PRINTPLAIN(|FORM) ==== | ==== PRINTPLAIN(|FORM) ==== | ||
| - | 引数の文字列を平文として出力します。この時ボタン文字列(0など)があってもボタン化しません。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 括弧内のキーワードは引数タイプを指定します。\\ | + | |
| - | * なし - < | ||
| - | * FORM - < | ||
| - | * CUSTOMDRAWLINE < | ||
| ==== DRAWLINEFORM < | ==== DRAWLINEFORM < | ||
| - | 指定した文字列を使って1行の区切りを表示します。 DRAWLINEFORMではFORM構文に対応しています。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| ==== REUSELASTLINE < | ==== REUSELASTLINE < | ||
| - | 最終行を指定した書式付き文字列で書き換えるが、\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | これを使って書き換えた行は、次の行が追加されるとそれに置き換わる\\ | + | |
| - | 基本的にはINPUT、INPUTSのループ処理の中でのみ使用するもの\\ | + | |
| - | 引数はPRINTFORMと同様の書式を使用可\\ | + | |
| - | なお、REUSELASTLINE (この半角スペース必須)とすれば、警告文なしで空行にできます\\ | + | |
| - | =|BOX|\\ | + | |
| - | $INPUT_LOOP\\ | + | |
| - | INPUT\\ | + | |
| - | IF RESULT != 0\\ | + | |
| - | ; | + | |
| - | ; | + | |
| - | GOTO INPUT_LOOP\\ | + | |
| - | ENDIF\\ | + | |
| - | | | = | | + | |
| - | のように、GOTO INPUT_LOOPの前にREUSELASTLINEを呼び出すと、\\ | + | |
| - | 前の入力が画面から消去され、次の入力は前の入力と同じ行に表示される\\ | + | |
| - | これによって、無効な入力が繰り返されても、行数が増えず、\\ | + | |
| - | 気づいたら選択肢が画面外に…なんて事態は防げる…はず\\ | + | |
| - | ちなみに@USERXXX系関数の条件分岐の最後に\\ | + | |
| - | (対象は@USERCOM、@USERSHOP、@USERABLUPの3つ)\\ | + | |
| - | =|BOX|\\ | + | |
| - | ; | + | |
| - | ; | + | |
| - | ENDIF\\ | + | |
| - | | | = | | + | |
| - | とやっておくと…?\\ | + | |
| - | (Emuera専用なら; | + | |
| ==== CLEARLINE < | ==== CLEARLINE < | ||
| - | 指定した行数の文字列を削除します(行の数え方はLINECOUNTと同様です)\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 行数はPRINTL等で改行が行われるまでのものを1つの行とします。\\ | + | |
| - | なお、長い文字列が複数行に分割されたものもまとめて1行として扱うので気をつけてください。\\ | + | |
| ==== PRINT_IMG < | ==== PRINT_IMG < | ||
| - | 行中に指定した画像を表示します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | HTML_PRINT命令の< | + | |
| ==== PRINT_RECT < | ==== PRINT_RECT < | ||
| - | 行中に横幅がフォントサイズの引数%である長方形を表示します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | SETCOLOR命令によりフォント色と同様に色を変えられます。\\ | + | |
| - | HTML_PRINT命令の< | + | |
| ==== PRINT_RECT < | ==== PRINT_RECT < | ||
| - | 行中にx, | + | [[erabasicリファレンス_文字表示・入力# |
| - | SETCOLOR命令によりフォント色と同様に色を変えられます。\\ | + | |
| - | HTML_PRINT命令の<shape type=' | + | |
| ==== PRINT_SPACE < | ==== PRINT_SPACE < | ||
| - | フォントサイズの引数%分だけ何も表示しないスペースを作ります。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | HTML_PRINT命令の< | + | |
| ===== 表示操作・フォント操作・表示仕様参照 ===== | ===== 表示操作・フォント操作・表示仕様参照 ===== | ||
| + | [[erabasicリファレンス_総索引|この項目の説明を開く]] | ||
| + | |||
| ==== SETCOLOR <R>, <G>, <B> ==== | ==== SETCOLOR <R>, <G>, <B> ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== SETCOLOR <RGB> ==== | ==== SETCOLOR <RGB> ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== RESETCOLOR ==== | ==== RESETCOLOR ==== | ||
| - | 文字色を指定した色に変更、適用はRESETCOLORが呼ばれるまで。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 指定方法はRGB形式になります\\ | + | |
| - | SETCOLORで指定した色はRESETCOLORでリセットすることができます\\ | + | |
| - | 現在の背景色はGETCOLORで、デフォルトの背景色はGETDEFCOLORで取得することができます。\\ | + | |
| - | 1.731以降ではSETCOLORに0xRRGGBB形式で指定できるようになりました。\\ | + | |
| - | =|BOX|\\ | + | |
| - | SETCOLOR 255, 128, 0\\ | + | |
| - | SETCOLOR 0xFF8000\\ | + | |
| - | | | = | | + | |
| - | これはどちらの行も同じ意味になります。 GETCOLOR命令で取得できる値は後者です。\\ | + | |
| ==== SETBGCOLOR <R>, <G>, <B> ==== | ==== SETBGCOLOR <R>, <G>, <B> ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== SETBGCOLOR <RGB> ==== | ==== SETBGCOLOR <RGB> ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== RESETBGCOLOR ==== | ==== RESETBGCOLOR ==== | ||
| - | 背景色を指定した色に変更する命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 基本的な仕様はSETCOLOR・RESETCOLORと同様ですが、\\ | + | |
| - | 安全のため変更後0.2秒以内に再変更する場合は0.2秒経過まで強制WAITになります。\\ | + | |
| - | 現在の背景色はGETBGCOLORで、デフォルトの背景色はGETDEFBGCOLORで取得することができます。\\ | + | |
| ==== SETCOLORBYNAME < | ==== SETCOLORBYNAME < | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== SETBGCOLORBYNAME < | ==== SETBGCOLORBYNAME < | ||
| - | 定義済み色名からフォント表示色や背景色を指定する命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 他の仕様はすべてSETCOLOR・SETBGCOLORと同様です。 引数は色名です。定義済み色名についてはKnownColor列挙体 に準拠しておりますので、そちらを参照してください。\\ | + | |
| ==== GETCOLOR ==== | ==== GETCOLOR ==== | ||
| - | 現在使用している文字色コードをRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 戻り値は16進数で0xRRGGBBとなります。\\ | + | |
| - | 例えばオレンジ色(R, | + | |
| - | 色と数字の対応はweb colorについて解説しているWebサイトを参考にするとよいでしょう。\\ | + | |
| - | 1.731での変更により、SETCOLOR命令もSETCOLOR 0xFF8000のような形式で指定できるようになりました。\\ | + | |
| ==== GETDEFCOLOR ==== | ==== GETDEFCOLOR ==== | ||
| - | コンフィグで指定している文字色コードをRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== GETBGCOLOR ==== | ==== GETBGCOLOR ==== | ||
| - | 現在使用している背景色コードをRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== GETDEFBGCOLOR ==== | ==== GETDEFBGCOLOR ==== | ||
| - | コンフィグで指定している背景色コードをRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== GETFOCUSCOLOR ==== | ==== GETFOCUSCOLOR ==== | ||
| - | コンフィグで指定している選択中文字色コードをRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== FONTBOLD ==== | ==== FONTBOLD ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== FONTITALIC ==== | ==== FONTITALIC ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== FONTREGULAR ==== | ==== FONTREGULAR ==== | ||
| - | 以降の文字を指定したスタイルに変更する\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | BOLDとITALICは重複可(太字斜体)\\ | + | |
| - | REGULARを呼ぶと、太字・斜体指定が解除されます\\ | + | |
| ==== FONTSTYLE < | ==== FONTSTYLE < | ||
| - | FONTSTYLE以降の文字を指定したスタイルに変更します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 0であれば通常、1なら太字、2なら斜体、4なら打ち消し線、8なら下線が引かれます。\\ | + | |
| - | これらはビットごとに組み合わせることができます。\\ | + | |
| - | 例えばFONTSTYLE 3なら太字かつ斜体になります。\\ | + | |
| - | FONTBOLD、FONTITALICは現在のスタイルに太字、斜体スタイルを加えます。\\ | + | |
| - | FONTREGULARはFONTSTYLE 0と等価です。つまり通常のスタイルに戻します。\\ | + | |
| - | =|BOX|\\ | ||
| - | FONTSTYLE 1 + 2\\ | ||
| - | PRINTL 太字+斜体\\ | ||
| - | FONTSTYLE 5\\ | ||
| - | PRINTL 太字+打ち消し\\ | ||
| - | FONTITALIC\\ | ||
| - | PRINTL 太字+斜体+打ち消し\\ | ||
| - | FONTSTYLE 0\\ | ||
| - | PRINTL 通常\\ | ||
| - | | | = | | ||
| - | < | ||
| ==== GETSTYLE ==== | ==== GETSTYLE ==== | ||
| - | 現在のフォントのスタイル(太字、斜線など)をRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | これはSETSTYLE命令で指定した値と同じです。\\ | + | |
| - | SETSTYLE命令が行われていない時は0を返します。\\ | + | |
| ==== CHKFONT < | ==== CHKFONT < | ||
| - | 指定された名前のフォントがインストールされているかどうかを調べます。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | インストールされていれば1、されていなければ0がRESULT: | + | |
| - | 使用例はSETFONT命令を参照してください。\\ | + | |
| ==== SETFONT < | ==== SETFONT < | ||
| - | SETFONT命令以降の文字列表示に指定された名前のフォントを用います。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 引数を省略、または空文字列を指定した場合、emuera.configに指定された標準のフォントに戻します。\\ | + | |
| - | 指定されたフォントがインストールされていない場合、代わりに" | + | |
| - | インストールされていない可能性があるフォントを指定する場合はSETFONTの前にCHKFONT命令を行ってください。\\ | + | |
| - | =|BOX|\\ | ||
| - | PRINTL abc123あいう(標準フォント)\\ | ||
| - | CHKFONT " | ||
| - | IF RESULT\\ | ||
| - | SETFONT " | ||
| - | PRINTL abc123あいう(MS Pゴシック)\\ | ||
| - | ENDIF\\ | ||
| - | CHKFONT " | ||
| - | IF RESULT\\ | ||
| - | SETFONT " | ||
| - | PRINTL abc123あいう(MS 明朝)\\ | ||
| - | ENDIF\\ | ||
| - | STR:0 = MS P明朝\\ | ||
| - | CHKFONT STR: | ||
| - | IF RESULT\\ | ||
| - | SETFONT STR: | ||
| - | PRINTL abc123あいう(MS P明朝)\\ | ||
| - | ENDIF\\ | ||
| - | SETFONT\\ | ||
| - | | | = | | ||
| ==== GETFONT ==== | ==== GETFONT ==== | ||
| - | 現在使用しているフォントの名前をRESULTS: | + | [[erabasicリファレンス_文字表示・入力# |
| - | これはSETFONT命令で指定した名前と同じです。\\ | + | |
| - | SETFONT命令が行われていない時はemuera.configで指定されている標準のフォントの名前を代入します。\\ | + | |
| ==== FORCEKANA < | ==== FORCEKANA < | ||
| - | 表示命令のひらがな・カタカナを指定します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | キーワード" | + | |
| - | 引数で指定した値により、以下の影響があります。\\ | + | |
| - | * 0: | ||
| - | * 1: | ||
| - | * 2: | ||
| - | * 3: | ||
| ==== ALIGNMENT < | ==== ALIGNMENT < | ||
| - | ALIGNMENT以降の行を指定した位置に揃えます。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | キーワードには" | + | |
| - | 通常の表示はALIGNMENT LEFTであり、左端に揃えられます。\\ | + | |
| - | ALIGNMENT CENTERによりタイトル画面のように中央に揃えることができます。\\ | + | |
| - | ALIGNMENTが適用されるのは改行された時点です。\\ | + | |
| - | =|BOX|\\ | ||
| - | ALIGNMENT RIGHT\\ | ||
| - | PRINT あああ\\ | ||
| - | ALIGNMENT CENTER\\ | ||
| - | PRINTL いいい\\ | ||
| - | ALIGNMENT LEFT\\ | ||
| - | | | = | | ||
| - | このようにすると、" | ||
| - | 現在のALIGNMENTはCURRENTALIGNで取得することができます。\\ | ||
| ==== CURRENTALIGN ==== | ==== CURRENTALIGN ==== | ||
| - | 現在のALIGNMENTをRESULTS: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 返値はALIGNMENT命令で指定した文字列と同じです(大文字)。\\ | + | |
| - | ALIGNMENT命令が行われていない時は初期値のLEFTを返します。\\ | + | |
| ==== REDRAW < | ==== REDRAW < | ||
| - | 描画制御命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 引数に0を指定するとユーザーが入力を必要とするタイミングでのみ描画を行うようにします。\\ | + | |
| - | 引数に1を指定すると通常通り、コンフィグの" | + | |
| - | 引数に2を加えると(REDRAW 2やREDRAW 3など)、上記の効果に加え、REDRAW命令を行った瞬間に強制的に描画を行います。\\ | + | |
| - | 現在のREDRAW状態(0または1)はCURRENTREDRAWで取得することができます。\\ | + | |
| ==== CURRENTREDRAW ==== | ==== CURRENTREDRAW ==== | ||
| - | 現在のREDRAW状態をRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | 返値は通常時は1、REDRAW命令を用いて描画を抑制した時は0になります。\\ | + | |
| ==== PRINTCPERLINE ==== | ==== PRINTCPERLINE ==== | ||
| - | コンフィグ" | + | [[erabasicリファレンス_文字表示・入力# |
| ==== LINEISEMPTY ==== | ==== LINEISEMPTY ==== | ||
| - | 現在PRINTしている行が空行かどうかを判断する命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | この命令を実行した時点で「PRINTL 」を行おうとした場合、\\ | + | |
| - | その結果がただの空行になる場合には1を、そうでない場合は0をRESULT: | + | |
| - | PRINTC系で条件に応じたボタンを順次書き連ねる場合に、最後にこの命令を使用することで、\\ | + | |
| - | 表示されるボタンがあるかないかを判別し、なければ専用の表示をするといったことが可能です\\ | + | |
| ==== BARSTR < | ==== BARSTR < | ||
| - | 与えられた引数と同一の引数のBAR命令で表示される文字列と同じ物をRESULTS: | + | [[erabasicリファレンス_文字表示・入力# |
| ==== MONEYSTR < | ==== MONEYSTR < | ||
| - | 引数で与えられた数値に対して、設定されたお金の単位を付けた文字列をRESULTS: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 単位の前置・後置も自動的に処理します。\\ | + | |
| - | 第2引数はTOSTR命令と同様の数値の文字列化における変換書式指定子となります。\\ | + | |
| ==== SKIPDISP < | ==== SKIPDISP < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | =|BOX|\\ | ||
| - | PRINT等の画面出力命令およびWAIT、TWAITなどの命令を無視するフラグを設定する命令SKIPDISP追加\\ | ||
| - | 書式:SKIPDISP < | ||
| - | 引数:0 無視しないようにする\\ | ||
| - | 0以外 無視するようにする\\ | ||
| - | 内容:このフラグを立てると、PRINT等の出力が一切行われなくなる\\ | ||
| - | また、このフラグが立ってる間にINPUTおよびINPUTSに達した場合は\\ | ||
| - | ユーザーが何をすればいい知る術がないこと、また飛ばせば無限ループに入る可能性が高いため\\ | ||
| - | 警告文と対処法を明示した上でエラーになるようにしてあります\\ | ||
| - | 今一般に使われる口上の実装では口上の非表示が可能な場合、\\ | ||
| - | 表示と非表示でコマンドの結果が変わったり、動作が変わってしまう場合がある\\ | ||
| - | そこで、これを立てた上で口上を呼び出せば、表示はされることなくそれ以外の処理が行われるため\\ | ||
| - | 表示/ | ||
| - | INPUT/ | ||
| - | SKIPDISP 0しておいて、INPUT処理後に再度SKIPDISP 1するなりの対策があります(一応前者推奨)\\ | ||
| - | ちなみに今無視するフラグが立ってるかはISSKIP()式中関数で取得できます\\ | ||
| - | | | = | | ||
| - | ver1.808から、SIF文の直後に置いても動作するようになりました。 なお、SKIPDISPを使用すると引数に関係なくRESULT: | ||
| ==== NOSKIP ==== | ==== NOSKIP ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== ENDNOSKIP ==== | ==== ENDNOSKIP ==== | ||
| - | =|BOX|\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 以下、私家改造版更新履歴より、\\ | + | |
| - | 表示関係無視フラグを無視する区間を指定できるNOSKIP〜ENDNOSKIP実装\\ | ||
| - | この2つで囲った区間はSKIPDISP 1の状態でも表示等される\\ | ||
| - | 主にINPUTが必要な場合に使用するとよい\\ | ||
| - | また、この命令はSKIPDISPの状態に影響しないので、\\ | ||
| - | SKIPDISPフラグが立ちうる環境下のコード(例えば表示/ | ||
| - | これを使うと、絶対に表示する必要がある場所をきちんと表示できるようになります\\ | ||
| - | | | = | | ||
| ==== ISSKIP ==== | ==== ISSKIP ==== | ||
| - | SKIPDISPのフラグが0以外(PRINT等の出力を無視)なら1を、そうでなければ0をRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| ==== MOUSESKIP ==== | ==== MOUSESKIP ==== | ||
| - | 右クリックが押されてWAITスキップの状態になっているなら1を、そうでなければ0をRESULT: | + | [[erabasicリファレンス_文字表示・入力# |
| - | マクロ処理時のスキップ中は0を返します\\ | + | |
| - | マクロ処理のスキップと右クリックが競合した場合はマクロを優先し0を返します\\ | + | |
| - | 文字列操作・参照\\ | ||
| ==== TOUPPER < | ==== TOUPPER < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== TOLOWER < | ==== TOLOWER < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== TOHALF < | ==== TOHALF < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== TOFULL < | ==== TOFULL < | ||
| - | 引数の文字列に特定の変換をかけた結果をRESULTS: | + | [[erabasicリファレンス_データ操作・保存# |
| - | TOUPPERはアルファベットを大文字にした結果を、TOLOWERは小文字化した結果を代入します\\ | + | |
| - | TOHALFは全角文字を半角にしますが、対応する半角文字がない全角文字はそのままです。\\ | + | |
| - | TOFULLは半角文字を全角にします。\\ | + | |
| ==== TOSTR < | ==== TOSTR < | ||
| - | 数値を文字列に変換する命令です。\\ | + | [[erabasicリファレンス_データ操作・保存#tostr_数式_書式指定子|この項目の説明を開く]] |
| - | 変換したい数字を第一引数に、変換の書式を文字列で第二引数に指定します。\\ | + | |
| - | 第二引数は省略できますが、省略した場合はPRINTFORMの{}内などと同じように単に文字列になります。\\ | + | |
| - | この関数は内部でC#のInt64.ToString()関数を呼んでおり、C# | + | |
| - | 簡単な書式指定の例は同名の式中で使える関数を確認してください。 書式指定の詳細はC# | + | |
| ==== ISNUMERIC < | ==== ISNUMERIC < | ||
| - | 文字列を数値としてパース可能か(TOINTで値を取れるか)を判断します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 引数を数値として解釈できる場合1を、それ以外の場合0をRESULT: | + | |
| ==== TOINT < | ==== TOINT < | ||
| - | 引数文字列を数値化してRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 引数を数値として解釈できない場合、0が代入されます。全角数字の場合も同様です。\\ | + | |
| ==== STRLEN < | ==== STRLEN < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== STRLENS < | ==== STRLENS < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== STRLENFORM < | ==== STRLENFORM < | ||
| - | 文字列の長さを測定し、RESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 長さはSHIFT-JISでのバイト数です。つまり全角文字を2文字と数えます。\\ | + | |
| - | =|BOX|\\ | ||
| - | STRLEN ABCあいう\\ | ||
| - | PRINTFORML < | ||
| - | STR:0 = ABCあいう\\ | ||
| - | STRLENS STR: | ||
| - | PRINTFORML < | ||
| - | STRLENFORM abc%STR: | ||
| - | PRINTFORML < | ||
| - | |||
| - | ; | ||
| - | STRLENS " | ||
| - | PRINTFORML < | ||
| - | WAIT\\ | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | 結果\\ | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | | | = | | ||
| ==== STRLENU < | ==== STRLENU < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== STRLENSU < | ==== STRLENSU < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== STRLENFORMU < | ==== STRLENFORMU < | ||
| - | STRLEN、STRLENS、STRLENFORMのUnicode版です。違いは全角文字も1文字と数えることです。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| ==== SUBSTRING < | ==== SUBSTRING < | ||
| - | 指定した文字列式の部分文字列をRESULTS: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 開始位置は文字列の最初が0です。元文字列の長さより後を指定した場合、空文字列"" | + | |
| - | 文字数はSHIFT-JISでのバイト数で指定します。つまり全角文字を2文字と数えます。\\ | + | |
| - | 文字数に負の値を指定するか、元文字列の終端より後の位置を指定した場合、開始位置から最後までの文字列を返します。\\ | + | |
| - | 開始位置または終了位置で文字を切ることができない場合(全角文字の途中を指している場合)、1つ後ろを指定されたと判断されます。\\ | + | |
| - | このことで指定した文字数よりも1文字分だけ長い文字列が返される場合があるので注意してください。\\ | + | |
| - | =|BOX|\\ | ||
| - | STR:0 = 01234あいうえお\\ | ||
| - | SUBSTRING STR:0, 0, -1\\ | ||
| - | PRINTFORML < | ||
| - | SUBSTRING STR:0, 1, 3\\ | ||
| - | PRINTFORML < | ||
| - | SUBSTRING STR:0, 6, 3\\ | ||
| - | PRINTFORML < | ||
| - | WAIT\\ | ||
| - | 結果\\ | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | | | = | | ||
| ==== SUBSTRINGU < | ==== SUBSTRINGU < | ||
| - | SUBSTRINGのUnicode版です。違いは全角文字も1文字と数えることです。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| ==== CHARATU < | ==== CHARATU < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 文字列中の任意の文字数目の文字を取得する式中関数CHARATU追加\\ | ||
| - | 書式:CHARATU(< | ||
| - | 内容:文字列の指定した位置の文字を取得する\\ | ||
| - | 処理系はユニコードとなります\\ | ||
| - | | | = | | ||
| ==== STRFIND < | ==== STRFIND < | ||
| - | 文字列検索命令です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第一引数には検索される対象の文字列を文字列式で、\\ | + | |
| - | 第二引数には検索する文字列を文字列式で指定します。\\ | + | |
| - | RESULT: | + | |
| - | =|BOX|\\ | ||
| - | STR:0 = abcdefghi\\ | ||
| - | STR:1 = あいうえお\\ | ||
| - | STR:2 = うえ\\ | ||
| - | STRFIND STR:0, " | ||
| - | PRINTFORML < | ||
| - | STRFIND STR:1, " | ||
| - | PRINTFORML < | ||
| - | STRFIND STR:1, STR: | ||
| - | PRINTFORML < | ||
| - | STRFIND STR:1, " | ||
| - | PRINTFORML < | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | ; | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | | | = | | ||
| - | 1.712以降、STRFIND命令に第3引数が指定できるようにしました。\\ | ||
| - | 第3引数には検索の開始位置を0から始まるインデックスで指定します。\\ | ||
| - | |||
| - | STRFIND " | ||
| - | |||
| - | 上の行の結果、RESULTには5が代入されます。\\ | ||
| - | " | ||
| ==== STRFINDU < | ==== STRFINDU < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | STRFINDのユニコード版STRFINDU実装\\ | + | |
| - | 書式:STRFINDU(< | + | |
| - | 内容:STRFINDのユニコード版、返り値の文字の位置と開始インデックスがユニコードでのカウントになっている\\ | + | |
| - | STRCOUNT < | + | |
| - | 文字列中の指定部分文字列の数を取得する命令です。ヒットした数をRESULT: | + | |
| - | 検索文字列の書式はC# | + | |
| - | | | = | | + | |
| ==== SPLIT < | ==== SPLIT < | ||
| - | 第1引数で指定した文字列を、第2引数で指定した文字列を区切りとして分割し、第3引数で指定した文字列配列変数に代入します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | また、分割した数をRESULTに代入します。\\ | + | |
| - | 第3引数で指定する変数は配列変数でなければなりません。\\ | + | |
| - | =|BOX|\\ | ||
| - | SPLIT " | ||
| - | | | = | | ||
| - | 上記のスクリプトの結果、LOCALS: | ||
| - | 分割後の要素数が第3引数に代入可能な要素数を超えた分については代入が行われません\\ | ||
| - | RESULTには実際の分割数が入れられるのでそちらで判別してください\\ | ||
| ==== STRJOIN <配列変数>{, | ==== STRJOIN <配列変数>{, | ||
| - | 文字列結合命令です。以下、私家改造版read meより\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | ○文字列配列の結合関数STRJOINの追加\\ | ||
| - | 書式:STRJOIN(<配列変数>{, | ||
| - | 内容:ツールチップの最大表示時間を[表示時間(ms)]に設定\\ | ||
| - | 引数:<配列変数>:結合した配列変数、キャラ変数を指定した場合エラーになるかも\\ | ||
| - | <区切り文字列>:結合のさいに要素間に加える文字列、他の言語の同一処理同様、省略時は"," | ||
| - | <配列添え字開始位置>、<配列添え字要素数>:指定した場合 配列添え字開始位置≦i<開始位置+配列添え字要素数 の範囲で結合する\\ | ||
| - | 後者を指定する場合、前者は省略不可\\ | ||
| - | | | = | | ||
| ==== REPLACE < | ==== REPLACE < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 文字列置換命令REPLACE実装\\ | ||
| - | 書式:REPLACE(< | ||
| - | 内容:置換対象文字列を置換対象パターンで検索し、ヒットしたら置換後の文字列で置き換えます。結果はRESULTSに代入されます。\\ | ||
| - | 内部処理は思いっきり正規表現です。第2引数はC# | ||
| - | そのため、()や[]、$、/ | ||
| - | | | = | | ||
| ==== ESCAPE < | ==== ESCAPE < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 文字列を正規表現用にエスケープする式中関数ESCAPEを追加\\ | ||
| - | 書式:ESCAPE([文字列])\\ | ||
| - | 内容:文字列が正規表現中で平文となるように、引数中の文字列の正規表現メタ文字をエスケープして返す\\ | ||
| - | | | = | | ||
| ==== UNICODE < | ==== UNICODE < | ||
| - | RESULTS: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 例えば、以下のスクリプトは白抜きのハートマークを表示します。\\ | + | |
| - | ただし、この関数ではサロゲートペアを扱うことはできません。\\ | + | |
| - | また、フォントが対応していなければ表示できません。\\ | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | UNICODE 0x2661\\ | + | |
| - | PRINTFORMW %RESULTS%\\ | + | |
| - | | | = | | + | |
| - | なお、EmueraのUnicode対応は完全ではないことに注意してください。\\ | + | |
| - | 例えばEmueraはサロゲートペアを使用した場合、正確な動作は保証できません。\\ | + | |
| ==== ENCODETOUNI < | ==== ENCODETOUNI < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 文字列に対してUNICODEのバイトコードを返すENCODETOUNI実装\\ | ||
| - | 書式:ENCODETOUNI < | ||
| - | 内容:与えられた文字列をユニコードにエンコードしてそのバイトを数値として返す\\ | ||
| - | RESULT: | ||
| - | RESULT: | ||
| - | | | = | | ||
| ===== 算術 ===== | ===== 算術 ===== | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== POWER < | ==== POWER < | ||
| - | 指定した変数に累乗を代入します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 例えばPOWER A, X, Y ならば、AにXのY乗が代入されます。\\ | + | |
| - | 演算結果がオーバーフローを起こすとエラーになります。\\ | + | |
| - | =|BOX|\\ | ||
| - | X = 11\\ | ||
| - | Y = 2\\ | ||
| - | POWER A, X, 2\\ | ||
| - | PRINTFORML < | ||
| - | POWER CFLAG:2, X + 1, Y + 1\\ | ||
| - | PRINTFORML < | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | 結果(TARGETは適切に設定されているとする)\\ | ||
| - | < | ||
| - | < | ||
| - | | | = | | ||
| ==== ABS < | ==== ABS < | ||
| - | 引数の絶対値をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| ==== SIGN < | ==== SIGN < | ||
| - | 引数の符号をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 負の値なら-1、0なら0、正の値なら1を代入します。\\ | + | |
| ==== SQRT < | ==== SQRT < | ||
| - | 引数の平方根をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| ==== GETBIT < | ==== GETBIT < | ||
| - | 引数の特定のビットを取得し、RESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第1引数に対象となる数字を、第2引数には取得したいビットの位置を指定します。 第2引数に指定できる値は0〜63までで、範囲外の数値を指定するとエラーになります。\\ | + | |
| - | 第2引数が定数の場合、例えば5であれば、\\ | + | |
| - | GETBIT X, 5\\ | ||
| - | RESULT = (X & 1p5) != 0\\ | ||
| - | 2つの行は同じ結果になります。\\ | ||
| ==== MAX < | ==== MAX < | ||
| - | 引数の中で最大の数値をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| ==== MIN < | ==== MIN < | ||
| - | 引数の中で最小の数値をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| ==== LIMIT < | ==== LIMIT < | ||
| - | 第一引数の値をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | ただし、第一引数が第二引数より小さいなら第二引数の値を、第三引数より大きいなら第三引数を返します。\\ | + | |
| - | 例えばAに X - Y を代入したいが、代入後の値が0以上100以下であってほしい場合、通常は以下のように書きます。\\ | + | |
| - | =|BOX|\\ | ||
| - | A = X - Y\\ | ||
| - | SIF A < 0\\ | ||
| - | A = 0\\ | ||
| - | SIF A > 100\\ | ||
| - | A = 100\\ | ||
| - | | | = | | ||
| - | LIMIT命令を使うとこれを二行にまとめることができます。\\ | ||
| - | =|BOX|\\ | ||
| - | LIMIT X - Y, 0, 100\\ | ||
| - | A = RESULT\\ | ||
| - | | | = | | ||
| ==== INRANGE < | ==== INRANGE < | ||
| - | 第一引数の値が第二引数以上かつ第三引数以下であれば1を、第一引数が第二引数より小さい、または第三引数より大きいなら0をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| ==== SETBIT < | ==== SETBIT < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CLEARBIT < | ==== CLEARBIT < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== INVERTBIT < | ==== INVERTBIT < | ||
| - | ビット操作関数です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第1引数で指定した変数の、第2引数以降で指定した位置のビットを操作します。\\ | + | |
| - | SETBITはビットを1にし、CLEARBITは0にし、INVERTBITは反転させます。\\ | + | |
| - | =|BOX|\\ | ||
| - | SETBIT X, A\\ | ||
| - | CLEARBIT Y, B\\ | ||
| - | INVERTBIT Z, C\\ | ||
| - | | | = | | ||
| - | の結果は以下と同じです。\\ | ||
| - | =|BOX|\\ | ||
| - | X |= 1 << A\\ | ||
| - | Y &= ~(1 << B)\\ | ||
| - | Z ^= 1 << C\\ | ||
| - | | | = | | ||
| - | また、これらのビット操作関数の書式はGETBIT関数と対応しています。\\ | ||
| - | " | ||
| ===== キャラ操作・参照 ===== | ===== キャラ操作・参照 ===== | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== ADDCHARA < | ==== ADDCHARA < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== DELCHARA < | ==== DELCHARA < | ||
| - | eramakerからある命令ですが、一度にたくさんのキャラを足したり消せるようになりました\\ | + | [[erabasicリファレンス_データ操作・保存# |
| ==== SWAPCHARA < | ==== SWAPCHARA < | ||
| - | 指定した二人のキャラクタの登録番号を入れ替えます。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | + | |
| - | ; | + | |
| - | ADDCHARA 10\\ | + | |
| - | ADDCHARA 11\\ | + | |
| - | PRINTFORML NO:1 = {NO:1}, NO:2 = {NO:2}\\ | + | |
| - | SWAPCHARA 1,2\\ | + | |
| - | PRINTFORML NO:1 = {NO:1}, NO:2 = {NO:2}\\ | + | |
| - | | | = | | + | |
| - | =|BOX|\\ | + | |
| - | 結果\\ | + | |
| - | NO:1 = 10, NO:2 = 11\\ | + | |
| - | NO:1 = 11, NO:2 = 10\\ | + | |
| - | | | = | | + | |
| ==== SORTCHARA < | ==== SORTCHARA < | ||
| - | 任意のキーによる、キャラリストのソート。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | ソートキーはNAMEのような文字列変数、NOのような数値型変数、CFLAGのような数値配列変数のいずれでも可能です。\\ | + | |
| - | <キャラクタ変数> | + | |
| - | FORWARDなら昇順、BACKなら降順になります。省略した場合は昇順でソートされます。\\ | + | |
| - | MASTERはソートの対象になりません。\\ | + | |
| - | また、TARGET: | + | |
| - | しかしTARGET: | + | |
| - | =|BOX|\\ | + | |
| - | ; | ||
| - | SORTCHARA\\ | ||
| - | ; | ||
| - | SORTCHARA BACK\\ | ||
| - | ; | ||
| - | SORTCHARA CFLAG: | ||
| - | ; | ||
| - | SORTCHARA NAME, BACK\\ | ||
| - | | | = | | ||
| - | なお、TARGET == -1の場合でも、CFLAG: | ||
| ==== GETCHARA < | ==== GETCHARA < | ||
| - | 現在所有しているキャラの中にそのキャラがいるかを判定し、いればリスト上での位置を、いなければ-1を返します\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | リスト全体から特定のキャラの有無を確認したい場合に使えます\\ | + | |
| ==== ADDDEFCHARA ==== | ==== ADDDEFCHARA ==== | ||
| - | ゲーム開始時のシステム的なキャラ追加処理を行う命令です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | chara0*.csvで定義されたキャラと、gamebase.csvで指定された初期キャラを追加します。\\ | + | |
| - | " | + | |
| - | 該当するcsvが存在しない場合、ADDVOIDCHARA同様に空のキャラクタを作成します。\\ | + | |
| - | これはeramakerの初期化処理を再現するための命令であり、@SYSTEM_TITLE以外では使用できません。\\ | + | |
| ==== ADDVOIDCHARA ==== | ==== ADDVOIDCHARA ==== | ||
| - | csvに依らずにキャラを追加する命令です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | ADDVOIDCHARAで追加されたキャラは全ての変数に0又は"" | + | |
| ==== DELALLCHARA ==== | ==== DELALLCHARA ==== | ||
| - | 登録されている全てのキャラクタを削除します。 以下のスクリプトと同じことです。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | REPEAT CHARANUM\\ | ||
| - | DELCHARA 0\\ | ||
| - | REND\\ | ||
| - | | | = | | ||
| ==== PICKUPCHARA < | ==== PICKUPCHARA < | ||
| - | 引数で指定したキャラのみを残し、他のキャラを全て削除する命令です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | MASTER: | + | |
| - | 対象キャラに負の値を指定した場合エラーになりますが、MASTER、TARGET、ASSI等を対象に設定し、\\ | + | |
| - | その結果それらの変数の中身が負の値だった場合は、例外でエラーになりません(無視される)。\\ | + | |
| ==== EXISTCSV < | ==== EXISTCSV < | ||
| - | 対応するキャラが定義されているかどうかをチェックしRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 定義されていれば1、されていなければ0を返します。\\ | + | |
| - | ADDCHARA noがエラーにならずに実行できるかどうかを調べることができます。\\ | + | |
| ==== FINDCHARA < | ==== FINDCHARA < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== FINDLASTCHARA < | ==== FINDLASTCHARA < | ||
| - | FINDCHARA命令はキャラクタ変数と値を指定し、変数がその値であるキャラクタの登録番号をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 複数見つかった場合、FINDCHARAは最初にヒットしたキャラを、\\ | + | |
| - | FINDLASTCHARAは最後にヒットしたキャラを返します。見つからなかった場合は-1を返します。\\ | + | |
| - | また、第3引数を指定することで検索の開始位置を、第4引数を指定することで検索の終了位置を指定できます。\\ | + | |
| - | ただし、検索範囲がキャラクタ数の範囲を超える場合はエラーとなります。\\ | + | |
| - | =|BOX|\\ | ||
| - | X = -1\\ | ||
| - | WHILE 1\\ | ||
| - | FINDCHARA CFLAG:10, 123, X + 1\\ | ||
| - | X = RESULT\\ | ||
| - | SIF X < 0\\ | ||
| - | BREAK\\ | ||
| - | PRINTFORML %NAME: | ||
| - | WEND\\ | ||
| - | | | = | | ||
| ==== COPYCHARA < | ==== COPYCHARA < | ||
| - | 第一引数で指定された登録番号のキャラの全てのデータを第二引数で指定された登録番号のキャラにコピーします。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| ==== ADDCOPYCHARA < | ==== ADDCOPYCHARA < | ||
| - | 引数で指定された登録番号のキャラと同じデータであるキャラを新たに追加します。つまり、ADDCHARAの変種です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 変数操作・変数参照・CSV参照\\ | + | |
| ==== VARSIZE < | ==== VARSIZE < | ||
| - | 指定した変数の配列のサイズをRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 多次元配列変数の場合、一番左の要素から順にRESULT: | + | |
| - | 配列のサイズはVariableSize.csvで指定した値です。\\ | + | |
| - | =|BOX|\\ | ||
| - | VARSIZE FLAG\\ | ||
| - | PRINTFORML < | ||
| - | VARSIZE SAVESTR\\ | ||
| - | PRINTFORML < | ||
| - | VARSIZE TALENT\\ | ||
| - | PRINTFORML < | ||
| - | WAIT\\ | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | 結果(サイズを変更していない場合)\\ | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | | | = | | ||
| - | ※実際に変数を参照するわけではないので配列外参照が発生することはありません。 上の例ではTARGET == -1の場合でも-1人目のTALENTを参照しようとしてエラー、ということにはなりません。\\ | ||
| ==== RESETDATA ==== | ==== RESETDATA ==== | ||
| - | GLOBALとGLOBALSを除く全ての変数を初期化します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 具体的には全てのキャラを削除し、全てのローカル変数および全ての通常の変数に0又は空文字列を代入します。\\ | + | |
| - | また、PALAMLVやSTRなど初期値が設定されている変数については初期値を代入します。\\ | + | |
| ==== RESETGLOBAL ==== | ==== RESETGLOBAL ==== | ||
| - | グローバル変数を初期化します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 具体的にはGLOBALに0を代入し、GLOBALSに空文字列を代入します。\\ | + | |
| ==== RESET_STAIN < | ==== RESET_STAIN < | ||
| - | 第1引数で指定したキャラクタのSTAINを初期化する命令です。 初期値はBEGIN TRAINのときに代入される値と同様で、_replace.csvの「汚れの初期値」で指定できます。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| ==== SWAP < | ==== SWAP < | ||
| - | 変数1と変数2の中身を入れ替えます\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 交換する2つの変数は同じ型(整数型と整数型、文字列型と文字列型)である必要があります\\ | + | |
| ==== CSVNAME < | ==== CSVNAME < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVCALLNAME < | ==== CSVCALLNAME < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVNICKNAME < | ==== CSVNICKNAME < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVMASTERNAME < | ==== CSVMASTERNAME < | ||
| - | CSVで定義されたNAME、CALLNAME、NICKNAME、MASTERNAMEを直接呼び出す関数です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 所有してないキャラの名前とかが欲しいときとかにどうぞ\\ | + | |
| - | 第一引数がキャラ番号(NOの方)です。\\ | + | |
| ==== CSVBASE < | ==== CSVBASE < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVCSTR < | ==== CSVCSTR < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVABL < | ==== CSVABL < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVTALENT < | ==== CSVTALENT < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVMARK < | ==== CSVMARK < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVEXP < | ==== CSVEXP < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVRELATION < | ==== CSVRELATION < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVJULE < | ==== CSVJULE < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVEQUIP < | ==== CSVEQUIP < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== CSVCFLAG < | ==== CSVCFLAG < | ||
| - | CSVで定義された値を直接呼び出す関数です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第一引数がキャラ番号、第二引数が各変数のインデックスです。\\ | + | |
| - | CSVCSTRはRESULTSに文字列を代入し、その他はRESULTに数値を代入します。\\ | + | |
| ==== GETNUM < | ==== GETNUM < | ||
| - | 各csvで定義されている名称からその数値を取得し、RESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 例えば、abl.csvで" | + | |
| - | 定義されていない場合は-1になります。\\ | + | |
| - | csvと変数の対応はEmueraの拡張文法# | + | |
| ==== GETPALAMLV < | ==== GETPALAMLV < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== GETEXPLV < | ==== GETEXPLV < | ||
| - | 与えられた値の内容とPALAMLV・EXPLVを比較し、その引数がPALAMLV・EXPLVでどこまで以上かをRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第2引数は調査する最大のLVを表します。PALAMLV・EXPLVの値を設定してから使用してください。\\ | + | |
| ==== FINDELEMENT < | ==== FINDELEMENT < | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== FINDLASTELEMENT < | ==== FINDLASTELEMENT < | ||
| - | 配列中の特定範囲から特定の要素の位置を取得する関数です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第3・第4引数で指定された配列要素の検索範囲に第2引数で指定されたものと同じ要素があれば、その位置を返します。\\ | + | |
| - | 複数ある場合はFINDELEMENTは最初にヒットしたものを、\\ | + | |
| - | FINDLASTELEMENTは最後にヒットしたものを返します。ヒットしない場合は-1を返します。\\ | + | |
| - | 検索対象が文字列の場合はREPLACEと同様に正規表現を使えます。\\ | + | |
| - | 第5引数は文字列の場合のみ有効で、0であれば文字列の一部が一致でもOKとし、\\ | + | |
| - | 0以外であれば文字列と完全に一致した場合のみOKとします。\\ | + | |
| ==== VARSET < | ==== VARSET < | ||
| - | 指定した変数の配列の指定範囲に第二引数の値を代入します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第二引数を省略した場合、0または空文字列が代入されます。\\ | + | |
| - | 第三引数以降を省略した場合、配列の全てに代入されます。\\ | + | |
| - | 例えば\\ | + | |
| - | =|BOX|\\ | ||
| - | VARSET FLAG, 0\\ | ||
| - | VARSET STR, " | ||
| - | VARSET TA: | ||
| - | | | = | | ||
| - | この例ではFLAGの要素全てが0になります。\\ | ||
| - | STR: | ||
| - | 同じことはERB上でFOR-NEXTループなどを使って行うこともできますが、ループ回数が数十万回程度になると実行時間が無視できなくなります。\\ | ||
| - | VARSET命令はERB上での代入よりはるかに早く処理を終わらせることができます。\\ | ||
| - | キャラクタ変数をVARSET命令の対象にした場合、指定したキャラの要素のみに代入されます。\\ | ||
| - | |||
| - | =|BOX|\\ | ||
| - | VARSET CFLAG: | ||
| - | VARSET CSTR, "" | ||
| - | | | = | | ||
| - | この例ではMASTERのCFLAG: | ||
| - | また、対象を省略した場合は通常通りTARGETとみなされるのでTARGETのCSTRが全て"" | ||
| - | 1次元配列および配列型キャラクタ変数以外の、DITEMTYPEやTA等に使用した場合、第三引数以降は無視され配列の全てに代入されます。\\ | ||
| ==== CVARSET < | ==== CVARSET < | ||
| - | 指定した登録キャラクタについてキャラクタ変数の特定要素へ代入する命令です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第一引数で指定した変数の第四引数以降で指定した登録キャラクタについて、第二引数で指定した要素へ第三引数で指定した値を代入します。\\ | + | |
| - | NAME、ISASSIなどの一次元配列変数の場合、第二引数は処理に影響しません。そのため第三引数を省略しない場合、適当な値を指定してください。\\ | + | |
| - | 第三引数を省略した場合、0又は"" | + | |
| - | 第二引数も省略した場合、0番目の要素に代入されます。\\ | + | |
| - | 第四引数以降を省略した場合、全ての登録キャラクタに代入されます。\\ | + | |
| ==== CVARSET CFLAG, 10, 123 ==== | ==== CVARSET CFLAG, 10, 123 ==== | ||
| - | このスクリプトは以下と同じことです。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | + | |
| - | REPEAT CHARANUM\\ | + | |
| - | CFLAG: | + | |
| - | REND\\ | + | |
| - | | | = | | + | |
| ==== ARRAYSHIFT < | ==== ARRAYSHIFT < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 配列をシフトする命令ARRAYSHIFT実装\\ | ||
| - | 書式:ARRAYSHIFT < | ||
| - | 内容:配列変数を指定した数だけずらす、正の値で添え字の大きい方へ、負の値で小さい方にずらす\\ | ||
| - | 配列の範囲からはみでた値は掃き捨て、ずらして出来た空白領域は第2引数で指定した値で満たす\\ | ||
| - | 省略可能な第4および第5引数を使うと一部の範囲のみをずらすことができる\\ | ||
| - | 1次元配列および配列型キャラクタ変数のみに対応しています。DITEMTYPEやTA等に使用することはできません。\\ | ||
| - | | | = | | ||
| ==== ARRAYREMOVE < | ==== ARRAYREMOVE < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 配列要素を部分削除する命令ARRAYREMOVE実装\\ | ||
| - | 書式:ARRAYREMOVE < | ||
| - | 内容:配列変数を指定した初期値から要素数分だけ削除し、後ろを値を詰める\\ | ||
| - | 消す要素数を0以下にすると初期値から後ろ全て消去になります\\ | ||
| - | 1次元配列および配列型キャラクタ変数のみに対応しています。DITEMTYPEやTA等に使用することはできません。\\ | ||
| - | | | = | | ||
| ==== ARRAYSORT < | ==== ARRAYSORT < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 配列変数をソートするARRAYSORT実装\\ | ||
| - | 書式:ARRAYSORT [対象変数](, | ||
| - | 内容:開始インデックスから対象要素数個の配列データをソートする\\ | ||
| - | FORWARDで昇順、BACKで降順\\ | ||
| - | | | = | | ||
| ==== ARRAYCOPY < | ==== ARRAYCOPY < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | 無頓着な配列コピー命令ARRAYCOPY実装\\ | ||
| - | 書式:ARRAYCOPY < | ||
| - | 内容:コピー元変数の値をコピー先変数へコピーする\\ | ||
| - | 型変数は型が同じで次元数が同じである必要がある\\ | ||
| - | また、キャラクター変数には非対応\\ | ||
| - | 要素数が異なる場合はコピーできる分だけコピーする\\ | ||
| - | 書式例:ARRAYCOPY " | ||
| - | | | = | | ||
| ==== ARRAYMSORT array1{, array2...} ==== | ==== ARRAYMSORT array1{, array2...} ==== | ||
| - | ARRAYMSORTはarray1を昇順でソートし、それと同じ順序でarray2以降の配列を並び替えます。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | array1は一次元配列である必要があります。array2以降は多次元配列も受け付けます。\\ | + | |
| - | array1に0または空文字列の要素があるとき、それを配列の終端とみなし以降の要素はソートしません。\\ | + | |
| - | array2以降の配列の要素数がarray1のソートされた要素数よりも少ない場合場合、命令を中断しRESULT: | + | |
| - | 全ての配列のソートに成功した場合、この命令はRESULT: | + | |
| - | =|BOX|\\ | ||
| - | @TEST\\ | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | ARRAY1 = 3, | ||
| - | ARRAY2 = 1001, | ||
| - | ARRAY3:0:0 = 1, 101, 2763\\ | ||
| - | ARRAY3:1:0 = 2, 102, 9615\\ | ||
| - | ARRAY3:2:0 = 3, 103, 7035\\ | ||
| - | |||
| - | ARRAYMSORT ARRAY1, | ||
| - | PRINTFORML > ARRAY1 == {ARRAY1: | ||
| - | PRINTFORML > ARRAY2 == {ARRAY2: | ||
| - | FOR I, | ||
| - | PRINTFORML > ARRAY3: | ||
| - | NEXT\\ | ||
| - | | | = | | ||
| - | |||
| - | =|BOX|\\ | ||
| - | ;;; | ||
| - | > ARRAY1 == 1,2,3,0 | ||
| - | > ARRAY2 == 1002, | ||
| - | > ARRAY3:0:0 == 2,102,9615 | ||
| - | > ARRAY3:1:0 == 3,103,7035 | ||
| - | > ARRAY3:2:0 == 1,101,2763 | ||
| - | | | = | | ||
| ==== CUPCHECK < | ==== CUPCHECK < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | CUP、CDOWNに対応するUPCHECKであるCUPCHECK追加\\ | + | |
| - | 書式:CUPCHECK < | + | |
| - | 内容:引数で指定したキャラに対するUPCHECKを走らせる、それだけ\\ | + | |
| - | 当然ですがUP, | + | |
| - | セーブデータ操作\\ | + | |
| - | SAVEDATA < | + | |
| - | < | + | |
| - | SAVEDATA命令は@SAVEINFOを呼び出さないのでPUTFORMでコメントを入れることができません。\\ | + | |
| - | 代わりに2つ目の引数の< | + | |
| - | (1.704からは文字列変数だけでなく文字列式が使用できます) 以下に例を示します。\\ | + | |
| - | | | = | | + | |
| - | =|BOX|\\ | ||
| - | GETTIME\\ | ||
| - | STR:0 = %RESULTS:0% {DAY+1}日目\\ | ||
| - | SAVEDATA 14, STR: | ||
| - | SAVEDATA 15, RESULTS:0 + " " + @" | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | 結果(ロード画面)\\ | ||
| - | [13] ----\\ | ||
| - | [14] 2009年03月28日 00:31:27 1日目\\ | ||
| - | [15] 2009年03月28日 00:31:27 1日目\\ | ||
| - | [16] ----\\ | ||
| - | | | = | | ||
| - | 上書きの確認などは行わないので必要ならERB側で用意してください。\\ | ||
| - | 既にデータがあるかどうかはCHKDATA命令で調べることができます。\\ | ||
| - | SAVEDATAは(SAVEGAME命令と違って)スクリプトのどの場所でも呼び出すことができます。\\ | ||
| ==== LOADDATA < | ==== LOADDATA < | ||
| - | < | + | [[erabasicリファレンス_データ操作・保存# |
| - | ロードに失敗した場合、エラー終了します。\\ | + | |
| - | 必ずCHKDATA命令でロード可能かどうかを調べてから実行してください。\\ | + | |
| - | LOADDATAは(LOADGAME命令と違って)スクリプトのどの場所でも呼び出すことができます。\\ | + | |
| ==== DELDATA < | ==== DELDATA < | ||
| - | < | + | [[erabasicリファレンス_データ操作・保存# |
| - | ファイルが存在しなくてもエラーにはなりません。\\ | + | |
| ==== CHKDATA < | ==== CHKDATA < | ||
| - | < | + | [[erabasicリファレンス_データ操作・保存#chkdata_数式|この項目の説明を開く]] |
| - | RESULT: | + | |
| - | * 0 - このファイルはロード可能です。 | + | |
| - | * 1 - 指定されたファイルは存在しません。 | + | |
| - | * 2 - ゲームのコードが違います。(gamebase.csvの" | + | |
| - | * 3 - バージョンが違います。(gamebase.csvの" | + | |
| - | * 4 - 上記以外の問題があるファイルです。 | + | |
| - | RESULT: | + | |
| - | RESULT: | + | |
| ==== SAVENOS < | ==== SAVENOS < | ||
| - | コンフィグ" | + | [[erabasicリファレンス_データ操作・保存# |
| - | 数値変数を省略することはできません。\\ | + | |
| ==== SAVEGLOBAL ==== | ==== SAVEGLOBAL ==== | ||
| - | 変数GLOBALとGLOBALSをセーブします。保存先は" | + | [[erabasicリファレンス_データ操作・保存# |
| - | ERHファイル内でGLOBAL及びSAVEDATAフラグを持つ変数が定義されていればそれもセーブします。\\ | + | |
| ==== LOADGLOBAL ==== | ==== LOADGLOBAL ==== | ||
| - | GLOBALとGLOBALSをロードします。保存先は" | + | [[erabasicリファレンス_データ操作・保存# |
| - | 読み込みに失敗してもエラーにはなりません。\\ | + | |
| - | 読み込みに成功するとRESULTに1を、失敗すると0を代入します。\\ | + | |
| - | 通常のセーブデータと同様に、gamebase.csvで設定されたコード、バージョンが適切でないファイルはロードできません。\\ | + | |
| - | 変数GLOBALの詳細は変数の節を参照してください。\\ | + | |
| ==== OUTPUTLOG ==== | ==== OUTPUTLOG ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | ログ出力命令OUTPUTLOG実装\\ | ||
| - | やり過ぎはディスクの寿命を縮めるのでほどほどに\\ | ||
| - | なお、ログの文字コードはUnicodeです。\\ | ||
| - | | | = | | ||
| ==== SAVECHARA str filename, str memo, int charano{, int charano2, ...} ==== | ==== SAVECHARA str filename, str memo, int charano{, int charano2, ...} ==== | ||
| - | 指定したキャラクタのデータをファイルに保存する命令です。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第一引数はデータをセーブするファイル名(の一部)を指定します。実際のファイル名は" | + | |
| - | 第二引数はセーブデータのメモとなる文字列を保存します。後にCHKCHARADATA関数により読むことができます。\\ | + | |
| - | 第三引数以降にはセーブしたいキャラの登録番号を指定します。いくつでも可能ですが同一の登録番号を複数回指定することはできません。\\ | + | |
| - | datフォルダーが存在しない場合、フォルダの作成を試みます。作成に失敗した場合エラーになります。\\ | + | |
| - | また、第一引数が空文字列である、第一引数にファイル名に使えない文字が含まれるなどの場合エラーになります。\\ | + | |
| ==== LOADCHARA str filename ==== | ==== LOADCHARA str filename ==== | ||
| - | 第一引数はデータをロードするファイル名(の一部)を指定します。実際のファイル名は" | + | [[erabasicリファレンス_データ操作・保存# |
| - | RESULT: | + | |
| - | LOADVARの前にCHKCHARADATA関数によりファイルの適切さを確認すべきです。\\ | + | |
| - | LOADCHARAはSAVEされているキャラの数だけ新しいキャラを登録します。\\ | + | |
| - | したがって既存の登録キャラには影響しません。\\ | + | |
| - | 何名のキャラが追加されたかを知るにはロード前後でのCHARANUMを比較してください。\\ | + | |
| ==== CHKCHARADATA str filename ==== | ==== CHKCHARADATA str filename ==== | ||
| - | datフォルダ内の" | + | [[erabasicリファレンス_データ操作・保存# |
| - | RESULTにはロード可能な場合は0、何らかの理由により不可能な場合は非0が代入されます。\\ | + | |
| - | また、ロード可能な場合はRESULTS: | + | |
| ==== FIND_CHARADATA str filename ==== | ==== FIND_CHARADATA str filename ==== | ||
| - | LOADCHARAの対象となり得るファイルをdatフォルダの中から探索しファイル名(chara_*.datの*の部分)をRESULTSに代入します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | RESULTにはヒット数(発見されたファイル数)が代入されます。\\ | + | |
| - | 引数はchara_*.datの*の部分を指定できます。\\ | + | |
| - | 例えばFIND_CHARADATA(" | + | |
| - | 引数を省略した場合、" | + | |
| - | なお、chara_.dat(*が空文字列)はLOADCHARAで指定できないのでヒットしません。\\ | + | |
| - | ヒット数がRESULTSの要素数を超えた場合はエラーにはなりませんが超えた分のファイル名は代入されません。\\ | + | |
| ==== SAVETEXT str text, int fileNo{, int force_savdir, | ==== SAVETEXT str text, int fileNo{, int force_savdir, | ||
| - | textで指定したテキストを、ファイル名textXX.txt(例えばfileNoが2ならtext02.txt)に保存します。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | この命令はテキストにヘッダーなどを付け加えたり変更したりすることなく文字列そのままを保存します。\\ | + | |
| - | この命令は通常はオプション設定の影響を受け、savフォルダ内に作成されたり、UTF-8で保存されます。\\ | + | |
| - | 第3引数に非0を指定した場合、オプションを無視して強制的にsavフォルダ内に保存します。savフォルダは必要に応じて作成されます。\\ | + | |
| - | 第4引数に非0を指定した場合、オプションを無視して強制的にUTF-8エンコードで保存します。\\ | + | |
| - | 成功した場合RESULT: | + | |
| - | 短い時間中に同一ファイルに書き込むことを繰り返した場合、ウイルス対策ソフト等の影響で書き込みに失敗する可能性がありますので成否のチェックは重要です。\\ | + | |
| ==== LOADTEXT int fileNo{, int force_savdir, | ==== LOADTEXT int fileNo{, int force_savdir, | ||
| - | LOADTEXT命令版はtextXX.savを読み取りその結果をRESULTS: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 第2引数に非0を指定した場合、オプションによらずsavフォルダ内のファイルを探します。\\ | + | |
| - | 第3引数に非0を指定した場合、UTF-8エンコードで保存されているものとして読み取ります。\\ | + | |
| - | 失敗した場合、RESULTS: | + | |
| - | 同名の式中関数もあり、RESULTS: | + | |
| ===== 日付・時刻取得 ===== | ===== 日付・時刻取得 ===== | ||
| + | [[erabasicリファレンス_データ操作・保存# | ||
| + | |||
| ==== GETTIME ==== | ==== GETTIME ==== | ||
| - | パソコンの現在日時・時刻に関する情報をRESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | 現在日時が2009年3月28日13時5分23秒678ミリ秒であれば、RESULT: | + | |
| - | RESULTS: | + | |
| - | RESULTS: | + | |
| - | 年月日について独自の表記をしたい場合はRESULT: | + | |
| - | なお、RESULT: | + | |
| - | (数ミリ秒しか経過していない場合、同じ値が帰ってくることがあります)\\ | + | |
| - | パフォーマンスの測定を目的とする場合は注意してください。\\ | + | |
| ==== GETMILLISECOND ==== | ==== GETMILLISECOND ==== | ||
| - | 西暦0001年1月1日からの経過時間をミリ秒単位で取得し、RESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | そのまま加減算ができるので経過時間などを調べるにはGETTIMEよりも適しています。\\ | + | |
| - | なお、RESULT: | + | |
| - | (数ミリ秒しか経過していない場合、同じ値が帰ってくることがあります)\\ | + | |
| - | パフォーマンスの測定を目的とする場合は注意してください。\\ | + | |
| ==== GETSECOND ==== | ==== GETSECOND ==== | ||
| - | 西暦0001年1月1日からの経過時間を秒単位で取得し、RESULT: | + | [[erabasicリファレンス_データ操作・保存# |
| - | そのまま加減算ができるので経過時間などを調べるにはGETTIMEよりも適しています。\\ | + | |
| ===== 入力・ウェイト ===== | ===== 入力・ウェイト ===== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== FORCEWAIT ==== | ==== FORCEWAIT ==== | ||
| - | 右クリック、マクロのスキップでスキップできないWAIT命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | この命令に達した時点でこれらのスキップ状態は解除されます。\\ | + | |
| ==== INPUT {< | ==== INPUT {< | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== INPUTS {< | ==== INPUTS {< | ||
| - | eramakerと同様の命令ですが、引数により空文字列を入力された場合のデフォルト入力値を設定することができます。\\ | + | [[erabasicリファレンス_文字表示・入力#inputs_文字列|この項目の説明を開く]] |
| - | 引数を省略し空文字列を入力した場合、従来と同様にINPUTは再入力、INPUTSはRESULTSに空文字列が代入され次の処理へ進みます。\\ | + | |
| ==== TINPUT < | ==== TINPUT < | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== TINPUTS < | ==== TINPUTS < | ||
| - | 制限時間のある入力受付命令です。 1番目の引数は制限時間(ms)ですが、100msより細かい値を設定しても正確な動作はできません。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 2番目の引数は時間切れ時のデフォルトのリターン値になります\\ | + | |
| - | 3番目の引数は残り時間を表示するかで0なら非表示、他は表示となります。省略した場合は1(表示)です。\\ | + | |
| - | 4番目の引数は時間切れ時に表示される文字列です。空文字列の場合はタイマー表示を消去して次の処理へ移ります。\\ | + | |
| - | なお、4番目の引数を設定した場合、3番目の引数は省略できません。\\ | + | |
| - | またTINPUTSにおいて、INPUTS同様にマクロ式を用いることができます。\\ | + | |
| - | 文字列として()を使用する場合、を用いてエスケープしてください。\\ | + | |
| ==== TWAIT < | ==== TWAIT < | ||
| - | 第一引数が制限時間、第二引数が入力受付フラグです。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 制限時間経過するまで動作を停止します\\ | + | |
| - | 実際の挙動は入力受付フラグの指定によって変化します\\ | + | |
| - | * 入力受付フラグ = 0:入力を受け付け、入力がなされると制限時間前でも次に進みます | ||
| - | * 入力受付フラグ ≠ 0:入力を受け付けません(制限時間まで強制的に待たせることができます) | ||
| ==== ONEINPUT {< | ==== ONEINPUT {< | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== ONEINPUTS {< | ==== ONEINPUTS {< | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | =|BOX|\\ | ||
| - | 一文字限定入力自動処理命令ONEINPUT、ONEINPUTS実装\\ | ||
| - | 書式:ONEINPUT or ONEINPUTS\\ | ||
| - | 内容:一文字のみの入力を受け付ける、入力すると自動的に次の処理に移る\\ | ||
| - | ペースト等を用いて複数桁の数字(複数の文字)を一度に貼りつけた場合、最初の桁(文字)のみが入力されたものとして処理されます。\\ | ||
| - | INPUTやINPUTS同様、引数により空文字列を入力された場合のデフォルト入力値を設定することができます。\\ | ||
| - | ただし、ONEINPUTで負の値を指定した場合や、ONEINPUTSで空文字列を指定した場合は、引数は無効となり、引数なしの場合と同じ挙動になります。\\ | ||
| - | また、複数桁の数字(複数の文字)を引数とした場合、最初の桁(文字)のみがデフォルト入力値となります。\\ | ||
| - | 引数を省略し空文字列を入力した場合、通常と同様にONEINPUTは再入力、ONEINPUTSはRESULTSに空文字列が代入され次の処理へ進みます。\\ | ||
| - | ONEINPUTSの場合、空文字列のままEnterを押しても空文字列を入力したとみなされます。\\ | ||
| - | なお、これらの命令を利用した場合にはEmueraのCONFIG設定においてキーボードマクロを使用する設定になっていても、\\ | ||
| - | うまく働かない現象が起こりますがそれは仕様です。\\ | ||
| - | またONEINPUTSにおいて、INPUTS同様にマクロ式を用いることができます。\\ | ||
| - | 文字列として()を使用する場合、を用いてエスケープしてください。\\ | ||
| - | | | = | | ||
| ==== TONEINPUT < | ==== TONEINPUT < | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== TONEINPUTS < | ==== TONEINPUTS < | ||
| - | 引数はそれぞれTINPUT、TINPUTSと同じです。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | それぞれONEINPUTとTINPUT、ONEINPUTSとTINPUTSの性質を併せ持つ入力受付命令です。\\ | + | |
| - | これらの命令を利用した場合にはEmueraのCONFIG設定においてキーボードマクロを使用する設定になっていても、\\ | + | |
| - | うまく働かない現象が起こりますがそれは仕様です。\\ | + | |
| - | またTONEINPUTSにおいて、INPUTS同様にマクロ式を用いることができます。\\ | + | |
| - | 文字列として()を使用する場合、を用いてエスケープしてください。\\ | + | |
| ==== WAITANYKEY ==== | ==== WAITANYKEY ==== | ||
| - | いずれかのキー入力、またはマウスのクリックを待つWAIT命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | WAITのONEINPUT版ともいえます。\\ | + | |
| ==== INPUTMOUSEKEY {int time} ==== | ==== INPUTMOUSEKEY {int time} ==== | ||
| - | INPUTMOUSEKEY命令はマウスやキーボードの入力を直接認識する命令です。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 引数はTINPUTのような時間切れ処理を行うまでの時間をミリ秒で指定します。\\ | + | |
| - | 引数を省略したか0以下を指定した場合には時間切れ処理は行われません。\\ | + | |
| - | この命令は、ONEINPUT等では捕捉できないファンクションキーや方向キー、PageUpキー等も入力として認識することができます。\\ | + | |
| - | 一方でこの命令による入力の受付待機中はESCキーや右クリックによるスキップ機能、マクロ機能、その他の機能が使用できず、単にESCキー等が押されたという結果のみ受け付けます。\\ | + | |
| - | また、この命令は時間切れ表示等を含めて一切のPRINT処理を行いません。\\ | + | |
| - | スキップ機能の実装や、入力を表示したい場合などはERB側で対応する必要があります。\\ | + | |
| - | 第2引数にミリ秒単位で数値を指定することにより、時間切れ処理が行われます。 INPUTMOUSEKEYの返り値は最大5つであり、RESULT: | + | |
| - | RESULT:0 == 1; マウス押下が検出された\\ | ||
| - | > RESULT:1 ; | ||
| - | > RESULT:2 ; | ||
| - | > RESULT:3 ; | ||
| - | > RESULT:4 ; | ||
| - | RESULT:0 == 2; マウスホイールの回転が検出された\\ | ||
| - | > RESULT:1 ; | ||
| - | > RESULT:2 ; | ||
| - | > RESULT:3 ; | ||
| - | RESULT:0 == 3; キーボード押下が検出された\\ | ||
| - | > RESULT:1 ; | ||
| - | > RESULT:2 ; | ||
| - | RESULT:0 == 4; 時間切れにより終了した\\ | ||
| - | マウスのボタンについては_VirtualKey.ERHのMB_LEFT〜MB_MIDDLEを、キーコードについては_VirtualKey.ERHのVK_〜を参照してください。\\ | ||
| - | キーコードはGETKEY関数のものと共通です。\\ | ||
| - | マウスホイールのホイール量は1や-1ではなく最低でも120など大きな値になるので注意してください。\\ | ||
| - | また、Emueraの画面外にカーソルがある場合にホイールが検出されるかどうかはWindowsの設定次第でありEmuera側では変更できません。\\ | ||
| - | 初期設定ではWindows8.1以前は検出されますがWindows10では画面外のホイールは検出されないようです。\\ | ||
| ===== ループ・分岐構文 ===== | ===== ループ・分岐構文 ===== | ||
| + | [[erabasicリファレンス_条件分岐・繰り返し# | ||
| + | |||
| ==== FOR < | ==== FOR < | ||
| - | FOR〜NEXTはREPEAT〜RENDの機能強化版です。\\ | + | [[erabasicリファレンス_条件分岐・繰り返し#for_数値型変数_数式_数式_数式_next|この項目の説明を開く]] |
| - | 第1引数はカウントに使用される変数を表します(REPEATでは常にCOUNT: | + | |
| - | 第2引数は変数に最初に代入される値を表します(REPEATでは常に0)。\\ | + | |
| - | 第3引数はループが終了される値を表します(REPEATで設定可能な値)。\\ | + | |
| - | 第4引数はループごとに加算される値を表します(REPEATでは常に1)。\\ | + | |
| - | =|BOX|\\ | ||
| - | FOR COUNT, 0, X\\ | ||
| - | 〜〜\\ | ||
| - | NEXT\\ | ||
| - | REPEAT X\\ | ||
| - | 〜〜\\ | ||
| - | REND\\ | ||
| - | | | = | | ||
| - | 上の二つはほぼ同じ動作をします。\\ | ||
| - | ともにX回の繰り返しを行う構文で、ループの途中でCONTINUEやBREAKを使用できます。\\ | ||
| - | 異なる点はカウント用の変数を指定できることと、開始値とステップを変更できることです。\\ | ||
| - | また、FOR〜NEXTは入れ子にすることができます。\\ | ||
| - | =|BOX|\\ | ||
| - | FOR Y, 0, 100\\ | ||
| - | FOR X, 0, 100\\ | ||
| - | 〜〜\\ | ||
| - | NEXT\\ | ||
| - | NEXT\\ | ||
| - | | | = | | ||
| - | 第1引数である< | ||
| - | 第4引数である< | ||
| - | < | ||
| - | < | ||
| - | < | ||
| - | 各値はループの開始と同時に固定され、ループの途中で変数が変化しても影響を受けません。\\ | ||
| - | 以下の2つは同じ結果になります。\\ | ||
| - | =|BOX|\\ | ||
| - | ; | ||
| - | X = 10\\ | ||
| - | FOR COUNT:X, 0, X, X/ | ||
| - | X = 10000\\ | ||
| - | NEXT\\ | ||
| - | | | = | | ||
| - | =|BOX|\\ | ||
| - | ; | ||
| - | FOR COUNT:10, 0, 10, 10/ | ||
| - | X = 10000\\ | ||
| - | NEXT\\ | ||
| - | | | = | | ||
| - | なお、GOTO等の命令で直接FOR〜NEXT内に入った場合、REPEAT〜RENDと同様にNEXTの直前まで通常通り実行し、その後NEXTを無視して次の行から処理を続行します。\\ | ||
| ===== WHILE < | ===== WHILE < | ||
| - | REPEAT〜RENDやFOR〜NEXTのような繰り返し構文の一種です。\\ | + | [[erabasicリファレンス_条件分岐・繰り返し#while_数式_wend|この項目の説明を開く]] |
| - | WHILEの< | + | |
| - | 常に満たし続ける条件を与えると、BREAKで抜けるようになっていない限り無限ループになります\\ | + | |
| - | あまりにループ処理が長いとEmueraが文句を言う場合があります\\ | + | |
| - | なお、GOTO等の命令で直接WHILE〜WEND内に入った場合、通常どおりWENDに到達した時点でWHILEへループし、条件を判定します。\\ | + | |
| ===== DO\\ LOOP < | ===== DO\\ LOOP < | ||
| - | REPEAT〜RENDやFOR〜NEXTのような繰り返し構文の一種です。\\ | + | [[erabasicリファレンス_条件分岐・繰り返し#do_loop_数式|この項目の説明を開く]] |
| - | Cのdo〜while、VBのdo〜loop while構文と同様、LOOPの< | + | |
| - | WHILE〜WENDと異なり最低でも1回は実行されることが特徴です。\\ | + | |
| - | なお、DO〜LOOP内のCONTINUEした場合にはLOOPの条件を満たしていなければそのままLOOPを抜けます。CONTINUEしてもDO文に戻るとは限らないことに注意してください。\\ | + | |
| - | また、GOTO等の命令で直接DO〜LOOP内に入った場合、通常どおりLOOPに到達した時点で条件を判定し、< | + | |
| ==== SELECTCASE < | ==== SELECTCASE < | ||
| - | 分岐構文です。Visual Basicの同名の構文と動作を似せています。\\ | + | [[erabasicリファレンス_条件分岐・繰り返し# |
| - | IF構文と似ていますが、SELECTCASEは1つの値を元に複数の行へ分岐する構文です。\\ | + | |
| - | SELECTCASEに指定した引数の値によって分岐します。 もっとも単純な使用法は以下のようになります。\\ | + | |
| - | =|BOX|\\ | + | ==== RANDOMIZE |
| - | SELECTCASE X\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | CASE 1\\ | + | |
| - | PRINTL Xは1です。\\ | + | |
| - | CASE 3\\ | + | |
| - | PRINTL Xは3です。\\ | + | |
| - | CASEELSE\\ | + | |
| - | PRINTL Xは1でも3でもありません。\\ | + | |
| - | ENDSELECT\\ | + | |
| - | | | = | | + | |
| - | このスクリプトはXの値によって分岐します。\\ | + | |
| - | SELECTCASE文が実行された時、Xが1であれば" | + | |
| - | 同様にXが3であれば" | + | |
| - | Xの値に対応するCASE文がない時、CASEELSE文があればそこに飛びます。なければENDSELECTに飛びます。\\ | + | |
| - | Cなどのswitch文と異なり、1つのCASEから次のCASEに流れ落ちることはありません。\\ | + | |
| - | また、BREAK文でENDSELECTに飛ぶことはできません。\\ | + | |
| - | なお、GOTO等の命令で直接SELECTCASE〜CASE〜CASEELSE〜ENDSELECT内に入った場合、IF〜ELSEIF〜ELSE〜ENDIFと同様に\\ | + | |
| - | CASE、CASEELSE、ENDSELECTの直前まで通常通り実行したあとに、ENDSELECTの次の行へ飛び処理を続行します。\\ | + | |
| - | CASEの条件式には3種類の書式があります。\\ | + | |
| - | 1つは上記のように値を直接指定する方法、2つ目は" | + | |
| - | "IS < | + | |
| - | "< | + | |
| - | また、CASEには複数の条件式をカンマで区切って指定することができます。\\ | + | |
| - | これらを利用して例えば以下のように書くことができます。\\ | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | SELECTCASE X\\ | + | |
| - | CASE 1\\ | + | |
| - | PRINTL Xは1です。\\ | + | |
| - | CASE 2,3\\ | + | |
| - | PRINTL Xは1ではありません。\\ | + | |
| - | PRINTL Xは2か3です。\\ | + | |
| - | CASE 10 TO 20\\ | + | |
| - | PRINTL Xは1でも2でも3でもありません。\\ | + | |
| - | PRINTL Xは10以上20以下です。\\ | + | |
| - | CASE IS <= 30\\ | + | |
| - | PRINTL Xは1, 2, 3, 10以上20以下のどれでもありません。\\ | + | |
| - | PRINTL Xは30以下です。\\ | + | |
| - | CASE 40, 5 * 10 TO 6 * 10, IS >= 10 * 10\\ | + | |
| - | PRINTL Xは30以下ではありません。\\ | + | |
| - | PRINTL Xは40, 50以上60以下, | + | |
| - | CASEELSE\\ | + | |
| - | PRINTL Xは30以下, | + | |
| - | ENDSELECT\\ | + | |
| - | | | = | | + | |
| - | ISやTOは" | + | |
| - | 例えば" | + | |
| - | また、"< | + | |
| - | 右辺が左辺より小さい場合はそのCASEが実行されることはありません。\\ | + | |
| - | + | ||
| - | 1つのCASEに複数の条件式がある場合、短絡評価が起きることに注意してください。\\ | + | |
| - | 条件は左から順にチェックされ、条件を満たすものが見つかった場合、残りの条件は評価されません。\\ | + | |
| - | SELECTCASEの引数として文字列式を使用することもできます。\\ | + | ==== DUMPRAND ==== |
| - | SELECTCASEに文字列を指定した場合はCASEの条件式も文字列式である必要があります。\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | 乱数制御\\ | ||
| - | ==== RANDOMIZE < | ||
| - | ==== DUMPRAND ==== | ||
| ==== INITRAND ==== | ==== INITRAND ==== | ||
| - | RAND: | + | [[erabasicリファレンス_データ操作・保存# |
| - | + | ||
| - | RANDOMIZE命令は指定した値で乱数を初期化します。\\ | + | |
| - | 同じ値で初期化したならば、RANDは必ず同じ結果を返します。\\ | + | |
| - | DUMPRANDは現在の乱数の状態をRANDDATA変数に保存します。\\ | + | ===== デバッグ補助・システムフロー制御 ===== |
| - | INITRANDはRANDDATA変数に保存したデータを読み出します。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | DUMPRANDを行う前にINITRANDを行ってしまわないように注意してください。\\ | + | |
| - | RANDDATA変数の中身が不適当な場合、RANDが正常に動作しなくなります。\\ | + | |
| - | =|BOX|\\ | ||
| - | PRINTFORML {RAND: | ||
| - | RANDOMIZE 23478612\\ | ||
| - | PRINTFORML {RAND: | ||
| - | RANDOMIZE 23478612\\ | ||
| - | PRINTFORML {RAND: | ||
| - | DUMPRAND\\ | ||
| - | PRINTFORML {RAND: | ||
| - | INITRAND\\ | ||
| - | PRINTFORML {RAND: | ||
| - | INITRAND\\ | ||
| - | PRINTFORML {RAND: | ||
| - | | | = | | ||
| - | |||
| - | =|BOX|\\ | ||
| - | ; | ||
| - | 92539/ | ||
| - | 34536/ | ||
| - | 34536/ | ||
| - | 68286/ | ||
| - | 68286/ | ||
| - | 68286/ | ||
| - | | | = | | ||
| - | 上記の結果のうち、最初の行は不定です。実行するたびに結果が変わります。\\ | ||
| - | 2行目、3行目は同じ値でRANDOMIZEした直後なので必ずこの結果になります。\\ | ||
| - | 4行目の前にDUMPRAND命令を実行しています。\\ | ||
| - | 5行目の前にINITRAND命令を行うことで、RANDの状態をDUMPRAND命令で保存した状態まで戻しています。\\ | ||
| - | そのため、4行目と5行目は結果が同じになっています。\\ | ||
| - | 6行目では再度INITRAND命令を行うことで、繰り返し同じ結果を得ています。\\ | ||
| - | RANDDATA変数はセーブされる変数なので、セーブ前にDUMPRANDを行い、ロード直後にINITRANDを行うことで同じ乱数状態を続けて使うことができます。\\ | ||
| - | |||
| - | ===== デバッグ補助・システムフロー制御 ===== | ||
| ==== BEGIN < | ==== BEGIN < | ||
| - | BEGINはeramakerから存在する命令ですが、キーワードとして新しくFIRSTとTITLEが追加されました。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | BEGIN FIRSTはタイトル画面で" | + | |
| - | BEGIN TITLEはタイトル画面に戻ります。\\ | + | |
| - | どちらも変数の初期化などは行いませんので適宜RESETDATA命令を実行してください。\\ | + | |
| ===== CALLTRAIN < | ===== CALLTRAIN < | ||
| - | 連続コマンド実行命令です。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | あらかじめSELECTCOM: | + | |
| - | =|BOX|\\ | ||
| - | SELECTCOM: | ||
| - | SELECTCOM: | ||
| - | ・\\ | ||
| - | ・\\ | ||
| - | ・\\ | ||
| - | SELECTCOM: | ||
| - | |||
| - | CALLTRAIN (設定したコマンドの数)\\ | ||
| - | | | = | | ||
| - | 通常のコマンド実行と同様にSHOW_STATUSやSHOW_USERCOMも呼び出しますが、TRAINコマンド、USERCOMの表示はされません。\\ | ||
| - | どうしてもUSERCOMの表示をしたい場合はNOSKIP〜ENDNOSKIPを使うと良いでしょう。\\ | ||
| - | CALLTRAINによる自動実行が終了後、システム関数@CALLTRAINENDが呼び出されます。\\ | ||
| - | ただし、@CALLTRAINENDはイベント関数ではないため多重定義できないことに注意してください。\\ | ||
| - | なお、コマンドの指定に使うコマンド番号は、ゲーム中の値でなく、TRAIN.CSVで指定した値になります\\ | ||
| ==== DOTRAIN < | ==== DOTRAIN < | ||
| - | 強制的にTRAINを行う命令です。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ#dotrain_数式|この項目の説明を開く]] |
| - | @EVENTTRAIN、@SHOW_STATUS、@SHOW_USERCOM、@USERCOM、@EVENTCOMEND及びそこから呼び出された関数の中でのみ使用可能です。\\ | + | |
| - | 引数で指定する番号はtrain.csvで定義した番号に対応しています。\\ | + | |
| - | 動作はコマンドが選択された場合と同じで、UP、DOWNなどの変数を初期化し、SELECTCOMに引数を代入し、@EVENTCOMが呼ばれ、@COM{SELECTCOM}が呼ばれ……という流れになります。\\ | + | |
| - | + | ||
| - | 引数が0未満であるか、TRAINNAMEの要素数以上の値であればエラーになりますが、それ以外のチェックは行われません。\\ | + | |
| - | 引数がtrain.csvで定義されていない数字でも強制的に実行しようとします。\\ | + | |
| - | また、@COM_ABLEを呼び出さず、強制的に実行されます。\\ | + | |
| - | 必要であればDOTRAINの前に以下のようなチェックを行ってください。\\ | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | SIF ( X < 0 || X >= VARSIZE(" | + | |
| - | RETURN\\ | + | |
| - | RESULT = 1\\ | + | |
| - | TRYCALLFORM COM_ABLE{X}\\ | + | |
| - | SIF RESULT == 0\\ | + | |
| - | RETURN\\ | + | |
| - | DOTRAIN X\\ | + | |
| - | | | = | | + | |
| - | 逆にDOTRAINを用いてTRAINのコマンドを独自に実装することもできます。\\ | + | |
| - | 例えばtrain.csvを空にしておき、@SHOW_USERCOMで独自に表示し、@USERCOMでDOTRAINを行います。\\ | + | |
| - | あるいはtrain.csvを空にする代わりに全ての@COM_ABLEが0を返すようにしてもよいでしょう。\\ | + | |
| - | @COM_ABLEを変更する代わりに、全ての@COM_ABLEを削除し、_replace.csvの" | + | |
| - | なお、CALLTRAINの処理の途中でDOTRAINが行われた場合、CALLTRAINの残りは無効になります。\\ | + | |
| ==== THROW < | ==== THROW < | ||
| - | 強制的にエラーとし、引数に与えた文字列でエラー表示を行う命令です。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| ===== CALL・JUMP・GOTO系 ===== | ===== CALL・JUMP・GOTO系 ===== | ||
| + | [[erabasicリファレンス_総索引|この項目の説明を開く]] | ||
| + | |||
| ===== TRYJUMP < | ===== TRYJUMP < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ===== TRYCALL < | ===== TRYCALL < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ===== TRYGOTO < | ===== TRYGOTO < | ||
| - | JUMP、CALL、GOTOと同じですが、指定した関数が存在しなくともエラーになりません。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し#trygoto_文字列|この項目の説明を開く]] |
| - | 指定した関数が存在しない場合は何もしません。\\ | + | |
| - | TRYJUMPとTRYCALLは引数を指定できます。詳しくは関数の「自作関数における引数指定」の項を参照してください。\\ | + | |
| - | なお、TRYGOTOで直接IF〜ELSEIF〜ELSE〜ENDIF内に入った場合、ELSEIF、ELSE、ENDIFの直前まで通常通り実行したあとに、ENDIFの次の行へ飛び処理を続行します。\\ | + | |
| - | また直接REPEAT〜REND内に入った場合、RENDの直前まで通常通り実行し、その後RENDを無視して次の行から処理を続行します。\\ | + | |
| - | これらの処理はGOTOや他のGOTO系命令と同様の処理です。その他のEmueraで追加されたループ・分岐構文についてはこのページの「ループ・分岐構文」「TRYC系」の項を参照してください。\\ | + | |
| ===== JUMPFORM < | ===== JUMPFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ===== CALLFORM < | ===== CALLFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ===== GOTOFORM < | ===== GOTOFORM < | ||
| - | JUMP、CALL、GOTOと同じですが、PRINTFORMなどと同じ形式で関数名を指定できます。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | =|BOX|\\ | ||
| - | CALLFORM KOJO_{NO: | ||
| - | | | = | | ||
| - | のような使い方ができます。 JUMPFORMとCALLFORMは引数を指定できます。詳しくは関数の「自作関数における引数指定」の項を参照してください。\\ | ||
| - | なお、GOTOFORMで直接ループ・分岐構文内に入った場合については「TRYGOTO」やこのページの「ループ・分岐構文」「TRYC系」の項を参照してください。\\ | ||
| ==== TRYJUMPFORM < | ==== TRYJUMPFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCALLFORM < | ==== TRYCALLFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYGOTOFORM < | ==== TRYGOTOFORM < | ||
| - | JUMP、CALL、GOTOと同じですが、PRINTFORMなどと同じ形式で関数名を指定でき、関数が存在しなくてもエラーになりません。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | TRYJUMPFORMとTRYCALLFORMは引数を指定できます。詳しくは関数の「自作関数における引数指定」の項を参照してください。\\ | + | |
| - | なお、TRYGOTOFORMで直接ループ・分岐構文内に入った場合については「TRYGOTO」やこのページの「ループ・分岐構文」「TRYC系」の項を参照してください。\\ | + | |
| ==== CALLF < | ==== CALLF < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== CALLFORMF < | ==== CALLFORMF < | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | 式中関数を返り値無視で呼び出す命令CALLF、CALLFORMF実装\\ | + | |
| - | 書式:CALLF 関数名, 引数1, ....\\ | + | |
| - | (式中関数ですが、普通の関数の引数書式で呼び出してください)\\ | + | |
| - | 内容:式中関数を通常の関数扱いで呼び出す、返り値は破棄される\\ | + | |
| - | 疑似SETTERを作りたくてやった、今は反省している\\ | + | |
| - | 当然だがRESULTやRESULTSは呼んだ式中関数内で操作していない限り、変化しない。\\ | + | |
| - | CALLEVENT <文字列>\\ | + | |
| - | イベント関数をイベント関数として呼び出します。\\ | + | |
| - | 引数を与えることはできません。\\ | + | |
| - | またイベント関数中やイベント関数から呼び出された関数中で使用することもできません。\\ | + | |
| - | | | = | | + | |
| ===== CALL・JUMP・GOTO系2 (TRYC-CATCH-ENDCATCH) ===== | ===== CALL・JUMP・GOTO系2 (TRYC-CATCH-ENDCATCH) ===== | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCJUMP < | ==== TRYCJUMP < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCCALL < | ==== TRYCCALL < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCGOTO < | ==== TRYCGOTO < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCJUMPFORM < | ==== TRYCJUMPFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCCALLFORM < | ==== TRYCCALLFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYCGOTOFORM < | ==== TRYCGOTOFORM < | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== CATCH\\ ENDCATCH ==== | ==== CATCH\\ ENDCATCH ==== | ||
| - | 拡張書式:TRYC系関数呼び出し〜CATCH〜ENDCATCH\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | (TRYC系はTRY系関数と同様の関数系が用意されてます)\\ | + | |
| - | 内容:TRYC系の関数呼び出し時に関数が見つからなかった場合の挙動を制御\\ | + | |
| - | 文法としてはIF〜ELSE〜ENDIFと同様になりました(違いは関数があった場合の処理がなくてもよいこと)\\ | + | |
| - | そのため、GOTO等の命令で直接TRYC系〜CATCH〜ENDCATCH内に入った場合、IF〜ELSEIF〜ELSE〜ENDIFと同様に\\ | + | |
| - | CATCH、ENDCATCHの直前まで通常通り実行したあとに、ENDCATCHの次の行へ飛び処理を続行します。\\ | + | |
| - | また、TRYCGOTO・TRYCGOTOFORMで直接ループ・分岐構文内に入った場合については「TRYGOTO」やこのページの「ループ・分岐構文」の項を参照してください。\\ | + | |
| - | =|BOX|\\ | ||
| - | TRYCCALL UNKNOWN_FUNC ; | ||
| - | 関数があったとき、関数処理後に行う処理(あれば、なければ省略して直CATCHでOK)\\ | ||
| - | CATCH\\ | ||
| - | 関数がなかったときに行う処理\\ | ||
| - | ENDCATCH\\ | ||
| - | | | = | | ||
| - | なお、入れ子可能です。\\ | ||
| ==== TRYCALLLIST ==== | ==== TRYCALLLIST ==== | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYJUMPLIST ==== | ==== TRYJUMPLIST ==== | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== TRYGOTOLIST ==== | ==== TRYGOTOLIST ==== | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== FUNC < | ==== FUNC < | ||
| - | 複数の関数(ラベル)を指定し、最初に見つかった関数(のみ)を呼び出すための構文です。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し#func_文字列_引数1_引数2_endfunc|この項目の説明を開く]] |
| - | TRYLIST系〜ENDFUNC内に上記の文法以外の記述をすることはできません。\\ | + | |
| - | なお、TRYGOTOLISTで直接ループ・分岐構文内に入った場合については「TRYGOTO」やこのページの「ループ・分岐構文」「TRYC系」の項を参照してください。\\ | + | |
| - | 以下のように使用します。\\ | + | |
| - | =|BOX|\\ | ||
| - | TRYCALLLIST\\ | ||
| - | FUNC 関数1\\ | ||
| - | FUNC 関数2\\ | ||
| - | ENDFUNC\\ | ||
| - | | | = | | ||
| - | FUNCで指定された関数の呼び出しを順に試み、成功すれば呼び出した後ENDFUNCへ、失敗すれば次の行のFUNC(又はENDFUNC)へ移動します。\\ | ||
| - | これは以下のスクリプトと同等です。\\ | ||
| - | =|BOX|\\ | ||
| - | TRYCCALL 関数1\\ | ||
| - | CATCH\\ | ||
| - | TRYCCALL 関数2\\ | ||
| - | CATCH\\ | ||
| - | ENDCATCH\\ | ||
| - | ENDCATCH\\ | ||
| - | | | = | | ||
| ===== RETURN系 ===== | ===== RETURN系 ===== | ||
| + | [[erabasicリファレンス_関数の定義・呼び出し# | ||
| + | |||
| ==== RETURN < | ==== RETURN < | ||
| - | eramakerからある命令ですが、返り値に定数でない変数や数式も指定できるようになりました。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | また、複数の返り値に対応しています。\\ | + | |
| - | 複数の返り値を指定した場合、先頭からRESULT: | + | |
| ==== RETURNFORM < | ==== RETURNFORM < | ||
| - | RETURNの亜種です。\\ | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 引数に指定された書式付文字列を数式として解析し、RETURNを行います。\\ | + | |
| - | 例えば、以下のようなことができます。\\ | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | A = 100\\ | + | |
| - | CALL TEST\\ | + | |
| - | PRINTFORMW RESULT == {RESULT}\\ | + | |
| - | | | = | | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | @TEST\\ | + | |
| - | STR = A * 10\\ | + | |
| - | RETURNFORM %STR%\\ | + | |
| - | | | = | | + | |
| - | RETURNと異なり、%は剰余演算子ではなく文字列式の開始とみなされるので注意してください。\\ | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | ; | + | |
| - | RETURN A % 100\\ | + | |
| - | | | = | | + | |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | ; | + | |
| - | RETURNFORM A % 100\\ | + | |
| - | | | = | | + | |
| - | また、複数の返り値に対応しています。\\ | + | |
| - | 複数の返り値を指定した場合、先頭からRESULT: | + | |
| ==== RETURNF <式> ==== | ==== RETURNF <式> ==== | ||
| - | < | + | [[erabasicリファレンス_関数の定義・呼び出し# |
| - | 詳細はユーザー定義の式中関数を参照してください。\\ | + | |
| - | 複数の返り値には対応していません。\\ | + | |
| ===== DEBUG系 ===== | ===== DEBUG系 ===== | ||
| - | DEBUG系命令はデバッグモードで起動したときのみ動作します。\\ | + | [[erabasicリファレンス_デバッグ# |
| - | 非デバッグモード時には何もしません。\\ | + | |
| - | 非デバッグモード時には引数の解析も行われないため、< | + | |
| ==== DEBUGPRINT < | ==== DEBUGPRINT < | ||
| + | [[erabasicリファレンス_デバッグ# | ||
| + | |||
| ==== DEBUGPRINTL < | ==== DEBUGPRINTL < | ||
| + | [[erabasicリファレンス_デバッグ# | ||
| + | |||
| ==== DEBUGPRINTFORM < | ==== DEBUGPRINTFORM < | ||
| + | [[erabasicリファレンス_デバッグ# | ||
| + | |||
| ==== DEBUGPRINTFORML < | ==== DEBUGPRINTFORML < | ||
| - | これらはそれぞれPRINT命令やPRINTLと同様の動作をします。\\ | + | [[erabasicリファレンス_デバッグ# |
| - | 異なる点は出力先がメインコンソールではなくデバッグコンソールである点です。\\ | + | |
| - | また、SKIPDISP命令の影響を受けず、nを使用することもできません。\\ | + | |
| ==== DEBUGCLEAR ==== | ==== DEBUGCLEAR ==== | ||
| - | デバッグコンソールのPRINT内容を全て削除します。\\ | + | [[erabasicリファレンス_デバッグ# |
| ==== ASSERT < | ==== ASSERT < | ||
| - | 引数が真(非0)のとき、何もしません。\\ | + | [[erabasicリファレンス_デバッグ# |
| - | 引数が偽(0)の時、エラーを出力してスクリプトの実行を停止します。\\ | + | |
| ===== ツールチップ系 ===== | ===== ツールチップ系 ===== | ||
| - | ボタン上にマウスカーソルを置くことにより表示されるツールチップを制御するための命令です。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | ツールチップの設定法は[[emueraリファレンス_html関連命令|Emueraリファレンス「html関連命令」]]を参照してください。\\ | + | |
| ==== TOOLTIP_SETCOLOR < | ==== TOOLTIP_SETCOLOR < | ||
| - | ツールチップの前景色及び背景色を0xRRGGBB形式の数値で設定します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定にR, | + | |
| ==== TOOLTIP_SETDELAY < | ==== TOOLTIP_SETDELAY < | ||
| - | ツールチップが表示されるまでの時間をミリ秒単位で設定します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | ディフォルトは500(ミリ秒)、最大値は32767です。\\ | + | |
| ==== TOOLTIP_SETDURATION int msDuration ==== | ==== TOOLTIP_SETDURATION int msDuration ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | =|BOX|\\ | ||
| - | ○ツールチップの表示時間を設定する命令TOOLTIP_SETDURATIONを追加\\ | ||
| - | 書式:TOOLTIP_SETDURATION [表示時間(ms)]\\ | ||
| - | 内容:ツールチップの最大表示時間を[表示時間(ms)]に設定\\ | ||
| - | 引数:[表示時間(ms)]:0以上の整数値 0の場合デフォルトの挙動になります、後タイマーの特性上極端に短い時間は想定通りに動かないかもねー\\ | ||
| - | | | = | | ||
| ===== HTML系 ===== | ===== HTML系 ===== | ||
| - | htmlっぽいタグを利用してPRINTしたりする命令・関数群です。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 詳細は[[emueraリファレンス_html関連命令|Emueraリファレンス「html関連命令」]]を参照してください。\\ | + | |
| ==== HTML_PRINT < | ==== HTML_PRINT < | ||
| - | htmlっぽいタグを利用してPRINTする命令です。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 引数がPRINTのような文字列ではなくPRINTSと同じ文字列式でり、自動的に改行するので実際はPRINTSLの動作に近いです。\\ | + | |
| - | HTML_PRINTによる描画はALIGNMENT、SETFONT、COLOR、FONTSTYLE命令とその類似命令の影響を受けません。\\ | + | |
| - | これらの効果を得るには全てタグで指定する必要があります。\\ | + | |
| - | HTML_TAGSPLIT < | + | |
| - | 対象文字列をHTML文字列と解釈し、タグと平文に分割して分割数をRESULTに、分割後文字列をRESULTSに代入します。\\ | + | |
| - | 第二、第三引数が指定されている場合、RESULT、RESULTSの代わりに指定された変数に代入します。\\ | + | |
| - | 分割処理中にエラーが生じた場合、RESULTに-1が代入されます。\\ | + | |
| - | HTML_TAGSPLITはタグの内容や対応関係の適否までは検証しません。\\ | + | |
| - | 分割数がRESULTSの配列サイズを超えた場合、超えた分はRESULTSに代入されません。\\ | + | |
| ===== AWAIT関連 ===== | ===== AWAIT関連 ===== | ||
| - | テキストボックスを経由せずに入力を行ったりするための命令・関数群です。\\ | + | [[erabasicリファレンス_総索引|この項目の説明を開く]] |
| ===== AWAIT {int time} ===== | ===== AWAIT {int time} ===== | ||
| - | ERBの実行を一時停止し、Windowsの処理を行います。\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | 引数を指定した場合、指定したミリ秒数だけ実行を待機します。\\ | + | |
| - | AWAIT命令はEmueraの無限ループ警告を中断し、Emueraのプロセスが「応答なし」になることを防ぎます。\\ | + | |
| - | 時間がかかる処理を行うときに使用して下さい。\\ | + | |
| - | ただし、AWAIT命令自体がそれなりの実行時間がかかるため、頻繁に行いすぎると遅くなります。\\ | + | |
| - | また、ユーザーを不安にしないため、例えば以下のように作業進度を逐次表示することをお勧めします。\\ | + | |
| - | =|BOX|\\ | + | |
| - | REDRAW 0\\ | + | |
| - | FOR LCNT, 0, 100\\ | + | |
| - | PRINTSL " | + | |
| - | AWAIT\\ | + | |
| - | CLEARLINE 1\\ | + | |
| - | ; | + | |
| - | NEXT\\ | + | |
| - | | | = | | + | |
| ==== GETKEY int vkey ==== | ==== GETKEY int vkey ==== | ||
| - | キーボード及びマウスボタンの状態を返します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 引数で指定されるキーが押されていれば1、押されていなければ0を返します。\\ | + | |
| - | この関数はEmueraのウインドウがアクティブのときのみ1を返し、アクティブ状態でなければキー状態にかかわらず0を返します。\\ | + | |
| - | キーコードの数値と実際のキーの対応に関してはマイクロソフト社が提供するMSDNのGetKeyState()の項を参照してください。\\ | + | |
| ==== GETKEYTRIGGERED int vkey ==== | ==== GETKEYTRIGGERED int vkey ==== | ||
| - | GETKEYと同様にキーボード及びマウスボタンの状態を返します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | GETKEYは現在押されているかどうかを取得するのに対し、GETKEYTRIGGEREDは押された直後のみ1を返します。\\ | + | |
| - | すなわち継続して押し続けている場合はGETKEYは1を返しますが、GETKEYTRIGGERDは最初のみ1を返し以降は0を返します。\\ | + | |
| - | この関数はEmueraのウインドウがアクティブのときのみ1を返し、アクティブ状態でなければキー状態にかかわらず0を返します。\\ | + | |
| - | キーコードの数値と実際のキーの対応に関してはマイクロソフト社が提供するMSDNのGetKeyState()の項を参照してください。\\ | + | |
| ==== MOUSEX ==== | ==== MOUSEX ==== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== MOUSEY ==== | ==== MOUSEY ==== | ||
| - | マウスカーソルの現在のX座標またはY座標を取得します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | 座標はクライアント領域の左下位置を(0, | + | |
| - | カーソルがクライアント領域内にある場合MOUSEYは負の値を返すことに注意してください。\\ | + | |
| - | クライアント領域の広さはCLIENTWIDTH、CLIENTHEIGHT関数によって取得できます。\\ | + | |
| - | (クライアント領域左上を基準とするY座標が必要なら、MOUSEY()+CLIENTHEIGHT()によって取得できます)\\ | + | |
| - | この関数はEmueraのウインドウがアクティブでなくても、また、マウスカーソルがウインドウ外であっても正常に動作します。\\ | + | |
| ==== ISACTIVE ==== | ==== ISACTIVE ==== | ||
| - | Emueraのウインドウの状態を返します。\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | アクティブであれば1、アクティブでなければ0を返します。\\ | + | |
| ===== 画像処理関連 ===== | ===== 画像処理関連 ===== | ||
| - | 画像処理関係の命令です。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | Gで始まるGraphics系命令は、変更可能な描画領域を操作するための命令です。\\ | + | |
| - | G系命令を使用するには描画方式にGRAPHICSまたはTEXTRENDERERを指定する必要があります。\\ | + | |
| - | 描画方式にWINAPIが指定されている場合、G系の命令は使用できずエラーになります。\\ | + | |
| - | SPRITEで始まるSprite系命令は、スプライトに関する命令です。\\ | + | |
| - | スプライトはresourcesフォルダで宣言したリソースと同様にPRINT_IMG命令などで行中に表示することもできます。\\ | + | |
| - | CBGで始まるClientBackground系命令は、クライアント領域の背景画像に関連した命令です。\\ | + | |
| - | 画像処理系の命令での色指定はRGBではなくアルファ値(不透明度)を含むARGB形式であることに注意して下さい。\\ | ||
| - | ARGB型は16進数で0xAARRGGBBで表されます。\\ | ||
| - | |||
| - | 画像処理系の命令の大半は式中で関数として呼び出すこともできます。\\ | ||
| - | 関数として呼び出した場合には、結果の値はRESULTには代入されずに戻り値となります。\\ | ||
| ==== GCREATE int ID, int width, int height ==== | ==== GCREATE int ID, int width, int height ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したサイズで指定したIDのGraphicsを作成します。\\ | + | |
| - | GraphicsのIDは0以上の整数、width、heightは1以上8192以下の間の整数値でなければなりません。\\ | + | |
| - | 引数がこの範囲を外れるとエラーです。\\ | + | |
| - | 作成に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが既に作成されている場合、0を返します。\\ | + | |
| - | Graphicsを作り直す場合はGDISPOSE命令で既存のGraphicsを廃棄してください。\\ | + | |
| ==== GCREATEFROMFILE int ID, str filepath ==== | ==== GCREATEFROMFILE int ID, str filepath ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | resourcesフォルダ内の画像ファイルを相対パスで指定し、その画像を開いてGraphicsを作成します。\\ | + | |
| - | resourcesフォルダ内のcsvファイルでリソースを宣言した場合と異なり、画像ファイルはロックされません。\\ | + | |
| - | 作成に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが既に作成されている場合はGraphicsの作成に失敗し、この命令は何もせずに0を返して終了します。\\ | + | |
| - | ファイルが存在しない、画像として認識できない、ファイルのサイズが大きすぎる、などで失敗した場合も0を返します。\\ | + | |
| ==== GDISPOSE int ID ==== | ==== GDISPOSE int ID ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsを廃棄します。\\ | + | |
| - | 廃棄に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが未作成(廃棄済の場合を含む)の場合、0を返します。\\ | + | |
| - | GCLEAR int ID, int cARGB\\ | + | |
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | |
| - | 指定したIDのGraphicsの全域を指定した色で置き換えます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | ID又は色指定が不適切な場合はエラーになります。\\ | + | |
| ==== GFILLRECTANGLE int ID, int x, int y, int width, int height ==== | ==== GFILLRECTANGLE int ID, int x, int y, int width, int height ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsに(x, | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 描画の色はGSETBRUSH命令によってあらかじめ指定しなければEmueraコンフィグの文字色で描画されます。\\ | + | |
| ==== GDRAWG int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight ==== | ==== GDRAWG int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== GDRAWG int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight, var cm ==== | ==== GDRAWG int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight, var cm ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したdestIDのGraphicsに、指定したsrcIDのGraphicsを描画します。\\ | + | |
| - | 描画先destのGraphicsの位置及びサイズを4つの整数で、描画元srcのGraphicsの位置及びサイズを4つの整数で指定します。\\ | + | |
| - | オプションとして、5x5以上の二次元数値配列をcmとして指定することでカラーマトリクスを適用して描画します。\\ | + | |
| - | colorMatrixは全要素を1/ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 描画先Graphics又は描画元Graphicsのいずれかが未作成であるなどの場合、0を返します。\\ | + | |
| - | 描画先と描画元Graphicsは同一でも実行可能です。\\ | + | |
| ==== GDRAWGWITHMASK int destID, int srcID, int maskID, int destX, int destY ==== | ==== GDRAWGWITHMASK int destID, int srcID, int maskID, int destX, int destY ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したdestIDのGraphicsに、srcIDのGraphicsを、maskIDのGraphicsをマスクとして適用して描画します。\\ | + | |
| - | 出力先destIDのGraphics内の描画位置をdestX, | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | srcIDとmaskIDの幅及び高さが完全に一致すること、描画領域がdestIDからはみ出さないことが成功の条件です。\\ | + | |
| - | マスクとして適用して描画するとは、具体的には、マスク画像の青の値を不透明度としてソース画像に適用して描画することです。\\ | + | |
| - | 例えば、マスク画像が完全に白一色(つまり全部の場所で青色がMAX)の場合、ソース画像はマスクなしの場合と同様にそのまま描画されます。\\ | + | |
| - | マスク画像が完全に黒一色(つまり全部の場所で青色が0)の場合、ソース画像は完全透明として扱われ何も起きません。\\ | + | |
| - | この命令の処理はGPUではなく、CPUがシングルスレッドで解決します。速度には期待しないでください。\\ | + | |
| ==== GDRAWSPRITE int ID, str sprName ==== | ==== GDRAWSPRITE int ID, str sprName ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== GDRAWSPRITE int ID, str sprName, int destX, int destY ==== | ==== GDRAWSPRITE int ID, str sprName, int destX, int destY ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== GDRAWSPRITE int ID, str sprName, int destX, int destY, int destWidth, int destHeight ==== | ==== GDRAWSPRITE int ID, str sprName, int destX, int destY, int destWidth, int destHeight ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== GDRAWSPRITE int ID, str sprName, int destX, int destY, int destWidth, int destHeight, var cm ==== | ==== GDRAWSPRITE int ID, str sprName, int destX, int destY, int destWidth, int destHeight, var cm ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsに指定したsprNameのSpriteを描画します。\\ | + | |
| - | オプションとして、Graphics内部の位置をdestX, | + | |
| - | また、描画幅及び高さをdestWidth, | + | |
| - | さらに、cmに5x5の行列を指定することでカラーマトリクスを適用して描画します。\\ | + | |
| - | なおSpriteのサイズはSPRITEWIDTH(str imgName), SPRITEHEIGHT(str imgName)関数で取得できます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | アニメーションスプライトを指定した場合、実行時のフレーム1つが描画されます。\\ | ||
| ==== GSETCOLOR int ID, int cARGB, int x, int y ==== | ==== GSETCOLOR int ID, int cARGB, int x, int y ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsの指定位置のピクセルを指定した色に置き換えます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | この命令はそれほど高速ではありません。\\ | + | |
| - | GGETCOLOR命令と合わせて大きな画像の全体を書き換える試みは実用的な時間内には終わりません。\\ | + | |
| ==== GSETBRUSH int ID, int cARGB ==== | ==== GSETBRUSH int ID, int cARGB ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsに指定した色のブラシを設定します。\\ | + | |
| - | 指定したブラシはGDISPOSE命令でGraphicsが破棄されるまで記憶されます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | ここで設定した色のブラシがGFILLRECTANGLE命令で使用されます。\\ | + | |
| ==== GSETFONT int ID, str fontName, int fontSize ==== | ==== GSETFONT int ID, str fontName, int fontSize ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsに指定した名前およびサイズのフォントを設定します。\\ | + | |
| - | 指定したフォントはGDISPOSE命令でGraphicsが破棄されるまで記憶されます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 設定したフォントを利用する命令・関数はバージョン1.824現在には存在しません。\\ | + | |
| ==== GSETPEN int ID, int cARGB, int penWidth ==== | ==== GSETPEN int ID, int cARGB, int penWidth ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsに指定した色及び幅のペンを設定します。\\ | + | |
| - | 指定したペンはGDISPOSE命令でGraphicsが破棄されるまで記憶されます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 設定したペンを利用する命令・関数はバージョン1.824現在には存在しません。\\ | + | |
| ==== GCREATED int ID ==== | ==== GCREATED int ID ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsが作成済みであるなら1を、未作成(廃棄済を含む)なら0を取得します。\\ | + | |
| ==== GWIDTH int ID ==== | ==== GWIDTH int ID ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== GHEIGHT int ID ==== | ==== GHEIGHT int ID ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsの幅または高さを取得します。\\ | + | |
| - | Graphicsが未作成(廃棄済を含む)なら0を返します。\\ | + | |
| ==== GGETCOLOR int ID, int x, int y ==== | ==== GGETCOLOR int ID, int x, int y ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsの指定位置の色を0xAARRGGBB形式の整数値で取得します。\\ | + | |
| - | Graphicsが未作成又は廃棄済み、あるいはx, | + | |
| - | この命令のみ、失敗した場合に0ではなく-1を返すことに注意してください。\\ | ||
| - | 黒色かつ完全透明の位置の色を取得した場合に、この命令は0を返します。\\ | ||
| ==== GSAVE int ID, int fileNo ==== | ==== GSAVE int ID, int fileNo ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 指定したIDのGraphicsの画像を、fileNoの番号を付けたファイル名でpng形式で出力し保存します。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| ==== GLOAD int ID, int fileNo ==== | ==== GLOAD int ID, int fileNo ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | fileNoの番号を付けたファイル名の画像を開き、Graphicsを作成します。\\ | + | |
| - | 動作としてはCREATEFORMFILE命令とほぼ同じですがresoucesフォルダ内の画像ではなくGSAVE命令で保存した画像から作成する点が異なります。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが既に作成されている場合はGraphicsの作成に失敗し、この命令は何もせずに0を返して終了します。\\ | + | |
| ==== SPRITECREATE str spriteName, int gID ==== | ==== SPRITECREATE str spriteName, int gID ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== SPRITECREATE str spriteName, int gID, int x, int y, int width, int height ==== | ==== SPRITECREATE str spriteName, int gID, int x, int y, int width, int height ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | gIDのGraphicsの一部または全部を元にして、spriteNameで指定したリソース名を持つスプライトを作成します。\\ | + | |
| - | (x, y, width, height)を指定することでGraphicsのその部分をスプライトとして切り取れます。\\ | + | |
| - | 作成に成功した場合、非0を返します。\\ | + | |
| - | 同じリソース名のスプライトが既に存在するなどで失敗した場合、0を返します。\\ | + | |
| - | スプライトは親GraphicsのIDと切取位置を記憶しているだけなので、親Graphicsに変更があるとスプライトも変更されます。\\ | + | |
| - | また、親Graphicsが破棄されるとスプライトも破棄された扱いになります。\\ | + | |
| - | 作成したスプライトはresoucesフォルダ内のcsvで宣言したリソースとほぼ同様に扱うことができます。\\ | + | |
| - | 例えばPRINT_IMG命令やHTML_PRINTのimgタグなどで使用できます。\\ | + | |
| ==== SPRITEANIMECREATE str spriteName, int width, int height ==== | ==== SPRITEANIMECREATE str spriteName, int width, int height ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | spriteNameで指定したリソース名を持つ、width及びheightで指定したサイズのアニメーションスプライトを作成します。 作成に成功した場合、非0を返します。\\ | + | |
| - | 同じリソース名のスプライトが既に存在するなどで失敗した場合、0を返します。\\ | + | |
| - | アニメーションさせるためにはSPRITEANIMEADDFRAME命令によってフレームを追加する必要があります。\\ | + | |
| - | アニメーションスプライトに関する注意点については、resoucesも参照してください。\\ | + | |
| ==== SPRITEANIMEADDFRAME string spriteName, int gID, int x, int y, int width, int height, int offsetx, int offsety, int delay ==== | ==== SPRITEANIMEADDFRAME string spriteName, int gID, int x, int y, int width, int height, int offsetx, int offsety, int delay ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | spriteNameで指定したリソース名を持つアニメーションスプライトにフレームを追加します。\\ | + | |
| - | gIDで指定したGraphicsの(x, | + | |
| - | アニメーションスプライトの作成時に設定したサイズの範囲から外れた部分は描画されません。\\ | + | |
| - | delayにはこのフレームを表示する時間をミリ秒単位で指定します。\\ | + | |
| - | spriteNameのリソース名が存在しない、又はアニメーションスプライトでない場合はこの命令は失敗し、何もしません。\\ | + | |
| - | フレームの追加に成功した場合1を、失敗した場合は0を返します。\\ | + | |
| ==== SPRITEDISPOSE string spriteName ==== | ==== SPRITEDISPOSE string spriteName ==== | ||
| - | spriteNameで指定したリソース名を持つスプライトを廃棄します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | 廃棄に成功した場合、非0を返します。\\ | + | |
| - | この命令はスプライトの元となったGraphics等には影響しません。\\ | + | |
| - | Graphicsに割り当てられたメモリを解放するにはGDISPOSE命令を使用してください。\\ | + | |
| ==== SPRITEGETCOLOR string spriteName, int x, int y ==== | ==== SPRITEGETCOLOR string spriteName, int x, int y ==== | ||
| - | spriteNameで指定したリソース名を持つスプライトの指定位置の色を0xAARRGGBB形式の整数値で取得します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | spriteNameが未作成又は廃棄済み、あるいはx, | + | |
| - | この命令のみ、失敗した場合に0ではなく-1を返すことに注意してください。\\ | ||
| - | 黒色かつ完全透明の位置の色を取得した場合に、この命令は0を返します。\\ | ||
| ==== SPRITECREATED str spriteName ==== | ==== SPRITECREATED str spriteName ==== | ||
| - | 指定した名称のスプライトが作成済みであるなら1を、未作成又は廃棄済みであるなら0を返します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| ==== SPRITEWIDTH str spriteName ==== | ==== SPRITEWIDTH str spriteName ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== SPRITEHEIGHT str spriteName ==== | ==== SPRITEHEIGHT str spriteName ==== | ||
| - | 指定した名称のスプライトの幅または高さを取得します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | スプライトが未作成又は廃棄済みであるなら0を返します。\\ | + | |
| ==== SPRITEPOSX str spriteName ==== | ==== SPRITEPOSX str spriteName ==== | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== SPRITEPOSY str spriteName ==== | ==== SPRITEPOSY str spriteName ==== | ||
| - | 指定した名称のスプライトの相対位置のX、Yを取得します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | スプライトが未作成又は廃棄済みであるなら0を返します。\\ | + | |
| - | 相対位置のX、Yが0なのか未作成又は廃棄済であるのかの区別には別途SPRITECREATEDを呼び出してください。\\ | + | |
| ==== SPRITESETPOS str spriteName, int posx, int posy ==== | ==== SPRITESETPOS str spriteName, int posx, int posy ==== | ||
| - | 指定した名称のスプライトの相対位置のX、Yを設定します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| ==== SPRITEMOVE str spriteName, int movex, int movey ==== | ==== SPRITEMOVE str spriteName, int movex, int movey ==== | ||
| - | 指定した名称のスプライトの相対位置のX、Yに指定した値を加算します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | つまり、\\ | + | |
| - | =|BOX|\\ | ||
| - | SPRITESETPOS spriteName, SPRITEPOSX(spriteName) + movex, SPRITEPOSY(spriteName) + movey\\ | ||
| - | | | = | | ||
| - | と同等です。\\ | ||
| ==== CBGSETG int ID, int x, int y, int zdepth ==== | ==== CBGSETG int ID, int x, int y, int zdepth ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | IDで指定するGraphicsをクライアント領域に表示するように設定します。\\ | + | |
| - | (x, y)に0を指定した場合、クライアント領域の左下と画像の左下が一致するように表示されます。\\ | + | |
| - | xは右方向が正、yは下方向が正、zdepthは画面奥方向が正です。\\ | + | |
| - | zdepthは0以外の値を指定します。通常の文字描画がzdepth==0に相当し、zdepthが負であれば文字よりも手前に描画されます。\\ | + | |
| ==== CBGSETSPRITE str spriteName, int x, int y, int zdepth ==== | ==== CBGSETSPRITE str spriteName, int x, int y, int zdepth ==== | ||
| - | spriteNameで指定したリソース名を持つスプライトをクライアント領域に表示するように設定します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | (x, y)に0を指定した場合、クライアント領域の左下と画像の左下が一致するように表示されます。\\ | + | |
| - | xは右方向が正、yは下方向が正、zdepthは画面奥方向が正です。\\ | + | |
| - | zdepthは0以外の値を指定します。通常の文字描画がzdepth==0に相当し、zdepthが負であれば文字よりも手前に描画されます。\\ | + | |
| ==== CBGCLEAR ==== | ==== CBGCLEAR ==== | ||
| - | CBGで始まる各種CBG系命令で設定した背景画像の設定を全て解除します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| ==== CBGCLEARBUTTON ==== | ==== CBGCLEARBUTTON ==== | ||
| - | CBGSETBUTTONSPRITE命令で設定したボタンの設定を解除します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| ==== CBGREMOVERANGE int zmin, int zmax ==== | ==== CBGREMOVERANGE int zmin, int zmax ==== | ||
| - | CBGSETG、CBGSETSPRITE、CBGSETBUTTONSPRITE命令で設定した画像のうち、Z深度がzmin以上zmax以下である画像を設定解除します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| ==== CBGREMOVEBMAP ==== | ==== CBGREMOVEBMAP ==== | ||
| - | CBGSETBMAPG命令で設定したボタンマップの設定を解除します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| ==== CBGSETBMAPG int ID ==== | ==== CBGSETBMAPG int ID ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | IDで指定するGraphicsをクライアント領域のボタンマップとして設定します。\\ | + | |
| - | ここで設定したボタンマップはCBGSETBUTTONSPRITE命令及びINPUTMOUSEKEY命令に影響します。\\ | + | |
| - | ボタンマップ画像は表示はされませんがCBGSETG命令で設定した画像と同様に画面左下と画像左下位置が一致するように配置されます。\\ | + | |
| - | マウスカーソル直下のボタンマップ画像の色が、ボタンの値として認識されます。\\ | + | |
| - | ただし、色のアルファ値が255でない(透明又は半透明である)ときにはボタンの値としては認識されません。\\ | + | |
| ==== CBGSETBUTTONSPRITE int button, str spriteName, str spriteNameB, | ==== CBGSETBUTTONSPRITE int button, str spriteName, str spriteNameB, | ||
| + | [[erabasicリファレンス_画像・html表示# | ||
| + | |||
| ==== CBGSETBUTTONSPRITE int button, str spriteName, str spriteNameB, | ==== CBGSETBUTTONSPRITE int button, str spriteName, str spriteNameB, | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | CBGSETBMAPG命令で設定したボタンマップと連動して選択可能なボタンを設定します。\\ | + | |
| - | マウス直下のボタンマップ画像の色の0xRRGGBB値が、引数buttonに等しい時に表示されるスプライトをspriteNameB、それ以外のときに表示されるスプライトをspriteNameに指定します。\\ | + | |
| - | spriteName又はspriteNameBは空文字列を指定することができ、そうした場合には非選択中又は選択中に何も表示しません。\\ | + | |
| - | x, y, zdepthについてはCBGSETSPRITEと同じです。基準位置(x, | + | |
| - | オプションで当該ボタンを選択中に表示されるツールチップ文字列をtooltipmesで指定することができます。\\ | + | |
| - | 同じbuttonの値に複数のCBGSETBUTTONSPRITEを割り当てることができ、また、ボタンの位置と一致する必要はありません。\\ | + | |
| - | そうした場合、ツールチップについては画像のxy位置とは関係なく、ツールチップ文字列が設定された中で最もzdepthが大きいもの(最先に描画され、最奥に見えるもの)の表示が優先されます。\\ | + | |
| - | spriteNameで指定したリソース名を持つスプライトをクライアント領域に表示するように設定します。\\ | + | |
| - | (x, y)に0を指定した場合、クライアント領域の左下と画像の左下が一致するように表示されます。\\ | + | |
| - | xは右方向が正、yは下方向が正、zdepthは画面奥方向が正です。\\ | + | |
| - | zdepthは0以外の値を指定します。通常の文字描画がzdepth==0に相当し、zdepthが負であれば文字よりも手前に描画されます。\\ | + | |
| ==== SETANIMETIMER int time ==== | ==== SETANIMETIMER int time ==== | ||
| - | アニメーションスプライト用にミリ秒単位で再描画間隔を指定します。\\ | + | [[erabasicリファレンス_画像・html表示# |
| - | Emueraは通常はINPUT等の入力待ち中に再描画を行いません。\\ | + | |
| - | この命令で再描画間隔を設定することでINPUT等の入力待ち中に画像をアニメーションさせることができます。\\ | + | |
| - | なお、TINPUTなどの時間切れ処理のある命令中には再描画を行いません。\\ | + | |
| - | 実際の描画間隔はコンピュータの状態により、指定した時間よりもやや遅れます。\\ | + | |
| - | したがって描画間隔をアニメーションのdelayの値と同じ値にすると頻繁にフレームが飛ぶことになります。\\ | + | |
| - | delayよりも十分に短い間隔を指定してください。\\ | + | |
| - | この命令はコンフィグの「フレーム毎秒」の項目とは無関係です。\\ | ||
| - | また、REDRAW命令による再描画抑止の効果を受けません。\\ | ||
| ===== 未整理項目 ===== | ===== 未整理項目 ===== | ||
| + | [[erabasicリファレンス_文字表示・入力# | ||
| + | |||
| ==== CLEARTEXTBOX ==== | ==== CLEARTEXTBOX ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_文字表示・入力# |
| - | =|BOX|\\ | ||
| - | ○入力欄を空にする命令CLEARTEXTBOX追加\\ | ||
| - | 書式:CLEARTEXTBOX\\ | ||
| - | 内容:最下部の入力欄のテキストを全て消去する\\ | ||
| - | | | = | | ||
| ===== STRDATA ===== | ===== STRDATA ===== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_データ操作・保存# |
| - | =|BOX|\\ | ||
| - | ○PRINTDATAの非表示、選択文字列返し版STRATA追加\\ | ||
| - | 書式:STRDATA < | ||
| - | DATA、DATAFORM、DATALIST〜ENDATA\\ | ||
| - | ENDDATA\\ | ||
| - | 内容:DATA構文で指定された文字列からランダムで1つを返す\\ | ||
| - | DATALIST構文中のDATA系は改行文字で連結して返されます\\ | ||
| - | | | = | | ||
| ===== STOPCALLTRAIN ===== | ===== STOPCALLTRAIN ===== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_ゲームの実行・処理の流れ# |
| - | + | ||
| - | =|BOX|\\ | + | |
| - | ○CALLTRAIN命令のフローをスクリプトから強制終了するSTOPCALLTRAIN追加\\ | + | |
| - | 書式:STOPCALLTRAIN\\ | + | |
| - | 内容:CALLTRAIN命令が動いている間に呼び出されると、その時点でCALLTRAINの処理を終了する\\ | + | |
| - | それ以外の場合は何もしない\\ | + | |
| - | | | = | | + | |
emueraリファレンス_命令.1782969138.txt.gz · 最終更新: by 127.0.0.1
