vault backup: 2026-05-03 20:37:58

03-UnrealEngine/卡通渲染相关资料/渲染功能/ARC/Gameplay/REDSceneContext.md

@@ -0,0 +1,57 @@
+---
+title: REDSceneContext
+date: 2026-05-03 00:00:00
+excerpt: 全局 Shader 数据管线，提供 BGMultColor、灾害效果等 Shader 可访问数据
+tags:
+  - ARC
+  - Gameplay
+  - Rendering
+rating: ⭐
+---
+
+# REDSceneContext
+
+返回 [[Gameplay]]
+
+## 概述
+
+`UREDSceneContext` 是 ARC 引擎的全局 Shader 数据管线，将游戏逻辑层的数据传递给 Shader 使用。它是一个 UObject，可以在蓝图和 C++ 中设置参数，数据通过 `ViewUniformShaderParameters` 传入 GPU。
+
+## 提供的数据
+
+| 参数 | 类型 | 用途 |
+|------|------|------|
+| `BGMultColor` | FLinearColor | [[BGMultColor全局色调]]：场景颜色乘算 + 饱和度 |
+| `DisasterPosition` | FVector | 灾害效果中心位置（场景破坏特效） |
+| `DisasterWind` | FVector | 灾害风力方向和强度 |
+| `DisasterQuake` | float | 灾害震动强度 |
+| `GameTime` | float | 游戏时间（用于 Shader 动画） |
+| `BGTime` | float | 背景时间（可独立于 GameTime） |
+
+## 数据流
+
+```
+游戏逻辑 (Blueprint/C++)
+    ↓ 设置 UREDSceneContext 参数
+REDSceneContext
+    ↓ SceneRendering.cpp 读取
+ViewUniformShaderParameters
+    ↓ Upload to GPU
+Shader (View.BGMultColor, View.DisasterPosition, ...)
+```
+
+## 灾害效果系统
+
+`DisasterPosition`、`DisasterWind`、`DisasterQuake` 三个参数用于格斗游戏中的必杀技演出——场景因攻击而震动、风吹、变形等效果，由 Shader 读取这些参数来驱动场景顶点动画和粒子。
+
+## 关联文档
+
+- [[BGMultColor全局色调]] — 使用 `BGMultColor` 参数
+- [[RED场景视图类型]] — 场景分层与 Context 配合
+
+## 修改文件列表
+
+| 文件 | 修改类型 |
+|------|---------|
+| `Source/Runtime/Engine/Public/REDSceneContext.h` | **新增** |
+| `Source/Runtime/Renderer/Private/SceneRendering.cpp` | 读取 Context 写入 ViewUniform |