Lua標準関数のdofileではNSAやNS2アーカイブの中のファイルは実行できませんが、
NL_dofileはアーカイブの中のファイルも実行できます。
もちろん、system.luaもアーカイブの中から実行できます。

NL_dofile("lib.lua")

　　セルアニメーションと同じく、一定時間経過ごとに呼び出されます。
　　引数はありません。
　　戻り値にtrueを返すと画面を更新します。falseだと画面を更新しません。

function NSCALL_animation()

　　ウィンドウの「閉じる」をクリックしたときの動作を指定します。
　　引数はありません。戻り値trueでプログラムを終了、falseでキャンセルです。
　　戻り値：この後の動作（trueで終了処理の続行、falseでキャンセル）

function NSCALL_close ()

　　プログラムが終了する直前の動作を指定します。
　　引数も戻り値もありません。

function NSCALL_end ()

　　セーブデータがロードされた直後に呼び出されます。
　　saveコールバック関数で保存したデータを読み込んで処理をしてください。
　　引数はセーブ番号、戻り値はありません。

function NSCALL_load(savenum)

　　*define節からgame命令によって、もしくはリセットによって*startに飛んだときに呼ばれます。

function NSCALL_reset()

　　シナリオスクリプト側のデータが実際にセーブされる直前に呼び出されます。
　　セーブされるべきなのは、この関数が呼び出されたそのときのデータではなく、
　　最後に到達したセーブポイント時点でのデータです。間違わないようご注意ください。
　　引数はセーブ番号、戻り値はありません。

function NSCALL_save(savenum)

　　セーブポイントに到達したときに呼び出されます。
　　Lua側でセーブしておきたいデータがある場合はこの段階でメモリ内のセーブデータを更新してください。
　　引数も戻り値もありません。

function NSCALL_savepoint()

　　デフォルトのpretextgosubのタイミングで呼び出されます。
　　この命令を使うとデフォルトの処理は行われなくなります。pregextgosubも無効になります。

function NSCALL_tag(tag)

　　表示文の、変換が終わったものが送られます。実際に表示される文字列です。
　　テキストを表示します。@や\を読み込んだら対応するクリック待ちも行ってください。

function NSCALL_text(printstr)

　　表示文の、表示テキストが渡されたタイミングで呼び出されます。
　　この段階では変数を展開したり半角数字を全角に直したりしていません。
　　自動で変換をしたくない場合はこちらを設定します。

function NSCALL_text0(plainstr)

次の記号がコンマかどうかを調べます。読み込みはしません。引数の数を変えたいときに使います。

b=NSCheckComma() -- 次がコンマならb=true コンマでなければb=falseが代入される。

click命令と等価です。

NSClick()

luasub func
この命令を実行すると、以後シナリオスクリプト（00.txt〜）でfunc命令を実行したときに、
Lua関数 NSCOM_func() が呼び出されます。
luasubで登録されるLua関数には引数も戻り値もありません。
引数や戻り値はそれぞれ下で説明している関数を使って利用してください。
なお、既存の命令も上書きできます。
たとえばluasub bgとすると、もともとのbg命令ではなくluaのNSCOM_bg関数が優先されます。
もともとのbg命令を呼びたい場合は、defsubのときと同様_bgとしてください。

--- NScripter ---
*define
luasub func
game
*start
func
\
end

--- Lua ---
function NSCOM_func(){
    NSExec("puttext \"成功\"")
}

0.txt 00.txt nscript.datがなくて、system.luaだけがあるとき、system.luaだけで起動するようになりました。
;mode800等の設定は、一行目に--mode800 などのようにして行います（動作は0.txtの時と同じ）

--mode800

function NSCOM_main(){
    NSExec("puttext \"起動した！\"")
    NSClick()
    NSEnd()
}

テクスチャをそのまま画面にコピーします。
numはテクスチャ番号です。
dx,dyは転送先、画面上の左上の点の座標。sx,syは転送元、テクスチャ上の左上の点の座標、w,hは幅と高さです。
矩形を重ね合わせを考慮せずそのままコピーしますので、ここから先で説明しているNSDSp〜系の命令よりも高速です。
αブレンディングも重ね合わせや変形の必要もない画像はなるべくこの関数で描画してください。

NSDBlt(0,0,64,32,32,64,0)

テクスチャ作成時に、外部DLLを使ってテクスチャの中身をバイト単位で設定できます。
NSD系のテクスチャは作成時の内容を変更することが出来ません。
例えば、フォントを出力するような外部DLLを使って、文字フォントのテクスチャを作ることが出来ます。
なお、引数paramがない場合は省略できます（この場合、DLLにはNULLが送られます）。
呼び出されるDLL関数の型は次の通りにしてください。
void Func (unsigned char *ptr,int w,int h,const char *param);
paramは呼び出し元から渡された文字列引数です。指定されなかった場合はNULLが入ります。
wは画像の幅、hは画像の高さです。
ptrはビットデータ配列です。
(x,y)ピクセルのデータはptr[x*4+y*w*4]〜ptr[x*4+y*w*4+3]にあります。
x*4+y*w*4=posとおくと、p[pos]=青 p[pos+1]=緑 p[pos+2]=赤 p[pos+3]=α値です。

NSDCall(10,"*200,60",fontproc,"20,20,あいうえお")

NSDCall(8,"test.png",filterproc,"gauss")

画面を真っ黒でクリアします。

NSDClear()

NSD〜系の画像処理は、NScripterの描画処理とは独立しています。
したがって、Lua関数から抜けたり、Lua内部からNScripterの元々の機能を呼び出すと、描画している画像は全部上書きされてしまいます。
残す必要がある場合は、この関数を実行することで、今現在の画面をNScripter上の「背景画面」としてコピーすることが出来ます。
なお、この命令はNScripter側のBGロードと同じ処理をしていますので、立ち絵は全部消去されます。

NSDCopyToBg()

テクスチャを削除します。なお、明示的に削除しなくても、同じ番号にテクスチャをロードすると古いテクスチャは削除されます。
　使わなくなったテクスチャは削除するとメモリが節約できます。

NSDDelete(0)

NSD系命令のテクスチャ作成時に呼び出すDLL関数を設定します。
Luaファイル読み込み時に一度だけ実行してください。
戻り値の番号はNSDCall関数にて引数に指定します。

fontproc=NSDDLL("deffont.dll","Font")

numにはスプライン補間のデータ番号（０〜９９）を指定します。
xarrayにxの座標を小さい順に格納した配列、yarrayにそのxにそれぞれ対応するyの値を格納した配列を渡します。
スプライン補間に必要な計算をして、そのデータ番号に登録します。

画面の指定した領域を指定した色で塗りつぶします。
それぞれ、左上の座標、右下の座標、RGBの指定（0〜255で）です。

NSDFill(0,0,639,479,255,255,255)

テクスチャのサイズを取得します。

width,height=NSDGetSize(0)

PNGファイルをテクスチャとしてロードします。アーカイブからでも裸でも読めます（ただし最新版のnspng.dllが必要）
numはテクスチャ番号です。0から15が指定できます。
この関数群は画像の一部を指定して転送することが出来ますので、一緒に使うチップは連結してまとめて置いてください。
（これは、将来的にグラフィックカードのテクスチャ機能に置き換えるときに、テクスチャ切り替えを少なくして高速化するためです）

NSDLoad(2,"test.png")

NSDLoad(3,"*32,32")
-- 色指定を省略すると完全透明なテクスチャになります。
-- これはNSDLoadでは使い道がありませんが、後で説明するNSDCallで使います

NSDLoad(4,"*48,24,128,64,32,255")

時間のかかる関数からは時々これを呼んでWindowsのメッセージを処理してください。
戻り値は終了フラグです。trueのときは直ちに関数から抜けてNScripterに処理を戻してください。

b=NSDoEvents() -- b==trueのときは処理をやめてLua関数から抜けること

NSDOffMode(true)で、NSD系命令の書きこみ先をオフスクリーンバッファに変更します。
NSDOffMode(false)で、NSD系命令の書きこみ先は画面になります。デフォルトの書き込み先は画面です。
NSDOffMode(true)の時は、NSDPresent、NSDPresentRectは使えません（画面には書きこんでいないため）。
この命令は、次のNSDTransitionと組み合わせて、トランジションを実現するために使います。

NSDOffMode(true)

画面を実際に更新します。ウィンドウ内が再描画されます。
NSDPresent()は全画面、NSDPresetnRect(lx,ly,rx,ry)は指定した矩形領域が再描画されます（それぞれ左上座標、右上座標です）

NSDPresent()

画面を実際に更新します。ウィンドウ内が再描画されます。
NSDPresent()は全画面、NSDPresetnRect(lx,ly,rx,ry)は指定した矩形領域が再描画されます（それぞれ左上座標、右上座標です）

NSDPresentRect(0,0,319,479)

NSD系命令用のテクスチャを、NScripterのスプライトに変換します。
タグは省略すると"a;"になります。
NSD系命令のテクスチャは常にα付きなので、:a以外には変換できません。
NSD系命令のテクスチャにはセルやアニメ設定の概念がないので、設定が必要ならタグを指定する必要があります。
DLLで作ったフォント画像をNScripterのテクスチャにしたい時などに使えると思います。

NSDSetSprite(0,8)

NSDSetSprite(3,10,":a/2,0,3;")

テクスチャをα値を考慮して重ね合わせで表示します。拡大縮小回転などの変形処理は行われません。
numはテクスチャ番号です。
dx,dyは転送先、画面上の左上の点の座標。sx,syは転送元、テクスチャ上の左上の点の座標、w,hは幅と高さ、alphaは全体のα値です。
転送元のテクスチャ画像のα値をそのまま使いたい場合は、alphaには255を指定して下さい。

NSDSp(0,0,64,32,32,64,0,128)

テクスチャを回転拡大縮小などの変形処理を加えて画面に転送します。
numはテクスチャ番号です。
dcx,dcyは転送先画面の「中心の」座標、sx,syは転送元テクスチャの「左上の」座標、w,hはテクスチャの「変形前の」幅と高さです。
xs,ysは横・縦の倍率（少数で、1.0が元のサイズ）,rotは回転角（度単位で、少数で、0.0が回転無し）です。alphaは全体のα値です。

NSDSp2(0,16,80,64,0,32,32,0.5,0.5,90,128)

テクスチャを回転拡大縮小などの変形処理を加えて画面に転送します。
numはテクスチャ番号です。
dcx,dcyは転送先画面の「中心の」座標、sx,syは転送元テクスチャの「左上の」座標、w,hはテクスチャの「変形前の」幅と高さです。
xs,ysは横・縦の倍率（少数で、1.0が元のサイズ）,rotは回転角（度単位で、少数で、0.0が回転無し）です。alphaは全体のα値です。

NSDSp2Add(0,16,80,64,0,32,32,0.5,0.5,90,128)

テクスチャをα値を考慮して、加算合成で表示します。その他はNSDSpと同じです。

NSDSpAdd(0,0,64,32,32,64,0,128)

NSDOffMode(true)でオフスクリーンに描き込まれた画像を、実際に画面に反映します。
この関数は、一端画像をNScripterのデータに書き戻してNScripter側のエフェクト処理を呼んでいますので、NScripter側のエフェクトと同程度の重さの処理になります。
NSD〜系の描画だけで実現できるエフェクトは、そちらで実装したほうが高速になります。
このとき、NScripterと同じエフェクトが使えます。また、この関数は引数を省略できます。

NSDTransition(1)

NSDTransition(10,500)

NSDTransition(18,1000,"rule.png")

NSDTransition関数は、CTRLキーで高速化したりスペースやクリックでキャンセルしたり出来ます。
NSDTransitionFは高速化やキャンセルが出来ないトランジションを実行します。
そのほかはNSDTransitionと同じです。

NSDTransitionF(1)

NScripterの動作を終了します。

NSEnd()

　文字列で指定されたNScripterの命令を実行します。
　命令は一回にひとつだけです。:によるマルチステートメントは使えません。
　複数の命令を実行したい場合は、この命令を続けて複数回呼んでください。
　goto gosub selectなどジャンプが伴う命令、for next命令は使えません。
　命令がLuaを呼び出してもかまいませんが、そこからNSExecを二重に呼んではいけません。
　if文は使えますが、マルチステートメントが使えないので、Lua側のifのほうが書きやすいと思います。

NSExec("amsp 10,100,50")

NScripterのアニメーション処理を実行します。
普段は定期的に呼ばれている関数ですが、Lua内からは自動では呼ばれないので、
アニメーションを実行する必要がある場合は、時々この命令を呼んでください。
（メッセージ待ちの時などに呼ぶのが一般的な使い方です）

NSExecAnimation()

最後に入力されたマウスクリックを取得します。
lは左クリックアップ（trueかfalse）、rは右クリックアップ（trueかfalse）、wはホイール入力（整数）
ldは左クリックダウン（trueかfalse）、rdは右クリックダウン（trueかfalse）です。
基本的にはlとrとwを見ておけばいいです。アクションゲーム等でldやrdを使うこともあるかもしれません。
Luaは戻り値を省略できるので、後ろが必要ない場合は省けます。

l=NSGetMouse() -- 左クリックだけ取得
l,r,w=NSGetMouse() -- 左右クリックとホイールを取得
l,r,w,ld,rd=NSGetMouse() -- 全部取得

指定したファイルfilenameをnsaもしくはns2アーカイブから探し、
アーカイブのファイル名arcnameと、スタート位置offset（ファイル先頭から）と、
サイズlength（単位バイト）を返します。
ただし、アーカイブでなく生でそのファイルがある場合は、
arcnameにはfilenameそのまま、位置とサイズにはともに０を返します。
（生ファイルのサイズを代入するわけではないので注意）
ファイルがなかったときはarcnameにnilを返します。

arcname,offset,length=NSGetFileInfo("test.dat")

NScripterの数値変数から値を取得します。

num=NSGetIntValue(10) -- %10の値が返る。

そのキーが今押されているかどうかをtrueかfalseで返します。
NScripter命令の「checkkey」とだいたい同じです。
keycodeには次の文字列が指定できます。
　・英字１文字、数字、スペースなどはそのまま指定できます。
　・"ESC" エスケープキー
　・"SPACE"でもスペースキーは取得できます。
　・"RETURN" "ENTER" リターンキー
　・"CTRL" コントロールキー
　・"UP" "DOWN" "LEFT" "RIGHT" カーソルキー上下左右
　・"F1"〜"F12" ファンクションキー
　・"PAGEUP" "PAGEDOWN" ページアップ、ダウンキー
　・"SHIFT" シフトキー

b=checkkey("CTRL") -- CTRLキーが押されていればtrue

マウスの位置を取得します。画面外の場合は-1,-1が返ります。

x,y=NSGetMouse()

スキップ状態を取得します。0=スキップモードではない 1=スキップモード 2=オートモード です。

skipmode=NSGetSkip()

NScripterの文字列変数から値を取得します。

str=NSGetStrValue(12) -- $12の値が返る。

NScripterのウィンドウの表示領域の大きさを得ます。

width,height=NSGetWindowSize()

　文字列で指定したラベルにgosubジャンプします。つまりシナリオスクリプトのgosub命令と等価です。

NSGosub ("*sub")

　文字列で指定したラベルにgotoジャンプします。つまりシナリオスクリプトのgoto命令と等価です。
　ここで、ジャンプするのはあくまでシナリオスクリプト(00.txt等)の実行位置であり、
　Luaの実行はそのまま続行されることに注意してください。

NSGoto ("*loop")

無効領域を追加します。この後NSUpdateで再描画します。

NSInvalidate(10,10,100,100) -- (10,10)-(100,100) 幅と高さではなく、「座標」です。

点x0,y0と点x1,y1を通るような関数fの、y=f(x)の値を求めます。

y=NSLinear(1,5,3,15,4)

アニメーション割り込みの発生間隔を指定します。
ミリ秒単位で指定出来ますが、その時間で必ず来るとは限りません。
物理的に間に合わない場合はかなり遅れて飛んでくることになります。
実際にどのタイミングで呼び出されたかは、NSTimer()を使って取得してください。

NSLuaAnimationInterval(20) -- 20ミリ秒に一回呼ばれる

NSLuaアニメーション割り込みを開始したり止めたり出来ます。
デフォルトはfalseですので、設定が終わったらこの関数でtrueを指定して、
割り込みを開始してください。Luaで操作したいオブジェクトがひとつもないときは、
falseを指定して割り込みをとめることが出来ます。trueを指定すればまた割り込みが発生します。

NSLuaAnimationMode(true)

指定したチャンネルの演奏を終了します。

NSOggClose(4)

指定したチャンネルをフェード操作します。startvolからendvolまで変化します。timeの単位はミリ秒です。
closeflag=trueでフェード終了後ファイルをクローズします。falseの時は演奏続行です。

NSOggFade(4,-10000,0,1000,false)

指定したチャンネルが演奏していればtrue していなければfalseが返ります。

isp=NSOggIsPlaying(10)

ストリーミング再生チャンネルchにファイルをロードします。再生はしません。
nsogg2.dllが必要です。

NSOggLoad(3,"se.ogg")

ロードしたファイルを再生します。isloop=trueでループ、falseで一回だけです。
nsogg2.dllが必要です。

NSOggPlay(3,false)

ロードしたファイルを再生します。ループ開始点を指定できます。
単位は秒で、double型（実数型）で指定できます。

NSOggPlay2(4,1.4142)

指定したチャンネルの音量を変更します。
0〜-10000が指定できます。0が最大、-10000が最小です。

NSOggVolume(3,0)

ダイアログボックスを表示します。
NScripterでいうmesbox命令ですが、本文とタイトルの指定順が逆になっていますのでご注意ください。
（こちらのほうがWindowsでは標準のようなので、標準に従うことにしました。）

NSOkBox("本文です","タイトルです。")

引数列のコンマをひとつ読み飛ばします。引数と引数の間には普通コンマがあります。

NSPopComma()

NScripterの識別子形式の文字列の引数をひとつ読み込みます。大文字が含まれていた場合小文字に変換されます。
識別子形式とは、たとえばbg命令のblackやwhiteだとか、ld命令のl r cだとかのように、""で囲まれていない文字列です。

id=NSPopID()

NScripterの数値の引数をひとつ読み込みます。

number=NSPopInt()

NScripterの数値変数引数の番号をひとつ読み込みます。%5なら5です。

ivalindex=NSPopIntRef()

NScripterのラベル名をひとつ読み込みます。大文字だった場合小文字に変換されます。

label=NSPopLabel()

NScripterの文字列の引数をひとつ読み込みます。

str=NSPopStr()

NScripterの文字列変数引数の番号をひとつ読み込みます。$10なら10です。

svalindex=NSPopStrRef()

　シナリオスクリプトのサブルーチンからreturnします。つまりシナリオスクリプトのreturn命令と等価です。

NSReturn()

NSExec("savepoint")は駄目です。NSSavePoint()という専用の関数を使ってください。

NSSavePoint()

NScripterの数値変数に値を設定します。

NSSetIntValue(3,10) -- %3=10

NScripterの文字列変数に値を設定します。

NSSetStrValue(10,"test") -- $10="test"

指定した時間（ミリ秒単位）ほかのスレッドに動作を明け渡します。
NScripter命令の「wait」とだいたい同じです。
動作をすぐにNScripterに戻すスクリプトでは必要ありませんが、
長時間Luaスクリプトを走らせっぱなしにするとCPU使用率が上がるので、
適度にNSSleep(1)とかNSSleep(2)とかを呼んでCPU使用率を下げてください。

NSSleep(1)

拡張スプライトを消去します。
この命令だけでは画面に反映されませんのでNSUpdate()を呼んでください。

NSSp2Clear(2)

拡張スプライトの情報を得ます。幅、高さ、セル数が得られます。

w,h=NSSp2GetInfo(2)

拡張スプライトの位置を得ます。中心座標Ｘ，Ｙ，横倍率,縦倍率,回転角,α値,出力オプションが得られます。

cx,cy=NSSp2GetPos(7)

拡張スプライト（lsp2系）をロードします。
画面外にロードしますので、移動しないと見えません。

NSSp2Load(0,":a/2,0,3;test.bmp")

拡張スプライトを移動します。
この命令だけでは画面に反映されませんのでNSUpdate()を呼んでください。
ope=0で普通、ope=1で加算ブレンディング、ope=2で減算ブレンディングです。

NSSp2Move(0,100,100,100,100,45,255,0)

拡張スプライトを表示したり消したりします。trueで表示、falseで非表示です。
この命令だけでは画面に反映されませんのでNSUpdate()を呼んでください。

NSSp2Visible(1,true)

スプライトのセルを設定します。

NSSpCell(4,0)

スプライトを消去します。
この命令だけでは画面に反映されませんのでNSUpdate()を呼んでください。

NSSpClear(2)

スプライトの情報を得ます。幅、高さ、セル数が得られます。

w,h=NSSpGetInfo(2)

スプライトの位置を得ます。左上座標Ｘ，Ｙ，α値が得られます。

lx,ly=NSSpGetPos(2)

NSDefSplineで定義したデータ番号を指定し、求めたいxの値を指定すると、スプライン補間によってyの値が返ります。
ここで、xはxarrayに指定した最小値と最大値の間になくてはなりません。

xa={1,2,4} ya={2,4,8}
NSDefSpline(0,xa,ya)
y=NSSpline(0,3)

普通のスプライト（lsp系）をロードします。
ファイル名にはlspで使えるのと同じタグが使えます。
画面外にロードしますので、移動しないと見えません。

NSSpLoad(0,":a/2,0,3;test.bmp")

スプライトを移動します。
mspと同じく、この命令だけでは画面に反映されません。
適切なタイミングでNSUpdate()を呼んでください。
（ほかのスプライトも全部描画してからまとめて呼んだほうが効率がいいです）

NSSpMove(3,100,100,255)

スプライトを表示したり消したりします。trueで表示、falseで非表示です。
この命令だけでは画面に反映されませんのでNSUpdate()を呼んでください。

NSSpVisible(1,true)

指定したNScripterの機能を呼び出します。
NScripter命令で言うmenu_???命令やsystemcall命令等をまとめたものです。
メッセージを送るだけなので、即時実行されないこともあります。
（その場合、NScripterが次にメッセージを処理したときに実行されます）
次の文字列が指定できます。
★close 　「閉じる」ボタンを押したのと同じ動作をします。
★end 　NScripterを終了します。何も聞いてこないので注意してください。end命令と同じです。
★reset 　NScripterをリセットします。何も聞いてこないので注意してください。reset命令と同じです。
★full 　フルスクリーン化します。
★window 　ウィンドウ化します。
★automode　オートモード状態にします。
★skip 　スキップ状態にします。
★skipoff 　スキップ状態を解除します。

NSSystemCall("close")

1msに1増え続けるタイマーを取得します。resettimer gettimerと同じ精度です。
Windowsが起動してから経過したミリ秒を指すカウンタは、ひたすら増えていくだけです。
この関数からは値を取得することしか出来ません。二回呼び出して、その差をとることで、
経過時間が正確にわかります。

count=NSTimer()

無効領域を再描画します。print 1と等価です。

NSUpdate()

はい／いいえをたずねるダイアログボックスを表示します。戻り値はbooleanです。
NScripterでいうyesnobox命令ですが、本文とタイトルが逆になっていますのでご注意ください。

result=NSYesNoBox("質問です","タイトルです") -- はいを押せばresult=true、いいえならresult=false