Metal着色器定义clip_distance数组后stage_in属性报错如何解决

错误根因 #

• 语法错误：[[clip_distance]] 内置语义的修饰位置不符合Metal规范，数组类型的属性修饰符必须放在数组声明的末尾，你原来的写法 float clip_distance [[clip_distance]][6] 属于非法声明。
• 逻辑错误：[[clip_distance]] 是光栅化阶段的专用语义，仅会被光栅化器读取用于裁剪计算，不会作为插值数据传递给片元着色器。你将该字段放在了顶点输出、片元输入共用的结构体中，片元着色器用[[stage_in]]接收时，无法为该内置语义字段找到对应插值通道，因此报类型非法错误。

修复方案 #

推荐采用更简洁的参数拆分方案：将clip_distance从共用结构体中移除，作为顶点函数的独立输出参数即可，无需修改片元逻辑。

修复后完整代码 #

#include <metal_stdlib>
using namespace metal;
#include <SceneKit/scn_metal>

struct NodeBuffer {
    float4x4 modelTransform;
    float4x4 modelViewProjectionTransform;
    float4x4 modelViewTransform;
    float4x4 normalTransform;
    float2x3 boundingBox;
};

struct VertexInput {
    float3 position  [[attribute(SCNVertexSemanticPosition)]];
    float2 uv [[attribute(SCNVertexSemanticTexcoord0)]];
};

// 移除clip_distance字段，结构体可同时用于顶点输出、片元输入
struct VertexOut {
    float4 position [[position]];
    float2 uv;
};

vertex VertexOut textureSamplerVertex(
    VertexInput in [[ stage_in ]], 
    constant NodeBuffer& scn_node [[buffer(1)]],
    out float clip_distance[6] [[clip_distance]] // 作为独立输出参数
) {
    VertexOut out;
    out.position = scn_node.modelViewProjectionTransform * float4(in.position, 1.0);
    // 必须给所有6个裁剪距离赋值，未赋值会触发未定义行为
    clip_distance[0] = 1.5 - in.position.x;
    for(int i = 1; i < 6; i++) {
        clip_distance[i] = 1.0; // 其余裁剪平面默认不生效
    }
    out.uv = in.uv;
    return out;
}

fragment float4 textureSamplerFragment(
    VertexOut out [[ stage_in ]], 
    texture2d<float, access::sample> customTexture [[texture(0)]]
) {
    constexpr sampler textureSampler(coord::normalized, filter::linear, address::repeat);
    return customTexture.sample(textureSampler, out.uv );
}

注意事项 #

• 裁剪距离数组的所有元素必须显式赋值，值大于0的部分表示该平面可见区域，小于0会被裁剪。
• Metal最多支持8个裁剪平面，你使用6个属于合法范围。

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