168 lines
5.5 KiB
Markdown
168 lines
5.5 KiB
Markdown
---
|
||
title: 自定义光照Pass
|
||
date: 2026-05-03 00:00:00
|
||
excerpt: REDDeferredLightPS 自定义光照 Pass、PointLight 排序和自定义光照路径
|
||
tags:
|
||
- ARC
|
||
- Rendering
|
||
- Lighting
|
||
rating: ⭐
|
||
---
|
||
|
||
# 自定义光照 Pass
|
||
|
||
返回 [[Rendering]]
|
||
|
||
## 概述
|
||
|
||
ARC 引擎在 Deferred Lighting 阶段新增了自定义光照 Pass，通过 `REDDeferredLightPS` 替换标准光照 Pixel Shader，实现 [[RED阴影系统]] 的阴影着色逻辑。同时修改了点光源的渲染排序和数据传递方式。
|
||
|
||
## REDDeferredLightPS
|
||
|
||
在 `LightRendering.cpp` 中新增 Pixel Shader 类：
|
||
|
||
```cpp
|
||
class REDDeferredLightPS : public FDeferredLightPS
|
||
{
|
||
// 绑定 DynamicShadowShade uniform 参数
|
||
// 调用 REDDirectionalPixelMain 入口
|
||
};
|
||
```
|
||
|
||
### DynamicShadowShade 参数
|
||
|
||
从 C++ 端传入的 uniform float，控制动态阴影区域的明暗程度：
|
||
|
||
```cpp
|
||
// 0.0 = 完全黑色的动态阴影
|
||
// 1.0 = 无动态阴影效果
|
||
SetShaderValue(RHICmdList, ShaderRHI,
|
||
DynamicShadowShadeParam, LightSceneInfo->DynamicShadowShade);
|
||
```
|
||
|
||
## 点光源排序
|
||
|
||
点光源通过 `bPointLightRED` 排序键确保在方向光之后渲染：
|
||
|
||
```cpp
|
||
// 排序优先级：方向光 → 点光源(RED) → 其他
|
||
SortKey |= bPointLightRED ? (1 << PointLightSortBit) : 0;
|
||
```
|
||
|
||
这确保方向光的阴影着色先完成，点光源再叠加贡献。
|
||
|
||
## 点光源 CustomData 覆写
|
||
|
||
渲染点光源时，GBufferD 的 CustomData 被重新解释为 DiffuseColor：
|
||
|
||
```hlsl
|
||
// DeferredLightPixelShaders.usf
|
||
#if USE_RED_CUSTOM_DATA_POINTLIGHT
|
||
ScreenSpaceData.GBuffer.DiffuseColor.rgb =
|
||
ScreenSpaceData.GBuffer.CustomData.rgb;
|
||
#endif
|
||
```
|
||
|
||
## RED_CUSTOM_LIGHTING 宏
|
||
|
||
通过 `RED_CUSTOM_LIGHTING` 定义控制是否启用整个自定义光照路径。关闭时回退到标准 UE4 Deferred Lighting。
|
||
|
||
## Decal Emissive 处理
|
||
|
||
贴花的 Emissive 被作为正常光照渲染（而非 Emissive 通道），因为在 RED 管线中 BaseColor 已被阴影颜色系统占用：
|
||
|
||
```cpp
|
||
// Decal Emissive → normal lighting contribution
|
||
// (BaseColor 在 RED 系统中用于 shadow color)
|
||
```
|
||
|
||
## 关联文档
|
||
|
||
- [[RED阴影系统]] — 核心阴影着色逻辑
|
||
- [[RED自定义数据通道]] — 点光源 CustomData 的来源
|
||
|
||
## 完整代码解析
|
||
|
||
> Shader 侧的完整代码解析（`REDDirectionalPixelMain`、`REDGetShadowTerms`、`REDGetShadowColor`）请参见 [[RED阴影系统#完整代码解析]]。本节仅补充 C++ 端的结构说明。
|
||
|
||
### LightRendering.cpp — REDDeferredLightPS 类结构
|
||
|
||
```cpp
|
||
// ASW Change : 2016/10/12 21:35:18 Takuro.K
|
||
// 继承自标准 FDeferredLightPS，新增 DynamicShadowShade 参数绑定
|
||
class REDDeferredLightPS : public FDeferredLightPS
|
||
{
|
||
DECLARE_SHADER_TYPE(REDDeferredLightPS, Global);
|
||
|
||
// Shader 参数声明
|
||
FShaderParameter DynamicShadowShadeParam;
|
||
|
||
// 构造函数中绑定参数
|
||
REDDeferredLightPS(const ShaderMetaType::CompiledShaderInitializerType& Initializer)
|
||
: FDeferredLightPS(Initializer)
|
||
{
|
||
DynamicShadowShadeParam.Bind(
|
||
Initializer.ParameterMap, TEXT("DynamicShadowShade"));
|
||
}
|
||
|
||
// SetParameters 中传入光源的 DynamicShadowShade 值
|
||
void SetParameters(FRHICommandList& RHICmdList,
|
||
const FSceneView& View,
|
||
const FLightSceneInfo* LightSceneInfo)
|
||
{
|
||
FDeferredLightPS::SetParameters(RHICmdList, View, LightSceneInfo);
|
||
|
||
const FPixelShaderRHIParamRef ShaderRHI = GetPixelShader();
|
||
// 从光源信息获取 DynamicShadowShade 值并设置到 GPU
|
||
SetShaderValue(RHICmdList, ShaderRHI,
|
||
DynamicShadowShadeParam,
|
||
LightSceneInfo->DynamicShadowShade);
|
||
}
|
||
};
|
||
```
|
||
|
||
### LightRendering.cpp — 点光源排序
|
||
|
||
```cpp
|
||
// ASW Change : 2019/02/05 20:37:00 Takeshi.N
|
||
// 确保点光源在方向光之后渲染，让方向光阴影着色先完成
|
||
// bPointLightRED 标志位用于区分 RED 系统的点光源
|
||
uint32 SortKey = 0;
|
||
SortKey |= bDirectionalLight ? 0 : (1 << DirectionalLightSortBit);
|
||
SortKey |= bPointLightRED ? (1 << PointLightSortBit) : 0;
|
||
|
||
// 排序结果：DirectionalLight(RED) → PointLight(RED) → 其他光源
|
||
```
|
||
|
||
### LightRendering.cpp — RED_CUSTOM_LIGHTING 条件分派
|
||
|
||
```cpp
|
||
// 根据 RED_CUSTOM_LIGHTING 宏决定使用标准光照还是 RED 光照
|
||
#if RED_CUSTOM_LIGHTING
|
||
if (bUseREDLighting)
|
||
{
|
||
// 使用 REDDeferredLightPS 渲染方向光
|
||
TShaderMapRef<REDDeferredLightPS> PixelShader(View.ShaderMap);
|
||
// ...
|
||
}
|
||
else
|
||
#endif
|
||
{
|
||
// 标准 UE4 Deferred Light 路径
|
||
TShaderMapRef<FDeferredLightPS> PixelShader(View.ShaderMap);
|
||
// ...
|
||
}
|
||
```
|
||
|
||
## 代码修改情况
|
||
|
||
| 文件路径 | 行号 | 修改类型 | 修改内容 |
|
||
|---------|------|---------|---------|
|
||
| `Source/Runtime/Renderer/Private/LightRendering.cpp` | — | 新增 | `REDDeferredLightPS` 类（继承 `FDeferredLightPS`） |
|
||
| `Source/Runtime/Renderer/Private/LightRendering.cpp` | — | 新增 | `DynamicShadowShade` Shader 参数绑定 |
|
||
| `Source/Runtime/Renderer/Private/LightRendering.cpp` | — | 修改 | 点光源排序键 `bPointLightRED`（方向光后渲染） |
|
||
| `Source/Runtime/Renderer/Private/LightRendering.cpp` | — | 修改 | Decal Emissive → 正常光照贡献 |
|
||
| `Shaders/Private/DeferredLightPixelShaders.usf` | L109~L145 | 新增 | `REDDirectionalPixelMain` 入口（详见 [[RED阴影系统]]） |
|
||
| `Shaders/Private/DeferredLightPixelShaders.usf` | L236~L239 | 新增 | CustomData → DiffuseColor 覆写 |
|
||
| `Shaders/Private/DeferredLightingCommon.ush` | L457~L557 | 新增 | `REDGetShadowTerms` + `REDGetShadowColor`（详见 [[RED阴影系统]]） |
|