Metal深度缓冲区与SceneKit渲染集成问题及格式咨询

我正在使用Metal渲染带有Z缓冲的场景，需将该Z缓冲集成到SceneKit渲染流程中，但无法让SceneKit正确使用该深度缓冲，且不确定SceneKit期望的Z缓冲格式。

根据相关资料，我原以为SceneKit使用范围为1（近平面）到0（远平面）的反向对数Z缓冲，但实际实现后，SceneKit绘制的物体无法正确遵循深度缓冲：要么始终显示，要么始终被遮挡。

Metal渲染通道生成Z缓冲纹理的代码 #

struct FragmentOut {
    float4 color [[color(0)]];
    float depth [[depth(any)]];
};

fragment FragmentOut metalRenderFragment(const InOut in [[ stage_in ]]) {
    FragmentOut out;
    out.depth = 0; // 0 is far with reverse z buffer

    ...
    
    float cameraSpaceZ = ...; // Computed in shader

    // These constants are taken from SceneKit's camera and inlined here
    const float zNear = 0.0010000000474974513; 
    const float zFar = 1000.0;

    float logDepth = log(z / zNear) / log(zFar / zNear);

    out.depth = 1.0 - logDepth; // Reverse the depth for scenekit

    return out;
}

SceneKit渲染全屏四边形的代码 #

fragment FragmentOut sceneKitFullScreenQuadFragment(const InOut in [[ stage_in ]],
                                depth2d<float, access::sample> depthTexture [[texture(1)]])
{
    constexpr sampler sampler(filter::linear);
    
    const float depth = depthTexture.sample(sampler, in.uv);
    return {
        .color = float4(0),
        .depth = depth,
    };
}

我有两个问题：

1. SceneKit使用的Z缓冲格式是什么？是否为反向对数Z缓冲？
2. 我在为SceneKit生成Z缓冲值的过程中存在哪些错误？

1. SceneKit的Z缓冲格式 #

SceneKit确实使用反向对数深度缓冲，范围为近平面=1.0，远平面=0.0，深度纹理格式通常为MTLPixelFormatDepth32Float（32位浮点深度），需确保你生成的深度纹理格式与SceneKit内部一致。

另外要注意，SceneKit的相机空间Z轴方向为指向屏幕外为正，如果你的cameraSpaceZ采用指向屏幕内为正的右手坐标系，会直接导致深度值完全反转，这是常见的适配误区。

2. 代码中的错误点 #

• 未定义变量：代码中log(z / zNear)里的z未定义，应该替换为你计算好的cameraSpaceZ，这是直接导致深度值异常的笔误。
• 相机空间Z符号不匹配：若你的cameraSpaceZ是相机前方（屏幕内）为负，需要先对其取反，再代入对数计算，否则深度值的远近关系会完全颠倒。
• 未做边界钳制：当cameraSpaceZ小于zNear或大于zFar时，logDepth会超出0-1范围，需要用clamp(logDepth, 0.0, 1.0)限制区间，避免深度值异常。
• UV坐标不匹配：部分Metal纹理的Y轴是翻转的，全屏四边形的UV需要调整为float2(in.uv.x, 1.0 - in.uv.y)再采样深度纹理，否则会出现深度值与画面位置不对应的情况，导致遮挡逻辑混乱。

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