1
#if defined(_ENV_REFLECTION_ON)
2
{
3
    half perceptualRoughness = 1.0 - _Smoothness;
4
    half3 reflectVector = reflect(-viewDirWS, normalWS);
5
    #if defined(_ENV_REFLECTION_CUBEMAP_OVERRIDE)
6
        // 路径 A：开发者手动指定一张 Cubemap
7
        half mip = PerceptualRoughnessToMipmapLevel(perceptualRoughness);
8
        half3 envSpecular = SAMPLE_TEXTURECUBE_LOD(
9
            _EnvReflectionCube, sampler_EnvReflectionCube, reflectVector, mip
10
        ).rgb;
11
    #else
12
        // 路径 B：交给 URP 内置函数自动处理
13
        half3 envSpecular = GlossyEnvironmentReflection(
14
            reflectVector, input.positionWS, perceptualRoughness, 1.0h
15
        );
16
    #endif
17
    color.rgb += envSpecular * _SpecularColor.rgb * _EnvReflectionIntensity;
18
}
19
#endif

1
Shader 调用:
2
  GlossyEnvironmentReflection(reflectVector, positionWS, perceptualRoughness, occlusion)
3
      │
4
      ▼
5
┌─ GlobalIllumination.hlsl ─────────────────────────────────────┐
6
│                                                                │
7
│  ① 检查 _ENVIRONMENTREFLECTIONS_OFF 关键字                    │
8
│     ├── 开了 → 直接返回 _GlossyEnvironmentColor（纯色Fallback） │
9
│     └── 没开 → 继续往下                                       │
10
│                                                                │
11
│  ② 检查 _REFLECTION_PROBE_BLENDING                            │
12
│     ├── 开了 → CalculateIrradianceFromReflectionProbes()       │
13
│     │            （支持双探针混合 + Box Projection）           │
14
│     └── 没开 → 直接采 unity_SpecCube0（主探针）               │
15
│                                                                │
16
│  ③ PerceptualRoughnessToMipmapLevel()                         │
17
│     将 [0,1] 的粗糙度映射到 mipmap 层级 [0, 6]                 │
18
│                                                                │
19
│ ④ SAMPLE_TEXTURECUBE_LOD()                                    │
20
│    按 (方向向量, mipmap层级) 采样 Cubemap 纹理                  │
21
│                                                                │
22
│  ⑤ DecodeHDREnvironment()                                     │
23
│    将 HDR 编码的纹理数据解码回线性颜色空间                      │
24
│                                                                │
25
│  ⑥ 返回结果 × occlusion（环境光遮蔽）                          │
26
└────────────────────────────────────────────────────────────────┘

1
// 完整签名版本（带屏幕空间 UV，用于 Forward+）
2
half3 GlossyEnvironmentReflection(
3
    half3  reflectVector,          // 反射方向向量（世界空间）
4
    float3 positionWS,             // 像素世界坐标（用于 Box Projection）
5
    half   perceptualRoughness,    // 感知粗糙度 = 1 - Smoothness
6
    half   occlusion,              // 环境光遮蔽 (AO)
7
    float2 normalizedScreenSpaceUV // 屏幕空间 UV（Forward+ 探针簇用）
8
)

1
// 非线性映射：感知粗糙度 → Mipmap 层级
2
real PerceptualRoughnessToMipmapLevel(real perceptualRoughness, uint maxMipLevel)
3
{
4
    // ① 先做一个非线性重映射
5
    perceptualRoughness = perceptualRoughness * (1.7 - 0.7 * perceptualRoughness);
6

7
    // ② 再线性映射到 mipmap 层级范围
8
    return perceptualRoughness * maxMipLevel;
9
}
10

11
// 默认 maxMipLevel = 6（UNITY_SPECCUBE_LOD_STEPS）
12
real PerceptualRoughnessToMipmapLevel(real perceptualRoughness)
13
{
14
    return PerceptualRoughnessToMipmapLevel(perceptualRoughness, UNITY_SPECCUBE_LOD_STEPS);
15
}

1
half4 encodedIrradiance = SAMPLE_TEXTURECUBE_LOD(
2
    unity_SpecCube0,        // Cubemap 纹理（由引擎绑定）
3
    samplerunity_SpecCube0, // 采样器状态（滤波模式等）
4
    reflectVector,          // 3D 方向向量
5
    mip                     // mipmap 层级（上一步算出来的）
6
);

1
real3 DecodeHDREnvironment(real4 encodedIrradiance, real4 decodeInstructions)
2
{
3
    // decodeInstructions 由 CPU 端根据纹理的 HDR 编码方式填入
4
    // 典型值示例: (2.0, 2.2, 0, 0) 用于 RGBM 编码
5

6
    // 处理 Alpha 通道对 RGB 的影响（某些编码格式需要）
7
    real alpha = max(
8
        decodeInstructions.w * (encodedIrradiance.a - 1.0) + 1.0,
9
        0.0
10
    );
11

12
    // HDR 解码公式: multiplier × alpha^exponent × rgb
13
    return (decodeInstructions.x * PositivePow(alpha, decodeInstructions.y))
14
           * encodedIrradiance.rgb;
15
}

1
// 如果两个 Reflection Probe 的总权重还不到 0.99
2
if (totalWeight < 0.99f)
3
{
4
    // 剩余权重交给 Skybox（或 Custom Environment）
5
    half4 encodedIrradiance = SAMPLE_TEXTURECUBE_LOD(
6
        _GlossyEnvironmentCubeMap,      // ← 这就是 Skybox！
7
        sampler_GlossyEnvironmentCubeMap,
8
        reflectVector, mip
9
    );
10
    irradiance += (1.0f - totalWeight) *
11
        DecodeHDREnvironment(encodedIrradiance, _GlossyEnvironmentCubeMap_HDR);
12
}

1
像素位置在 Probe A 影响范围内？
2
  ├─ 是 → 采 Probe A（权重 wA）
3
  │        像素位置也在 Probe B 范围内？
4
  │          ├─ 是 → 采 Probe B（权重 wB），与 A 混合
5
  │          └─ 否 → 只用 A
6
  │
7
  └─ 否 → 总权重 < 1.0？
8
             ├─ 是 → 剩余 (1 - wA - wB) 的权重给 Skybox
9
             └─ 否（理论上不会发生）→ 全黑

1
优先级从高到低：
2
┌─────────────────────────────────────────────────────────────┐
3
│ 1. _ENVIRONMENTREFLECTIONS_OFF 开关                          │
4
│    └─ 如果开了 → 返回纯色 _GlossyEnvironmentColor，结束      │
5
│                                                             │
6
│ 2. _REFLECTION_PROBE_BLENDING 开启？                        │
7
│    ├─ 是 → 进入双探针混合流程                                │
8
│    │   ├─ 2a. unity_SpecCube0（场景中最重要的 Reflection Probe）│
9
│    │   ├─ 2b. unity_SpecCube1（第二重要的 Probe）            │
10
│    │   └─ 2c. _GlossyEnvironmentCubeMap（Skybox Fallback）   │
11
│    │                                                             │
12
│    └─ 否 → 只采 unity_SpecCube0                              │
13
│        （可能经过 Box Projection 修正）                       │
14
│                                                             │
15
│ 3. Shader 里手动指定 _EnvReflectionCubemapOverride           │
16
│    └─ 完全绕过以上所有逻辑，只采你给的 Cube 贴图              │
17
└─────────────────────────────────────────────────────────────┘

1
#if defined(_ENV_REFLECTION_CUBEMAP_OVERRIDE)
2
    // 【完全绕过 URP 探针系统】
3
    // 直接采材质槽位里绑定的 Cubemap
4
    half mip = PerceptualRoughnessToMipmapLevel(perceptualRoughness);
5
    half3 envSpecular = SAMPLE_TEXTURECUBE_LOD(
6
        _EnvReflectionCube, sampler_EnvReflectionCube, reflectVector, mip
7
    ).rgb;
8
    // 注意：这里没有 DecodeHDREnvironment！
9
    // 因为我们假设用户传入的是普通 LDR Cubemap（如一张 JPG/PNG 导入的 Skybox）
10
#else
11
    // 【走 URP 标准流程】
12
    // GlossyEnvironmentReflection 内部会：
13
    //   1. 判断是否开了 _REFLECTION_PROBE_BLENDING
14
    //   2. 计算 SpecCube0 / SpecCube1 的混合权重
15
    //   3. 必要时做 Box Projection
16
    //   4. 权重不足时 fallback 到 Skybox
17
    //   5. PerceptualRoughnessToMipmapLevel() 选 mipmap
18
    //   6. SAMPLE_TEXTURECUBE_LOD() 采样
19
    //   7. DecodeHDREnvironment() 解码 HDR
20
    //   8. 结果 × occlusion
21
    half3 envSpecular = GlossyEnvironmentReflection(
22
        reflectVector, input.positionWS, perceptualRoughness, 1.0h
23
    );
24
#endif