# VNAnime2 说明书
# 你可以自己编写你的VNAnime2说明书
# 所有#开头的行都会被认为是注释，不会显示。
# 请使用UTF8编码保存文件，文件名为"vnhelp_vnanime2_<ID>.txt"，保存到lib目录中
# 其中<ID>部分是说明书的标识，一般用语言缩写，比如：EN, CH, JP
# 但实际上<ID>不限制长度和内容，你可以用自己的名字，但不要搞太长。
#
# 可以使用部分标识来给文字做修饰，如<color=#RRGGBB>带颜色的文字</color>,<size=20>不同大小的文字</size>,<b>粗体</b>, 或<i>斜体</i>。
# 如果你希望你做的说明可以放到VNGE包中发布，请联系Keitaro或Countd360
#
# VNAnime2说明要件:
# VNAnime2需要3部分说明: [[KeyframeView]], [[DetailView]] 和 [[SettingView]]，请不要修改要件的名字
#
# v1.3 - Countd360
#


[[KeyframeView]]
<size=20><color=#00ff00><b>欢迎使用VNAnime2 v1.3!</b></color></size>
看上去和以前的版本差不多？但这是个全新内核的新版VNAnime！

<color=#00ff00>基础知识</color>
➤<b>VNAnime</b>：VNAnime是VNGameEngine中的一个模块，目的是做关键帧动画。
➤<b>Clip动画片段</b>：VNAnime模块的产品，一组关键帧的合集。一个场景中可以创建多个片段，他们可以在需要的时候被播放。
➤<b>Keyframe关键帧</b>：动画的常用方式，百度吧。
➤<b>Target_Object目标对象</b>：你想要在动画片段中控制的东西，可以是人物，物品，相机，地图，系统，某些插件等等。使用<color=#00ff00>[Add]</color>按钮向片段中加入对象是制作片段的第一步。
➤<b>Properties属性</b>：加入对象后，可以在关键帧视图中展开其属性列表。列表中有该对象的所有属性如位置、旋转、缩放等等。不同的对象会有不同的属性列表。有部分属性需要在VNActor的设定中打开才能被VNAnime支持，大部分插件都是。

<color=#00ff00>V1.3更新的新功能</color>
➤支持VNPhysics对象的控制
➤支持新的插值模式T，该模式类似与离散模式D类似，但播放时只会在遇到关键帧时才执行。通常与强制更新模式force同时使用。
➤支持对于垃圾清理的支持。可以设定某个clip启动、循环或停止时清理内存。可以设定在任意clip执行的时候停止清理内存（仅限HS2和KKS）。可以通过关键帧控制内存清理。

<color=#00ff00>V1.2更新的新功能</color>
➤支持了关键帧copy-to功能，将一个目标对象上的关键帧复制到另一个同类的对象上。
➤支持快捷键。

<color=#00ff00>V1.1更新的新功能</color>
➤按下Ctrl键访问关键帧多选的快捷功能，包括全选，反选，垂直选择和范围选择。
➤按下Shift键访问关键帧位移的快捷功能，包括插入和删除空帧和自定义位移功能。
➤在关键帧视图中右键点击一个位置可以在该位置上创建关键帧。（类似于Timeline）

<color=#00ff00>VNAnime2的新特性</color>
➤每个属性的关键帧现在都是独立的了！
➤IK/FK的每个骨骼都可以独立调整了。
➤每个属性有详细的更新设定可以设置。
➤相机也有独立的属性了。
➤Clip同期设定将更加有用。
➤VNText可以在片段中控制了。
➤VNSound可以在片段中控制了。
➤友好的快捷键设定。
➤可以和旧VNAnime片段共存，也可以将旧版片段升级到新版。（开发中……）
➤没有标定过，但应该运行的更快。如果觉得比旧版慢的话请和我联系。

<color=#00ff00>用法指南</color>
➤点击<color=#00ff00>[Add]</color>按钮，选择一个想要控制的物体。几乎工作室内所有的东西都可以控制，包括部分插件的设定，甚至包括其他的动画片段。VN框架下使用一个特殊的"TAG目录"来管理需要处理的对象。如果你不是很明白的话不要删除或修改那些“-”开头的目录。
➤在关键帧视图中选择你要动画的属性。点击对象的名字选择全部的属性，或者点击属性名字选择需要的。按住shift可以多选。
➤用进度条或者进度条下面的按钮来设定当前帧位置。注意关键帧视图中绿色的竖线就是当前帧位置。或者点击关键帧视图上部的帧号也能定位。
➤点击<color=#00ff00>[Register]</color>按钮创建<color=#ff0000>为选择的属性在当前帧位置上</color>关键帧。如果你选择了多个属性，就会创建多个关键帧，但一定在同一个时间上。如果已经有关键帧会更新。
➤一个关键帧不构成动画，换一个时间位置，改变一下属性的值，再创建一个关键帧。这样在两个关键帧之间就有动画了。但是，不是每个属性都可以有平滑的插值动画，有些属性的值是离散的。比如嘴型可以是1，可以2，但没有1.5这个嘴型。对于这类离散值，一个关键帧的设定将会保持到下一个关键帧，中间不会有插值。
➤关键帧试图中◆代表了一个关键帧。点击可以选择，可以按住shift复选，也可以鼠标框选。选中关键帧后可以用<color=#00ff00>[Copy]</color>按钮复制，用<color=#00ff00>[Delete]</color>按钮删除.
➤复制了关键帧后可以用<color=#00ff00>[Paste]</color>按钮将复制的关键帧粘贴到当前帧位置上。如果你复制了几个不同时间上的关键帧，那么第一个关键帧会放在当前帧位置，其他关键帧保持原来的时间跨度依次往后放置。
➤你还可以拖动选中的关键帧来左右移动。但注意不要拖动太多的关键帧，会非常的慢。这种时候可以用复制-删除-粘贴的方式来移动位置。
➤如果你选择了一个可以插值的关键帧，会有一个插值曲线的设定窗口出现。两个关键帧中间的插值方式是由后面那个关键帧的插值曲线决定的。如果你选择的关键帧中还有不同的曲线，曲线设定窗口中会出现多条曲线，这时你无法用句柄调节，只能使用调用预设曲线。
➤大部分情况下你不需要动画一个对象的所有属性。比如有时候你只要控制对象的位置就可以了。这时你可以到详细设定中去删除不需要的属性。在左侧选中对象后，点击上方的<color=#00ff00>[>>]</color>按钮可以打开详细设定，详细设定有其自己的说明页。或者可以在<color=#00ff00>[Setting]</color>面板里面隐藏掉不用的属性。

[[DetailView]]
在对象详细设定中你可以操作对象的关键帧。
➤<color=#00ff00>Export</color>:将关键帧导出到json文本文件。
➤<color=#00ff00>Import</color>:从json文本文件中导入关键帧。
➤<color=#00ff00>Copy To</color>:将关键帧复制到另一个同类物体，或者复制到另一个动画片段中去。
<color=#ffff00>✱注意</color>：这里的<color=#00ff00>Export</color>和<color=#00ff00>Import</color>的内容是对象中的关键帧，对象的ID不包括在内。意思是你可以将导出的内容导入给另一个同类的对象。
<color=#ffff00>✱注意</color>：<color=#00ff00>Export</color>和<color=#00ff00>Copy To</color>的内容是你选择了的属性。但如果没有选择任何属性的话将操作所有的属性。

也可以操作对象的属性。
➤<color=#00ff00>Add</color>: 给对象增加一个新的属性，适用于某些属性被删除了的情况。
➤<color=#00ff00>Delete Empty</color>: 删除空的属性（没有关键帧的属性）。可以让你的界面干净点，运行的稍微快一点点。
➤<color=#00ff00>Delete</color>: 删除选中的属性。删除属性会同时删除其中的关键帧，小心使用。

在下面是对象所有属性的列表，你可以点击属性名字选择，也可以用批量选择按钮:
➤<color=#00ff00>All</color>: 全选
➤<color=#00ff00>Empty</color>: 选中空属性
➤<color=#00ff00>Invert</color>: 反选
➤<color=#00ff00>None</color>: 清除选择

在属性列表中，每个属性名字后面的括号中是包含的关键帧的数量。后面的一些按钮是更新相关的设定。
➤<color=#00ff00>auto/diff/force</color>: 更新模式选择。<color=#00ff00>auto</color>模式将当前帧和上次更新状态对比，决定是否需要更新。<color=#00ff00>diff</color>模式将当前帧状态和场景中的对象当前状态做对比，决定是否更新。旧版VNAnime1用的是这个模式。<color=#00ff00>force</color>模式不做对比，每次都更新。
➤<color=#00ff00>«</color>:设定如果当前帧位置在第一个关键帧之前时，是否要更新
➤<color=#00ff00>»</color>:设定如果当前帧位置在最后一个关键帧之后时，是否要更新
➤<color=#00ff00>A/C/D/T</color>:插值模式选择。A为自动模式，即只在非连续的关键帧间插值。C为连续模式，即使关键帧紧邻也会在中间插值。D为离散模式，即不进行插值。T为触发模式，仅在遇到关键帧时才触发，在两个关键帧之间不更新。对于离散的属性只能选择D或T模式。如果两个关键帧是紧邻的，中间没有空的帧，被称为连续关键帧。
➤<color=#00ff00>↑/↓</color>:调节属性在列表中的位置。属性列表中的顺序是属性的更新顺序，和关键帧视图中的顺序是无关的！
<color=#ffff00>✱注意</color>：你可以选中多个属性，然后同时调节它们的上述更新设定。

[[SettingView]]
设定界面用于调整整个动画片段的参数和全局参数。

在<b><Clip properties>动画片段属性</b>中:
➤<color=#00ff00>Name</color>:每个动画片段都有个独有的名字，用于在其他模块或其他片段中调用它。起名字时请以字母开头以防bug。
➤<color=#00ff00>Priority</color>:VNAnime可以同时播放多个片段，如果片段中都设定了某一个对象的某一属性，那么优先级高的胜出。
➤<color=#00ff00>Auto run on load</color>:是否在场景载入后立刻开始播放片段。
➤<color=#00ff00>Length</color>:片段的帧长度。
➤<color=#00ff00>FPS</color>:每秒的帧数。注意这个值是决定你可以在一秒中设定多少个关键帧，而不是片段播放时候的刷新频率。实际播放时候片段一秒内更新的次数就是你游戏的FPS，由你的电脑性能决定。
➤<color=#00ff00>Speed</color>:播放速度调节。和上面两个参数一起决定最终的播放速度。一个300帧长，30FPS的动画需要10秒。但如果速度设定为2的话只需要5秒。
➤<color=#00ff00>Loop</color>:片段循环的次数，注意不是播放的次数。设定为0的时候不循环=播放一次，设定1则循环1次=播放2次，设定2则循环2次=播放3次，依次类推。设定-1为无限循环。
➤<color=#00ff00>Auto rewind when stop clip</color>:停止播放时是否自动倒回至第0帧。在编辑画面中的停止按钮（■）实为暂停按钮（||）故不受此设定影响，真正的停止按钮（■）在管理画面中。但请注意，如果将本选项打开，在SSS/VNSS中使用f_clipstop指令时将会使本片段重置到第0帧，这可能会影响你的场景。
➤<color=#00ff00>Do garbage collect</color>:选择是否要在clip开始、停止或者循环的时候执行内存垃圾清理（内存垃圾清理会造成动画卡顿）
<color=#ffff00>✱注意</color>：修改片段属性后需要按<color=#00ff00>[Update Porperties]</color>按钮使设定生效。

在<b><Clip operation>动画片段操作</b>中:
➤<color=#00ff00>Optimize</color>:删除不需要的属性和关键帧来优化表现。开发中……
➤<color=#00ff00>Export</color>:将整个片段导出到json文本文件。
➤<color=#00ff00>Import</color>:从json文本中导入片段数据。

在<b><Global Setting>全局设定</b>中:
➤<color=#00ff00>Auto hide unused properties</color>:隐藏未使用的属性，让界面干净些。
➤<color=#00ff00>VideoExport Mode</color>:打开此模式允许和VideoExport联动，但同时UI中的鼠标点击会影响到窗口后面的UI。
➤<color=#00ff00>Suspend GC</color>:仅限HS2/KKS。在任何clip播放的时候阻止垃圾回收，除非clip中设定的垃圾回收或者GC的总量到达了设定的上限。
➤<color=#00ff00>Editor window size</color>:编辑窗口的大小，最小500x265
➤<color=#00ff00>Target panel width</color>:左侧对象栏的宽度，最小150，最大窗口宽度一半。
<color=#ffff00>✱注意</color>：VNAnime2中不再支持旧版的编辑界面了

在<b><shortcuts>快捷键</b>中:
➤<color=#00ff00>shortcuts</color>:快捷键设置，点击按钮并按下想要的按键，支持ctrl、alt、shift的组合。点击右键取消。
➤<color=#00ff00>Suspend-vanilla-studio-shortcut-keys</color>:是否在编辑clip2时禁用游戏自带的工作室快捷键。如Q/W/E/R等。
➤<color=#00ff00>Suspend-vanilla-camera-shortcut-keys</color>:是否在编辑clip2时禁用游戏自带的镜头控制快捷键。如方向按键等。

