如何在Term::Animation中实现对象叠加及层级异常排查

问题现象 #

使用Perl的Term::Animation库开发终端动画时出现层级显示异常：

• 云会从太阳前方穿过，但无法从火箭后方穿过
• 同为标量定义的树，云却能正常从其后方穿过

核心困惑 #

火箭（@rocket）和太阳（@sun）以数组定义，云（$cloud1/$cloud2/$cloud3）以标量定义，但标量定义的树却能让云正常穿过后方，无法理解这种变量类型差异导致的渲染区别。

问题根源 #

Term::Animation的实体层级渲染逻辑仅和实体的Z轴坐标（position参数的第三个值）以及创建顺序有关，和变量是数组还是标量完全无关：

1. 查看代码中各实体的Z轴设置：
   • 云的Z轴值为10
   • 太阳的Z轴值为20
   • 火箭的Z轴值为15
   • 树的Z轴值为5
2. 渲染优先级规则：Z值越大，实体显示层级越高（越靠上，会覆盖下层实体）：
   • 太阳（Z=20）> 火箭（Z=15）> 云（Z=10）> 树（Z=5）
   • 云的Z值小于火箭，所以移动时会被火箭挡住，看起来像无法从火箭后方穿过
   • 云的Z值大于树，所以移动时会覆盖树，视觉上呈现从树后方穿过的效果
   • 云的Z值小于太阳，所以移动时会被太阳挡住，看起来像从太阳前方穿过

修复方案 #

调整实体的Z轴坐标，根据需求设置正确的层级关系：

示例：让云从火箭后方穿过 #

将云的Z轴值设为大于火箭的15（比如16），这样云会显示在火箭上层，移动时就能从火箭后方穿过：

# 修改cloud1的Z轴坐标
$s->new_entity(
    shape           => $cloud1,
    position        => [ 2, 1, 16], # Z轴从10改为16
    callback_args   => [1,0,0,0],
    wrap            => 1,
    default_color   => 'WHITE',
    auto_trans      => 1,
);

# 同理修改cloud2和cloud3的Z轴为16
$s->new_entity(
    shape           => $cloud2,
    position        => [ 10, 5, 16],
    callback_args   => [1,0,0,0],
    wrap            => 1,
    default_color   => 'WHITE',
    auto_trans      => 1,
);

$s->new_entity(
    shape           => $cloud3,
    position        => [ 15, 1, 16],
    callback_args   => [1,0,0,0],
    wrap            => 1,
    default_color   => 'WHITE',
    auto_trans      => 1,
);

通用层级规则 #

• 若要实体A覆盖实体B（A在B上方），设置A的Z值 > B的Z值
• 若要实体A从实体B后方穿过（B覆盖A），设置A的Z值 < B的Z值

内容的提问来源于stack exchange，提问作者Exponecial