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リファレンス]]に統合しました。 |
| - | このページで解説する文法は必須ではありません。\\ | + | |
| - | ERBで出来る全てのことは「式中で使える関数」を使わなくとも(スクリプトが多少長くなるだけで)実行できます。\\ | + | |
| - | いままでの文法に不便を感じないのであれば「式中で使える関数」を使用する必要はありません。\\ | + | |
| - | 「式中で使える関数」はEmuera ver 1.712で追加された新しい文法です。\\ | + | [[erabasicリファレンス|リファレンストップ]] · [[erabasicリファレンス_総索引|名前の総索引]] |
| - | これは多くのプログラミング言語で単に「関数」と呼ばれるものです。\\ | + | |
| - | eramaker basicでは@〜〜で定義しCALLで呼び出すものを「関数」と呼んでいるため、Emueraでは新しい「関数」を「式中で使える関数」と呼びます。\\ | + | |
| - | 以下、誤解がない場合には「式中で使える関数」を単に関数と呼びます。\\ | + | |
| - | また、他のページでは「式中で使える関数」を略して「式中関数」と呼ぶことがあります。\\ | + | ====== |
| - | しかし、他のプログラミング言語における式中関数(匿名関数)やインライン関数とは無関係です。\\ | + | [[erabasicリファレンス_組み込み式中関数#式中関数の使い方・引数の読み方|この項目の説明を開く]] |
| - | 組み込み関数ではない、ERB中で定義して使う「式中で使える関数」については[[emueraリファレンス_ユーザー定義の式中関数|Emueraリファレンス_ユーザー定義の式中関数]]を参照してください。\\ | + | |
| - | + | ||
| - | 「式中で使える関数」は以下のように使います。\\ | + | |
| - | + | ||
| - | A = ABS(A)\\ | + | |
| - | IF STRLENS(STR: | + | |
| - | LOCALS:0 = %SUBSTRING(STR: | + | |
| - | ENDIF\\ | + | |
| - | これは、\\ | + | |
| - | Aの絶対値を求めてAに代入し、\\ | + | |
| - | STR: | + | |
| - | LOCALS: | + | |
| - | というスクリプトです。\\ | + | |
| - | 上記のスクリプトは以下のように「式中で使える関数」を使わない形で置き換えることができます。\\ | + | |
| - | + | ||
| - | ABS A\\ | + | |
| - | A = RESULT\\ | + | |
| - | STRLENS STR:0\\ | + | |
| - | IF RESULT > A\\ | + | |
| - | SUBSTRING STR:0, A, 1\\ | + | |
| - | LOCALS:0 = %RESULTS: | + | |
| - | ENDIF\\ | + | |
| - | RESULTとRESULTSに中間の値が代入されることを除けば、上と全く同じ動作をします。\\ | + | |
| ===== 凡例 ===== | ===== 凡例 ===== | ||
| - | 以下の解説における記号の説明です。\\ | + | [[erabasicリファレンス_組み込み式中関数#凡例|この項目の説明を開く]] |
| - | 例えば、\\ | + | |
| - | + | ||
| - | int STRLENS(str s)\\ | + | |
| - | str SUBSTRING(str s, int start = 0, int length = -1)\\ | + | |
| - | などのうち、最初のintやstrは戻り値の型を表します。\\ | + | |
| - | intであれば整数型、strであれば文字列型です。\\ | + | |
| - | 以下のスクリプトは1行目は正常に動作しますが、2行目はエラーになります。\\ | + | |
| - | A = STRLENS(" | + | |
| - | A = SUBSTRING(" | + | |
| - | SUBSTRINGの戻り値はstr、つまり文字列型なので、整数型の変数Aに代入することはできません。 文字列型を返す関数は代入こそできないものの、その他の点では文字列変数と同じように扱うことができます。\\ | + | |
| - | STR = %SUBSTRING(" | + | |
| - | 次のSTRLENSやSUBSTRINGが関数の名前になります。\\ | + | |
| - | + | ||
| - | ()の中の文字、" | + | |
| - | 引数が複数ある場合は, | + | |
| - | + | ||
| - | 引数の最初の単語は引数の型です。\\ | + | |
| - | STRLENSの引数は文字列型(str)です。\\ | + | |
| - | SUBSTRINGは第1引数が文字列型(str)、第2引数と第3引数が整数型(int)です。\\ | + | |
| - | その次のstrやstart、lengthといった単語は引数の名前です。\\ | + | |
| - | 引数の名前は解説文の中で使うための便宜上の名前であり、特に意識する必要はありません。\\ | + | |
| - | + | ||
| - | 引数の名前の後ろの = 0 などはその引数が省略可能であることと、省略した場合のディフォルト値を表します。\\ | + | |
| - | 以下のスクリプトはどの行も全て同じ意味になります。\\ | + | |
| - | + | ||
| - | STR = SUBSTRING(RESULTS)\\ | + | |
| - | STR = SUBSTRING(RESULTS, | + | |
| - | STR = SUBSTRING(RESULTS, | + | |
| - | STR = SUBSTRING(RESULTS, | + | |
| - | 引数の省略の際に最後の引数ではなく途中の引数を省略する場合はSUBSTRING(RESULTS, | + | |
| - | ただし、どの引数を省略されたかが明らかな場合は不要です。\\ | + | |
| - | 以下のスクリプトはどの行も全て同じ意味になります。\\ | + | |
| - | ;int RAND(int min = 0, int max)\\ | + | |
| - | A = RAND(100)\\ | + | |
| - | A = RAND( , 100)\\ | + | |
| - | A = RAND(0, 100)\\ | + | |
| - | そのほか、\\ | + | |
| - | + | ||
| - | int GETTIME()\\ | + | |
| - | は引数が無いことを表しています。この場合でもGETTIME()のように()は必須です(変数と区別するためです)\\ | + | |
| - | int FINDCHARA(var key, ? value, int start = 0)\\ | + | |
| - | のうち、varは変数型を表します。ここにはTALENTなど変数を渡します。\\ | + | |
| - | ? | + | |
| - | FINDCHARAでは第1引数に指定した変数によって第2引数に渡すべき型が変わります。\\ | + | |
| - | + | ||
| - | int MAX(int n, int m...)\\ | + | |
| - | は引数がいくつでも良いことを表しています。\\ | + | |
| - | + | ||
| - | M = MAX(A, B, C, D, E, F, G)\\ | + | |
| - | はA〜Gの中で一番大きい数字をMに代入します。\\ | + | |
| ===== 組み込み関数 ===== | ===== 組み込み関数 ===== | ||
| - | 基本的に同名の命令と同じ動作をしますが、RESULTやRESULTSへの代入は行われません。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | また、一部には同名の命令と仕様が違うものがあります。\\ | + | |
| - | 組み込み関数ではない、ERB中で定義して使う「式中で使える関数」については[[emueraリファレンス_ユーザー定義の式中関数|Emueraリファレンス_ユーザー定義の式中関数]]を参照してください。\\ | + | |
| ==== int GETCHARA(int no) ==== | ==== int GETCHARA(int no) ==== | ||
| - | 現在所有しているキャラの中にそのキャラがいるかを判定し、いればリスト上での位置(登録番号)を、いなければ-1を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | リスト全体から特定のキャラの有無を確認したい場合に使えます。\\ | + | |
| ==== int FINDCHARA(var key, ? value, int start = 0, int end = ※) ==== | ==== int FINDCHARA(var key, ? value, int start = 0, int end = ※) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int FINDLASTCHARA(var key, ? value, int start = 0, int end = ※) ==== | ==== int FINDLASTCHARA(var key, ? value, int start = 0, int end = ※) ==== | ||
| - | キャラクタ変数keyとその値valueを指定し、変数がその値であるキャラクタの登録番号を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 見つからなかった場合は-1を返します。\\ | + | |
| - | 複数見つかった場合、FINDCHARAは最初にヒットしたキャラを、\\ | + | |
| - | FINDLASTCHARAは最後にヒットしたキャラを結果とします。\\ | + | |
| - | start以上end未満の登録番号のキャラを検索範囲とします。\\ | + | |
| - | endを省略した場合、start以降のすべてキャラが検索範囲です。\\ | + | |
| - | ただし、検索範囲がキャラクタ数の範囲を超える場合はエラーとなります。\\ | + | |
| - | X = -1\\ | ||
| - | WHILE 1\\ | ||
| - | X = FINDCHARA(CFLAG: | ||
| - | SIF X < 0\\ | ||
| - | BREAK\\ | ||
| - | PRINTFORML %NAME: | ||
| - | WEND\\ | ||
| - | 上記のスクリプトはCFLAG: | ||
| - | キャラクタ変数はNOのような非配列変数でも、NAMEのような文字列変数でもかまいません。\\ | ||
| - | 変数に文字列型変数を指定した場合、第2引数valueも文字列型でなければなりません。\\ | ||
| ==== str CSVNAME(int no) ==== | ==== str CSVNAME(int no) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== str CSVCALLNAME(int no) ==== | ==== str CSVCALLNAME(int no) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== str CSVNICKNAME(int no) ==== | ==== str CSVNICKNAME(int no) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== str CSVMASTERNAME(int no) ==== | ==== str CSVMASTERNAME(int no) ==== | ||
| - | CSVで定義されたNAME、CALLNAME、NICKNAME、MASTERNAMEを直接呼び出す関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 第一引数noがキャラ番号(NOの方)です。\\ | + | |
| ==== str CSVCSTR(int no, int index) ==== | ==== str CSVCSTR(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVBASE(int no, int index) ==== | ==== int CSVBASE(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVABL(int no, int index) ==== | ==== int CSVABL(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVTALENT(int no, int index) ==== | ==== int CSVTALENT(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVMARK(int no, int index) ==== | ==== int CSVMARK(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVEXP(int no, int index) ==== | ==== int CSVEXP(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVRELATION(int no, int index) ==== | ==== int CSVRELATION(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVJUEL(int no, int index) ==== | ==== int CSVJUEL(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVEQUIP(int no, int index) ==== | ==== int CSVEQUIP(int no, int index) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CSVCFLAG(int no, int index) ==== | ==== int CSVCFLAG(int no, int index) ==== | ||
| - | CSVで定義された値を直接呼び出す関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 第一引数noがキャラ番号、第二引数indexが各変数のインデックスです。\\ | + | |
| - | CSVCSTRの戻り値は文字列型、その他は整数型です。\\ | + | |
| ==== int EXISTCSV(int no) ==== | ==== int EXISTCSV(int no) ==== | ||
| - | 対応するキャラが定義されているかどうかをチェックします。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 定義されていれば1、されていなければ0を返します。\\ | + | |
| - | ADDCHARA noがエラーにならずに実行できるかどうかを調べることができます。\\ | + | |
| ==== int GETNUM(var key, str name) ==== | ==== int GETNUM(var key, str name) ==== | ||
| - | 各csvで定義されている名称からその数値を取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数#int_getnum_var_key_str_name|この項目の説明を開く]] |
| - | 例えば、abl.csvで" | + | |
| - | 定義されていない場合は-1を返します。\\ | + | |
| - | csvと変数の対応はEmueraの拡張文法#一般のページの「文字列による配列変数の要素の指定」に準じます。\\ | + | |
| ==== int STRLENS(str s) ==== | ==== int STRLENS(str s) ==== | ||
| - | 引数strに指定された文字列の長さを測定し、返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 長さはSHIFT-JISでのバイト数です。つまり全角文字を2文字と数えます。\\ | + | |
| ==== int STRLENSU(str s) ==== | ==== int STRLENSU(str s) ==== | ||
| - | 引数strに指定された文字列の長さを測定し、返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 長さは単純に文字の数です。つまり全角文字も1文字と数えます。\\ | + | |
| ==== str SUBSTRING(str s, int start = 0, int length = -1) ==== | ==== str SUBSTRING(str s, int start = 0, int length = -1) ==== | ||
| - | sに指定された文字列の部分文字列を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | startが0でない場合、指定された位置以降の文字列を返します。\\ | + | |
| - | lengthが負の値でない場合、指定された長さの文字列を返します。\\ | + | |
| - | いずれもSHIFT-JISでのバイト数です。つまり全角文字を2文字と数えます。\\ | + | |
| ==== str SUBSTRINGU(str s, int start = 0, int length = -1) ==== | ==== str SUBSTRINGU(str s, int start = 0, int length = -1) ==== | ||
| - | SUBSTRINGのUnicode版です。違いは全角文字も1文字と数えることです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== str CHARATU(str s, int position = 0) ==== | ==== str CHARATU(str s, int position = 0) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 文字列中の任意の文字数目の文字を取得する式中関数CHARATU追加\\ | ||
| - | 書式:CHARATU(< | ||
| - | 内容:文字列の指定した位置の文字を取得する\\ | ||
| - | 処理系はユニコードとなります\\ | ||
| ==== int STRFIND(str str, str find, int start = 0) ==== | ==== int STRFIND(str str, str find, int start = 0) ==== | ||
| - | 同名の命令とほぼ同じです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | strの中からfindの文字列を探し、見つかった場所の0から始まるインデックスを返します。\\ | + | |
| - | インデックスは全角文字を2文字と数えます。\\ | + | |
| - | 見つからなかった場合、-1を返します。\\ | ||
| - | startが指定された場合、startで指定されたインデックスから検索を開始します。\\ | ||
| - | startが指定されても、戻り値はstartからのインデックスではなく、全体のインデックスであることに注意してください。\\ | ||
| - | 例えば以下のような結果になります。\\ | ||
| - | |||
| - | PRINTFORML {STRFIND(" | ||
| - | PRINTFORML {STRFIND(" | ||
| - | ; | ||
| - | 1\\ | ||
| - | 4\\ | ||
| ==== int STRFINDU(str str, str find, int start = 0) ==== | ==== int STRFINDU(str str, str find, int start = 0) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | STRFINDのユニコード版STRFINDU実装\\ | ||
| - | 書式:STRFINDU(< | ||
| - | 内容:STRFINDのユニコード版、返り値の文字の位置と開始インデックスがユニコードでのカウントになっている\\ | ||
| ==== int STRCOUNT(str input, str match) ==== | ==== int STRCOUNT(str input, str match) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 文字列中の指定部分文字列の数を取得する命令STRCOUNT追加\\ | ||
| - | 書式:STRCOUNT < | ||
| - | > STRCOUNT(< | ||
| - | 返り値、ヒットした数\\ | ||
| - | ちなみに内部的には正規表現処理なので、検索文字列の書式はC# | ||
| ==== str UNICODE(int value) ==== | ==== str UNICODE(int value) ==== | ||
| - | 引数の値に対応したunicodeの文字を返す命令です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 例えば、以下のスクリプトは白抜きのハートマークを10個表示します。\\ | + | |
| - | ただし、この関数ではサロゲートペアを扱うことはできません。\\ | + | |
| - | また、フォントが対応していなければ表示できません。\\ | + | |
| - | + | ||
| - | UNICODE 0x2661\\ | + | |
| - | PRINTFORMW %UNICODE(0x2661) * 10%\\ | + | |
| - | なお、EmueraのUnicode対応は完全ではないことに注意してください。\\ | + | |
| - | 例えばEmueraはサロゲートペアを使用した場合、正確な動作は保証できません。\\ | + | |
| ==== int ENCODETOUNI(str value, int position = 0) ==== | ==== int ENCODETOUNI(str value, int position = 0) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | ENCODETOUNIの式中関数版を追加\\ | ||
| - | 書式:ENCODETOUNI(< | ||
| - | 内容:文字列の対象位置の文字をユニコードのコード値に変換して返す\\ | ||
| - | 位置は省略可でその場合は0(先頭)を対象とします\\ | ||
| ==== str STRJOIN(var array, {str separator = ",", | ==== str STRJOIN(var array, {str separator = ",", | ||
| - | 第一引数arrayの要素の内、start以上end未満の範囲の要素全てを結合した一つの文字列を返り値として返す式中間数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 要素同士を結合する際に、第二引数separatorがその間に加えられて結合されます。\\ | + | |
| - | 他の言語の同一の処理同様に、第二引数省略時は「, | + | |
| ==== str REPLACE(str source, str match, str newvalue) ==== | ==== str REPLACE(str source, str match, str newvalue) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 文字列置換命令REPLACE実装\\ | ||
| - | 書式:REPLACE(< | ||
| - | 内容:置換対象文字列を置換対象パターンで検索し、ヒットしたら置換後の文字列で置き換える\\ | ||
| - | 内部処理は思いっきり正規表現です。第2引数はC# | ||
| - | そのため、()や[]、$、/ | ||
| ==== str ESCAPE(str value) ==== | ==== str ESCAPE(str value) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 文字列を正規表現用にエスケープする式中関数ESCAPEを追加\\ | ||
| - | 書式:ESCAPE([文字列])\\ | ||
| - | 内容:文字列が正規表現中で平文となるように、引数中の文字列の正規表現メタ文字をエスケープして返す\\ | ||
| ==== int VARSIZE(str name, int dim = 0) ==== | ==== int VARSIZE(str name, int dim = 0) ==== | ||
| - | 同名の命令と少し挙動が違います。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | nameで指定した変数の配列のサイズ(要素数)を返します。\\ | + | |
| - | 同名の命令と異なり、\\ | + | |
| - | X = VARSIZE(" | ||
| - | のような形で文字列として指定する必要があります。\\ | ||
| - | また、DITEMTYPEやTAなどの多次元配列変数のサイズを取得する場合、第2引数により次元を指定する必要があります(一番左の要素から順に、0, | ||
| - | 多次元配列変数の要素数を一度に取得する場合についてはVARSIZE命令の方を用いてください。\\ | ||
| ==== int GETTIME() ==== | ==== int GETTIME() ==== | ||
| - | 同名の命令がRETURNに代入する値と同じです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 現在の日時・時刻を数値で返します。\\ | + | |
| - | 現在日時が2009年3月28日13時5分23秒678ミリ秒であれば、" | + | |
| ==== str GETTIMES() ==== | ==== str GETTIMES() ==== | ||
| - | 同名の命令がRETURNSに代入する値と同じです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 現在の日時・時刻を文字列で返します。\\ | + | |
| - | 現在日時が2009年3月28日13時5分23秒678ミリ秒であれば、" | + | |
| ==== int GETMILLISECOND() ==== | ==== int GETMILLISECOND() ==== | ||
| - | 西暦0001年1月1日からの経過時間をミリ秒単位で返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | GETTIME()の結果と異なり単純な加減算ができるので経過時間などを調べるには適しています。\\ | + | |
| ==== int GETSECOND() ==== | ==== int GETSECOND() ==== | ||
| - | 西暦0001年1月1日からの経過時間を秒単位で返します。 GETTIME()の結果と異なり単純な加減算ができるので経過時間などを調べるには適しています。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int CHKFONT(str fontname) ==== | ==== int CHKFONT(str fontname) ==== | ||
| - | 引数の名前のフォントがインストールされていれば1を、されていなければ0を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | SETFONTの前に呼んでください。\\ | + | |
| ==== int POWER(int x, int y) ==== | ==== int POWER(int x, int y) ==== | ||
| - | 同名の命令とほぼ同じです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | xのy乗を返します。\\ | + | |
| ==== int RAND(int min = 0, int max) ==== | ==== int RAND(int min = 0, int max) ==== | ||
| - | 同名の変数とほぼ同じです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | RAND(X)はRAND: | + | |
| - | 乱数生成器は全く同じで、RANDOMIZEやINITRANDによって乱数を制御できます。\\ | + | |
| - | RAND関数では2つの引数を指定することができ、2つ指定された場合は1つ目の引数が乱数の最小値として使われます。\\ | + | |
| - | この関数は0〜18446744073709551615(2の64乗-1)の間で生成した乱数をmax-minで割った余りにminを加えて返します。\\ | + | |
| - | したがって、maxはminより大きい(同じではだめ)値である必要があります。\\ | + | |
| - | max-minが符号付64ビット整数(9223372036854775807)の最大値を超える場合にエラーになります。\\ | + | |
| - | また、max-minが非常に大きい場合(1京くらい?)、余りを求める方法による偏りが無視できなくなります。\\ | + | |
| ==== int ABS(int n) ==== | ==== int ABS(int n) ==== | ||
| - | 指定された数値の絶対値を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int SIGN(int n) ==== | ==== int SIGN(int n) ==== | ||
| - | 指定された数値の符号を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 負の値なら-1、0なら0、正の値なら1を返します。\\ | + | |
| ==== int MAX(int n, int m...) ==== | ==== int MAX(int n, int m...) ==== | ||
| - | 指定された数値のうち、最大の数値を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 引数は1つ以上、いくつでも指定できます。\\ | + | |
| ==== int MIN(int n, int m...) ==== | ==== int MIN(int n, int m...) ==== | ||
| - | 指定された数値のうち、最小の数値を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 引数は1つ以上、いくつでも指定できます。\\ | + | |
| ==== int LIMIT(int value, int min, int max) ==== | ==== int LIMIT(int value, int min, int max) ==== | ||
| - | valueの値を返します。ただし、valueがminより小さいならminを、maxより大きいならmaxを返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 例えばAに X - Y を代入したいが、代入後の値が0以上100以下であってほしい場合、通常は以下のように書きます。\\ | + | |
| - | A = X - Y\\ | ||
| - | SIF A < 0\\ | ||
| - | A = 0\\ | ||
| - | SIF A > 100\\ | ||
| - | A = 100\\ | ||
| - | LIMIT関数を使うとこれを一行にまとめることができます。\\ | ||
| - | A = LIMIT(X - Y, 0, 100)\\ | ||
| ==== int INRANGE(int value, int min, int max) ==== | ==== int INRANGE(int value, int min, int max) ==== | ||
| - | valueの値がmin以上max以下であれば1を、valueがminより小さい、またはmaxより大きいなら0を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int SQRT(int n) ==== | ==== int SQRT(int n) ==== | ||
| - | 指定された数値の平方根を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 端数は切り捨てます。\\ | + | |
| ==== int GETBIT(int n, int m) ==== | ==== int GETBIT(int n, int m) ==== | ||
| - | 指定された数値nのm番目のビットを返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | mに指定できる値は0〜63までで、範囲外の数値を指定するとエラーになります。\\ | + | |
| - | mが定数の場合、例えば5であれば、\\ | + | |
| - | A = GETBIT(X, 5)\\ | ||
| - | B = (X & 1p5) != 0\\ | ||
| - | AとBは同じ結果になります。\\ | ||
| ==== int CBRT(int value) ==== | ==== int CBRT(int value) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int LOG(int value) ==== | ==== int LOG(int value) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int LOG10(int value) ==== | ==== int LOG10(int value) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int EXPONENT(int value) ==== | ==== int EXPONENT(int value) ==== | ||
| - | 以下、私家改造版更新履歴より\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 数学関数を式中関数として追加\\ | ||
| - | CBRT(三重根)\\ | ||
| - | LOG(自然関数)\\ | ||
| - | LOG10(常用対数)\\ | ||
| - | EXPONENT(指数関数)\\ | ||
| - | 書式は全部:関数名(引数)\\ | ||
| - | Emueraでは小数を扱うことができないため、使用の際には工夫を必要とします。\\ | ||
| ==== str GETFONT() ==== | ==== str GETFONT() ==== | ||
| - | 現在使用しているフォントの名前を取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | これはSETFONT命令で指定した名前と同じです。\\ | + | |
| - | SETFONT命令が行われていない時はemuera.configで指定されている標準のフォントの名前を取得します。\\ | + | |
| ==== int GETCOLOR() ==== | ==== int GETCOLOR() ==== | ||
| - | 現在使用している文字色コードを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 戻り値は16進数で0xRRGGBBとなります。\\ | + | |
| - | 例えばオレンジ色(R, | + | |
| - | 色と数字の対応はweb colorについて解説しているWebサイトを参考にするとよいでしょう。\\ | + | |
| - | 1.731での変更により、SETCOLOR命令もSETCOLOR 0xFF8000のような形式で指定できるようになりました。\\ | + | |
| ==== int GETDEFCOLOR() ==== | ==== int GETDEFCOLOR() ==== | ||
| - | コンフィグで指定している文字色コードを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== int GETBGCOLOR() ==== | ==== int GETBGCOLOR() ==== | ||
| - | 現在使用している背景色コードを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== int GETDEFBGCOLOR() ==== | ==== int GETDEFBGCOLOR() ==== | ||
| - | コンフィグで指定している背景色コードを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== int GETFOCUSCOLOR() ==== | ==== int GETFOCUSCOLOR() ==== | ||
| - | コンフィグで指定している選択中文字色コードを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 基本的な仕様はGETCOLORと同様です。\\ | + | |
| ==== int GETSTYLE() ==== | ==== int GETSTYLE() ==== | ||
| - | 現在のフォントのスタイル(太字、斜線など)を取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | これはSETSTYLE命令で指定した値と同じです。\\ | + | |
| - | SETSTYLE命令が行われていない時は0を返します。\\ | + | |
| ==== str CURRENTALIGN() ==== | ==== str CURRENTALIGN() ==== | ||
| - | 現在のALIGNMENTを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 返値はALIGNMENT命令で指定した文字列と同じです(大文字)。\\ | + | |
| - | ALIGNMENT命令が行われていない時は初期値のLEFTを返します。\\ | + | |
| ==== int CURRENTREDRAW() ==== | ==== int CURRENTREDRAW() ==== | ||
| - | 現在のREDRAW状態を取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 返値は通常時は1、REDRAW命令を用いて描画を抑制した時は0になります。\\ | + | |
| ==== str TOSTR(int value, str format = "" | ==== str TOSTR(int value, str format = "" | ||
| - | 数値を文字列に変換する命令です。\\ | + | [[erabasicリファレンス_組み込み式中関数#str_tostr_int_value_str_format|この項目の説明を開く]] |
| - | 変換したい数字を第一引数に、変換の書式を文字列で第二引数に指定します。\\ | + | |
| - | 第二引数は省略できますが、省略した場合はPRINTFORMの{}内などと同じように単に文字列になります。\\ | + | |
| - | この関数は内部でC#のInt64.ToString()関数を呼んでおり、C# | + | |
| - | A = 438765\\ | ||
| - | PRINTSL TOSTR(A)\\ | ||
| - | PRINTSL TOSTR(A, " | ||
| - | PRINTSL TOSTR(A, " | ||
| - | PRINTSL TOSTR(A, " | ||
| - | PRINTSL TOSTR(A, " | ||
| - | PRINTSL TOSTR(A, " | ||
| - | < | ||
| - | < | ||
| - | PRINTSL TOSTR(A, " | ||
| - | |||
| - | ; | ||
| - | 438765 // | ||
| - | 6b1ed //" | ||
| - | 6B1ED //" | ||
| - | 00438765 //" | ||
| - | 0006B1ED //" | ||
| - | 00438765 //" | ||
| - | < | ||
| - | < | ||
| - | 0043万8765 //" | ||
| - | 第二引数が適切でない場合、エラーになります。\\ | ||
| - | これ以上の詳細はC# | ||
| ==== int GETPALAMLV(int value, int maxLV) ==== | ==== int GETPALAMLV(int value, int maxLV) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int GETEXPLV(int value, int maxLV) ==== | ==== int GETEXPLV(int value, int maxLV) ==== | ||
| - | 第1引数valueで指定した値とPALAMLV又はEXPLVの値を比較し、LVを返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 第2引数は調査する最大のLVを表します。\\ | + | |
| - | " | + | |
| - | RESULT = -1\\ | ||
| - | REPEAT B\\ | ||
| - | IF A < PARAMLV: | ||
| - | RESULT = COUNT\\ | ||
| - | BREAK\\ | ||
| - | ENDIF\\ | ||
| - | REND\\ | ||
| - | IF RESULT == -1\\ | ||
| - | RESULT = B\\ | ||
| - | ENDIF\\ | ||
| - | と同じです。\\ | ||
| ==== str TOUPPER (str value) ==== | ==== str TOUPPER (str value) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== str TOLOWER (str value) ==== | ==== str TOLOWER (str value) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== str TOHALF (str value) ==== | ==== str TOHALF (str value) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== str TOFULL (str value) ==== | ==== str TOFULL (str value) ==== | ||
| - | 引数の文字列に特定の変換をかけた結果を返す関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | TOUPPERはアルファベットを大文字にした結果を返し、TOLOWERは小文字化した結果を返します。\\ | + | |
| - | TOHALFは全角文字を半角にしますが、対応する半角文字がない全角文字はそのままです。\\ | + | |
| - | TOFULLは半角文字を全角にします。\\ | + | |
| ==== int SUMARRAY(var array, int start = 0, int end = ※) ==== | ==== int SUMARRAY(var array, int start = 0, int end = ※) ==== | ||
| - | 配列の値の総和を返す関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | arrayに総和を求めたい1次元数値型配列を指定し、start以上end未満の要素の範囲を合計します。\\ | + | |
| - | endを省略した場合、配列の最後までを合計します。\\ | + | |
| - | RESULT = SUMARRAY(X, A, B)の結果は\\ | + | |
| - | RESULT = 0\\ | ||
| - | FOR COUNT, A, B\\ | ||
| - | RESULT += X: | ||
| - | REND\\ | ||
| - | と同等です。\\ | ||
| - | 加算される値はX: | ||
| - | arrayに指定できるものは数値型1次元配列変数のみで文字列変数や多次元配列は指定できません。\\ | ||
| - | arrayにCFLAGなどのキャラクタ配列を指定した場合、指定されたキャラについてのみ合計します。\\ | ||
| ==== int MATCH(var array, ? value, int start = 0, int end = ※) ==== | ==== int MATCH(var array, ? value, int start = 0, int end = ※) ==== | ||
| - | arrayで指定した配列変数の中にvalueと一致する要素がいくつあるかを返す関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | valueはarrayと同じ型である必要があります。\\ | + | |
| - | arrayに検索対象となる1次元配列を指定し、start以上end未満の要素の範囲で検索します。\\ | + | |
| - | endを省略した場合、配列の最後までを対象とします。\\ | + | |
| - | RESULT = MATCH(X, Y, A, B)の結果は\\ | + | |
| - | RESULT = 0\\ | ||
| - | FOR COUNT, A, B\\ | ||
| - | IF X:COUNT == Y\\ | ||
| - | RESULT += 1\\ | ||
| - | ENDIF\\ | ||
| - | REND\\ | ||
| - | と同等です。(X、Yの代わりに文字列配列と文字列式を指定しても動作します)\\ | ||
| - | arrayに指定できるものは1次元配列変数のみで多次元配列は指定できません。\\ | ||
| - | arrayにCFLAGなどのキャラクタ配列を指定した場合、指定されたキャラについてのみ数え上げます。\\ | ||
| ==== int MAXARRAY(var array, int start = 0, int end = ※) ==== | ==== int MAXARRAY(var array, int start = 0, int end = ※) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int MINARRAY(var array, int start = 0, int end = ※) ==== | ==== int MINARRAY(var array, int start = 0, int end = ※) ==== | ||
| - | 配列の値の最大又は最小値を返す関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | arrayに検索対象となる1次元配列を指定し、start以上end未満の要素の範囲で検索します。\\ | + | |
| - | endを省略した場合、配列の最後までを対象とします。\\ | + | |
| - | RESULT = MAXARRAY(X, A, B)の結果は\\ | + | |
| - | RESULT = X:A\\ | ||
| - | FOR COUNT, A, B\\ | ||
| - | IF X:COUNT > RESULT\\ | ||
| - | RESULT = X: | ||
| - | ENDIF\\ | ||
| - | REND\\ | ||
| - | と同等です。\\ | ||
| - | arrayに指定できるものは数値型1次元配列変数のみで文字列変数や多次元配列は指定できません。\\ | ||
| - | arrayにCFLAGなどのキャラクタ配列を指定した場合、指定されたキャラについてのみ検索します。\\ | ||
| ==== int SUMCARRAY(var carray, int start = 0, int end = CHARANUM) ==== | ==== int SUMCARRAY(var carray, int start = 0, int end = CHARANUM) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CMATCH(var carray, ? value, int start = 0, int end = CHARANUM) ==== | ==== int CMATCH(var carray, ? value, int start = 0, int end = CHARANUM) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int MAXCARRAY(var carray, int start = 0, int end = CHARANUM) ==== | ==== int MAXCARRAY(var carray, int start = 0, int end = CHARANUM) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int MINCARRAY(var carray, int start = 0, int end = CHARANUM) ==== | ==== int MINCARRAY(var carray, int start = 0, int end = CHARANUM) ==== | ||
| - | キャラクタ間を走査するSUMARRAY、MATCH、MAXARRAY、MINARRAYのバリエーションです。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | arrayはキャラクタ配列変数でなければなりません。\\ | + | |
| - | start, endはキャラクタ登録番号で指定します。\\ | + | |
| - | 例えば" | + | |
| - | (BはCHARANUMより小さくなければなりません)\\ | + | |
| - | RESULT = 0\\ | ||
| - | FOR COUNT, A, B\\ | ||
| - | RESULT += CFLAG: | ||
| - | REND\\ | ||
| ==== int ISNUMERIC(str value) ==== | ==== int ISNUMERIC(str value) ==== | ||
| - | 文字列を数値としてパース可能か(TOINTで値を取れるか)を判断します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 引数を数値として解釈できる場合、1を返します。それ以外の場合、0を返します。\\ | + | |
| ==== int TOINT(str value) ==== | ==== int TOINT(str value) ==== | ||
| - | 引数文字列を数値化して返します。ただし、半角数字で構成された文字列のみ数値化できます。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 引数を数値として解釈できない場合、0を返します。全角数字の場合も同様です。\\ | + | |
| ==== int CHKDATA(int value) ==== | ==== int CHKDATA(int value) ==== | ||
| - | 引数で示される番号のファイルのデータの情報を返し、またRESULT: | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 0 - このファイルはロード可能です。\\ | + | |
| - | 1 - 指定されたファイルは存在しません。\\ | + | |
| - | 2 - ゲームのコードが違います。(gamebase.csvの" | + | |
| - | 3 - バージョンが違います。(gamebase.csvの" | + | |
| - | 4 - 上記以外の問題があるファイルです。\\ | + | |
| - | 返り値が0のとき、RESULTS: | + | |
| - | 返り値が0以外のとき、RESULTS: | + | |
| - | また、CHKDATAを呼んだタイミングがRESULT: | + | |
| - | RESULT: | + | |
| ==== int CHKCHARADATA(str filename) ==== | ==== int CHKCHARADATA(str filename) ==== | ||
| - | datフォルダ内の" | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 戻り値はロード可能な場合は0、何らかの理由により不可能な場合は非0です。\\ | + | |
| - | また、ロード可能な場合はRESULTS: | + | |
| ==== int FIND_CHARADATA(str filename) ==== | ==== int FIND_CHARADATA(str filename) ==== | ||
| - | LOADCHARAの対象となり得るファイルをdatフォルダの中から探索しファイル名(chara_*.datの*の部分)をRESULTSに代入します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 戻り値はヒット数(発見されたファイル数)です。\\ | + | |
| - | 引数はchara_*.datの*の部分を指定できます。\\ | + | |
| - | 例えばFIND_CHARADATA(" | + | |
| - | 引数を省略した場合、" | + | |
| - | なお、chara_.dat(*が空文字列)はLOADCHARAで指定できないのでヒットしません。\\ | + | |
| - | ヒット数がRESULTSの要素数を超えた場合はエラーにはなりませんが超えた分のファイル名は代入されません。\\ | + | |
| ==== int SAVENOS() ==== | ==== int SAVENOS() ==== | ||
| - | コンフィグ" | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int PRINTCPERLINE() ==== | ==== int PRINTCPERLINE() ==== | ||
| - | コンフィグ" | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int LINEISEMPTY() ==== | ==== int LINEISEMPTY() ==== | ||
| - | 現在PRINTしている行が空行かどうかを判断する式中関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | この関数を呼び出した時点で「PRINTL 」を行おうとした場合、\\ | + | |
| - | その結果がただの空行になる場合には1が、そうでない場合は0が返ります。\\ | + | |
| - | PRINTC系で条件に応じたボタンを順次書き連ねる場合に、最後にこの関数を使用することで、\\ | + | |
| - | 表示されるボタンがあるかないかを判別し、なければ専用の表示をするといったことが可能です\\ | + | |
| ==== int GROUPMATCH(? | ==== int GROUPMATCH(? | ||
| - | ? | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 以下、私家改造版更新履歴より、\\ | + | |
| - | 変数の値の複数からの一致確認命令GROUPMATCH実装\\ | ||
| - | 書式:GROUPMATCH(< | ||
| - | 内容:値2から値N(任意の数)までの値に値1と同じ値のものが何個あるかを返す、ない場合は当然0\\ | ||
| ==== int NOSAMES(? value1, ? value2...) ==== | ==== int NOSAMES(? value1, ? value2...) ==== | ||
| - | ? | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 以下、私家改造版更新履歴より、\\ | + | |
| - | 指定した値群が全て異なる値かをチェックする命令NOSAMES実装\\ | ||
| - | 書式:NOSAMES(< | ||
| - | 内容:引数に渡した値が「全て異なる」ものであれば1を返す、そうでなければ0を返す\\ | ||
| ==== int ALLSAMES(? value1, ? value2...) ==== | ==== int ALLSAMES(? value1, ? value2...) ==== | ||
| - | ? | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 以下、私家改造版更新履歴より、\\ | + | |
| - | 指定した値群が全て同じ値かをチェックする命令ALLSAMES実装\\ | ||
| - | 書式:ALLSAMES(< | ||
| - | 内容:引数に渡した値が「全て同じ」であれば1を返す、そうでなければ0を返す\\ | ||
| ==== int ISSKIP() ==== | ==== int ISSKIP() ==== | ||
| - | SKIPDISPのフラグが0以外(PRINT等の出力を無視)なら1を、そうでなければ0を返します\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | (int MOUSESKIP)\\ | ||
| - | この関数はEmuera1.810でMESSKIPに統合されました。\\ | ||
| - | MESSKIPを使用してください。\\ | ||
| - | この関数はかつて以下のような処理をしていました。\\ | ||
| - | |||
| - | 右クリックが押されてWAITスキップの状態になっているなら1を、そうでなければ0を返します\\ | ||
| - | マクロ処理時のスキップ中は0を返します。\\ | ||
| - | マクロ処理のスキップと右クリックが競合した場合はマクロを優先し0を返します\\ | ||
| - | 現在ではEscキーによるスキップと右クリックによるスキップを区別せずに1を返します。\\ | ||
| ==== int MESSKIP() ==== | ==== int MESSKIP() ==== | ||
| - | WAITスキップの状態になっているなら1を、そうでなければ0を返します\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== str CONVERT(int value, ※) ==== | ==== str CONVERT(int value, ※) ==== | ||
| - | ※には2, | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 第一引数を2, | + | |
| ==== str MONEYSTR(int value, str format = "" | ==== str MONEYSTR(int value, str format = "" | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 式中関数MONEYSTRの引数を拡張\\ | ||
| - | 書式:MONEYSTR([数値]{, | ||
| - | 内容:引数で与えられた数値に対して、設定されたお金の単位を付けた文字列を返す\\ | ||
| - | 単位の前置・後置も自動的に処理します\\ | ||
| - | 第2引数はTOSTR()関数と同様の数値の文字列化における変換書式指定子となります\\ | ||
| ==== int FINDELEMENT (var array, ? value, int start = 0, int end = ※, int flag) ==== | ==== int FINDELEMENT (var array, ? value, int start = 0, int end = ※, int flag) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int FINDLASTELEMENT (var array, ? value, int start = 0, int end = ※, int flag) ==== | ==== int FINDLASTELEMENT (var array, ? value, int start = 0, int end = ※, int flag) ==== | ||
| - | 配列中の特定範囲から特定の要素の位置を取得する関数です。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | valueはarrayと同じ型である必要があります。\\ | + | |
| - | start、endで指定された配列要素の検索範囲にvalueで指定された内容と同じ要素があれば、その位置を返します。\\ | + | |
| - | endを省略した場合、配列の最後までを対象とします。\\ | + | |
| - | 複数ある場合はFINDELEMENTは最初にヒットしたものを、\\ | + | |
| - | FINDLASTELEMENTは最後にヒットしたものを返します。ヒットしない場合は-1を返します。\\ | + | |
| - | 検索対象が文字列型の場合はREPLACEと同様に正規表現を使えます。\\ | + | |
| - | flagは検索対象が文字列型の場合のみ有効で、0であれば文字列の一部が一致でもOKとし、\\ | + | |
| - | 0以外であれば文字列と完全に一致した場合のみOKとします。\\ | + | |
| - | arrayに指定できるものは1次元配列変数のみで多次元配列は指定できません。\\ | + | |
| - | arrayにCFLAGなどのキャラクタ配列を指定した場合、指定されたキャラについてのみ数え上げます。\\ | + | |
| ==== str BARSTR(int value, int max, int length) ==== | ==== str BARSTR(int value, int max, int length) ==== | ||
| - | 与えられた引数と同一の引数のBAR命令で表示される文字列と同じ物を取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int COLOR_FROMNAME(str colorname) ==== | ==== int COLOR_FROMNAME(str colorname) ==== | ||
| - | 与えられた引数を色名として判定し0xRRGGBB形式の数値として返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 該当する色名が存在しない場合、-1を返します。\\ | + | |
| ==== int COLOR_FROMRGB(int r, int g, int b) ==== | ==== int COLOR_FROMRGB(int r, int g, int b) ==== | ||
| - | 与えられたR, | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 引数が0-255の範囲外の場合、エラーになります。\\ | + | |
| ==== INRANGEARRAY ==== | ==== INRANGEARRAY ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== INRANGECARRAY ==== | ==== INRANGECARRAY ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | ○配列内の指定した範囲内の数値を持つ要素数を取得するINRANGEARRAY、INRANGECARRAY追加\\ | ||
| - | 書式:INRANGEARRAY([対象一次元数値配列変数], | ||
| - | 内容:最小値 <= 値 < 最大値をとる値を持つ配列中の要素の数を返す\\ | ||
| - | |||
| - | 書式:INRANGECARRAY([対象数値型キャラクタ配列変数], | ||
| - | 内容:キャラクタ配列変数について指定した配列をキャラクタで回して、要素、最小値 <= 値 < 最大値をとる値を持つ要素数を取得する\\ | ||
| ==== str GETLINESTR(str letter) ==== | ==== str GETLINESTR(str letter) ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | ○CUSTOMDRAWLINE、DRAWLINEFORMの表示文字列を取得する式中関数GETLINESTR追加\\ | ||
| - | 書式:GETLINESTR(< | ||
| - | 内容:引数文字列をCUSTOMDRAWLINE、DRAWLINEFORMに渡した時に表示される文字列を返す\\ | ||
| - | ☆注意・必ず読んでください☆\\ | ||
| - | この変数及び式中関数が返す文字列の長さが「1行に表示できる文字列長」に対応することは『全く保証されません』\\ | ||
| - | そう思い込んで処理を書いてうまく動かなくてもそれはEmueraのバグではありませんし、この件について当方は一切の責任を負いません\\ | ||
| ==== int PRINTCLENGTH() ==== | ==== int PRINTCLENGTH() ==== | ||
| - | 以下、私家改造版更新履歴より、\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | ○PRINTCの文字数を取得するPRINTCLENGTH追加\\ | ||
| - | 書式:PRINTCLENGTH()\\ | ||
| - | 内容:コンフィグのPRINTCの文字数の値を返す\\ | ||
| ==== str STRFORM(str value) ==== | ==== str STRFORM(str value) ==== | ||
| - | 与えられた文字列をPRINTFORMなどと同様の書式付文字列とみなし、展開後の文字列を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int GETCONFIG(str value) ==== | ==== int GETCONFIG(str value) ==== | ||
| - | ==== str GETCONFIGS(str value) ==== | + | [[erabasicリファレンス_組み込み式中関数# |
| - | コンフィグ及びreplace.csvの設定項目を整数または文字列で取得します。\\ | + | |
| - | 取得できる項目は以下の通りです。\\ | + | |
| - | GETCONFIG(" | + | ==== str GETCONFIGS(str value) ==== |
| - | GETCONFIG(" | + | [[erabasicリファレンス_組み込み式中関数# |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIG(" | + | |
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| - | GETCONFIGS(" | ||
| ==== str HTML_POPPRINTINGSTR() ==== | ==== str HTML_POPPRINTINGSTR() ==== | ||
| - | 現在PRINT中で改行待ちの文字列バッファをHtml形式で取得し、バッファを空にします\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | pタグはつかないのでALIGNMENT命令によるalignは反映されません。\\ | + | |
| ==== str HTML_GETPRINTEDSTR(int lineNo) ==== | ==== str HTML_GETPRINTEDSTR(int lineNo) ==== | ||
| - | 表示済みのラインのうちlineNoで指定した行の内容をhtml形式の文字列として取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 行の数え方はLINECOUNTやCLEARLINE命令と同じです。\\ | + | |
| ==== str HTML_ESCAPE(str value) ==== | ==== str HTML_ESCAPE(str value) ==== | ||
| - | 対象の文字列をHtml向けにエスケープ(文字参照に変換)します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | アンエスケープにはHTML_TOPLAINTEXT関数を使用します。\\ | + | |
| ==== str HTML_TOPLAINTEXT(str value) ==== | ==== str HTML_TOPLAINTEXT(str value) ==== | ||
| - | 対象のhtml文字列をプレーンテキストに変換します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 具体的には、文字列からhtmlタグを削除し文字参照を展開します。\\ | + | |
| ==== int SAVETEXT(str text, int fileNo{, int force_savdir, | ==== int 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エンコードで保存します。\\ | + | |
| - | 成功した場合非0が、失敗した場合0を返します。\\ | + | |
| - | 短い時間中に同一ファイルに書き込むことを繰り返した場合、ウイルス対策ソフト等の影響で書き込みに失敗する可能性がありますので成否のチェックは重要です。\\ | + | |
| ==== str LOADTEXT(int fileNo{, int force_savdir, | ==== str LOADTEXT(int fileNo{, int force_savdir, | ||
| - | LOADTEXT命令版はtextXX.savを読み取りその結果を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 第2引数に非0を指定した場合、オプションによらずsavフォルダ内のファイルを探します。\\ | + | |
| - | 第3引数に非0を指定した場合、UTF-8エンコードで保存されているものとして読み取ります。\\ | + | |
| - | 失敗した場合、空文字列を返します\\ | + | |
| ==== int GETKEY(int vkey) ==== | ==== int GETKEY(int vkey) ==== | ||
| - | キーボード及びマウスボタンの状態を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 引数で指定されるキーが押されていれば1、押されていなければ0を返します。\\ | + | |
| - | この関数はEmueraのウインドウがアクティブのときのみ1を返し、アクティブ状態でなければキー状態にかかわらず0を返します。\\ | + | |
| - | キーコードの数値と実際のキーの対応に関してはマイクロソフト社が提供するMSDNのGetKeyState()の項を参照してください。\\ | + | |
| ==== int GETKEYTRIGGERED(int vkey) ==== | ==== int GETKEYTRIGGERED(int vkey) ==== | ||
| - | GETKEYと同様にキーボード及びマウスボタンの状態を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | GETKEYは現在押されているかどうかを取得するのに対し、GETKEYTRIGGEREDは押された直後のみ1を返します。\\ | + | |
| - | すなわち継続して押し続けている場合はGETKEYは1を返しますが、GETKEYTRIGGERDは最初のみ1を返し以降は0を返します。\\ | + | |
| - | この関数はEmueraのウインドウがアクティブのときのみ1を返し、アクティブ状態でなければキー状態にかかわらず0を返します。\\ | + | |
| - | キーコードの数値と実際のキーの対応に関してはマイクロソフト社が提供するMSDNのGetKeyState()の項を参照してください。\\ | + | |
| ==== int CLIENTWIDTH () ==== | ==== int CLIENTWIDTH () ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CLIENTHEIGHT () ==== | ==== int CLIENTHEIGHT () ==== | ||
| - | クライアント領域(ウィンドウの描画領域)の現在の幅または高さを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | この数値にはウィンドウ枠やメニューバー、スクロールバー、テキスト入力領域の幅や高さを含みません。\\ | + | |
| - | CLIENTHEIGHTはユーザーによってゲーム中に変更される可能性があることに注意して下さい。\\ | + | |
| ==== int MOUSEX() ==== | ==== int MOUSEX() ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int MOUSEY() ==== | ==== int MOUSEY() ==== | ||
| - | マウスカーソルの現在のX座標またはY座標を取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 座標はクライアント領域の左下位置を(0, | + | |
| - | カーソルがクライアント領域内にある場合MOUSEYは負の値を返すことに注意してください。\\ | + | |
| - | クライアント領域の広さはCLIENTWIDTH、CLIENTHEIGHT関数によって取得できます。\\ | + | |
| - | (クライアント領域左上を基準とするY座標が必要なら、MOUSEY()+CLIENTHEIGHT()によって取得できます)\\ | + | |
| - | この関数はEmueraのウインドウがアクティブでなくても、また、マウスカーソルがウインドウ外であっても正常に動作します。\\ | + | |
| ==== int ISACTIVE() ==== | ==== int ISACTIVE() ==== | ||
| - | Emueraのウインドウの状態を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | アクティブであれば1、アクティブでなければ0を返します。\\ | + | |
| ==== int SPRITECREATED(str spriteName) ==== | ==== int SPRITECREATED(str spriteName) ==== | ||
| - | 指定した名称のスプライトが作成済みであるなら1を、未作成又は廃棄済みであるなら0を返します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int SPRITEWIDTH(str spriteName) ==== | ==== int SPRITEWIDTH(str spriteName) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int SPRITEHEIGHT(str spriteName) ==== | ==== int SPRITEHEIGHT(str spriteName) ==== | ||
| - | 指定した名称のスプライトの幅または高さを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | スプライトが未作成又は廃棄済みであるなら0を返します。\\ | + | |
| ==== int SPRITEPOSX(str spriteName) ==== | ==== int SPRITEPOSX(str spriteName) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int SPRITEPOSY(str spriteName) ==== | ==== int SPRITEPOSY(str spriteName) ==== | ||
| - | 指定した名称のスプライトの相対位置のX、Yを取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | スプライトが未作成又は廃棄済みであるなら0を返します。\\ | + | |
| - | 相対位置のX、Yが0なのか未作成又は廃棄済であるのかの区別には別途SPRITECREATEDを呼び出してください。\\ | + | |
| ==== int SPRITESETPOS(str spriteName, int posx, int posy) ==== | ==== int SPRITESETPOS(str spriteName, int posx, int posy) ==== | ||
| - | 指定した名称のスプライトの相対位置のX、Yを設定します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 成功した場合は非0を、指定したスプライトが未作成又は廃棄済み等の理由で失敗した場合には0を返します。\\ | + | |
| ==== int SPRITEMOVE(str spriteName, int movex, int movey) ==== | ==== int SPRITEMOVE(str spriteName, int movex, int movey) ==== | ||
| - | 指定した名称のスプライトの相対位置のX、Yに指定した値を加算します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 成功した場合は非0を、指定したスプライトが未作成又は廃棄済み等の理由で失敗した場合には0を返します。\\ | + | |
| ==== int GCREATE(int ID, int width, int height) ==== | ==== int GCREATE(int ID, int width, int height) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したサイズで指定したIDのGraphicsを作成します。\\ | + | |
| - | GraphicsのIDは0以上の整数、width、heightは1以上8192以下の間の整数値でなければなりません。\\ | + | |
| - | 引数がこの範囲を外れるとエラーです。\\ | + | |
| - | 作成に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが既に作成されている場合、0を返します。\\ | + | |
| - | Graphicsを作り直す場合はGDISPOSE命令で既存のGraphicsを廃棄してください。\\ | + | |
| ==== int GCREATEFROMFILE(int ID, str filepath) ==== | ==== int GCREATEFROMFILE(int ID, str filepath) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | resourcesフォルダ内の画像ファイルを相対パスで指定し、その画像を開いてGraphicsを作成します。\\ | + | |
| - | resourcesフォルダ内のcsvファイルでリソースを宣言した場合と異なり、画像ファイルはロックされません。\\ | + | |
| - | 作成に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが既に作成されている場合はGraphicsの作成に失敗し、この命令は何もせずに0を返して終了します。\\ | + | |
| - | ファイルが存在しない、画像として認識できない、ファイルのサイズが大きすぎる、などで失敗した場合も0を返します。\\ | + | |
| ==== int GDISPOSE(int ID) ==== | ==== int GDISPOSE(int ID) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsを廃棄します。\\ | + | |
| - | 廃棄に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが未作成(廃棄済の場合を含む)の場合、0を返します。\\ | + | |
| ==== int GCLEAR(int ID, int cARGB) ==== | ==== int GCLEAR(int ID, int cARGB) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsの全域を指定した色で置き換えます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | ID又は色指定が不適切な場合はエラーになります。\\ | + | |
| - | 画像処理系の命令での色指定はRGBではなくアルファ値(不透明度)を含むARGB形式であることに注意して下さい。\\ | + | |
| - | ARGB型は16進数で0xAARRGGBBで表されます。\\ | + | |
| ==== int GFILLRECTANGLE(int ID, int x, int y, int width, int height) ==== | ==== int GFILLRECTANGLE(int ID, int x, int y, int width, int height) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsに(x, | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 描画の色はGSETBRUSH命令によってあらかじめ指定しなければEmueraコンフィグの文字色で描画されます。\\ | + | |
| ==== int GDRAWG(int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight) ==== | ==== int GDRAWG(int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int GDRAWG(int destID, int srcID, int destX, int destY, int destWidth, int destHeight, int srcX, int srcY, int srcWidth, int srcHeight, var cm) ==== | ==== int 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リファレンス_組み込み式中関数# |
| - | 指定したdestIDのGraphicsに、指定したsrcIDのGraphicsを描画します。\\ | + | |
| - | 描画先destのGraphicsの位置及びサイズを4つの整数で、描画元srcのGraphicsの位置及びサイズを4つの整数で指定します。\\ | + | |
| - | オプションとして、5x5以上の二次元数値配列をcmとして指定することでカラーマトリクスを適用して描画します。\\ | + | |
| - | colorMatrixは全要素を1/ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 描画先Graphics又は描画元Graphicsのいずれかが未作成であるなどの場合、0を返します。\\ | + | |
| - | 描画先と描画元Graphicsは同一でも実行可能です。\\ | + | |
| ==== int GDRAWGWITHMASK(int destID, int srcID, int maskID, int destX, int destY) ==== | ==== int GDRAWGWITHMASK(int destID, int srcID, int maskID, int destX, int destY) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したdestIDのGraphicsに、srcIDのGraphicsを、maskIDのGraphicsをマスクとして適用して描画します。\\ | + | |
| - | 出力先destIDのGraphics内の描画位置をdestX, | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | srcIDとmaskIDの幅及び高さが完全に一致すること、描画領域がdestIDからはみ出さないことが成功の条件です。\\ | + | |
| - | マスクとして適用して描画するとは、具体的には、マスク画像の青の値を不透明度としてソース画像に適用して描画することです。\\ | + | |
| - | 例えば、マスク画像が完全に白一色(つまり全部の場所で青色がMAX)の場合、ソース画像はマスクなしの場合と同様にそのまま描画されます。\\ | + | |
| - | マスク画像が完全に黒一色(つまり全部の場所で青色が0)の場合、ソース画像は完全透明として扱われ何も起きません。\\ | + | |
| - | この命令の処理はGPUではなく、CPUがシングルスレッドで解決します。速度には期待しないでください。\\ | + | |
| ==== int GDRAWSPRITE(int ID, str sprName) ==== | ==== int GDRAWSPRITE(int ID, str sprName) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int GDRAWSPRITE(int ID, str sprName, int destX, int destY) ==== | ==== int GDRAWSPRITE(int ID, str sprName, int destX, int destY) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int GDRAWSPRITE(int ID, str sprName, int destX, int destY, int destWidth, int destHeight) ==== | ==== int GDRAWSPRITE(int ID, str sprName, int destX, int destY, int destWidth, int destHeight) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int GDRAWSPRITE(int ID, str sprName, int destX, int destY, int destWidth, int destHeight, var cm) ==== | ==== int GDRAWSPRITE(int ID, str sprName, int destX, int destY, int destWidth, int destHeight, var cm) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsに指定したsprNameのSpriteを描画します。\\ | + | |
| - | オプションとして、Graphics内部の位置をdestX, | + | |
| - | また、描画幅及び高さをdestWidth, | + | |
| - | さらに、cmに5x5の行列を指定することでカラーマトリクスを適用して描画します。\\ | + | |
| - | なおSpriteのサイズはSPRITEWIDTH(str imgName), SPRITEHEIGHT(str imgName)関数で取得できます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | アニメーションスプライトを指定した場合、実行時のフレーム1つが描画されます。\\ | ||
| ==== int GSETCOLOR(int ID, int cARGB, int x, int y) ==== | ==== int GSETCOLOR(int ID, int cARGB, int x, int y) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsの指定位置のピクセルを指定した色に置き換えます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | この命令はそれほど高速ではありません。\\ | + | |
| - | GGETCOLOR命令と合わせて大きな画像の全体を書き換える試みは実用的な時間内には終わりません。\\ | + | |
| - | 画像処理系の命令での色指定はRGBではなくアルファ値(不透明度)を含むARGB形式であることに注意して下さい。\\ | + | |
| - | ARGB型は16進数で0xAARRGGBBで表されます。\\ | + | |
| ==== int GSETBRUSH(int ID, int cARGB) ==== | ==== int GSETBRUSH(int ID, int cARGB) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsに指定した色のブラシを設定します。\\ | + | |
| - | 指定したブラシはGDISPOSE命令でGraphicsが破棄されるまで記憶されます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | ここで設定した色のブラシがGFILLRECTANGLE命令で使用されます。\\ | + | |
| - | 画像処理系の命令での色指定はRGBではなくアルファ値(不透明度)を含むARGB形式であることに注意して下さい。\\ | + | |
| - | ARGB型は16進数で0xAARRGGBBで表されます。\\ | + | |
| ==== int GSETFONT(int ID, str fontName, int fontSize) ==== | ==== int GSETFONT(int ID, str fontName, int fontSize) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsに指定した名前およびサイズのフォントを設定します。\\ | + | |
| - | 指定したフォントはGDISPOSE命令でGraphicsが破棄されるまで記憶されます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 設定したフォントを利用する命令・関数はバージョン1.824現在には存在しません。\\ | + | |
| ==== int GSETPEN(int ID, int cARGB, int penWidth) ==== | ==== int GSETPEN(int ID, int cARGB, int penWidth) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsに指定した色及び幅のペンを設定します。\\ | + | |
| - | 指定したペンはGDISPOSE命令でGraphicsが破棄されるまで記憶されます。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 画像処理系の命令での色指定はRGBではなくアルファ値(不透明度)を含むARGB形式であることに注意して下さい。\\ | + | |
| - | ARGB型は16進数で0xAARRGGBBで表されます。\\ | + | |
| - | 設定したペンを利用する命令・関数はバージョン1.824現在には存在しません。\\ | + | |
| ==== int GCREATED(int ID) ==== | ==== int GCREATED(int ID) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsが作成済みであるなら1を、未作成(廃棄済を含む)なら0を取得します。\\ | + | |
| ==== int GWIDTH(int ID) ==== | ==== int GWIDTH(int ID) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int GHEIGHT(int ID) ==== | ==== int GHEIGHT(int ID) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsの幅または高さを取得します。\\ | + | |
| - | Graphicsが未作成(廃棄済を含む)なら0を返します。\\ | + | |
| ==== int GGETCOLOR(int ID, int x, int y) ==== | ==== int GGETCOLOR(int ID, int x, int y) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsの指定位置の色を0xAARRGGBB形式の整数値で取得します。\\ | + | |
| - | Graphicsが未作成又は廃棄済み、あるいはx, | + | |
| - | この命令のみ、失敗した場合に0ではなく-1を返すことに注意してください。\\ | ||
| - | 黒色かつ完全透明の位置の色を取得した場合に、この命令は0を返します。\\ | ||
| ==== int GSAVE(int ID, int fileNo) ==== | ==== int GSAVE(int ID, int fileNo) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 指定したIDのGraphicsの画像を、fileNoの番号を付けたファイル名でpng形式で出力し保存します。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| ==== int GLOAD(int ID, int fileNo) ==== | ==== int GLOAD(int ID, int fileNo) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | fileNoの番号を付けたファイル名の画像を開き、Graphicsを作成します。\\ | + | |
| - | 動作としてはCREATEFORMFILE命令とほぼ同じですがresoucesフォルダ内の画像ではなくGSAVE命令で保存した画像から作成する点が異なります。\\ | + | |
| - | 処理に成功した場合、非0を返します。\\ | + | |
| - | 指定したIDのGraphicsが既に作成されている場合はGraphicsの作成に失敗し、この命令は何もせずに0を返して終了します。\\ | + | |
| ==== int SPRITECREATE(str spriteName, int gID) ==== | ==== int SPRITECREATE(str spriteName, int gID) ==== | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int SPRITECREATE(str spriteName, int gID, int x, int y, int width, int height) ==== | ==== int SPRITECREATE(str spriteName, int gID, int x, int y, int width, int height) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | gIDのGraphicsの一部または全部を元にして、spriteNameで指定したリソース名を持つスプライトを作成します。\\ | + | |
| - | (x, y, width, height)を指定することでGraphicsのその部分をスプライトとして切り取れます。\\ | + | |
| - | 作成に成功した場合、非0を返します。\\ | + | |
| - | 同じリソース名のスプライトが既に存在するなどで失敗した場合、0を返します。\\ | + | |
| - | スプライトは親GraphicsのIDと切取位置を記憶しているだけなので、親Graphicsに変更があるとスプライトも変更されます。\\ | + | |
| - | また、親Graphicsが破棄されるとスプライトも破棄された扱いになります。\\ | + | |
| - | 作成したスプライトはresoucesフォルダ内のcsvで宣言したリソースとほぼ同様に扱うことができます。\\ | + | |
| - | 例えばPRINT_IMG命令やHTML_PRINTのimgタグなどで使用できます。\\ | + | |
| ==== int SPRITEANIMECREATE(str spriteName, int width, int height) ==== | ==== int SPRITEANIMECREATE(str spriteName, int width, int height) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | spriteNameで指定したリソース名を持つ、width及びheightで指定したサイズのアニメーションスプライトを作成します。 作成に成功した場合、非0を返します。\\ | + | |
| - | 同じリソース名のスプライトが既に存在するなどで失敗した場合、0を返します。\\ | + | |
| - | アニメーションさせるためにはSPRITEANIMEADDFRAME命令によってフレームを追加する必要があります。\\ | + | |
| - | アニメーションスプライトに関する注意点については、resoucesも参照してください。\\ | + | |
| ==== int SPRITEANIMEADDFRAME(string spriteName, int gID, int x, int y, int width, int height, int offsetx, int offsety, int delay) ==== | ==== int SPRITEANIMEADDFRAME(string spriteName, int gID, int x, int y, int width, int height, int offsetx, int offsety, int delay) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | spriteNameで指定したリソース名を持つアニメーションスプライトにフレームを追加します。\\ | + | |
| - | gIDで指定したGraphicsの(x, | + | |
| - | アニメーションスプライトの作成時に設定したサイズの範囲から外れた部分は描画されません。\\ | + | |
| - | delayにはこのフレームを表示する時間をミリ秒単位で指定します。\\ | + | |
| - | spriteNameのリソース名が存在しない、又はアニメーションスプライトでない場合はこの命令は失敗し、何もしません。\\ | + | |
| - | フレームの追加に成功した場合1を、失敗した場合は0を返します。\\ | + | |
| ==== int SPRITEDISPOSE(string spriteName) ==== | ==== int SPRITEDISPOSE(string spriteName) ==== | ||
| - | spriteNameで指定したリソース名を持つスプライトを廃棄します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 廃棄に成功した場合、非0を返します。\\ | + | |
| - | この命令はスプライトの元となったGraphics等には影響しません。\\ | + | |
| - | Graphicsに割り当てられたメモリを解放するにはGDISPOSE命令を使用してください。\\ | + | |
| ==== int SPRITEGETCOLOR(string spriteName, int x, int y) ==== | ==== int SPRITEGETCOLOR(string spriteName, int x, int y) ==== | ||
| - | spriteNameで指定したリソース名を持つスプライトの指定位置の色を0xAARRGGBB形式の整数値で取得します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | spriteNameが未作成又は廃棄済み、あるいはx, | + | |
| - | この命令のみ、失敗した場合に0ではなく-1を返すことに注意してください。\\ | ||
| - | 黒色かつ完全透明の位置の色を取得した場合に、この命令は0を返します。\\ | ||
| ==== int CBGSETG(int ID, int x, int y, int zdepth) ==== | ==== int CBGSETG(int ID, int x, int y, int zdepth) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | IDで指定するGraphicsをクライアント領域に表示するように設定します。\\ | + | |
| - | (x, y)に0を指定した場合、クライアント領域の左下と画像の左下が一致するように表示されます。\\ | + | |
| - | xは右方向が正、yは下方向が正、zdepthは画面奥方向が正です。\\ | + | |
| - | zdepthは0以外の値を指定します。通常の文字描画がzdepth==0に相当し、zdepthが負であれば文字よりも手前に描画されます。\\ | + | |
| ==== int CBGSETSPRITE(str spriteName, int x, int y, int zdepth) ==== | ==== int CBGSETSPRITE(str spriteName, int x, int y, int zdepth) ==== | ||
| - | spriteNameで指定したリソース名を持つスプライトをクライアント領域に表示するように設定します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | (x, y)に0を指定した場合、クライアント領域の左下と画像の左下が一致するように表示されます。\\ | + | |
| - | xは右方向が正、yは下方向が正、zdepthは画面奥方向が正です。\\ | + | |
| - | zdepthは0以外の値を指定します。通常の文字描画がzdepth==0に相当し、zdepthが負であれば文字よりも手前に描画されます。\\ | + | |
| ==== int CBGCLEAR() ==== | ==== int CBGCLEAR() ==== | ||
| - | CBGで始まる各種CBG系命令で設定した背景画像の設定を全て解除します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int CBGCLEARBUTTON() ==== | ==== int CBGCLEARBUTTON() ==== | ||
| - | CBGSETBUTTONSPRITE命令で設定したボタンの設定を解除します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int CBGREMOVERANGE(int zmin, int zmax) ==== | ==== int CBGREMOVERANGE(int zmin, int zmax) ==== | ||
| - | CBGSETG、CBGSETSPRITE、CBGSETBUTTONSPRITE命令で設定した画像のうち、Z深度がzmin以上zmax以下である画像を設定解除します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int CBGREMOVEBMAP() ==== | ==== int CBGREMOVEBMAP() ==== | ||
| - | CBGSETBMAPG命令で設定したボタンマップの設定を解除します。\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| ==== int CBGSETBMAPG(int ID) ==== | ==== int CBGSETBMAPG(int ID) ==== | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | IDで指定するGraphicsをクライアント領域のボタンマップとして設定します。\\ | + | |
| - | ここで設定したボタンマップはCBGSETBUTTONSPRITE命令及びINPUTMOUSEKEY命令に影響します。\\ | + | |
| - | ボタンマップ画像は表示はされませんがCBGSETG命令で設定した画像と同様に画面左下と画像左下位置が一致するように配置されます。\\ | + | |
| - | マウスカーソル直下のボタンマップ画像の色が、ボタンの値として認識されます。\\ | + | |
| - | ただし、色のアルファ値が255でない(透明又は半透明である)ときにはボタンの値としては認識されません。\\ | + | |
| ==== int CBGSETBUTTONSPRITE(int button, str spriteName, str spriteNameB, | ==== int CBGSETBUTTONSPRITE(int button, str spriteName, str spriteNameB, | ||
| + | [[erabasicリファレンス_組み込み式中関数# | ||
| + | |||
| ==== int CBGSETBUTTONSPRITE(int button, str spriteName, str spriteNameB, | ==== int CBGSETBUTTONSPRITE(int button, str spriteName, str spriteNameB, | ||
| - | (※描画方法がGRAPHICS又はTEXTRENDERERのときのみ使用可能)\\ | + | [[erabasicリファレンス_組み込み式中関数# |
| - | 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が負であれば文字よりも手前に描画されます。\\ | + | |
emueraリファレンス_式中関数.1782969138.txt.gz · 最終更新: by 127.0.0.1
