将GLSL片段着色器代码转换为Xcode适用的Metal着色器代码

以下是适配Xcode的Metal版本代码，同时补充了Metal着色器必需的结构定义和资源绑定声明：

#include <metal_stdlib>
using namespace metal;

// 结构体定义需匹配你的渲染管线输入输出规范
struct LightingContribution {
    float3 diffuse;
};

struct SurfaceData {
    float2 diffuseTexcoord;
};

struct OutputData {
    float4 color [[color(0)]];
};

fragment OutputData emissionFragment(
    LightingContribution _lightingContribution [[buffer(0)]],
    SurfaceData _surface [[buffer(1)]],
    texture2d<float> emissionTexture [[texture(0)]],
    sampler emissionSampler [[sampler(0)]]
) {
    OutputData _output;
    
    float3 light = _lightingContribution.diffuse;
    float lum = max(0.0, 1.0 - (0.2126 * light.r + 0.7152 * light.g + 0.0722 * light.b));
    float4 emission = emissionTexture.sample(emissionSampler, _surface.diffuseTexcoord) * lum;
    _output.color += emission;
    
    return _output;
}

关键转换说明 #

• 纹理与采样器分离：Metal不支持GLSL中sampler2D这种将纹理和采样逻辑绑定的类型，必须分别声明texture2d<float>和sampler，并通过绑定点关联
• 类型映射：GLSL的vec3/vec4对应Metal的float3/float4，语法上保持一致的分量访问方式
• 采样方法替换：用texture2d.sample(sampler, uv)替代GLSL的texture2D(sampler, uv)
• 资源绑定标注：必须通过[[buffer(n)]]/[[texture(n)]]/[[sampler(n)]]标注每个输入资源的绑定位置，确保和CPU端设置的渲染管线绑定点一一对应
• 输出结构要求：Fragment着色器必须返回包含颜色输出的结构体，通过[[color(0)]]指定输出到第一个渲染目标

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