sth&文档

Document/ichni编辑器指南.md

@@ -24,16 +24,173 @@ Song Location：歌曲路径：导入后歌曲存储在编辑器内，与原路
 
 **<mark>Theme Bundle Selection</mark>**：选择主题包，~~之后写~~
 
+## 快捷键
+
+注意，颇多的快捷键都是在要鼠标在对应UI下才能触发的
+
+### **场景操作**
+
+1. **W**：向前移动场景相机。
+2. **S**：向后移动场景相机。
+3. **A**：向左移动场景相机。
+4. **D**：向右移动场景相机。
+5. **E**：向上移动场景相机。
+6. **Q**：向下移动场景相机。
+7. **鼠标右键**：按下时开始旋转场景相机，释放时停止旋转。
+
+---
+
+### **音乐播放器操作**
+
+1. **Enter**：播放或暂停音乐。
+
+---
+
+### **轨道操作**
+
+1. **Alt + P**：显示或隐藏所有路径节点。
+2. **Alt + D**：启用或隐藏所有轨道路径显示。
+
+---
+
+### **保存与导出**
+
+1. **Ctrl + S**：保存项目。
+2. **Ctrl + E**：导出项目。
+
+---
+
+### **复制、粘贴与删除**
+
+1. **Ctrl + C**：复制选中的游戏元素（目前仅支持单选）。
+2. **Ctrl + V**：粘贴游戏元素。
+3. **Ctrl + D**：删除选中的游戏元素。
+
+---
+
+### **分辨率提示**
+
+1. **Ctrl + 1**：切换到手机分辨率提示。
+2. **Ctrl + 2**：切换到平板分辨率提示。
+3. **Ctrl + 3**：切换到绝对安全区域提示。
+
+---
+
+### **UI 操作**
+
+1. **Ctrl + U**：切换所有静态窗口的显示状态。
+
+---
+
+### **摄像机切换**
+
+1. **Ctrl + M**：切换摄像机。
+
+---
+
+### **元素选择**
+
+1. **鼠标左键**：点击选择场景中的游戏元素（需不在 UI 上）。
+
 ## 谱面结构
 
 由于ichni的自由度极高，其谱面结构偏向原生unity，现在讲述简要功能
 
-#### Element Folder
+### Element Folder
 
 本质上是一个空节点，拥有自己的位置属性，可以在下面放置其他的元素
 
 ### Camera
 
-可以直接在folder下，也可以放在cross Track Point里，需要注意的是，一张谱面只能有一个camera
+可以直接在folder下（简单情况），也可以放在cross Track Point里（需要多机位的特殊情况），需要注意的是，**一张谱面只能有一个camera**
+
+camera的职责很简单：做一个camera。带着他或者他所在的folder和cross Track Point里的track乱动，他也就动起来了
+
+### Track
+
+Track是ichni的核心元件，以下分为几种
+
+###### 基础：TrackPath
+
+TrackPath属性：空间形状，前进方式，是否闭合
+
+前进方式：track的前进方式分为time和distance，time会把每两个pathnode之间的段分为相同的时间分别前进,diasance则会根据距离等量均分，如果有缓动那么将会强制使用diasance
+
+```示例
+以下是一个示例(代码块仅示意，没有实际意义和语法)
+new track{
+    pathnode0(0,0,0)
+    pathnode1(0,0,1)
+    pathnode2(0,0,10)
+    starttime:0
+    endtime:2
+}
+若是time模式下，0到1秒的时间track从0到1，而在剩下的1秒会从1直接冲到10
+distance就不会
+```
+
+
+
+###### 路径方式
+
+1. Movable
+
+2. Static
+
+###### 显示方式
+
+1. AutoOrient
+
+2. TrackPath
+
+###### movable属性：
+
+    开始时间，结束时间，可视长度，缓动
+
+    其中开始时间和结束时间是**track的头部**到达首尾的时间，而 结束时间+可视长度 则是**track尾**到达尾部的时间
+
+    在movable中，note以固定的位置生成在track上，在放note时切记判定时间要在track的启停时间之间
+
+###### Static属性：
+
+    下落时间，下落缓动
+
+    Static的track若是有选择显示方式，则会始终显示整条track
+
+    在static中，note从track的<mark>**尾部运动到头部**</mark>
+
+###### 显示属性
+
+    无论是AutoOrient还是TrackPath，都拥有一个材质系统，你可以选择主题包中的材质，两个显示方式不同的是，track path会由于其中pathnode的方向而改变面的朝向，而AutoOrient会强制track的面始终面向摄像机（这段建议实操看看效果，各有各的好）
+
+### pathnode
+
+无疑，pathnode是track下最主要的部分，但是也是最简单的部分，~~但是扛不住量大~~
+
+pathnode带有位置，旋转，缩放，颜色等，用于调整track部分的颜色
+
+建议实操
+
+### 事件
+
+事件是一个很大的基础类，包揽了track外几乎所有的动态效果
+
+事件包含displacement，swirl，scale，若是有过动效类型写谱的话，事件系统应当不难理解
+
+另外还有一个特殊的事件用在track下：trackPercentPoint
+
+        trackPercentPoint使用0到1的值代表track进程，配合trail使用可以实现 ~~反复横跳~~ 精细控制
+
+        还有一个trackHeadPoint是trackPercentPoint的简化版，虽然不该放在这里但是我真的懒得开一个来讲
+
+建议实操
+
+### Trail
+
+由于0.2（旧版本）的某些神奇效果使我们再次增加了Trail，Trail的原型是unity的尾迹效果，所以需要注意的是当用各种手段使trail瞬移的时候会拉出长长的痕迹
+
+trail配有位置，材质，颜色等（仍在开发）
+
+目前Trail只能在trackPercentPoint下生成，但是有一点奇技淫巧是可以把他复制出来然后直接粘贴在folder下，这样就可以通过事件控制他了