基于MetalKit与Swift的iOS 3D Viewer深度功能异常求助

问题现象 #

使用Metal与Swift开发iOS平台3D Viewer时，单个3D形状（如平面、四面体）可正常渲染，但同时绘制两个形状时深度测试失效。例如Z=0的平面本应处于Z>0的四面体后方，但从Z>0的相机视角观察，平面却显示在四面体前方。怀疑是深度纹理、模板状态配置错误，或是多次调用drawPrimitives导致问题，询问是否必须单次调用drawPrimitives才能实现深度测试。

核心问题与修复方案 #

1. 深度纹理格式与管线配置不匹配 #

渲染管线中设置的深度附件格式为.depth32Float_stencil8，但创建深度纹理时使用的是.stencil8，格式完全不兼容，导致深度缓冲区无法正常存储和读取深度值。

• 修复：创建深度纹理时采用与管线一致的.depth32Float_stencil8格式，同时不要写死纹理尺寸，要与MTKView的实际分辨率保持一致。

2. 深度纹理Usage配置错误 #

当前深度纹理的usage设为.pixelFormatView，该选项仅适用于纹理视图场景，无法满足深度附件的读写需求。

• 修复：将usage改为.renderTarget，这是深度纹理作为渲染目标的正确配置。

3. 多次调用drawPrimitives无影响 #

无需单次调用drawPrimitives，只要在同一个渲染命令编码器中连续执行绘制操作，深度缓冲区会被正确复用，深度测试失效与多次调用无关。

4. 模板附件格式冗余配置 #

渲染管线中同时将depthAttachmentPixelFormat和stencilAttachmentPixelFormat设为.depth32Float_stencil8，但.depth32Float_stencil8本身已经包含深度和模板通道，重复设置会造成冗余。如果不需要模板测试，可将stencilAttachmentPixelFormat设为.invalid。

修改后的关键代码片段 #

初始化代码（深度纹理部分修正） #

// 注意：若init时无法获取view尺寸，建议在draw方法中动态创建/更新深度纹理
let viewSize = CGSize(width: 576, height: 723) // 替换为实际view的尺寸
let desc = MTLTextureDescriptor.texture2DDescriptor(
    pixelFormat: .depth32Float_stencil8,
    width: Int(viewSize.width),
    height: Int(viewSize.height),
    mipmapped: false
)
desc.storageMode = .private
desc.usage = .renderTarget
depthTexture = device.makeTexture(descriptor: desc)!

渲染管线描述符修正 #

let renderPipelineDescriptor = MTLRenderPipelineDescriptor()
renderPipelineDescriptor.colorAttachments[0].pixelFormat = .bgra8Unorm
renderPipelineDescriptor.depthAttachmentPixelFormat = .depth32Float_stencil8
// 不需要模板测试时设置为.invalid
renderPipelineDescriptor.stencilAttachmentPixelFormat = .invalid

绘制代码补充建议 #

当MTKView尺寸发生变化（如屏幕旋转）时，需在draw方法中检查深度纹理尺寸是否与当前view匹配，若不匹配则重新创建深度纹理，避免因尺寸不匹配导致的深度测试异常。

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