脚本指令说明书v1.6.doc

(c)AVG MAKER DS By Hewenxie脚本指令说明书V1.6目 录一.对话文字显示指令51. say52. boxText53. SetFontColor64. FontShadowOn/FontShadowOff65. FontShadowColor6二. 图像相关操作指令71. chara72. clearChara73. anim74. bg85. res_chara86. res_bg87. btbg98. res_btbg99. texton910. textoff1011. erase1012. head1013. res_head1014. clearHead1115. quakex quakey1116. lrchara1117. res_lrchara1218. fadein fadeout1219. flash1320. wave1321. colorEffect1322. graybg13三. 脚本操作类指令141. jump142. if endif143. call154. changeText155. gameOver156. =157. select168. var_select169. menusys_on menusys_off1710. tbtrans_on tbtrans_off1711. review1712. LoadImageButton1813. image_select1814. setMenuBg1815. setMenuBtn1916. txt_select19四系统操作类指令191. set_var202. unset_var203. set_value204. delay205. save216. load217. var_save218. var_load229. SetGameName22五. 声音类指令221. playSFX222. res_playSFX223. loopSFX234. res_loopSFX235. playBGM236. stopBGM247. res_playBGM248. stopSFX24无特殊说明每条指令均为开头，以;结尾。指令前加/，即为注释掉该行，被注释掉的指令不会执行。如/say(.); 一. 对话文字显示指令 前置说明：对话显示内容支持字体颜色。字体颜色默认为白色，如要对字体颜色操作，请使用%cX，X为09任意数字，对应颜色如下：1-白色(white)，2-红色(red)，3-绿色(green)，4-蓝色(blue)，5-紫色(purple)，6-青色(cyan)，7-黄色(yellow)，8-淡灰色(light grey)，9-深灰色(dark grey)，0-黑色(black)如果希望在一句话中间出现换行，用n符号，停顿（继续则需要按键）效果，用t符号 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的美妙世界！); 3. SetFontColor 3.1 功能： 设置字体颜色。 3.2 脚本指令原型： SetFontColor (screen, number, red, green, blue) 3.3 参数说明： 1. screen：0-上屏 1-下屏 2. number：0-9,对应%c中的号码，请参照开篇前置说明 3. red,green,blue：即RGB, 三个参数范围分别都为0-31 3.4 例： SetFontColor (0,1,12,12,12); 4. FontShadowOn/FontShadowOff 4.1 功能： 字体阴影效果打开/关闭。 4.2 脚本指令原型： FontShadowOn() FontShadowOff() 4.3 参数说明： 4.4 例： FontShadowOn();FontShadowOff(); 5. FontShadowColor 5.1 功能： 设置字体阴影颜色。 5.2 脚本指令原型： FontShadowColor(color_number) 5.3 参数说明： 1. color_number：0-9,对应%c中的号码，请参照开篇前置说明 5.4 例： FontShadowColor (8);二. 图像相关操作指令 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,type) 4.3 参数说明： 1. path：背景图象文件路径。文件名后不写文件后缀。如果为null获NULL则为擦除背景 2. type：是否打开渐变进出效果。0-无效果，1-白渐进， 2-黑渐进， 3-10 黑色拉幕效果（具体请实机测试），11-白渐进+灰化效果，12-黑渐进+灰化效果 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, type) 6.3 参数说明： 1. resource : 资源文件路径。如果为null获NULL则为擦除背景 2. file name：背景图象文件路径。文件名后不写文件后缀。如果为null获NULL则为擦除背景 3. type：是否打开渐变进出效果。0-无效果，1-白渐进， 2-黑渐进， 3-10 黑色拉幕效果（具体请实机测试），11-白渐进+灰化效果，12-黑渐进+灰化效果 6.4 例： res_bg(avgFiles/bg/bg.res, bg1, 1); 7. btbg 7.1 功能： 加载背景至下屏。 7.2 脚本指令原型： btbg(path,type) 7.3 参数说明： 1. path：背景图象文件路径。文件名后不写文件后缀。如果为null获NULL则为擦除背景 2. type：是否打开渐变进出效果。0-无效果，1-白渐进， 2-黑渐进， 3-10 黑色拉幕效果（具体请实机测试） 7.4 例： btbg(avgFiles/bg/bg1,1); 8. res_btbg 8.1 功能： 从打包资源读取，加载背景至下屏。 8.2 脚本指令原型： res_btbg(resource, file name, type) 8.3 参数说明： 1. resource : 资源文件路径。如果为null获NULL则为擦除背景 2. file name：背景图象文件路径。文件名后不写文件后缀。如果为null获NULL则为擦除背景 3. type：是否打开渐变进出效果。0-无效果，1-白渐进， 2-黑渐进， 3-10 黑色拉幕效果（具体请实机测试） 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_head 13.1 功能： 从打包资源读取，加载头像。 13.2 脚本指令原型： res_head(resource, file name) 13.3 参数说明： 1. resource : 资源文件路径。 2. file name：头像文件名字。文件名后不写文件后缀。置为NULL或null时，指令变为擦除头像功能。 13.4 例： res_ head (avgFiles/chara/img.res, head1); res_ head (null, null); 14. clearHead 14.1 功能： 擦除头像。 14.2 脚本指令原型： clearHead() 14.3 参数说明： 无参数 14.4 例： clearHead(); 15. quakex quakey 15.1 功能： 画面振动效果。按x或y轴方向 15.2 脚本指令原型： quakex (times) quakey (times) 15.3 参数说明： times：振动次数, 不填则默认为5 15.4 例： quakex (1); quakey (5);16. lrchara 16.1 功能： 全屏分左半右半部分分别显示人物图像。图像大小256192或128192的立绘。支持单边独立保留图像或清除图像。 16.2 脚本指令原型： lrchara(lpath, rpath, isAlpha) 16.3 参数说明： 1. lpath：左边人物图象文件路径。文件名后不写文件后缀。为NULL（大写）时则为清除，为KEEP（大写）时则为保留当前图像。 2. rpath：右边人物图象文件路径。文件名后不写文件后缀。为NULL（大写）时则为清除，为KEEP（大写）时则为保留当前图像。 3. isAlpha：是否打开渐变进出效果。0-不打开，1-打开 16.4 例： lrchara(avgFiles/chara/chara1, avgFiles/chara/chara2, 1); lrchara(KEEP, avgFiles/chara/chara3, 1); lrchara(NULL, KEEP, 1);17. res_lrchara 17.1 功能： 全屏分左半右半部分分别显示人物图像。图像大小256192或128192的立绘。支持单边独立保留图像或清除图像。 17.2 脚本指令原型： res_lrchara(resource, lpath, rpath, isAlpha) 17.3 参数说明： 1. resource : 资源文件路径。 2. lpath：左边人物图象文件路径。文件名后不写文件后缀。为NULL（大写）时则为清除，为KEEP（大写）时则为保留当前图像。 3. rpath：右边人物图象文件路径。文件名后不写文件后缀。为NULL（大写）时则为清除，为KEEP（大写）时则为保留当前图像。 4. isAlpha：是否打开渐变进出效果。0-不打开，1-打开 17.4 例： res_lrchara(avgFiles/chara/img.res, chara1, chara2, 1); res_lrchara(avgFiles/chara/img.res, KEEP, chara3, 1); res_lrchara(avgFiles/chara/img.res, NULL, KEEP, 1);18. fadein fadeout 18.1 功能： 屏幕亮度控制的淡入淡出，可用于对屏幕整屏操作，同时对背景层和立绘层作用。 18.2 脚本指令原型： fadeout(screen,type,time); fadein(screen,type,time); 18.3 参数说明： 1. screen：屏幕 0-上屏 1-下屏 2-双屏 2. type：渐变类型 0-白色渐变 1-黑色渐变 3. time：渐变时间，1代表半秒，2为一秒 依次 18.4 例： fadeout(0,1,5); fadein(0,2,5);19. flash 19.1 功能： 屏幕闪光效果 19.2 脚本指令原型： flash(screen, type, times, length); 19.3 参数说明： 1. screen：屏幕 0-上屏 1-下屏 2. type：闪光类型 0-白色闪光 1-黑色闪光 3. times：闪光次数 4. length：闪光变化延时，该值越小，闪屏的速度就越快。推荐值4 19.4 例： flash(0,0,1,4);20. wave 20.1 功能： 画面波浪效果 20.2 脚本指令原型： wave(time); 20.3 参数说明： 1. time：时间 单位ms 20.4 例： wave(3000);21. colorEffect 21.1 功能： 背景底片效果 21.2 脚本指令原型： colorEffect (); 21.3 参数说明： 无 21.4 例： colorEffect ();22. graybg 22.1 功能： 背景灰化效果 22.2 脚本指令原型： graybg (); 22.3 参数说明： 无 22.4 例： graybg ();三. 脚本操作类指令 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);9. menusys_on menusys_off 9.1 功能： 菜单系统打开，关闭。现在只添加了存档读档功能。菜单系统打开后可以在随时按Start键或点击在下屏的menu按钮选择相应功能。 9.2 脚本指令原型： menusys_on() menusys_off() 9.3 参数说明： 无 9.4 例： menusys_on(); menusys_off();10. tbtrans_on tbtrans_off 10.1 功能： 文字框半透明效果开关, 关闭后文字框不做半透明处理，请在脚本初始化阶段使用。 10.2 脚本指令原型： tbtrans_on () tbtrans_off() 10.3 参数说明： 无 10.4 例： tbtrans_on(); tbtrans_off(); 11. review 11.1 功能： 调用鉴赏系统。 11.2 脚本指令原型： review(filename) 11.3 参数说明： filename: 鉴赏脚本的路径 11.4 例： review(avgFiles/data/review.txt); 12. LoadImageButton 12.1 功能： 加载图片按钮。加载图片按钮。（说明：图片用立绘方式转换，大小为128X64，分成64X64两个，左右分别取名为XXX1和XXX2） 12.2 脚本指令原型： LoadImageButton(id, resource, image, x, y); 12.3 参数说明： id: 选择号 resource: 资源名 image: 图片名 x: y: 13. image_select 13.1 功能： 出现图片选择项。LoadImageButton需在此之前进行。 13.2 脚本指令原型： image_select (var, number); 13.3 参数说明： var: 变量名 number: 选择数量 最多为4 13.4 例： set_var(choice, -1); image_select (choice, 3); 14. setMenuBg 14.1 功能： 设置menu系统背景，256色256192图用转化器人物选项转换 14.2 脚本指令原型： setMenuBg (resource, image); 14.3 参数说明： resource: 资源名 image: 图片名 14.4 例： setMenuBg (avgFiles/ component/UI.res, UI); 15. setMenuBtn 15.1 功能： 设置menu系统按钮，256色12816图用转化器人物选项转换 15.2 脚本指令原型： setMenuBtn (resource, image); 15.3 参数说明： resource: 资源名 image: 图片名 15.4 例： setMenuBtn (avgFiles/ component/UI.res, button); 16. txt_select 16.1 功能： 文字选择功能 16.2 脚本指令原型： txt_select(var, number, bcolor, fcolor, text1|text2|text3|text4) 16.3 参数说明： var: 变量 number: 选项数目 1-4 bcolor: 未选择项的颜色 fcolor: 选择项的颜色 text1-4: 显示的文字 16.4 例： set_var(choice, -1);txt_select(choice, 3, 1, 2, 选择一|选择二|选择三|选择四);boxText(1,20,20,200,150,0,choice = $(choice); unset_var(choice);四系统操作类指令系统变量说明：本系统最大支持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