如何查找Metal着色语言所有内置变量定义？含_surface类变量

你找错地方啦！_surface、_lightingContribution这些变量并不是Metal Shading Language（MSL）本身的内置变量，所以你在《Metal Shading Language Specification》里肯定找不到它们的定义——它们是苹果SceneKit框架在其**Shader Modifiers（着色器修改器）**机制中提供的预定义结构体实例。

下面给你梳理清楚关键信息：

• 来源明确：这些变量是SceneKit为了简化自定义着色逻辑，预注入到着色器修改器代码中的封装结构体。比如_surface对应的是SCNShaderSurface结构体，_lightingContribution对应SCNShaderLightingContribution结构体。
• 查找文档的正确位置：你需要去苹果开发者文档中搜索「SceneKit Shader Modifiers」，在对应的章节里会列出所有预定义的结构体和成员：
  • SCNShaderSurface包含你用到的ambientOcclusion（环境遮挡值）、view（视图方向向量）、normal（表面法向量）、specular（高光相关数据）等成员；
  • SCNShaderLightingContribution包含diffuse（漫反射光照贡献）等成员。
• 区分两类变量：MSL本身的内置变量是诸如thread_position_in_grid、vertex_id这类和图形管线、线程调度直接相关的变量，而_surface这类是上层框架为了封装渲染流程、提供便捷数据访问而定义的变量，仅在SceneKit的着色器修改器环境中生效。

对应你代码的简单解析：

float AO = _surface.ambientOcclusion; // 调用SceneKit预计算好的环境遮挡值
float lightContrib = _lightingContribution.diffuse.r; // 提取漫反射光照的红色通道强度
lightContrib *= AO;
float mask = _surface.specular.b; // 用高光数据的蓝色通道作为遮罩
float fresnel = saturate(dot(_surface.view, _surface.normal)); // 基于视图方向和法向量计算菲涅尔项

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