屏幕过场

Screen 配置位于 core/display/screens，顶层节点是效果 ID。

需要完整操作流程时，先阅读Screen 过场制作。本页代码未标为完整文件时，均为对应节点中的片段。

文件关系复制章节链接

每种图层只需要对应类型的字段，不要把所有字段复制到同一图层。Screen 的纯黑边和程序化遮罩不需要 PNG；Image 需先登记图片，Layout 需先准备字体、图片与局部 Layout。

顶层效果字段复制章节链接

Letterbox 的 top 和 bottom 至少有一个为 true。

Letterbox animation复制章节链接

animation:
  enter:
    duration: 12
    easing: ease-out
  exit:
    duration: 10
    easing: ease-in

缓动：linear、ease-in、ease-out、ease-in-out。

Scene 图层通用字段复制章节链接

Shape 字段复制章节链接

flash:
  type: shape
  animation: flash
  color: "#FFD94A"
  opacity: 0.7
  duration: 24

animation 可选：

• fill: 始终显示。
• fade-in: 淡入。
• fade-out: 淡出。
• flash: 闪烁一次。
• pulse: 闪烁两次。

Wipe 基础字段复制章节链接

图案：

• linear
• circle
• diamond
• radial
• split
• blinds
• checker
• dissolve
• stripes

band 只支持 linear。

分阶段 Wipe复制章节链接

cover 和 reveal 可以使用：

enter:
  duration: 18
  easing: ease-out
hold: 8
exit:
  duration: 18
  easing: ease-in

只要 enter、hold 或 exit 其中一个非零，图层总时长改为：

enter.duration + hold + exit.duration

此时至少需要进入或退出动画之一。

Image 图层复制章节链接

logo:
  type: image
  image:
    namespace: xerr_ui
    basename: icon
    id: scene_logo
  width: 192
  height: 0
  rotation: 0
  distance: 180
  overshoot: 1.15

width 和 height 至少一个大于 0。两者都填写时允许拉伸。只按高度缩放时，需要显式写 width: 0，否则 width 会使用省略值 160，并与 height 同时生效。

Layout 图层复制章节链接

content:
  type: layout
  layout: screen_scene_title
  variables:
    title: "区域解锁"
  refresh: 10
  distance: 72

完整 Layout 不支持整体 Zoom、Pop 或 Spin，因为内部文字、头像和进度各自定位。

Transition 字段复制章节链接

Image 的进入和退出总时长不能超过图层 duration。Layout 同样受此限制。

Marker复制章节链接

markers:
  covered: 18

Marker 名称不能为空，tick 必须小于 Scene 总时长。它不会自动执行命令，而是供 Kether、API 和事件等待。