Skip to content

Commit

Permalink
修正：事件字段相关描述
Browse files Browse the repository at this point in the history
  • Loading branch information
@NuanRMxi
NuanRMxi committed Oct 19, 2024
1 parent ee19481 commit 4e61c1e
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 25 deletions.
9 changes: 5 additions & 4 deletions src/chart-standard/chart-format/rpe/event.md
View file
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# Event
本页将介绍判定线事件层级下的**普通事件**。

RPE中，一共有五种普通事件，它们分别是：`moveXEvents`（X轴移动事件）、`moveYEvents`（Y轴移动事件）、`rotateEvents`（旋转事件）、`alphaEvents`（不透明度事件）、`speedEvents`（音符流速事件）。
在层级下，这些字段都对应一个 `JsonArray`，每一个元素代表一个事件。
在稍早版本，XY轴移动事件分离（XY事件不同时出现与消失）会被制谱器报错，因为这是对早期PhiEditor Chart的兼容，现在它不被报错，其本身也只是可选项。
- RPE中，一共有五种普通事件，它们分别是：`moveXEvents`（X轴移动事件）、`moveYEvents`（Y轴移动事件）、`rotateEvents`（旋转事件）、`alphaEvents`（不透明度事件）、`speedEvents`（音符流速事件）。
- 在层级下，这些字段都对应一个 `JsonArray`，每一个元素代表一个事件。
- 在稍早版本，XY轴移动事件分离（XY事件不同时出现与消失）会被制谱器报错，因为这是对早期PhiEditor Chart的兼容，现在它不被报错，其本身也只是可选项。
- 当前判定线无某一个事件时，无对应字段而非空数组。

除了**流速事件**外的其他所有普通事件都应该含有以下字段。
除了**流速事件**外的每个普通事件都应该含有以下字段。

| 字段名 | 类型 | 描述 | 默认值 | 加入版本 |
|:------------:|:-----------------------:|:----------------------------------------------------------------------------------------------------------------------:|:----------------------:|:----:|
Expand Down
44 changes: 23 additions & 21 deletions src/chart-standard/chart-format/rpe/judgeLine.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,25 +2,27 @@

每一个judgeLine（判定线）都含有以下字段：

| 字段名 | 类型 | 描述 | 默认值 | 加入版本 |
|:------------:|:---------:|:------------------------------------------------------------------------:|:--------------:|:----:|
| Group | int | 判定线所属[组](./root.md#judgelinegroup) | 0 | - |
| Name | string | 判定线名称 | Untitled | - |
| Texture | string | 判定线贴图，若非默认值，则为相对于谱面根目录的路径，更多详见[Texture](./extend.md#texture) | line.png | - |
| anchor | JsonArray | 判定线锚点，详见 [extend](./extend.md#anchor) | `[ 0.5, 0.5 ]` | 142 |
| eventLayers | JsonArray | 事件层级，默认包含至少一个层级（JsonObject），空层级为 `null`，最大有五个，层级下事件见 [event](./event.md) | - | - |
| extended | JsonArray | 特殊事件，详见 [extend Event](./extendEvent.md) | - | - |
| father | int | 父线，`-1` 表示无父线（行为待补充） | - | - | | -1 | - |
| isCover | int | 遮罩（行为待补充） | 1 | - |
| notes | JsonArray | 线上所有的Note，详见 [note](./note.md) | - | - |
| numOfNotes | int | Note总数量(包含 `FakeNote`，不包含 `Hold`) | 0 | - |
| zOrder | int | 线z轴(即图层），范围为±100（_范围需要验证_） | 0 | - |
| attachUI | string? | UI绑定，详见 [extend](./extend.md#attachui)；无绑定情况下，不存在本属性 | - | - |
| isGif | bool | 纹理是否为GIF，若为 `true` ，Texture为一个GIF文件 | false | 150 |
| posControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| sizeControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| skewControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| yControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| alphaControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| bpmfactor | float | _此字段无法在RPE中编辑_ | 1.0 | - |
| 字段名 | 类型 | 描述 | 默认值 | 加入版本 |
|:------------:|:----------:|:--------------------------------------------------------------------:|:--------------:|:----:|
| Group | int | 判定线所属[组](./root.md#judgelinegroup) | 0 | - |
| Name | string | 判定线名称 | Untitled | - |
| Texture | string | 判定线贴图，若非默认值，则为相对于谱面根目录的路径，更多详见[Texture](./extend.md#texture) | line.png | - |
| anchor | JsonArray | 判定线锚点，详见 [extend](./extend.md#anchor) | `[ 0.5, 0.5 ]` | 142 |
| eventLayers | JsonArray? | 事件层级，默认包含至少一个层级（JsonObject），空层级详见下方，最大有五个，层级下事件见 [event](./event.md) | - | - |
| extended | JsonArray | 特殊事件，详见 [extend Event](./extendEvent.md) | - | - |
| father | int | 父线，`-1` 表示无父线（行为待补充） | - | - | | -1 | - |
| isCover | int | 遮罩（行为待补充） | 1 | - |
| notes | JsonArray | 线上所有的Note，详见 [note](./note.md) | - | - |
| numOfNotes | int | Note总数量(包含 `FakeNote`，不包含 `Hold`) | 0 | - |
| zOrder | int | 线z轴(即图层），范围为±100（_范围需要验证_） | 0 | - |
| attachUI | string? | UI绑定，详见 [extend](./extend.md#attachui)；无绑定情况下，不存在本属性 | - | - |
| isGif | bool | 纹理是否为GIF，若为 `true` ，Texture为一个GIF文件 | false | 150 |
| posControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| sizeControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| skewControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| yControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| alphaControl | JsonArray | _此字段无法在RPE中编辑_ | - | - |
| bpmfactor | float | _此字段无法在RPE中编辑_ | 1.0 | - |
- 若层级为空，在某个版本之前，字段为 `null` ，在某个版本及以后，空层级无字段。（当前已知至少在 `143` 版本时无字段）
- 若所有层级都为空，`eventLayers` 字段不会出现。

0 comments on commit 4e61c1e

Please sign in to comment.