glTF 2.0 KHR_materials_clearcoat 扩展完全指南：清漆层材质的参数体系、BRDF 分层原理与工程实现

图形学【免费下载链接】glTFglTF – Runtime 3D Asset Delivery项目地址https://gitcode.com/gh_mirrors/gl/glTF点击查看免费下载KHR_materials_clearcoat 是 Khronos 官方已定稿Ratified的 glTF 2.0 材质扩展用于在既有 PBR 材质表面叠加一层清漆/涂层clear coat从而模拟汽车漆、木器清漆、陶器釉面等保护性光泽层。本文以该扩展的官方 README 与仓库内的 JSON Schema 为核心完整讲解五个扩展参数的语义与默认值、因子与纹理的线性组合规则、基于微表面 BRDF 与 Fresnel 的涂层分层数学原理以及实际 glTF 文件中的配置方法与相关扩展的协同用法帮助你在渲染器、转换工具或资产管线中正确实现与验证 clearcoat 材质。扩展状态与适用范围KHR_materials_clearcoat 属于 Khronos 官方扩展其 README 明确标注状态为Complete, Ratified by the Khronos GroupREADME即已通过 Khronos 集团正式审定可安全用于生产级资产与渲染器。依赖针对 glTF 2.0 规范编写Written against the glTF 2.0 spec核心材质模型为 Metallic-Roughness金属-粗糙度工作流对应规范正文见 Specification.adoc。互斥约束Exclusions以下两类材质上禁止同时使用本扩展使用了KHR_materials_pbrSpecularGlossiness已归档的镜面-光泽度工作流见 README使用了KHR_materials_unlit无光照材质见 README。原因在于 clearcoat 需要在 PBR 光照模型之上做分层合成而上述两种材质要么使用与 Metallic-Roughness 不同的 PBR 参数体系要么根本没有光照计算无法与涂层叠加。在材质上启用 clearcoat最小 JSON 示例clearcoat 通过向任意兼容的 glTF material 添加KHR_materials_clearcoat扩展对象来启用。官方 README 给出了一个清漆varnish材质的最小示例{ materials: [ { name: varnish, extensions: { KHR_materials_clearcoat: { clearcoatFactor: 1.0 } } } ] }在实际资产中还需要在 glTF 根对象的extensionsUsed数组中声明该扩展例如{ asset: { version: 2.0 }, extensionsUsed: [ KHR_materials_clearcoat ], materials: [ { name: varnish, pbrMetallicRoughness: { baseColorFactor: [ 0.65, 0.16, 0.16, 1.0 ] }, extensions: { KHR_materials_clearcoat: { clearcoatFactor: 1.0, clearcoatRoughnessFactor: 0.04 } } } ] }其中pbrMetallicRoughness定义底层材质其各参数的默认值与通道语义见 material.pbrMetallicRoughness.schema.json扩展对象则在其上叠加涂层。五个核心参数类型、默认值与取值范围官方 README 的参数表完整定义了扩展贡献的五个参数结合 Schemamaterial.KHR_materials_clearcoat.schema.json可以补充更精确的类型与取值范围信息参数类型说明是否必填 / 默认值Schema 约束clearcoatFactornumber涂层强度intensity / opacity否默认0.0[0.0, 1.0]clearcoatTexturetextureInfo涂层强度纹理否采样 R 通道线性空间clearcoatRoughnessFactornumber涂层粗糙度否默认0.0[0.0, 1.0]clearcoatRoughnessTexturetextureInfo涂层粗糙度纹理否采样 G 通道线性空间clearcoatNormalTexturematerial.normalTextureInfo涂层法线贴图否切线空间法线贴图几个 Schema 层面的关键细节clearcoatFactor为 0 时整个涂层被禁用Schema 中注明 A value of 0.0 means the material has no clearcoat layer enabled这是优化渲染的有效手段——大量无涂层材质可直接用 0 值跳过涂层计算。clearcoatTexture的强度值采样自 R 通道clearcoatRoughnessTexture的粗糙度值采样自 G 通道且全部位于线性空间linear space这与 baseColor 等 sRGB 纹理的处理方式不同采样后不得再经过 sRGB 解码。clearcoatNormalTexture复用normalTextureInfo结构因此与底层法线贴图一样支持scale参数默认1.0按scaledNormal normalize((texel * 2.0 - 1.0) * vec3(scale, scale, 1.0))缩放 X/Y 分量详见 material.normalTextureInfo.schema.json。三个纹理引用均为标准textureInfo必填index指向纹理可选texCoord指定TEXCOORD_n集合默认0详见 textureInfo.schema.json。因子与纹理的组合规则涂层强度与粗糙度既可以只给因子、只给纹理也可以同时给出两者官方 README 给出的组合公式为clearcoat clearcoatFactor * clearcoatTexture.r clearcoatRoughness clearcoatRoughnessFactor * clearcoatRoughnessTexture.g规则要点若clearcoatTexture或clearcoatRoughnessTexture未提供则对应纹理分量按1.0处理若因子与纹理同时存在因子作为纹理值的线性乘数linear multiplier所有 clearcoat 纹理的 RGB 分量均位于线性空间。这一因子 × 纹理的模式与核心 Metallic-Roughness 模型中metallicFactor/roughnessFactor的用法完全一致便于美术与程序化管线复用既有贴图烘焙流程。涂层法线贴图与切线空间约束clearcoatNormalTexture用于给涂层独立提供法线细节如细微的漆面橘皮。官方 README 对其使用提出了明确的规范性约束若未提供clearcoatNormalTexture则即使底层材质有法线贴图涂层层也不应用法线映射若提供了它可以引用与底层材质相同的法线贴图也可以是任意其他兼容的法线贴图使用涂层法线贴图的 mesh primitive必须具有已定义的切线空间——即必须带有NORMAL和TANGENT顶点属性或其底层材质必须带有法线贴图当 primitive 缺少NORMAL/TANGENT时按 glTF 2.0 规范定义的方式计算由于 glTF 2.0 规范并未强制规定某一种切线空间推导算法使用涂层法线贴图的 primitive应当SHOULD总是自带NORMAL与TANGENT属性当材质同时定义了normalTexture与clearcoatNormalTexture时两张贴图应当SHOULD使用相同的纹理坐标因为两者工作在同一切线空间、且纹素值通常彼此相关便于在贴图烘焙阶段共用一套 UV 布局。BRDF 分层模型fresnel_coat 与涂层着色公式clearcoat 效果通过微表面 BRDF 建模并分层叠加在 glTF 2.0 Metallic-Roughness 材质含自发光 emission 与所有扩展之上。官方 README 给出的分层伪代码如下# 来自 glTF 2.0 Metallic-Roughness 材质核心 material mix(dielectric_brdf, metal_brdf, metallic) # clearcoat clearcoat_brdf specular_brdf( normal clearcoatNormal, α clearcoatRoughness^2) # 分层 coated_material fresnel_coat( normal clearcoatNormal, ior 1.5, weight clearcoat, base material, layer clearcoat_brdf)其中fresnel_coat函数按weight与 Fresnel 项把一层 BRDF 叠加到另一层 BSDF 之上层的权重为weight * fresnel(ior)底层的权重为1 - (weight * fresnel(ior))。normal是只影响顶层涂层、不影响底层的 float3 向量。关于实现Implementation一节官方明确该节为非规范性non-normative即 BRDF 或分层算子的具体实现可依据设备性能与资源约束而变化——因此不同渲染器对同一 glTF 资产的涂层观感允许存在合理差异。涂层 BRDF涂层层的镜面 BRDFclearcoat_brdf复用 glTF 2.0 Metallic-Roughness 材质的镜面项定义于规范附录 B粗糙度与法线取自clearcoatNormal与clearcoatRoughness。分层Layeringfresnel_coat使用 glTF 2.0 Metallic-Roughness 材质的 Schlick Fresnel 项计算同样定义于附录 Bfunction fresnel_coat(normal, ior, weight, base, layer) { f0 ((1-ior)/(1ior))^2 fr f0 (1 - f0)*(1 - abs(dot(V, normal)))^5 return mix(base, layer, weight * fr) }代入各函数后得到涂层材质的完整形式coated_material mix(material, clearcoat_brdf(clearcoatRoughness^2), clearcoat * (0.04 (1 - 0.04) * (1 - VdotNc)^5))最终替换并化简使用附录 B 的符号Nc为涂层法线clearcoat_fresnel 0.04 (1 - 0.04) * (1 - abs(VdotNc))^5 clearcoat_alpha clearcoatRoughness^2 clearcoat_brdf D(clearcoat_alpha) * G(clearcoat_alpha) / (4 * abs(VdotNc) * abs(LdotNc)) coated_material mix(material, clearcoat_brdf, clearcoat * clearcoat_fresnel)观察上式可知默认涂层 IOR 为1.5对应的法线入射 Fresnel 反射率f0 ((1-1.5)/(11.5))^2 0.04这与 glTF 2.0 核心材质中的默认F0 0.04一致clearcoat_alpha是粗糙度的平方即粗糙度值直接作为微表面分布函数的 α 参数因此涂层粗糙度通常远小于底层材质粗糙度如 0.0~0.1 量级以表现平滑高光的漆面质感。自发光Emission的分层处理涂层在分层栈中位于自发光之上因此自发光会被 Fresnel 项变暗coated_emission emission * (1 - clearcoat * clearcoat_fresnel)这意味着从物理上讲涂层反射会吃掉一部分从底层发出的光——实现时不能把 emission 简单地画在涂层之上否则会违背能量守恒。设计讨论Discussion为使简单分层函数满足能量守恒实现采用NdotV而非VdotH计算微表面 Fresnel 项即忽略微表面的朝向由于涂层粗糙度通常很低微表面朝向非常接近法线方向此时NdotV ≈ NdotL该近似成立。同时这一简化分层函数忽略了许多真实涂层与底层之间发生的物理效应官方 README 明确列出涂层被视为无限薄不存在折射涂层与底层的折射率互不影响Fresnel 项独立计算层与层之间无散射无衍射。追求更高精度的渲染方案可参考规范附录 B 中描述的更复杂的层叠技术。完整配置示例带纹理的汽车漆材质将上述规则整合一个带强度贴图、粗糙度贴图与涂层法线贴图的完整材质如下{ asset: { version: 2.0 }, extensionsUsed: [ KHR_materials_clearcoat ], textures: [ { source: 0, sampler: 0 }, { source: 1, sampler: 0 }, { source: 2, sampler: 1 } ], materials: [ { name: car_paint, pbrMetallicRoughness: { baseColorFactor: [ 0.9, 0.1, 0.1, 1.0 ], metallicFactor: 0.0, roughnessFactor: 0.4 }, normalTexture: { index: 2, scale: 1.0 }, extensions: { KHR_materials_clearcoat: { clearcoatFactor: 1.0, clearcoatTexture: { index: 0, texCoord: 0 }, clearcoatRoughnessFactor: 0.05, clearcoatRoughnessTexture: { index: 1, texCoord: 0 }, clearcoatNormalTexture: { index: 2, scale: 0.3 } } } } ] }要点回顾强度贴图只取 R 通道、粗糙度贴图只取 G 通道可烘焙进同一张 RGB 图以节省内存两者均为线性空间clearcoatNormalTexture复用了底层法线贴图但scale取值更小0.3避免涂层法线细节过强干扰漆面整体反射。与相关扩展的协同tint、specular 与纹理变换clearcoat 生态不止这一个扩展。仓库中与之直接关联的扩展包括ADOBE_materials_clearcoat_tint为涂层着色模拟彩色清漆的透射吸收。它要求材质上必须同时定义KHR_materials_clearcoat通过clearcoatTintFactor默认[1.0,1.0,1.0]与clearcoatTintTexture相乘得到clearcoat_tint.rgb然后整体乘以底层光照项(f_emissive f_diffuse f_specular)详见 README 与 Schema。ADOBE_materials_clearcoat_specular用clearcoatIor默认1.5覆盖涂层默认 IOR并以clearcoatSpecularFactor默认1.0与clearcoatSpecularTexture采样 B 通道调制 F0/F90 反射率其机制与KHR_materials_iorKHR_materials_specular对底层材质的调制完全类比详见 README 与 Schema。KHR_texture_transform可作用于本扩展的三张纹理之上。仓库的 ObjectModel.adoc 明确列出了clearcoatTexture、clearcoatRoughnessTexture、clearcoatNormalTexture各自支持KHR_texture_transform的offset/rotation/scale动画属性路径如/materials/{}/extensions/KHR_materials_clearcoat/clearcoatTexture/extensions/KHR_texture_transform/offset即涂层贴图同样可参与 UV 变换动画扩展本身见 README。实现清单与验证建议面向渲染器或资产工具实现时建议按以下清单核对全部依据本扩展 README 与 Schema仅当clearcoatFactor 0时才执行涂层着色因子为 0 直接跳过整层计算纹理缺失时按1.0采样因子与纹理相乘全部在线性空间操作强度取texture.r粗糙度取texture.g法线贴图复用normalTextureInfo含scale使用mix(material, clearcoat_brdf, clearcoat * clearcoat_fresnel)完成分层其中clearcoat_fresnel 0.04 0.96 * (1 - |VdotNc|)^5clearcoat_brdf的 α 取粗糙度平方自发光按emission * (1 - clearcoat * clearcoat_fresnel)变暗在extensionsUsed中声明KHR_materials_clearcoat并遵守与KHR_materials_pbrSpecularGlossiness、KHR_materials_unlit的互斥约束若资产使用涂层法线贴图确保 primitive 提供NORMAL/TANGENT并让normalTexture与clearcoatNormalTexture共用相同纹理坐标。遵循以上步骤即可在自有渲染管线中输出能量守恒、且与其他 glTF 2.0 渲染器观感一致的 clearcoat 材质若需更深一层的 BRDF 推导与层叠技术细节可继续研读本仓库 Specification.adoc 中的附录 B 实现说明。赞分享图形学【免费下载链接】glTFglTF – Runtime 3D Asset Delivery项目地址https://gitcode.com/gh_mirrors/gl/glTF点击查看免费下载相关推荐ADOBE_materials_clearcoat_tint为 glTF 2.0 清漆层添加着色与透射控制的 PBR 材质扩展ADOBE_materials_clearcoat_tint为 glTF 2.0 清漆层添加着色与透射控制的 PBR 材质扩展 ADOBE_materials图形学glTF 2.0 KHR_materials_sheen 扩展详解用 Charlie Sheen BRDF 实现绒布、丝绸与织物材质的分层渲染glTF 2.0 KHR_materials_sheen 扩展详解用 Charlie Sheen BRDF 实现绒布、丝绸与织物材质的分层渲染 KHR_mat图形学three.js 清漆材质深度指南ClearcoatTest 模型与 KHR_materials_clearcoat 扩展解析three.js 清漆材质深度指南ClearcoatTest 模型与 KHR_materials_clearcoat 扩展解析 导读 本文以 three.js前端3D渲染图形学上一篇Salt Player 本地音乐播放器离线完整指南4 步跑通本地曲库下一篇OrchardCore 集成 Start Bootstrap Coming Soon 主题实战指南从背景视频落地页到可运行的建设中网站创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考