dingyuntian
3eea7e9ca6
- 列出 fade_in/out、fade_in_white、flash_white、 wipe_in/out、shutter_in/out 等指令的用法与示例
1.8 KiB
1.8 KiB
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；应从可见画面开始使用。
常用写法
// 传统黑色淡入淡出
<<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>>