87 lines
2.7 KiB
Markdown
87 lines
2.7 KiB
Markdown
---
|
||
title: RED场景视图类型
|
||
date: 2026-05-03 00:00:00
|
||
excerpt: 角色/特效/背景/HUD 分层渲染系统
|
||
tags:
|
||
- ARC
|
||
- Gameplay
|
||
- Rendering
|
||
rating: ⭐
|
||
---
|
||
|
||
# RED 场景视图类型
|
||
|
||
返回 [[Gameplay]]
|
||
|
||
## 概述
|
||
|
||
新增 `EREDSceneViewType` 枚举，将场景中的 Actor 按类型分层，允许选择性渲染特定层级。格斗游戏中常用于：角色和背景使用不同的后处理参数、特效层独立控制、HUD 层分离等。
|
||
|
||
## 视图类型
|
||
|
||
```cpp
|
||
enum class EREDSceneViewType
|
||
{
|
||
REDSceneView_Character, // 角色层
|
||
REDSceneView_Effect, // 特效层
|
||
REDSceneView_BG, // 背景层（主）
|
||
REDSceneView_BG_Layer1, // 背景分层 1
|
||
REDSceneView_BG_Layer2, // 背景分层 2
|
||
// ... Layer3 ~ Layer8
|
||
REDSceneView_HUD // HUD 层
|
||
};
|
||
```
|
||
|
||
## 使用方式
|
||
|
||
### Actor 端
|
||
|
||
每个 Actor 拥有 `REDSceneViewType` 属性，在编辑器中设置所属层级。
|
||
|
||
### 渲染端
|
||
|
||
`PlayerController::GetREDSceneViewTypeFlag()` 返回当前需要渲染的层级位掩码，Scene Visibility 阶段根据此掩码过滤 Actor。
|
||
|
||
### 排序键
|
||
|
||
自定义排序键影响渲染顺序，确保分层正确。
|
||
|
||
## 使用场景
|
||
|
||
- 角色层独立使用 [[BGMultColor全局色调]] 而不影响背景
|
||
- 背景多层分离实现视差效果
|
||
- 特效层独立的 Bloom 和后处理参数
|
||
- 对战 UI（血条等）使用 HUD 层，不受场景后处理影响
|
||
|
||
## 完整代码解析
|
||
|
||
```cpp
|
||
// EngineTypes.h — 场景视图类型枚举
|
||
// ASW 新增：将场景 Actor 按类型分层
|
||
enum class EREDSceneViewType : uint8
|
||
{
|
||
REDSceneView_Character, // 角色层（玩家、AI）
|
||
REDSceneView_Effect, // 特效层（粒子、光柱等）
|
||
REDSceneView_BG, // 背景主层
|
||
REDSceneView_BG_Layer1, // 背景分层1（近景装饰）
|
||
REDSceneView_BG_Layer2, // 背景分层2
|
||
// ... Layer3 ~ Layer8 // 更多背景分层
|
||
REDSceneView_HUD // HUD 层
|
||
};
|
||
|
||
// PlayerController 端
|
||
// 获取当前需要渲染的层级位掩码
|
||
uint32 GetREDSceneViewTypeFlag() const;
|
||
// 例如：只渲染角色和特效
|
||
// return (1 << REDSceneView_Character) | (1 << REDSceneView_Effect);
|
||
```
|
||
|
||
## 代码修改情况
|
||
|
||
| 文件路径 | 修改类型 | 修改内容 |
|
||
|---------|---------|---------|
|
||
| `Source/Runtime/Engine/Public/EngineTypes.h` | 新增 | `EREDSceneViewType` 枚举（Character/Effect/BG/HUD 等） |
|
||
| `Source/Runtime/Engine/Classes/GameFramework/PlayerController.h` | 新增 | `GetREDSceneViewTypeFlag()` 层级位掩码 |
|
||
| `Source/Runtime/Renderer/Private/SceneVisibility.cpp` | 修改 | 按 REDSceneViewType 过滤可见性 |
|
||
| `Source/Runtime/Renderer/Private/SceneRendering.cpp` | 修改 | 自定义排序键处理 |
|