如何使用Metal 3在NSWindow上实现屏幕渲染？

1. 给NSWindow绑定Metal渲染层 #

先把NSWindow的内容视图替换为MTKView（MetalKit视图），这是Mac上最快的Metal屏幕渲染入口，完全兼容Metal 3和Intel处理器：

// 假设你已创建NSWindow实例window
MTKView *metalView = [[MTKView alloc] initWithFrame:window.contentView.bounds];
// 获取系统默认Metal设备（Intel Mac会自动匹配兼容Metal 3的设备）
id<MTLDevice> device = MTLCreateSystemDefaultDevice();
metalView.device = device;
// 将Metal视图设为窗口内容视图
[window setContentView:metalView];

如果你的C++库需要手动控制渲染时机，关闭MTKView的自动绘制：

metalView.enableSetNeedsDisplay = NO;
metalView.paused = YES;

2. 初始化Metal核心组件（兼容Metal 3） #

这些是所有Metal渲染的基础，完全不需要Metal 4的新特性：

// 创建命令队列：用于提交渲染命令到GPU
id<MTLCommandQueue> commandQueue = [device newCommandQueue];

// 编写Metal 3兼容的着色器代码
NSString *shaderSource = @"#include <metal_stdlib>\n"
                         @"using namespace metal;\n"
                         @"struct VertexOut {\n"
                         @"    float4 position [[position]];\n"
                         @"    float4 color;\n"
                         @" };\n"
                         @"vertex VertexOut vertexFunc(uint vertexId [[vertex_id]]) {\n"
                         @"    VertexOut out;\n"
                         @"    float2 positions[3] = {float2(0.0, 1.0), float2(-1.0, -1.0), float2(1.0, -1.0)};\n"
                         @"    out.position = float4(positions[vertexId], 0.0, 1.0);\n"
                         @"    out.color = float4(1.0, 0.0, 0.0, 1.0);\n"
                         @"    return out;\n"
                         @" }\n"
                         @"fragment float4 fragmentFunc(VertexOut in [[stage_in]]) {\n"
                         @"    return in.color;\n"
                         @" }";

// 编译着色器库
id<MTLLibrary> library = [device newLibraryWithSource:shaderSource options:nil error:nil];
id<MTLFunction> vertexFunc = [library newFunctionWithName:@"vertexFunc"];
id<MTLFunction> fragmentFunc = [library newFunctionWithName:@"fragmentFunc"];

// 创建渲染管线状态
MTLRenderPipelineDescriptor *pipelineDesc = [[MTLRenderPipelineDescriptor alloc] init];
pipelineDesc.vertexFunction = vertexFunc;
pipelineDesc.fragmentFunction = fragmentFunc;
pipelineDesc.colorAttachments[0].pixelFormat = metalView.colorPixelFormat;

id<MTLRenderPipelineState> pipelineState = [device newRenderPipelineStateWithDescriptor:pipelineDesc error:nil];

3. 实现60帧同步的渲染循环 #

用CADisplayLink同步屏幕刷新频率，这是Mac上保证60帧的标准方式：

CADisplayLink *displayLink = [CADisplayLink displayLinkWithTarget:self selector:@selector(renderFrame)];
[displayLink addToRunLoop:[NSRunLoop mainRunLoop] forMode:NSDefaultRunLoopMode];

实现renderFrame方法完成单帧渲染提交：

- (void)renderFrame {
    MTKView *metalView = (MTKView *)self.window.contentView;
    // 获取交换链中当前可绘制的纹理帧
    id<MTLDrawable> drawable = [metalView currentDrawable];
    if (!drawable) return;

    // 创建渲染通道描述符
    MTLRenderPassDescriptor *passDesc = [metalView currentRenderPassDescriptor];
    passDesc.colorAttachments[0].loadAction = MTLLoadActionClear;
    passDesc.colorAttachments[0].clearColor = MTLClearColorMake(0.1, 0.1, 0.1, 1.0);
    passDesc.colorAttachments[0].storeAction = MTLStoreActionStore;

    // 创建命令缓冲区与渲染编码器
    id<MTLCommandBuffer> commandBuffer = [_commandQueue commandBuffer];
    id<MTLRenderCommandEncoder> encoder = [commandBuffer renderCommandEncoderWithDescriptor:passDesc];

    // 设置管线并绘制三角形示例
    [encoder setRenderPipelineState:_pipelineState];
    [encoder drawPrimitives:MTLPrimitiveTypeTriangle vertexStart:0 vertexCount:3];

    // 结束编码并提交帧到屏幕
    [encoder endEncoding];
    [commandBuffer presentDrawable:drawable];
    [commandBuffer commit];
}

4. C++库集成要点 #

如果你的渲染逻辑在C++中，可通过以下方式与ObjC层交互：

• 将Metal对象（device、commandQueue、pipelineState）通过void*桥接给C++，或直接使用ObjC++混编（把.m文件改为.mm）
• 在C中封装Metal调用，比如用类包装MTLCommandQueue等对象，通过ObjC直接调用Metal API

Intel Metal 3兼容注意事项 #

• 禁用Metal 4新增API，如MTLRenderPassDescriptor的visibilityResultBuffer、网格着色器等特性
• 着色器严格使用Metal 3兼容语法，避免Metal 4专属关键字或函数
• Intel Mac设备优先使用MTLStorageModePrivate存储模式，避免移动端专属存储特性

内容的提问来源于stack exchange，提问作者Ayam Cemani Chicken