KRKR基础篇（二）

这里介绍一些krkr的语法规范，具体的命令含义及用法以后再叙述

一：kag语法及基本概念

KAG使用的剧本语言为KAG Script，文件扩展名为.ks

脚本内的文字除 注释， 命令 ， 段落标签， 等内容外，一律被当作 剧本文字 进行显示处理。

每个标签都可能有若干属性，也可能没有属性，属性用于精确控制指令的行为。

1：标记命令

命令的格式为：

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

例如：

[bg file=图片1] 这里设置了一张背景图片 [r][I]

2:行命令

行命令一般单独占一行，用于较长的指令

命令的格式为：

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

这种语法格式要求一条指令 单独 占一行。

例如：

@bg file=图1
    这里也设置了一张背景图片[r][I]

与标记命令的执行结果是一样的

3：段落标签

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

分支选项 剧本跳跃 进度的存取都以段落标签为标志，剧本跳跃时，就只能跳跃到指定的段落标签开始。（学过html的小伙伴可能会比较熟悉这个，与利用a标签id属性实现跳转类似）

命令的格式为：

1 *标签名|显示名

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

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

例如：

*ch01|第一章
    这是第一章。[I][r]

4：注释

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

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

例如：

1 *ch01|第一章
2 这是第一章。[I][r]   ; 这是注释1
3 ;这是注释2

开发过程中的所有代码都要严格按照这些规范来进行。

二：关于渐变的类型、参数和使用

渐变效果是ADV制作中最经常用到的效果。ADV游戏经常包含图像的切换。如果毫无过渡的更换图像，效果一般会显得非常糟糕。因而，淡入、淡出等图像效果几乎是每一个ADV游戏必然会使用的。加入这些效果，可以使得图像的切换更加平滑，让游戏感觉更加精细。

KAG中，淡入、淡出这些在一定的时间内改变图像的功能都使用统一的渐变效果来实现。KAGeXpress的背景切换等效果，也被设计为可以调用渐变效果。使用的渐变效果的类型在KAGeXpress中都可以由method属性指定。

KAG包含了多种的渐变方式。吉里吉里内核自嵌了3种类型的渐变，此外通过外部插件，还可以增加新的渐变效果。

所有调用的渐变的指令都需要通过time属性指定时间，对于KAGeXpress的图像指令，未指定时间的渐变视作要求新的图像直接出现。

以下的图例中，A为渐变前的图像（下面称作原图像），B为用来取代原图像的目标图像（下面称作新图像）。

1：crossfade

最简单、最常用的渐变类型。要渐变的部分渐渐从原图像变为新图像

无特别的属性需要指定。

2：universal

一种独特的渐变类型。可以按照使用者的要求，按照任意顺序与方式渐变整个区域。

使用时，必须提供一个规则文件，指定渐变的规则。该文件必须是灰阶的图像。

请看以下的样图。

有渐变重叠效果出现