# 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>>
```