後ろの数値を、前の数値から引きます。
命令の引数として計算結果が使われます。

数字ｘ１ミリ秒分待ちます。クリックで飛ばせます。
数字は普通の数字でなければなりません。変数を使 いたいときは、
delay命令を使ってください。

一文字あたりの表示速度をミリ秒単位で指定します。
数 字は普通の数字でなければなりません。変数を使いたいときは、
textspeed命令を使ってください。

上のメニューから選ばれた、「低速」「普通」「高速」の文字 速度にあわせます。それが数字で何にあたるのかはdefaultspeed命令で設定できます。

数字ｘ１ミリ秒分待ちます。クリックで飛ばせません。
数字は普通の数字でなければなりません。変数を 使いたいときは、
wait命令を使ってください。

文字の色を変えます。HTMLで指定するのと同じ形式です。
（つ まり、１６進数で二桁づつ６ケタで指定、ということ。
　#000000が黒、#ffffffが白、#ffffaaが、白っぽい黄色になります。）
変 えたら以後変わりっぱなしなので注意してください。

文字変数$0〜$999まで1000個存在します。
0番から199番までが普通の変数で、200番か ら999番までがグローバル変数です。
普通の変数は、ゲームを終了する、もしくはreset命令などで動作を最初に戻すと値が消えますが、グロー バル変数は消えません。
普通の変数の値は、セーブ時にセーブファイルに記憶され、ロード時にその値が復元しますが、グローバル変数ではそうなりま せん。
具体的には、例えば、普通の変数は好感度に、グローバル変数はクリアフラグに、といった使い方がいいでしょう。
ただし、グローバル 変数を使う場合は、命令globalonを定義ブロックで実行しておかなくてはなりません。
文字変数の初期値は""（一文字もない）です。

通常は文字変数ですが表示文中にあればその文字変数の中身を表示します。

数字変数%0〜%999まで1000個存在します。
0番から199番までが普通の変数で、200番か ら999番までがグローバル変数です。
普通の変数は、ゲームを終了する、もしくはreset命令などで動作を最初に戻すと値が消えますが、グロー バル変数は消えません。
普通の変数の値は、セーブ時にセーブファイルに記憶され、ロード時にその値が復元しますが、グローバル変数ではそうなりま せん。
具体的には、例えば、普通の変数は好感度に、グローバル変数はクリアフラグに、といった使い方がいいでしょう。
ただし、グローバル 変数を使う場合は、命令globalonを定義ブロックで実行しておかなくてはなりません。
数字変数の初期値は0です。

通常は数字変数ですが表示文中にあればその数字変数の中身を表示します。

ルビ有りを示す

*define
rubyon
game
*start
setwindow 10,10,20,20,24,24,0,12,0,1,1,#ffffff,0,0,639,479
ルビ機能の(暫定仕様/ざんていしよう)です。@
ｒｕｂｙｏｎ時、(文字/もじ)は(下詰/したづめ)で表示されます。@
(縦/たて)の(字間/じかん)を、ルビが入る分とって下さい。@
「(承/うけたまわ)」る、とか、「(論理的/ロジカル)」みたいに、文字幅をあわせようとする機能がついてます。
ルビは折り返し改行されませんのでご注意ください。\
end

*で始まる文はラベル名です。gotoなどの飛び先として使います。
ラベル名に使える単語の一文字目は 半角のアルファベットと"_"（アンダーライン）、それ以降はアルファベット"_"（アンダーライン）数字の組み合わせです。

　　正しい 例）　*HAJIMARI
　　　　　　　　　*Mike_Tom
　　　　　　　　　*day01

　　誤った例）　*始ま り　　（全角文字を使っている）
　　　　　　　　　*Mike&Tom　（アンダーライン以外の記号を使っている)
　　　　　　 　　　*01day　　　（一文字目から数字）

*asterisk

後ろの数値を、前の数値と掛けます。
命令の引数として計算結果が使われます。

csel命令を実行すると、自動的にこのラベルにジャンプす る。このラベル後に選択肢表示の処理を実装する。

*customsel
skipoff
*csel_st
btndef clear
getcselnum %0
getcursorpos %1,%2
cselbtn 0,500,%1,%2
add %2,21
cselbtn 1,501,%1,%2
if %0>2 add %2,21:cselbtn 2,502,%1,%2
if %0>3 add %2,21:cselbtn 3,503,%1,%2
if %0>4 add %2,21:cselbtn 4,504,%1,%2

*csel_loop
selectbtnwait %0
if %0=-2 systemcall lookback:goto *csel_loop
if %0=-1 gosub *rclk:goto *csel_st
if %0>=500 & %0<=504 saveon:sub %0,500:cselgoto %0
goto *csel_loop

定義ブロック開始を示す特殊なラベルです。

*define
game

実行ブロック開始を示す特殊なラベルです。

*start
end

これのすぐ後に改行を書けば、その改行は無視されます。

前の数値を、後ろの数値で割ります。
命令の引数として計算結果が使われます。

:（コロン）でつなげることによって、一行にたくさんの命令 文を書くことができます。これは、if文で威力を発揮します。

btnwait %0
if %0=-1 allsphide:systemcall lookback

;で始まる文はコメントです。NScripterはこの文を 読み飛ばします。

defsub abs ; 渡された変数を絶対値に変換する

配列変数を使うにはdim命令を使います。
配列変数は?0〜?199まで200個定義できます。
グ ローバル変数として使うことはできません。

クリック待ちをします。

表示直前にgettagで取得できる情報を指定できます。

[太郎/0001.wav]「太郎の台詞」

これのすぐ後に改行を書けば、その改行は無視されます。

表示文字列の中で変数に値を代入できるようになりました。
{} で囲んで、その中で変数名,値を指定すると、その値が変数に代入されます。
ただし、エイリアスは使えません。
{変数名,値,変数名,値} のように、複数個書くと、それらの代入操作が全て実行されます。

jumpf命令とjumpb命令で使う飛び先です。
jumpf 命令、jumpb命令と~記号の間には表示文章を置かないようにしてください。

後ろの数値または文字列を、前の数値または文字列を足します。
数値同士、文字列同士でないとエラーとな ります。
命令の引数として計算結果が使われます。

mov ?0[0],?0[0]+1

mov $1,"●"
mov $2,"あいうえお"+$1+"さしすせそ"
;これで、$2は"あいうえお●さしすせそ"になります。

mov $0,"テスト"
mov $0,$0+"あいうえお"
;これで$0は"テストあいうえお"になります。

<と>で囲んだ文字列をテキストボタンに設定しま す。
テキストボタン番号は省略可能です。

改ページ待ちをします。直後の改行は無視されます。

setcursorとほぼ同じなのですが、こちらの座標指定 は、文字との相対座標ではなく、画面上の絶対座標としての指定です。

変数に変数を加えます。文字の場合は連結です。

add %0,6

add $5,"ああああ"

文字列を、行頭禁則文字列,行末禁則文字列の順で指定することで、
現在の禁則文字列に設定を追加しま す。define節専用です。

一文字だけでも設定できますし、複数並べれば、
それらが全て禁則文字になります。

nsaアーカイブを読み込むディレクトリを追加します。

拡張スプライト全体の表示を一時的にマスクすることが出来ま す。allsphide allspresumeと使い方は同じです。

拡張スプライト全体の表示を一時的にマスクすることが出来ま す。allsphide allspresumeと使い方は同じです。

すべてのスプライトを一時隠します

allsphide

allsphideで隠したスプライトを表示します

allspresume

mspと似ているが、こちらは増分ではなく絶対指定。

amsp 2,5,2,100

拡張スプライトの移動命令です。msp2は現在値からの相対 指定、amsp2は値そのものの指定です。

amsp2 0,10,20,10,10,5

アーカイブ展開プラグインを指定します。
書式は、"アーカイブファイル名|関連付けＤＬＬ名"です。
画 像、音声はアーカイブ対応していますが、スクリプトはしていません。

レジストリを読みに行く命令と組み合わせることで、いろいろな指定が できるようになります。

arc "arc.sar|scrunarc.dll"

getreg $0,"software\leaf\toheart","datadir"
add $0,"\lvns3dat.pak|axlfpak.spi"
arc $0

文字列を数字に変換します。Ｃ言語の同名関数と同じです。

atoi %0,"123"
atoi %3,$0

クリック待ちが指定時間（ミリ秒）たつと勝手に進むようにな る、デモなどに便利な命令です。
０を指定すれば、設定が無効になります。

商用ソフト「銀色」のために作った命令です。
この命 令を実行すると、メニューに「オートモード」がつきます。
オートモードは「次の選択肢まで進む」に似ていますが、ウェーブが
なりおわるま で先には進まず、ウェーブがないところでも、下のautomode_time命令で
どのくらいクリックまでに待つか指定することが出来ます。
い わゆる読み上げモードですね。

メニューからボリューム変更ダイアログが
使えるようになる。（MP3(BGM) voice(DWAVE 0) SE(DWAVE 1〜)のボリュームを
いじれるようになりました。）
この辺の拡張機能の追加については もうちょっとすっきりした命令を作る予定
（今有効な命令は将来的にもちゃんと使えます。）

上のmode_extで増える「オートモード」のとき、ウェー ブがなっていないときに　どのくらい待つのかをミリ秒単位で指定します。

表示文頭以外の自動のセーブポイント更新を停止します。
*define 節で
autosaveoff
とすることで、saveon/saveoff命令は無視されるようになります。
（表示文頭ではセーブ ポイントは従来通り更新されます）。
表示文頭以外でセーブさせたい場合（たとえばクリッカブルマップなど）では、手書きでsavepoint命令 を呼び出してください。タイミングによってはデータがうまく復帰できなかったりするので、画面全体を読み込んで描画する直前をセーブポイントにするとか、 うまく工夫してください。

指定AVIファイルを画面一杯に再生します。
数字が１ のときは、クリックすれば再生を中止して、次の処理へ移ります。
０のときには、最後まで再生し終わるまで、処理をスクリプトに戻しません。

バー表示指定をします。幅と高さは、バーが最大値であったと きの値です。
　最大値に満たない場合は、割合に合わせてバーが短くなります。
　バーは左詰表示です。単純に長さにあわせて指定した色で塗 りつぶすだけなので、
　値が足りないときの地の色は、元絵のほうで描いてしておいてください。
　なお、指定した後でprint命令などの 表示処理を実行しないと、画面に反映されません。

バーの設定をクリアします。　バーとは、格闘ゲームの体力 バーみたいなもののことです。

ボタン定義をクリアする。

bclear

デフォルトではbexecはカーソルキーとスペース／リター ンをボタン間の移動とボタンの決定に使うようになりました。
カーソルキー入力を得たい場合はbclearとbexecの間にbcursor命令を 入れてください。

どのスプライトとも重なっていないときの処理を指定する。これもexbtnやspstrに指定するのと同じ文 字列

bdef "C0" ;どれとも重なっていない場合はスプライト０番を非表示にする。

bclear命令とbexec命令の間にbdown命令を入 れると、左クリックを押し下げたときに処理が戻るようになりました。

ボタン処理を実行する。引数は文字列変数と数値変数、もしくは その両方が選べる。

bclearを実行するまで設定は残っている。
btimeを実行するまでは経過時間とタイムアウト時間の設定 も残っている。

文字列変数に戻る値：
どのスプライトでもないところが左クリックされた場合……"LCLICK"が返ります。
ス プライトが左クリック場合……"S(スプライト番号)"が返ります。たとえばスプライト１２番なら"S12"が返ります。
タイムアウトした場 合……"TIMEOUT"が返ります。
右クリックされた場合……"RCLICK"が返ります。
中クリックされた場合……"MCLICK" が返ります。
ホイールアップ／ダウンされた場合……"WHEELUP" "WHEELDOWN"が返ります。
キーが押された場合……それ ぞれに対応した文字列が返ります。英字は大文字で返ります。
　・英字１文字、数字はそのまま返ります。
　・"SPACE"　スペースキー
　 ・"RETURN"　リターンキー
　・"CTRL"　コントロールキー
　・"UP" "DOWN" "LEFT" "RIGHT" カーソルキー上下左右
　・"F1"〜"F12" ファンクションキー
　・"PAGEUP" "PAGEDOWN" ページアップ、ダウンキー
　・"SHIFT" シフトキー

数値変数に戻る値：
スプライトが押されたときにそのスプライト 番号を得る。それ以外の場合は-1が返る。

どの値が入力されても戻るので、必要のない値を受け取った場合はbexecに処理を戻してルー プすること。

bexec $0,%0

背景画像をロードします。一番上がファイルから、二つ目が単色での塗りつぶし指定、一番下が、黒、もしくは白 での塗りつぶし指定です。

特殊なサイズの背景を使いたいときに指定します。
x,yの位置から、width x heightドットの画像を置く、ということになります。

bgcpyでも同じ意味になります。現在の画面を背景画面と して取り込みます。
ofscpyもしくはofscopyとの違いは、背景画面になっているので、この上にテキストウィンドウなどを表示できること です。

圧縮された音楽ファイルをループで演奏する。mp3loop命令と同じ意味です。

bgm "bgm01.mp3"

音声再生時にＢＧＭボリュームを下げる。

bgmdownmode 1

bgmfadeoutと同じ要領で、フェードインの設定をしま す。

BGMのフェードアウトの時間を指定
define節で も実行節でも使えます。

圧縮された音楽ファイルを一度だけ演奏する。mp3と同じ意味です。

bgm "bgm01.mid"

圧縮された音楽ファイルの演奏を停止します。

bgmのボリュームを変えます。bgm命令とmp3命令で有効です。

bgmvol 100

高速に画面上で画像表示をしたいとき（ＡＩＲのオープニング のようなアニメーション処理）に使う命令です。
　ボタン画像バッファを利用しますので、事前にbtndefで画像を読みこんでください。
　 ボタン画像から読んでくる元画像の幅が画面上の幅と違うときは、画面にあわせて画像が拡大縮小されます。
（例えば、全画面のＸＹ半分のサイズの画 像を４つ描いたものをロードしておいて、高速に拡大しながら画面全体に表示していくと、残像効果でドットの荒さは見えず高速なアニメに見える、というテク ニックがＡＩＲでは使われています。）
　この命令はバッファを介さず直接スクリーンに画像を書きます。よって、終わった後は画面データが不定にな るので、下のofscpy命令を使った後、必ず別の画像をふつうのbg命令などで呼び出して、画像を確定してください。

　セーブによって も、この命令の結果としての画像がセーブされたりはしません。
　よって、使われる部分は限られてきます。（デモとか、ＳＬＧでの小窓アニメなど、 間にセーブやコマンド入力が挟まれないような処理）

画像ファイルを指定された分割数に分割してBMP形式で保存します。

bmpcut "test.bmp",3,2

一行、文字表示を改行する命令です。空行をはさみたいときに 使ってください。

一番内側のループをひとつ、途中で抜け出します。
す ぐ下のNEXT文を探し、その下へ抜けます。

二重ループを一気に外まで抜けることはできません。
一重めのループをBREAKで抜 けた後、さらに次のBREAKを書いてください。

【お勧めしない使い方】
BREAK *ラベル名
BREAK文に*ラベル 名があればそのラベルに飛びます。
ただし、ラベル指定でふたつのループを抜けても内部的には
一番内側のひとつしかループ状態を解除しませ ん。
先述のとおり、そういう使い方はスタックを無駄遣いするのと
ソースを見難くするのでお勧めはしません。

*define
game
*start
for %0=1 to 8
for %1=6 to 2 step -2
%0，%1
if %0=4 & %1=4 break
next
next
click
end

スプライトをボタンとして設定する。
パラメータを省略すると、マウスを重ねたときにセル１、マウスをは ずしたときにセル０、マウスをクリックしたときにセル２（セルがみっつ以上ある場合のみ）になる。
パラメータを三つ指定できる。それぞれ exbtnやspstrに指定するのと同じ文字列で、順に「マウスが重なっていないときの処理」「マウスが重なっているときの処理」「マウスを押したとき の処理」になる。
文字列には""を指定できるので、何もしないときには""にすること。

bsp 1 ;スプライト１番をボタンにする
bsp 2,"P3,0","P3,1","P4,1" ;スプライト２番をボタンにする。それぞれ重なっていないとき、重なったとき、押したときの処理を記述している。

ボタン処理を開始してからタイムアウトする時間を指定する。
時間の後で,1とすると、時間が経過して いてもボイス（dwaveチャンネル０）が再生し終わるまで待つ。これはオートモード等に使う。

btime 2000 ;２秒後にタイムアウトする。
btime 1000,1 ;１秒後にタイムアウトする。１秒を過ぎてもボイスが終了していなければ待つ。

左から順に、ボタン番号,x,y,wd,ht,x3,y3で す。
ボタンの定義命令です。ボタン番号>0です。
ゲーム画面上の(x,y)を左上として、サイズwd * htの範囲をボタンとして指定します。
その上にマウスカーソルがのると、ボタン画像ファイルの(x3,y3)を左上の点とする画像が表示されま す。
くわしくは、フォルダbtndemoにある説明.txtを参照下さい。

btndefの下で使ってください。
負ならば絶対値を取って、その数以上、正ならばその数以下の位置 にカーソルが来たときに、ボタン命令で-4を返します。

btndef clear
btnarea -400

ボタン画像ファイルを設定します。これを使うと、以前のボタン定義はクリアされます。
くわしくは、 フォルダbtndemoにある説明.txtを参照下さい。

btndefとbtnwait系命令の間に挟んでください。
そ のボタン命令において、ボタンの押しっぱなしを取得できるようににします。

btndown 1

ボタン時にテキストウィンドウが消えなくなります。

btnnowindowerase

次のbtnwaitもしくはbtnwait2の時間制限をミリ 秒で指定します。この命令を使った直後のボタンモードで、何も押されずに指定した時間が過ぎると、 btnwait系命令は-2を返します。

btntimeとほぼ同じだが、ボイスの発生終了まで待つ

btntime2 1000

実際にボタン処理します。数字変数に結果が戻ります。

戻り値：
０…どのボタンでもない ところをクリックした
−１…右クリックした
その他…ボタン番号

戻り値が０以下（ボタンを押していない）ときは、すぐにも ういちどbtnwaitを呼べば、また同じボタンモードに。
戻り値が１以上（実際にボタンを押した）ときは、押された瞬間の画像のままで、ボタン 定義は全てクリアされます。（メモリ節約のため）
くわしくは、フォルダbtndemoにある説明.txtを参照下さい。

実際にボタン処理します。数字変数に結果が戻ります。

戻り値：
０…どのボタンでもない ところをクリックした
−１…右クリックした
その他…ボタン番号

btnwait命令と違って、ボタン定義はクリアされませ ん。だから、ボタン画像ファイルは読まれっぱなしです。
ボタン処理が終わって、ボタンが要らなくなったら、他の処理がメモリを使えるように、 btndef ""でボタン定義をクリアして、ボタン画像を解放しておくことをお勧めします。

bclear命令とbexec命令の間にbtrans命令を 入れると、ボタン画像の透過部分には反応しなくなりました。

渡された文字列_w.bmpと渡された文字列_b.bmpから NScripter形式の透過画像を作ります。
付属しているbw2aconv.exeと同じ動作です。

＜豆知識＞
コマン ドプロンプトから
dir /b > filelist.txt
とかをやるとファイルリストが取れるので、
それと組み合わせ て一括変換に使うといいでしょう。

bw2a "test"

白抜きと黒抜きから、NScripter形式の透過画像を作り ます。
製作作業用の命令です。
nscripterと同じ位置にフォルダ"b"とフォルダ"w"を作り、それぞれ白抜きと黒抜きを入れてく ださい（白抜きと黒抜きについてはbw2aの説明をご覧ください）
ファイル名は元と同じでいいのがミソです。フォトショップのアクションを使えば 作業が効率化できるでしょう。

bw2a3 "test.bmp"

ウィンドウのタイトルを変えます。

ＣＤのフェードアウトに掛ける時間をミリ秒単位で指定します。

手動でスプライトのセルを指定します。内部状態を切り替えるだ けなので、あとでprintなどで画面に反映してください。

cellcheckspbtnのexbtnバージョンです。引数はexbtnと同じです。
スプライト がロードされ、かつ、セルが二つ以上あるときのみ拡張ボタンとして設定します。そうでないときは無視されます。
なお、exbtnについては「サン プル」「メニューのカスタマイズと複合ボタン」を参照してください。新機能S（音声再生）とM（スプライト移動）が増えています。

cellcheckexbtn 1,100,"P1,1P2"

基本的にはspbtnと同じですが、セルが二つ以上ない画像の場合は無視されます。
これはＣＧモードの ときに有効に使えます。
（つまり、サムネイルはセルがひとつだけにしておけば、
　spbtn登録はループで一気に行える）

for %0=0 to 9
  cellcheckspbtn %0,%0+1
next

out.bmpの隣にその画像ファイルを貼り付けていきます。
out.bmpが無ければ作成します。

キーの押下状態を取得します。
文字列には、英字１文字、数字、スペースなどはそのまま指定できます。
"SPACE" でもスペースキーは取得できます。
"RETURN" "ENTER" リターンキー
"CTRL" コントロールキー
"UP" "DOWN" "LEFT" "RIGHT" カーソルキー上下左右
"F1"〜"F12" ファンクションキー
"PAGEUP" "PAGEDOWN" ページアップ、ダウンキー
"SHIFT" シフトキー
を指定します。

checkkey %1," "

回想文字列を取得できるかどうかを調べます。
第一引数 は結果を格納する数字変数、第二引数は何ページ前かを指定します。
1で取得可能、0で不可能です。第二引数には１以上を指定してください。
０ は現在のページなので、この関数を使わなくても処理できるはずです。

checkpage %5,1

これで、「ファイル名」のファイルがあるＣＤドライブを検索します。
もしＣＤが入っていなければ指定 した文字列のエラーポップアップを表示します。
ボタンは「再試行」と「キャンセル」です。

chkcdfile "file.dat","CDがありません"

これで、「ファイル名」のファイルがあるＣＤドライブを検索します。
もしＣＤが入っていれば１、なけ れば０を返します。

chkcdfile_ex %0,"file.dat"

dwaveチャンネルのボリュームを変えます。

chvol 3,100

その位置の立ち絵を消します。
aはすべて消すことを 意味します。

クリックを待ちます。

クリック待ちをして、クリックした位置を取得します。Ｘ座標、Ｙ座標です。

通常、クリックによってメッセージが次のクリック待ちまで瞬 時表示になりますが、この時、通常クリック待ちではなくそのページの改頁待ちまで一気に飛ぶようにします。
define節専用命令です。

強制クリック待ち機能をオンにします。これを実行すると、特定 の文字を表示したらクリック待ちするように作れます。
ただし、その直後に本来のクリック待ち文字がある場合、もしくは、強制クリック文字の前に _（半角アンダーバー）がある場合は、強制クリック待ちはされません。
強制クリック待ち時に、単なるクリック待ちか改ページになるかは、二番目の パラメータが決めます。（最大行−数字）よりも下で強制クリック文字を見つけたときは、改ページになります。
この機能は、作業の簡便化には役立つ のですが、次の一行が非常に長く、数字設定よりも上の行から始まって字がはみ出すような現象を防ぐことまではできません。
その場合は、そこだけ本 来の改ページ文字を使うか、数字を変えてください。文字列は全角文字のみ許されます。

click "」。！？",2

クリック待ちでクリックしたときになるWAVEファイルを指定 します。
順に、普通のクリック待ち、改ページクリック待ち、です。

文字列同士を比べて、等しければ０、等しくなければそれ以外を、数字変数に代入します。
右のほうが大 きい場合、負、左のほうが大きい場合、正が帰ります。

三角関数cosθを取得します。
値は１０００倍されたものが返ってきます。

cos %1,60
;%0=1000になる。

指定された名前でダミーBMPファイル(640.480)を作ります。
真っ白背景に黒字でファイル名 がでかでか書かれます。

createdummy "test.bmp"

システムカスタマイズ時の選択肢命令。*customsel を呼び出すために使う。書式はselectと一緒。

csel "選択肢１",*s1,"選択肢２",*s2,"選択肢３",*s3

選択肢のテキストでボタンを作る。文字列とスプライト番号の指定が不要。

cselbtn 0,500,%1,%2

cselで設定したラベルへ飛ぶ。

cselgoto %0

そのスプライトを消去します。
-1を指定すると、すべ てのスプライトを消去します。

拡張スプライトを消去します。

csp2 0

csvファイルを閉じます。この命令で閉じないと開きっぱな しですので、使い終わったら閉じるようにしてください。

csvclose

（読み取りモード専用です）
csvファイルを最後まで 読み終わっていれば1、終わっていなければ0を返します。

csveof %1

csvファイルを開きます。一つ目の文字列はファイル名です。
nsaの中に格納しているファイルも読み 出すことが出来ます。
二つ目の文字列は、モード指定です。次のように指定します。
"r"……読み取りモード。通常のcsvファイルを読み ます。
"rc"……暗号化csv読み取りモード。wcで書き込んだcsvファイルを読みます。
"w"……書き込みモード。csvファイル に書き込みます。
"wc"……暗号化書き込みモード。csvファイルを暗号化して書き込みます。

csvopen "test.csv","r"

csvopen "angou.csv","wc"

（読み取りモード専用です）
csvファイルからデータを読み出します。指定した順に読み取ります。

csvread $0,$1,%0,%2

（書き込みモード専用です）
csvファイルにデータを書き込みます。指定した順に書き込みます。

csvwrite 12,"test",%1,$2

マシンの現在の年月日を取得します。

デバッグウィンドウに表示される文をdebuglog.txt というテキストファイルに保存していくことが出来る命令です。
debuglog 1でオン、debuglog 0でオフです。define節でもstart以降でも使えます。

その変数の値を１減らします。

デフォルトのフォントを指定します。
指定しなければ、ＭＳ ゴシックが使われます。

特殊表示文字!sdまたはtextspeeddefault命 令を呼び出したときの時の文字速度の指定です。
左から順に、メニューから「低速」「普通」「高速」を選んだときの速度です。

defaultspeed 50,20,0

BGMのデフォルトボリュームをいじれます。デフォルトでは １００（０から１００です。）

定義リセット命令です。*define節から読みなおしま す。

mov %200,1
definereset

MP3(BGM)のデフォルトボリュームをいじれます。デフォ ルトでは１００（０から１００です。）

SE(DWAVE 1〜)のデフォルトボリュームをいじれます。デフォルトでは１００（０から１００です。）

指定した名前のユーザ定義命令を作ります。
実際にはサブルーチンとして実装されます。
命令名 は変数と同じ法則で名づけることが出来ますが、先頭に_を使うことだけは出来ません。

defsub subname

以降のスクリプトで
subname
とあると、
*subname
にgosubジャンプする。

voice(DWAVE 0)のデフォルトボリュームをいじれます。デフォルトでは１００（０から１００です。）

数字ミリ秒分だけ、待ちます。クリックで飛ばせます。
特殊表示文字dと同じですが、変数を引数に使え ます。

NScrからWindowsのメニューバーをなくせます。

deletemenu

メモリ内に確保したスクリーンショットを削除します。
savescreenshot2 命令と組み合わせて使います。

deletescreenshot

配列変数はBASIC式です。つまり、この宣言だと、?0 は、
一次元目が0〜10の、二次元目が0〜20の添字を使えます。

例のとおり、今まで「数字」となっていたところならどこでも
配 列変数を使えます。

mov ?0[2][5],20
;?0[2][5]に20を代入。
mov %4,?0[3][1]
;%4に?0[3][1]を代入。
？０［２］［３］＝?0[2][3]@
;値を表示

numalias enemyparam,10
dim ?enemyparam[10]

その変数を、数字で割ります。整数、小数点以下切り捨てで答えが出ます。

draw系命令で描画した画像を実画面に転送します。
こ れがないと表示されません。

*test
saveoff
;デモ処理はsaveoffしたほうが速くなります。終わったらsaveonを忘れずに
mov %0,0
bg "bg.bmp",1
*lp
resettimer
drawclear
drawbg2 320,240,100,100,%0*2
draw
wait 5
;ウェイトを多少いれないと、メッセージ処理が遅れがちになります。
gettimer %1
if %1>=50 add %0,%1/50
if %1<50 waittimer 50:inc %0
;掛かった処理時間に比例して変数を変化させます。
goto *lp

ＢＧ画面を描画します。

drawbg

ＢＧ画面を描画します。(x,y)で位置を指定します。
x_scale、y_scaleは、縦横の拡 大率です。単位は％です。
rotは回転の角度です。反時計回りで、単位は度です。
なお、はみ出た部分は描画されないので前の画像が残りま す。
それではまずい場合は、事前にdrawclearなどで消しておいて下さい。

drawbg2 320,240,200,300,15

画面を黒く塗りつぶします。

drawclear

画面をその色で塗りつぶします。
ＲＧＢで、それぞれ ０〜２５５を指定します。

drawfill 255,0,128

スプライトを描画します。
スプライト番号、セル番号、透過度、表示先左上x座標,表示先左上y座標を 指定します。
通常モードでのスプライトの位置、表示非表示は関係ありません。
スプライトやテキストウィンドウは、新しく書いたほうが上へ 重なります。

drawsp 2,1,128,20,40

スプライトを描画します。
スプライト番号、セル番 号、透過度、表示先中心x座標,表示先中心y座標を指定します。
通常モードでのスプライトの位置、表示非表示は関係ありません。
スプライ トやテキストウィンドウは、新しく書いたほうが上へ重なります。

drawsp2 2,1,128,20,40,150,60,-10

drawsp系の命令で、一次変換を実現するものです。
ス プライトを描画します。
スプライト番号、セル番号、透過度、α値、表示先中心x座標,表示先中心y座標、行列の要素左上、右上、左下、左下の順で 指定します。
行列の要素は実際の１０００倍の値になります。

drawsp3 2,1,128,20,40,1500,300,800,1200

テキストウィンドウを描きます。
これより前に書いた スプライトは下に、後に書いたスプライトは上に来ます。

drawtext

define節で使います。DirectSoundを使うこ とを宣言します。この命令を使うには、DirectX2もしくはそれ以降が必要です。 (この命令は現在のバージョンでは使う必要がなくなっています）

ボイスを入れるときに便利な命令です。
dwave 0,"wav\数字.wav"と等価です。

dv0001:「これが０００１番のせりふだよー」

DirectSoundでＷＡＶファイルを演奏します。
数字はチャンネルＮＯで、０から４９までで す。
違うチャンネルの音はミキシングされて同時再生されます。
なお、オートモードでの再生終了待ちはチャンネル０で行います。
再 生できるのはＰＣＭ形式だけです。
wave系命令と同時に使用することも出来るので、たとえばMP3コーデックでの ＢＧＭをwaveloop命令で鳴らしつつ、こっちで音声再生という使い方が出来ます。

dwave 0,"test.wav"

演奏前にWAVをメモリにロードしdwaveplay dwaveplayloopで再生します

dwaveload 0,"test.wav"
dwaveplay 0

dwaveと同じ書式ですが、こっちはループ再生します。

dwaveloadでメモリにロードしたWAVを一度だけ再生 します。

dwaveloadでメモリにロードしたWAVをループで再生 します。

そのチャンネルの再生を止めます。