dingyuntian
3eea7e9ca6
- 列出 fade_in/out、fade_in_white、flash_white、 wipe_in/out、shutter_in/out 等指令的用法与示例
57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
# Yarn 全局转场指令表
|
|
|
|
全局转场采用“进入方式”和“退出方式”自由组合：`in` 表示盖住画面，`out` 表示揭开画面。
|
|
|
|
| Yarn 命令 | 默认时长 | 是否等待完成 | 用途 |
|
|
|---|---:|:---:|---|
|
|
| `<<fade_in>>` | 1 秒 | 是 | 黑色遮罩逐渐盖住画面 |
|
|
| `<<fade_out>>` | 1 秒 | 是 | 当前遮罩逐渐消失，黑幕和白幕通用 |
|
|
| `<<fade_in_sync>>` | 1 秒 | 否 | 开始黑色淡入后立即继续执行后续 Yarn |
|
|
| `<<fade_out_sync>>` | 1 秒 | 否 | 开始淡出后立即继续执行后续 Yarn |
|
|
| `<<fade_in_white>>` | 1 秒 | 是 | 白色遮罩逐渐盖住画面 |
|
|
| `<<flash_white>>` | 0.2 秒 | 是 | 完成一次白色闪光，参数表示完整总时长 |
|
|
| `<<wipe_in>>` | 0.6 秒 | 是 | 黑色幕布从左向右盖住画面 |
|
|
| `<<wipe_out>>` | 0.6 秒 | 是 | 当前颜色的幕布继续向右移出 |
|
|
| `<<shutter_in>>` | 0.6 秒 | 是 | 黑色上下幕布向中心闭合 |
|
|
| `<<shutter_out>>` | 0.6 秒 | 是 | 当前颜色的上下幕布向外打开 |
|
|
|
|
## 使用规则
|
|
|
|
- 所有时长参数都可以省略，单位为秒。
|
|
- Out 自动继承当前遮罩颜色，因此没有 `fade_out_white`。
|
|
- 除两个旧 Sync 指令外，其他指令都会等待动画完成。
|
|
- In 与 Out 可以自由组合，不要求同类型配对。
|
|
- `flash_white` 是一次性效果，不需要再接 Out；应从可见画面开始使用。
|
|
|
|
## 常用写法
|
|
|
|
```yarn
|
|
// 传统黑色淡入淡出
|
|
<<fade_in>>
|
|
<<load_scene ClinicOut>>
|
|
<<fade_out>>
|
|
|
|
// 白色淡入，普通淡出
|
|
<<fade_in_white 0.3>>
|
|
<<fade_out 0.8>>
|
|
|
|
// 黑幕淡入，然后向右推开
|
|
<<fade_in 0.5>>
|
|
<<wipe_out 0.6>>
|
|
|
|
// 推幕盖入，然后淡出
|
|
<<wipe_in>>
|
|
<<fade_out>>
|
|
|
|
// 白幕淡入，然后上下打开
|
|
<<fade_in_white>>
|
|
<<shutter_out>>
|
|
|
|
// 上下闭合，然后向右推开
|
|
<<shutter_in>>
|
|
<<wipe_out>>
|
|
|
|
// 单次白闪
|
|
<<flash_white 0.2>>
|
|
```
|