[翻译] KAGEX-Action系统(层动态效果)TXT说明档

波斯拖鞋

啊哈哈,久等了.[s:7]
------------------------------------------------------------------------------
Title: 吉里吉里/KAG改 アクション解説
Author: 合資会社ワムソフト 渡邊剛
Translater: KCDDP 波斯拖鞋

●概要

ActionLayer 是使吉里吉里的层拥有动态效果的扩展功能层。

◇TJS 中的使用方法

可以向 ActionLayer 的 beginAction 传递参数。
样式1
   第一参数: 动态效果模式
   第二参数: 参数的字典变量
样式2
   第一参数: 参数的字典变量。使用 "module" 指定动态效果模式名。

◇KAGEX 中的使用方法

动作的开始
[action layer=层名 module=动态效果模式 time=1000 ... ]

动作的停止
[stopaction layer=层名]

等待动作结束后继续下一指令
[wact layer=层名]
省略layer属性的情况下，将等待全部层动作停止。

◇层动作的注意事项：

・属于同一组的动态效果模式是互斥的，在一个层上只能同时有一个效果生效。
・不属于同组的动态效果模式可以叠加在同一层。（译注：例如可以一边放大画面一边摇晃画面……）

●属性相关

◇所有动作模式的通用属性

time    动作执行的持续时间
delay    延迟指定的一段时间后开始执行动作

◇移动动作组

◆共通属性

x        移動目标位置
y        移動目标位置

◆LayerNormalMoveModule  通常移動

无特别属性

◆LayerAccelMoveModule　 加速移動

无特别属性

◆LayerDecelMoveModule   減速移動

无特别属性

◆LayerParabolaMoveModule  抛物线式移动

x/y 是指定抛物线顶点坐标（并非落地点坐标）
toptime    则是指定到达最高点所花费的时间（同时指定了 time 属性的话，就可以制造出具有初速度的抛物线鸟。)

◇往返运动动作组

◆共通属性

无

◆LayerVibrateActionModule    振动动作

vibration    振動量(pixel)
waittime    振動间隔时间(ms)

◆LayerJumpActionModule    上下振动动作

vibration    上下振動量(pixel)
cycle        周期(ms)

◆LayerJumpOnceActionModule    上下振动动作（一次）

vibration    上下振動量(pixel)
cycle        周期(ms)

◆LayerWaveActionModule     左右振动动作

vibration    左右振動量(pixel)
cycle        周期(ms)

◆LayerWaveOnceActionModule     左右振动动作（一次）

vibration    左右振動量(pixel)
cycle        周期(ms)

◆LayerFallActionModule        落下动作

distance    落下距離(pixel)
falltime    落下時間(ms)

◇放大，缩小动作组

◆共通属性

无

◆LayerNormalZoomModule        简单放大

zoom    最后的放大率（纵横放大比例不同的情况没有加入）

◆LayerVRotateZoomModule    使用放大缩小效果造成的伪3D回转（纵轴）

angvel    旋转的角速度（度/sec）

◆LayerHRotateZoomModule    使用放大缩小效果造成的伪3D回转（横轴）

angvel    旋转的角速度（度/sec）

◆LayerHeartBeatZoomModule    心跳效果

zoom    最大放大率

◆LayerVibrateZoomModule    缩放震动

vibration    振動量(％)
waittime    振動间隔时间(ms)

◇旋转动作组

◆LayerNormalRotateModule    単純旋转

angvel        角速度（度/sec）

◆LayerVibrateRotateModule    旋转震动

vibration    振幅(度)
cycle        周期(ms)

◆LayerFalldownRotateModule        倒转

angle    倒转時最大角度（-90～90范围内 正数代表往左、負数代表往右）

◆LayerToRotateModule        旋转到指定角度

angle    指定角度

◇渐变动作组

◆LayerBlinkModeModule        闪烁效果

showtime    显示時間(ms)
hidetime    消失時間(ms)

◆LayerFadeModeModule        渐变动态效果

intime        渐入时间   (0的情况下没有渐入效果)
outtime        渐出时间   (0的情况下没有渐出效果)

◆LayerFadeToModeModule        改变层的不透明度

opacity        不透明度

波斯拖鞋

Title: 吉里吉里/KAGEX 相关文档
Author: 合資会社ワムソフト 渡邊剛
Translator: KCDDP 波斯拖鞋

●吉里吉里/KAGEX 概要

KAGEX 对吉里吉里/KAG 在 layer 方面进行了大量的机能扩张。

而 KAG 本体的基本功能完整保留。关于 KAG 的详细说明，

http://devdoc.kikyou.info/tvp/docs/kag3doc/contents/

请参考以上页面。

●文件夹组成

krkr.exe        吉里吉里主程序
plugin/            插件

※插件文件夹中，实际上需要的是以下两个文件
  layerExImage.dll
  wuvorbis.dll

savedata/        存档文件夹

data/            游戏资料夹
    system/        系统
    bgimage/    背景图片
    bgm/        BGM档
    fgimage/    前景图片
    image/        其他图片
    others/        其他档案
    rule/        画面切换用规则图片
    scenario/    剧本档
    sound/        音效档
    video/        影片文件
    startup.tjs    吉里吉里起动文件
    envinit.tjs    系统定义文件（KAG技能扩张用）

※游戏资料夹部分，具体文件是如何放置的并没有关系。

●扩张技能说明

◇追加层

◆增加特殊层

加入了以下的２层全画面层。

stage    （舞台层）深度位于背景层之上，前景层之下。
event    （事件层）深度位于前景层之上，消息层之下。
        
※实际上，前景层由于“水平”这一概念的增加，也可能显示在事件层之上。

本来的 KAG 系统「背景」即是使用 base 层显示， base 层由于
吉里吉里本身的设定限制，无法自由移动。
因此，KAGEX 加入了为实现背景卷动效果的特殊层（舞台层）。

此外，为「事件画面」的显示方便，前景层之上，增加了专门的事件层。

相比原版的KAG，KAGEX 的层构造变为如下图所示

-- -- -- --  messages (KAG消息层）
-- -- -- --  layers (KAG前景层:level5～8)
-----------  event
-- -- -- --  layers (KAG前景层:level0～4)
-----------  stage
-----------  base（KAG背景层）

◆前景层追加水平（level）概念

KAG 本来的前景层，是按照其编号决定显示顺位的。
KAGEX 则增加了「level」这一概念，由level单位来决定显示顺位。

・「level」的值越小，则层的显示顺位越低。
・在同一「level」值的层中，可以把层移动到「最前排」「最后排」。

◆layopt (扩张)

stage / event 和前景层一样，可以用 layopt 指令进行操作。
layopt 指令则增加了以下几个属性。

属性
    rotate  角度
    zoomx   横方向放大率
    zoomy   纵方向放大率
    zoom    放大率
    afx     旋转・放大的原点X坐标 center/left/right
            或使用该点距离图片左上点的相对坐标。
    afy     旋转・放大的原点Y坐标 center/top/bottom
            或使用该点距离图片左上点的相对坐标。
    type    合成模式
            ※http://devdoc.kikyou.info/tvp/docs/kr2doc/contents/index.html
    reset   层动作与层属性的初期化
            ※opacity 和 type 则重设为图象读入时的设定

◆laylevel (新增)

前景层显示水平设定。

属性
    layer (指定设定的前景层等)
    page (省略時默认为 fore)  
    level  表示 level
        表示level：layfront/layback 的分组对象（level值相同的层视为同一组）。
        表示level越大，显示顺位越靠前。

◆layfront (新增)

指定层移动到同一level值的所有层中的最前排

属性
    layer (指定设定的前景层等)
    page (省略時默认为 fore)  

◆layback (新增)

指定层移动到同一level值的所有层中的最后排

属性
    layer (指定设定的前景层等)
    page (省略時默认为 fore)  

◆clearlayers (新增)

清除所有层内容，停止执行。

属性
    page 的表或里

◆action (新增)

针对 stage / event 及前景层增加的指令，
设定层的自动动作效果

属性
    layer 指定需要操作的层（前景/stage/event)
    page 指定操作的是层的表页或里页
    module 动作效果指定
   
※一些动作效果拥有其独有的属性。
　具体动作效果的详细说明，请参考 action.txt。

◆stopaction (新增)

停止指定层的动作。
不指定层的情况下，停止所有层的动作效果。

属性
    layer 指定需要操作的层（前景/stage/event)
    page 指定操作的是层的表页或里页

◆wact (新增)

等待指定层的动作效果结束。
不指定层的情况下，等待全部层动作结束。

属性
    layer 指定需要操作的层（前景/stage/event)
    page 指定操作的是层的表页或里页
    canskip 値 true(默认) 或者 false
            true 的情况下可以点击跳过动画效果。

◆button (扩张)

可以单独指定按钮各个点击状态的图片。

属性
    normal    通常时的图片
    over    鼠标移动到按钮上时的图片    省略则使用与 normal 同一张图片
    on    点下鼠标时的图片        省略则使用与 over 同一张图片
    focus    focus时的图片                省略时则使用与 focus 同一张图片(译注：带focus的按钮俺没有用过，不清楚)

◆slider (新增)

在消息层上设置滑动槽（slider bar）。

属性
    exp        commit 时执行的 TJS 式
    bgcolor        背景色
    opacity        背景透明度
    value        连动变数名。指定后的情况
                (1)指定的变数的值，作为滑动槽的初期值
                (2)滑动槽移动时，变数相应改变
    position    初期值
    onchange    变化的值代入的变数名

    base        背景画像名。
                指定了背景图片的情况下， width 和 height 用于设定背景图片的大小
    width        背景宽
    height        背景高
    tab            滑动按钮图片（一起设定) normal / on / over 以此顺序排列（译注：类似普通按钮的graphic……吧？）
    normal        滑动按钮通常时的图片（分离）
    over        滑动按钮鼠标移动到按钮上时的图片（分离）
    on        滑动按钮点下鼠标时的图片（分离）

◆sysbutton (新增)

在消息层上( message0 )设置系统按钮。

属性
    normal        通常时的图片
    over        鼠标移动到按钮上时的图片    省略则使用与 normal 同一张图片
    on        点下鼠标时的图片        省略则使用与 over 同一张图片
    focus        focus时的图片                省略时则使用与 focus 同一张图片

    graphic        按钮图片（一起设定）
    graphickey     按钮图片透明色
    x            表示位置
    y            表示位置
    hint        对按钮的注释（移动到按钮上后显示浮动小说明框）
    exp        按钮按下时执行的 TJS 式
    clickse        按钮按下时的SE（音效）
    clicksebuf    按钮按下时的SE 使用声道
    onenter        鼠标移到按钮上时（enter时） 执行的 TJS 式
    enterse        enter时的 SE
    entersebuf    enter时的 SE 使用声道
    onleave        鼠标从按钮上移开时（leave时） 执行的 TJS 式
    leavese        leave时的 SE
    leavesebuf    leave时的 SE 使用声道
    recthit        同一般按钮的属性
    enabled        系统按钮有效
    disabled    系统按钮无效
        译注：以下两个属性非常有用，然而文档里没有提到，于是自行加上了
        ※name          每个系统按钮必须指定的属性，用于区别系统按钮（没有这个属性的话根本就会一直出错……|||）
        ※noStable      为真时，在“行走中”（例如切换效果中，自动前进中时），按钮也有效，为假时，和普通按钮相同

◆csysbutton (新增)

清除已定义的系统按钮

◆timeout (新增)

当前操作的消息层，增加timeout处理。（制作限时选项等时使用，用在之前）

属性
    time     等待玩家选择的限制时间
    storage     超时的情况下跳转到的剧本档
    target     超时的情况下跳转到的标签

◇Sound Rack 扩张

◆声音控制全部

音量控制方法

　直接指定
    KAG 的 [bgmopt] [seopt] 指令，可以直接控制音量大小。
  
  渐变指定
    KAG 的 [fadebgm] [fadese] 指令，可以平滑地调整播放中音乐的音量大小。

  循环（loop）的控制
    请使用吉里吉里的LoopTuner工具。
　　http://devdoc.kikyou.info/tvp/docs/kr2doc/contents/LoopTuner.html

    使用该工具，例如
      在 bgm01.ogg 对应的 bgm01.ogg.sli 内，设定循环效果。
　　　制作这样的循环控制文件。吉里吉里将根据sli文件执行循环效果。

  从任意位置开始播放（扩张机能）
　　(1) 使用LoopTuner在音乐档中设定标签
    (2) playbgm / playse / fadeinbgm / fadeinse 中，用 start 属性指定开始播放的标签

◆playbgm/playse/fadeinbgm/fadeinse (扩张)

从任意位置开始播放

属性
    start  指定开始播放的标签。使用在LoopTuner中设定的标签名。

◆fadepausebgm (新命令)

BGM 音量渐小，直到暂停

属性
    time    時間(ms単位)
            fadeout 用时，以 ms （毫秒）为单位指定。
            例如 time 设为 3000 ，则音乐在 3 秒内淡出。

◇表示系扩张

◆linemode (扩张)

KAG 换行模式的切换。
使用本指令的话，在消息窗口样式的作品中，
[l]或[cm]之类的指令，可以省略。

属性
    mode    line 或者 page
            未指定时，按照 KAG 默认设定。

line 使用时
    改行：[l] 继续执行
    [p]：等待后自动清除文字

page 使用时
    改行：[p] ，之后自动清除文字

并且，linemode 有效的情况下，行头有

【名字/表示名】

这种形式的记述文字的话，
将自动呼叫显示名字命令 namedisp(名字,表示名) 。
默认情况下， namedisp 对表示的文字不做任何处理，按原样显示。

使用「world扩张插件」的情况，请参考 kag3plugin/world/world.txt 。

Miliardo

辛苦了嗯= v =
为免生米煮成熟饭来顶一下。

a667830

感谢咯~
最好其实是给脚本我看看啦~
不过做人别贪心....