Godot中如何基于自定义depth属性实现同z索引内的绘制顺序控制？

核心问题拆解 #

你需要实现类似Y Sort的扁平化排序效果：所有目标节点处于同一Z索引，按自定义depth属性值决定绘制层级（值越高越靠前），同时保留节点父子间的变换、视觉属性继承关系。

方案一：复刻引擎Y Sort的底层逻辑（推荐） #

引擎原生Y Sort的扁平化效果，是在_attach_canvas_item_for_draw阶段，将子节点的CanvasItem重新插入父节点的r_z_list中，而非修改节点的顶级状态。你可以在GDExtension中复刻这一流程：

1. 收集子节点：参考Y Sort的子节点遍历逻辑，筛选出所有CanvasItem类型的子节点，提取它们的depth属性值。
2. 排序子节点：按depth值从低到高（或你需要的优先级）对子节点排序。
3. 调整绘制顺序：
   • 不要调用set_as_top_level(true)，保持节点的父子层级关系。
   • 在_attach_canvas_item_for_draw的回调钩子中，将排序后的子节点CanvasItem替换插入到父节点的r_z_list对应位置，同时同步更新r_z_last_list，确保渲染阶段能正确读取绘制顺序。

这种方式完全贴合引擎原生逻辑，既能实现扁平化排序，又能完整保留父子节点的变换、modulate等属性继承。

方案二：手动控制绘制流程（Godot 4.x+） #

如果不想深入引擎底层，可通过父节点手动控制子节点的绘制顺序：

1. 在父节点中开启ignore_children = true，关闭默认的子节点自动绘制。
2. 在父节点的_draw方法中，收集、排序子节点后手动调用其绘制方法：

   void CustomSortNode::_draw() {
       // 收集所有CanvasItem子节点
       Vector<CanvasItem*> sorted_children;
       for (int i = 0; i < get_child_count(); i++) {
           CanvasItem* child = Object::cast_to<CanvasItem>(get_child(i));
           if (child != nullptr) {
               sorted_children.push_back(child);
           }
       }
   
       // 按depth降序排序（值越高越先绘制，即越靠前）
       sorted_children.sort([](const CanvasItem* a, const CanvasItem* b) {
           return a->get("depth") > b->get("depth");
       });
   
       // 手动绘制排序后的子节点
       for (CanvasItem* child : sorted_children) {
           child->draw();
       }
   }
   

   该方案无需修改引擎底层，能完全保留父子属性继承，但仅适用于CanvasItem类型节点，且需要处理_draw方法的覆盖逻辑。

方案三：修复set_as_top_level的副作用（临时替代） #

如果坚持使用canvas_item_set_draw_index，可以手动同步父节点的属性到子节点，弥补set_as_top_level的缺陷：
在父节点的_process或_physics_process中，同步变换、视觉属性：

void CustomSortNode::_process(double delta) {
    const Transform2D parent_global_xform = get_global_transform();
    const Color parent_modulate = get_modulate();
    const bool parent_visible = is_visible();

    for (int i = 0; i < get_child_count(); i++) {
        CanvasItem* child = Object::cast_to<CanvasItem>(get_child(i));
        if (child != nullptr && child->is_top_level()) {
            // 同步全局变换
            child->set_global_transform(parent_global_xform * child->get_transform());
            // 同步调制颜色
            child->set_modulate(parent_modulate * child->get_modulate());
            // 同步可见性
            child->set_visible(parent_visible && child->is_visible());
            // 按需同步其他属性（如opacity、flip_h等）
        }
    }
}

这种方法需要维护大量属性同步，容易出现遗漏或性能损耗，仅作为临时过渡方案。

内容的提问来源于stack exchange，提问作者Manas R. Makde