# Standard 标准物理光照渲染

Standard 材质基于标准的 PBR 进行实现。

PBR(Physically Based Rendering) 是指使用基于物理原理和微平面理论建模的着色/光照模型，以及使用从现实中测量的表面参数来准确表示真实世界材质的渲染理念。

使用 PBR 的优势

• 基于物理模型与数学推演带来的效果的 真实。
• 艺术导向性的、标准化的美术参数带来的 易用 与 效果一致。

xr-frame 使用 PBR 有以下两种方式

1. 使用带光照材质的 glTF 资源，目前主流的各类 DCC工具 (Digital Content Create) 都可以产出这种业界通用的格式。
2. 使用内置的 standard 创建材质，并设置所需的不同 uniform 来进行对应渲染。

# 创建 standard 材质进行渲染

使用 standard 材质进行渲染时，可以设置以下的 uniform 来决定渲染效果。

各系数的美术意义可以参考 创建PBR纹理实用指南。

# 基础色 (baseColor)

基础色表示物体的 表面颜色，PBR 中可以认为影响 电介质(非金属)漫反射 与 金属反射率值。

vec4 baseColor = vec4(1.0, 1.0, 1.0, 1.0);
// 若设定基础色贴图
baseColor *= SRGBtoLINEAR(u_baseColorMap);
// 若设定基础色因子，glTF情况下，传入LINEAR空间颜色，不进行颜色空间转化
baseColor *= SRGBtoLINEAR(u_baseColorFactor);
// 若设定顶点色
baseColor *= vec4(v_Color, 1.0);

基础色贴图：左侧为只有基础色效果；右侧为基础色贴图

# 金属度粗糙度 (metallic rougness)

金属度 表示 哪些区域是粗金属（0=电介质，1=金属），影响 电介质模型 与 金属模型 的 线性混合。

粗糙度 表示 表面粗糙度，控制 漫反射和镜面反射。

IOR 表示 折射率，控制材质的 F0，即0度角入射的菲涅尔反射值。

float metallic = u_metallicRoughnessValues.b; // 默认值 0.0，glTF 为 1.0
float roughness = u_metallicRoughnessValues.g; // 默认值 1.0
// 若设定金属度粗糙度贴图
metallic *= metallicRoughnessMap.b;
roughness *= metallicRoughnessMap.g;
// F0
f0 = min( pow2( ( u_ior - 1.0 ) / ( u_ior + 1.0 ) ) * specularColorFactor;

金属度粗糙度：左上角为金属度效果图，左下角为粗糙度效果图，数值0为黑色，数值1为白色；右侧为金属粗糙度贴图，g 部分为粗糙度，b 部分为金属度。

# 法线 (Normal)

法线 可以认为是 垂直于顶点表面 的(单位)向量。于顶点数据中传入，用于 PBR 中光照相关的各类运算。

法线贴图 可以理解为一种高度贴图，用于模仿表面细节。贴图中的每个像素，代表切线空间中，将法线处理为真实法线的偏差处理。

使用法线贴图的情况下，需要传入顶点Tangent才能生效。

float normal = vNormal;
// 如果使用法线贴图，需要保证存在 vNormal 与 vTangent 以算出vTBN
mat3 vTBN = mat3( tangent, bitangent, normal );
normal = normalize( vTBN * normalMap );

法线：左侧图片为世界空间中法线效果，右侧为法线贴图。

# 自发光 (Emissive)

自发光 表示了材质作为光源向外发送的颜色信息，颜色空间为 SRGB。

vec4 emissiveColor = u_emissiveFactor;
// 若设定自发光贴图
vec4 emissiveColor *= SRGBtoLINEAR(u_emissiveMap);

自发光：左侧图片为只有自发光的效果，右侧图片为自发光贴图。

# 环境光遮蔽 (Ambient occlusion)

环境光遮蔽 指表面某点能获得多少环境中的光。该贴图只影响漫反射分配，不影响高光反射分配。

// 若设定遮蔽贴图
float ao = u_occlusionMap;
// 若设定遮蔽贴图 与 遮蔽因子
ao *= u_occlusionStrength;

环境光遮蔽：左侧图片为默认PBR渲染效果，右侧图片为环境光遮挡显示效果，0为完全遮蔽，1为完全不遮蔽。

# 透明剔除 (alphaCutoff)

透明剔除 用于进行透明度剔除。当alphaMode 为 MASK 的情况下，会不渲染 baseColor 的 alpha 小于 u_alphaCutoff 的像素。

如需使用透明剔除，需手动设置宏 WX_USE_ALPHA_CUTOFF或设置渲染状态使用。

透明剔除：左侧图片为开启alphaCutoff效果，右侧图片为未使用alphaCutoff效果。

# 清漆效果 (clearcoat)

清漆效果 可以认为是往物体表面添加透明涂层。

如需使用清漆效果，需手动设置宏 WX_USE_CLEARCOAT。

清漆强度：左侧图片为使用clearcoat效果，右侧图片为未使用clearcoat效果

# 高光反射与光泽度 (specularGlossiness)

高光反射与光泽度 是 PBR 的另外一种渲染流程，相对于金属度粗糙度流程，该流程可以在高光反射贴图中控制F0。其中 光泽度 相当于(1 - 粗糙度)。

漫反射部分 的 diffuse 因子与贴图可以直接使用 基础色 basecolor 相关参数。

如需使用高光反射与光泽度流程，需手动设置宏 WX_USE_SPECULARGLOSSINESS。

高光反射与光泽度：左侧为使用高光反射与光泽度流程模型的渲染效果；右上为diffuse贴图(baseColorMap)；右下为specularGlossiness贴图，其中rgb部分为高光反射，a部分为光泽度。

# standard 参数定义

• 基础色相关 basecolor
• 金属度粗糙度相关 metallic rougness ior
• 法线相关 normal
• 自发光相关 emissive
• 环境光遮蔽相关 ambient occlusion
• 透明剔除相关 alphacutoff
• 清漆效果相关 clearcoat
• 高光反射与光泽度相关 specular glossiness
• 透射 transmission (TODO)
• 体积渲染 volume (TODO)

# standard 宏定义

# standard 默认渲染状态

"renderStates": {
  cullOn: true,
  blendOn: false,
  depthWrite: true,
  cullFace: Kanata.ECullMode.BACK
}

具体渲染状态细节可以参考 材质支持渲染状态列表。

# 使用glTF渲染

参照 glTF 文档使用。

# 使用Mesh渲染

<xr-assets>
  <!-- 加载外部环境配置 -->
  <xr-asset-load type="env-data" asset-id="env1" src="/assets/env-hdr/data.bin" />

  <!-- 加载外部贴图 -->
  <xr-asset-load type="texture" asset-id="gold-albedo" src="/assets/material/gold/albedo.png" />
  <xr-asset-load type="texture" asset-id="gold-metallic" src="/assets/material/gold/metallic.png" />
  <xr-asset-load type="texture" asset-id="gold-roughness" src="/assets/material/gold/roughness.png" />
  <xr-asset-load type="texture" asset-id="gold-ao" src="/assets/material/gold/ao.png" />

  <!-- 加载standard材质 -->
  <xr-asset-material asset-id="standard-mat" effect="standard" />
</xr-assets>

<!--
  设置环境数据，配置对应的IBL（漫反射与镜面反射）
  使用外部配置
    env1
  使用内置配置 
    xr-frame-team-workspace-day
    xr-frame-team-workspace-day2
    xr-frame-team-workspace-night
-->
<xr-env env-data="env1"/>

<!--
  添加 圆体
  使用 standard-mat 材质
  设置 金属度因子为1，粗糙度因子为1
  设置 不同类型的贴图
  设置 渲染状态 cullOn 为 false
  ...
-->
<xr-mesh
  node-id="mesh-sphere" geometry="sphere"
  material="standard-mat"
  uniforms="
    u_metallicRoughnessValues: 1 1,
    u_baseColorMap: gold-albedo,
    u_metallicMap: gold-metallic,
    u_roughnessMap: gold-roughness
  "
  states="cullOn: false"
></xr-mesh>

glTF Resource from SketchFab by @re1monsen @theblueturtle_ @Bastien Genbrugge @Willy Decarpentrie @Martin Trafas