tjs语言_原创文档.pdfVIP

2.7.1.基本格式

KAG使用的剧本格式称作KAGScript，文件扩展名为.ks。

该文件是ANSI或Unicode（UCS2）编码的文本文件，可以

用记事本等纯文本编辑器编辑。

脚本内的文字除下面将讲到的注释、命令、段落标签等内容

外，一律被当作剧本文本被处理显示。

KS中用于控制引擎动作的部分，本文档一般称之为“命令”。

由于KAG可以被视作一种标记语言，所以这些命令也被称

作标记（Tag）。

每个标签都可能有若干个属性（也可能完全没有属性），用

于精确控制指令的行为。调用中传递的属性一般都需要附带

一个属性值，定义该属性指定的具体对象（例如对于“目标

文件(storage)”这样的属性，属性值一般就是文件名），但在

特殊情况下也可能不需要指定这个值。

2.7.2.标记命令

标记命令类似于HTML等标记语言，可以将控制指令插入文

本当中。

命令的格式为：

[命令名属性1=值1属性2=值2...]

例2.1.标记命令的范例

以下的代码将在KAGeXpress中显示一幅背景图片。

[bgfile=图片1]

下面是说明使用方法的例子。

这是一句话，[r]可以插入标记。[l][r][bgfile=图片1]当然

在行首插入标记命令也是可以的。[l][r][bgfile=图片1]比

如像这样。[l][r]

这种命令格式可以随意插入剧本文字中。

2.7.3.行命令

用类似于NScripter的指令格式书写命令标签，一般占用单

独的一行，用于较长的指令。

命令的格式为：

@命令名属性1=值1属性2=值2...

这种语法格式一般要求一条命令单独使用一行。

例2.2.行命令的范例

@bgfile=图片1

下面是使用方法的例子。

@bgfile=图片1一般来说，行命令是单独占用一行的。

请注意，KAG的标记命令和行命令两种格式在效果上是等效

的。

上面的例子，和标记命令的例子执行的结果是完全相同的。

下文介绍其他命令时，将只说明命令的名称。例如，我们说

到的“p命令”或“p标记”，其正确的调用方法是在ks中

插入“[p]”或者“@p”。

2.7.4.段落标签

段落标签占用单独的一行，代表了一个段落/章节的开始。

分支选项、剧本跳跃、进度的存取都以段落标签作为标志。

例如剧本跳跃时，就只能跳跃到指定段落标签的开始。

命令的格式为：

*标签名|显示名

标签名是标签的内部名称，建议使用简单但不重复的英文数

字组合。

显示名是显示在存档界面等地方的名称，可以使用较复杂的

中文名。

例2.3.段落标签的范例

*ch01|第一章这里是华丽的第一章。[l][r]

则如果在这章内（这个标签后，下一个标签前）存档，存档

界面中显示该存档的进度名称为“第一章”。

每次系统跳转到这个段落的时候，就会从段落标示的地方开

始执行。

2.7.5.注释

以;符号开始，从分号到该行结尾的所有内容将被忽略。

注释主要用于写入开发者的备忘、代码说明等内容。

例2.4.注释的范例

*ch01|第一章这里是华丽的第一章。[l][r];这是注释1;这是

注释2

1.@animstart：开始动画（Animation）

参数：

对象层数（必须）：layer=base或者0以上的整数

页面：page=back或者fore

片段（必须）：seg=1以上的整数

开始的标签（必须）：：

2.@animstop：停止动画（Animation）

@animstoplayer=0seg=1

参数：

对象层数（必须）：layer=base或者0以上的整数

页面：page=back或者fore

片段（必须）：seg=1以上的整数

3.@autowc：自动等待

@autowc

参数：

对象的文字：对象的文字：（对象文字）（对象文字）

开启or关闭：enab