From 3eea7e9ca687397382cc175faf3ce42f89f5de71 Mon Sep 17 00:00:00 2001
From: Ding Yuntian <1491671119@qq.com>
Date: Thu, 16 Jul 2026 17:57:06 +0800
Subject: [PATCH] =?UTF-8?q?docs(dialog):=20=E6=B7=BB=E5=8A=A0=20Yarn=20?=
 =?UTF-8?q?=E5=85=A8=E5=B1=80=E8=BD=AC=E5=9C=BA=E6=8C=87=E4=BB=A4=E8=A1=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 列出 fade_in/out、fade_in_white、flash_white、
  wipe_in/out、shutter_in/out 等指令的用法与示例
---
 Docs/Yarn全局转场指令表.md | 56 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 Docs/Yarn全局转场指令表.md

diff --git a/Docs/Yarn全局转场指令表.md b/Docs/Yarn全局转场指令表.md
new file mode 100644
index 000000000..bbc5ba51b
--- /dev/null
+++ b/Docs/Yarn全局转场指令表.md
@@ -0,0 +1,56 @@
+# 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>>
+```