(c)AVG MAKER DS
– By Hewenxie
腳本指令說明書
v0.9
無特殊說明每條指令均為@開頭，以;結尾。
指令前加//，即為註釋掉該行，被註釋掉的指令不會執行。如//@say(.....);
壹. 對話文字顯示指令
前置說明：對話顯示內容支持字體顏色。
字體顏色默認為白色，如要對字體顏色操作，請使用%cX，X為0～9任意數字，對應顏色如下：
1-白色(white)，2-紅色(red)，3-綠色(green)，4-藍色(blue)，5-紫色(purple)，
6-青色(cyan)，7-黃色(yellow)，8-淡灰色(light grey)，9-深灰色(dark grey)，0-黑色(black)
1. @say
1.1 功能：
人物對話顯示功能，在對話框中進行顯示。
1.2 腳本指令原型：
@say(style, isAnimation, name, content)
1.3 參數說明：
1. style：0-普通模式 1-有頭像模式（會空出壹塊空間用於顯示頭像）
2. isAnimation：人物說話是否有動畫效果，具體效果與@anim()有關。1-有動畫效果，0-無動畫效果
3. name：說話人物名字。如果不需要名字，置空即可
4. content：說話內容。註意用英文模式下的""包含其內容，格式如"妳好！"，引號內部不再兼容英文雙引號，中文雙引號兼容。
1.4 例：
@say(0,0,,"妳好！我是%c2靜%c1，初次見面！請多多關照！");
2. @boxText
2.1 功能：
框文字顯示功能，將文字在矩形框中進行顯示。
2.2 腳本指令原型：
@boxText(screen, basex, basey, maxx, maxy, verbatim, content)
2.3 參數說明：
1. screen：顯示用屏幕，0-上屏，1-下屏
2. basex：用於顯示文字的矩形框左上角頂點的x坐標
3. basey：用於顯示文字的矩形框左上角頂點的y坐標
4. maxx：用於顯示文字的矩形框右下角頂點的x坐標
5. maxy：用於顯示文字的矩形框右下角頂點的y坐標
6. verbatim：是否逐字顯示。0-否，1-逐字顯示
7. content：說話內容。註意用英文模式下的""包含其內容，格式如"妳好！"，引號內部不再兼容英文雙引號，中文雙引號兼容。
2.4 例：
@boxText(1,20,20,200,150,1,"妳即將進入AVG的美妙世界！");
二. 圖像相關操作指令
1. @chara
1.1 功能：
變更人物圖像，支持漸變效果。
1.2 腳本指令原型：
@chara(path, isAlpha)
1.3 參數說明：
1. path：人物圖象文件路徑。文件名後不寫文件後綴。
2. isAlpha：是否打開漸變進出效果。0-不打開，1-打開
1.4 例：
@chara(avgFiles/chara/chara1, 1);
2. @clearChara
2.1 功能：
擦除人物圖像。
2.2 腳本指令原型：
@clearChara()
2.3 參數說明：
無參數
2.4 例：
@clearChara();
3. @anim
3.1 功能：
加載動畫幀圖像。此動畫幀在對話過程中實現說話動作。
註意：由於此功能支持並不好，所以不建議使用。要使用的話圖像長寬最好不要超過16*16。
3.2 腳本指令原型：
@anim(path, width, height, x, y)
3.3 參數說明：
1. path：圖象文件路徑。文件名後不寫文件後綴。
2. width：圖像寬度。
3. height：圖象高度。
4. x：顯示圖像的x坐標。
5. y：顯示圖像的y坐標。
3.4 例：
@anim(avgFiles/chara/anim1, 16,16, 128,50);
4. @bg
4.1 功能：
加載背景。
4.2 腳本指令原型：
@bg(path,isAlpha)
4.3 參數說明：
1. path：背景圖象文件路徑。文件名後不寫文件後綴。如果為null獲NULL則為擦除背景
2. isAlpha：是否打開漸變進出效果。0-不打開，1-打開
4.4 例：
@bg(avgFiles/bg/bg1,1);
5. @res_chara
5.1 功能：
從打包資源讀取，變更人物圖像，支持漸變效果。
5.2 腳本指令原型：
@res_chara(resource, file name, isAlpha)
5.3 參數說明：
1. resource : 資源文件路徑。
2. file name：人物圖象文件名字。文件名後不寫文件後綴。
3. isAlpha：是否打開漸變進出效果。0-不打開，1-打開
5.4 例：
@res_chara(avgFiles/chara/img.res, chara1, 1);
6. @res_bg
6.1 功能：
從打包資源讀取，加載背景。
6.2 腳本指令原型：
@res_bg(resource, file name, isAlpha)
6.3 參數說明：
1. resource : 資源文件路徑。如果為null獲NULL則為擦除背景
2. file name：背景圖象文件路徑。文件名後不寫文件後綴。如果為null獲NULL則為擦除背景
3. isAlpha：是否打開漸變進出效果。0-不打開，1-打開
6.4 例：
@res_bg(avgFiles/bg/bg.res, bg1, 1);
7. @btbg
7.1 功能：
加載背景至下屏。
7.2 腳本指令原型：
@btbg(path,isAlpha)
7.3 參數說明：
1. path：背景圖象文件路徑。文件名後不寫文件後綴。如果為null獲NULL則為擦除背景
2. isAlpha：是否打開漸變進出效果。0-不打開，1-打開
7.4 例：
@btbg(avgFiles/bg/bg1,1);
8. @res_btbg
8.1 功能：
從打包資源讀取，加載背景至下屏。
8.2 腳本指令原型：
@res_btbg(resource, file name, isAlpha)
8.3 參數說明：
1. resource : 資源文件路徑。如果為null獲NULL則為擦除背景
2. file name：背景圖象文件路徑。文件名後不寫文件後綴。如果為null獲NULL則為擦除背景
3. isAlpha：是否打開漸變進出效果。0-不打開，1-打開
8.4 例：
@res_btbg(avgFiles/bg/bg.res, bg1, 1);
9. @texton
9.1 功能：
上屏顯示文字和文字框。
9.2 腳本指令原型：
@texton();
9.3 參數說明：
9.4 例：
@texton();
10. @textoff
10.1 功能：
上屏文字和文字框消失。
10.2 腳本指令原型：
@textoff();
10.3 參數說明：
10.4 例：
@textoff();
11. @erase
11.1 功能：
擦除指定屏幕上的文字。
11.2 腳本指令原型：
@erase(screen);
11.3 參數說明：
screen：0-上屏 1-下屏
11.4 例：
@erase(1);
12. @head
12.1 功能：
加載頭像。
12.2 腳本指令原型：
@head(path)
12.3 參數說明：
1. path：頭像文件路徑。文件名後不寫文件後綴。置為NULL或null時，指令變為擦除頭像功能。
12.4 例：
@head(avgFiles/chara/head1);
@head(null);
13. @res_chara
13.1 功能：
從打包資源讀取，加載頭像。
13.2 腳本指令原型：
@res_head(resource, file name)
13.3 參數說明：
1. resource : 資源文件路徑。
2. file name：頭像文件名字。文件名後不寫文件後綴。置為NULL或null時，指令變為擦除頭像功能。
13.4 例：
@res_chara(avgFiles/chara/img.res, head1);
@res_chara(null, null);
14. @clearHead
14.1 功能：
擦除頭像。
14.2 腳本指令原型：
@clearHead()
14.3 參數說明：
無參數
14.4 例：
@clearHead();
三. 腳本操作類指令
1. @jump
1.1 功能：
文本內無條件上下跳轉。
1.2 腳本指令原型：
@jump(num)
1.3 參數說明：
1. num：條轉行數。正數為向下跳轉，負數為向上跳轉，0為死循環不要用
1.4 例：
@jump(18);
@jump(-18);
2. @if @endif
2.1 功能：
條件執行體。符合條件執行體內指令，壹個@if對應壹個@return，體內可以支持條件執行體嵌套。
2.2 腳本指令原型：
@if(condition)
Body
@endif()
2.3 參數說明：
1. condition：執行條件，支持判斷類型：==(相等), >(大於), <(小於), >=(大於等於), <=(小於等於), !=(不等於)； 左操作數必須為變量，右操作數支持變量；
註意的是每個執行體只支持壹次邏輯判斷。
2.4 例：
1. @if($(var) == 100);
……………
@endif();
2. @if($(var1) == $(var2));
……………
@endif();
3. @call
3.1 功能：
帶返回的腳本文件跳轉。目標腳本執行完畢後返回原腳本文件繼續執行
3.2 腳本指令原型：
@call(path)
3.3 參數說明：
1. path：腳本文件路徑
3.4 例：
@call(avgFiles/data/test1.spt);
4. @changeText
4.1 功能：
不帶返回的腳本文件跳轉。直接更換腳本文件
4.2 腳本指令原型：
@ changeText (path)
4.3 參數說明：
1. path：腳本文件路徑
4.4 例：
@ changeText (avgFiles/data/test1.spt);
5. @gameOver
5.1 功能：
遊戲結束，遊戲重新初始化
5.2 腳本指令原型：
@ gameOver ()
5.3 參數說明：
無
5.4 例：
@ gameOver();
6. =
6.1 功能：
文本結束標誌，此標誌前不加@，註意如帶返回的腳本文件，末尾壹定加上此結束標誌。
6.2 腳本指令原型：
=
6.3 參數說明：
無
6.4 例：
=;
7. @select
7.1 功能：
出現按鈕進行選擇，執行相應操作。
7.2 腳本指令原型：
@select#1button_text1 $value1$ @ins1 @ins2 @ins3 ~text1 ~ #2 $$ @ @ @ ~~ #3 $1$ @ @ @ ~~;
說明：該指令設定較為復雜，設定為3個選擇項。每個選擇項格式為#num button_text $value$ @instruction1 @instruction2 @instruction3 ~text ~，#號後數字為選
項號，順序固定為1-2-3，不可改動。每個選項最大支持3條執行指令，判斷後相應順序執行。
7.3 參數說明：
1. button_text：按鈕文字
2. value：選項對應值，該功能預留，填該值無實際意義，所以每次寫0即可
3. instruction：腳本指令名。
4. text：選擇後顯示在對話文本框中文字。如不需要顯示後續內容則不填寫
7.4 例：
@select#1%c2按鈕壹 $-1$ @chara()@set_value($(sd)=18)@ ~選擇了選項壹$(sd)~ #2%c2按鈕二 $0$ @ @ @ ~選擇了按鈕二~ #3%c2按鈕三 $0$ @
@ @ ~選擇了按鈕三~;
8. @var_select
8.1 功能：
出現按鈕進行選擇，選擇結果對應值將記錄在指定變量中。0-第壹個選項，1-第二個，2-第三個
8.2 腳本指令原型：
@var_select(variable, number, item|.....|....);
8.3 參數說明：
1. variable：變量名，註意，使用的變量必須之前申請。
1. number：選項個數
3. item：選項名字，選項之間用 | 隔開。 選項數量1-3個。
8.4 例：
@set_var(choice, -1);
@var_select(choice, 2, no1|no2);
四．系統操作類指令
系統變量說明：本系統最大支持128個自定義整型類變量。並且在文本顯示指令和條件判斷指令中支持對系統變量值的顯示和判斷，調用形式為$(variable_name)，例如現
在已經申請了變量var1且值為100,調用時寫”變量值為$(var1)” 即可顯示 ”變量值為100”。
1. @set_var
1.1 功能：
申請系統變量。
1.2 腳本指令原型：
@ set_var (var_name, var_value)
1.3 參數說明：
1. var_name：變量名，註意變量名不要過長
2. var_value：初始值
1.4 例：
@set_var(var1, 100);
2. @unset_var
2.1 功能：
取消指定已經申請系統變量。
2.2 腳本指令原型：
@ unset_var (var_name)
2.3 參數說明：
1. var_name：變量名，註意變量名為已經申請的變量
2.4 例：
@unset_var(var1);
3. @set_value
3.1 功能：
對已申請的系統變量進行賦值。
3.2 腳本指令原型：
@ set_value($(var_name), var_value)
3.3 參數說明：
1. var_name：變量名，註意變量名不要過長
2. var_value：要賦的值
3.4 例：
@set_value($(var1), 0);
4. @delay
4.1 功能：
系統等待指定時間。
4.2 腳本指令原型：
@delay(time)
4.3 參數說明：
1. time：等待的時間 （單位：毫秒）
4.4 例：
@delay(1000);
5. @save
5.1 功能：
存儲當前進度。
5.2 腳本指令原型：
@save(text)
5.3 參數說明：
1. text：選填參數，存盤標簽內容，可以顯示在存檔按鈕上。不填則默認標簽內容為存盤時間。
5.4 例：
@save(第二章);
@save();
6. @load
6.1 功能：
讀取進度。
6.2 腳本指令原型：
@load()
6.3 參數說明：
無
6.4 例：
@load();
五. 聲音類指令
1. @playSFX
1.1 功能：
播放效果音，目前支持8bit signed 碼率為11025的raw格式聲音文件。
1.2 腳本指令原型：
@playSFX(path)
1.3 參數說明：
1. path：音頻文件路徑，註意文件用全名
1.4 例：
@playSFX(avgFiles/sound/1.raw);
2. @res_playSFX
2.1 功能：
從打包資源讀取，播放效果音，目前支持8bit signed 碼率為11025的raw格式聲音文件。
2.2 腳本指令原型：
@res_playSFX(resource, file name)
2.3 參數說明：
1. resource：音頻資源文件路徑，註意文件用全名
2. file name：音頻文件名，註意文件用全名
2.4 例：
@res_playSFX(avgFiles/sound/sound.res, 1.raw);
3. @loopSFX
3.1 功能：
循環播放效果音，目前支持8bit signed 碼率為11025的raw格式聲音文件。
3.2 腳本指令原型：
@loopSFX(path)
3.3 參數說明：
1. path：音頻文件路徑，註意文件用全名
3.4 例：
@loopSFX(avgFiles/sound/1.raw);
4. @res_loopSFX
4.1 功能：
從打包資源讀取，循環播放效果音，目前支持8bit signed 碼率為11025的raw格式聲音文件。
4.2 腳本指令原型：
@res_loopSFX(resource, file name)
4.3 參數說明：
1. resource：音頻資源文件路徑，註意文件用全名
2. file name：音頻文件名，註意文件用全名
4.4 例：
@res_loopSFX(avgFiles/sound/sound.res, 1.raw);
5. @playBGM
5.1 功能：
播放背景音樂。只支持mp3格式文件，碼率不宜過高，建議采用11025 8bit 96kps配置或更低，具體可以測試。在進行音樂切換的時候也是直接用該指令。
5.2 腳本指令原型：
@playBGM(path)
5.3 參數說明：
1. path：音頻文件路徑，註意文件用全名
5.4 例：
@playBGM (avgFiles/sound/bgm1.mp3);
6. @stopBGM
6.1 功能：
停止播放當前背景音樂。
6.2 腳本指令原型：
@ stopBGM()
6.3 參數說明：
無
6.4 例：
@stopBGM();
以上只是大約1/10