入场动画 (transition_in)

入场动画和出场动画是视觉小说中管理UI元素显示和隐藏的重要机制，我来详细解释：

入场动画 (transition_in)

当某个元素需要显示时播放的动画效果：

- character: "黛安娜"
  text: "你好"
  portrait: "protagonist"
  transition_in: "slide_left"  # 从左侧滑入

常见的入场动画类型：

• fade_in: 淡入（透明度从0到100%）
• slide_left/right/up/down: 从指定方向滑入
• zoom_in: 缩放进入（从小变大）
• bounce: 弹跳进入
• typewriter: 文字逐个显示

出场动画 (transition_out)

当元素需要隐藏时播放的动画效果：

- character: "黛安娜"
  text: "再见"
  portrait: "protagonist"
  transition_out: "fade_out"  # 说完后淡出

实际应用场景

1. 角色立绘的进出场

# 角色登场
- character: "艾米"
  text: "我来了！"
  portrait: "happy"
  transition_in: "slide_right"

# 角色离开
- character: "艾米"
  text: "我走了..."
  portrait: "sad"
  transition_out: "slide_left"

2. 对话框的显示控制

- character: "旁白"
  text: "..."
  transition_in: "fade_in"    # 对话框淡入
  transition_out: "fade_out"  # 对话框淡出

3. 背景切换时的角色处理

- character: "黛安娜"
  text: "我们去另一个地方吧"
  transition_out: "dissolve"  # 先让角色消失

- transition: "scene_change"
  duration: 1.0
  new_background: "forest"

- character: "黛安娜"
  text: "到了！"
  transition_in: "materialize"  # 在新场景中出现

时机控制

• 入场动画：在显示内容之前播放
• 出场动画：在内容显示完成后播放

这样设计可以让你精确控制每个视觉元素的出现和消失，创造流畅的视觉体验。比如角色可以优雅地走进场景说话，说完后优雅地离开，而不是突然出现和消失。