ichni_Creator_Studio/Document/ichni编辑器指南.md

# ichni编辑器指南

## 前言

ichni巴拉巴拉待会写

## 进入程序 新建项目

~~如果有一般的写谱经验那么大概都可以知道是做什么的~~

Project name：项目名字，即这张谱面的名字，建议的是 “曲名” +“  ”+“难度名称”

Creator：你的名字/谱师马甲

BPM：节拍，由于ichni是按照秒数存储谱面，而有变bpm的曲子少之又少，所以是固定bpm

            不知道bpm是什么的：[歌曲bpm是什么 - 搜索](https://cn.bing.com/search?q=%e6%ad%8c%e6%9b%b2bpm%e6%98%af%e4%bb%80%e4%b9%88&FORM=QSRE1)

            bpm测试器：[歌曲调性和BPM查找器 - 多功能音乐分析器](https://vocalremover.org/zh/key-bpm-finder)    

Delay：这里的Delay只是单纯的调整谱面开始的时间，调为负数可以在歌曲开始前开始谱面，如果有偏移（offset）的需求建议剪一下曲子

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**：切换所有静态窗口的显示状态。
2. **Ctrl+ ↑/↓**：放大，缩小ui大小

---

### **摄像机切换**

1. **Ctrl + M**：切换摄像机。

---

### **元素选择**

1. **鼠标左键**：点击选择场景中的游戏元素（需不在 UI 上）。

## 谱面结构

由于ichni的自由度极高，其谱面结构偏向原生unity，现在讲述简要功能

### Element Folder

本质上是一个空节点，拥有自己的位置属性，可以在下面放置其他的元素

### 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下，这样就可以通过事件控制他了

### Note

##### 基础

note可以视为环境物体，拥有击打时间，击打效果等

击打时间：建议使用采音器=>见采音器指南

##### 击打效果和判定模式

由于不同主题包拥有不同击打效果和判定模式，在add页需要输入字符来创建

---

## 谱面存档

望文生义，不必多说，以下讲的是一些特别的机制

### 自动保存

ichni每隔一段时间就会自动保存谱面，如果要回档，需要手动替换

### Clip

asd

### Export

ads