SuperStage — Stage Assets 舞台资产用户手册总览
1. 简介
Stage Assets 是 SuperStage 插件的核心模块之一，提供了一套程序化舞台设备生成工具。这些工具允许您在 Unreal Engine 编辑器中通过简单的参数调整，即时生成各种舞台结构和设备的 3D 模型，用于演出设计的预可视化（Pre-Visualization）。
所有 Stage Asset 都是标准的 UE Actor，可以直接拖入场景、移动、旋转、缩放，并在细节面板中调整参数。参数修改后模型即时重建预览，无需等待编译或手动刷新。
兼容性：Stage Assets 模块支持 Unreal Engine 5.6 ~ 5.7 版本。
2. 资产一览
Stage Assets 模块包含以下 6 个可用 Actor：
2.1 结构类资产
| Actor | 名称 | 功能简述 |
|---|---|---|
| Super Truss Gantry | 桁架龙门架 | 程序化桁架龙门架，支持多种截面（方/三角/平面）、规格（290/400/520mm）和造型（门形/T形/Portal/双跨），内置 DIN 4113 载荷计算 |
| Super Scaffold | 直线脚手架 | 程序化矩形脚手架系统，包含立杆、横杆、斜撑、底座板、平台板和配重块，内置 EN 12811 载荷与配重计算 |
| Super Curved Scaffold | 弧度脚手架 | 样条驱动的弧形脚手架系统，通过编辑样条曲线实现任意弧度的脚手架结构，其余功能与直线脚手架一致 |
2.2 软装类资产
| Actor | 名称 | 功能简述 |
|---|---|---|
| Super Drape | 舞台幕布 | 程序化舞台幕布/帘幕，支持 6 种幕布类型、5 种面料、4 种褶皱样式和 4 种开合方式，带吊杆和系绳，内置面料重量计算 |
2.3 视频/投影类资产
| Actor | 名称 | 功能简述 |
|---|---|---|
| Super Projector | 投影仪 | 投影映射模拟工具，利用 RGB 三通道光照函数将贴图投射到场景表面，支持梯形校正 |
| Super NDI Screen | NDI 视频屏幕 | NDI 视频流接收与显示工具，将网络中的实时视频画面显示在场景中的网格体上，支持透明模式和颜色调整 |
3. 通用操作指南
3.1 放置 Actor
所有 Stage Asset Actor 均可通过以下方式放置到场景中：
- 放置面板 — 在编辑器左侧"放置 Actor"面板中搜索 Actor 名称，拖入视口
- 内容浏览器 — 在内容浏览器中找到对应的蓝图/类，拖入视口
- 右键菜单 — 在视口中右键 → 放置 Actor → 搜索对应名称
3.2 调整参数
- 在视口中选中 Actor
- 在右侧细节面板（Details Panel）中查看所有可调参数
- 修改参数后，场景中的模型立即更新
- 参数按功能分组（结构、材质、可视化、统计等），可折叠/展开各组
3.3 材质指定
所有 Stage Asset 都支持为不同构件分别指定材质：
- 在细节面板中找到"Materials"分组
- 点击材质属性旁的下拉箭头
- 从项目中选择材质资源
- 留空则使用 UE 引擎默认材质
3.4 统计信息
结构类资产（桁架、脚手架）和幕布资产均提供只读的统计面板：
- 构件数量 — 各类构件的实例数量和总数
- 重量计算 — 基于行业标准的自重、载荷、配重等计算结果
- 物理参数 — 当前选用的材料/面料的详细物理参数
⚠️ 所有统计数据仅供预可视化参考，不可替代专业工程计算。
4. 行业标准参考
Stage Assets 模块在设计中参考了以下行业标准：
| 标准 | 适用资产 | 说明 |
|---|---|---|
| DIN 4113 | Super Truss | 德国铝合金结构设计标准，用于桁架载荷和挠度计算 |
| EN 12811-1 | Super Scaffold, Super Curved Scaffold | 欧洲脚手架标准，用于荷载等级、配重和安全系数计算 |
| EN 10210 | Super Scaffold, Super Curved Scaffold | 热轧空心截面标准，提供钢管壁厚参数 |
| BS 1139 | Super Scaffold | 英国脚手架管件标准，定义 Ø48.3mm 标准管径 |
5. 性能注意事项
5.1 实例化渲染
结构类资产（桁架、脚手架）使用 Instanced Static Mesh Component (ISM) 技术渲染：
- 优点：同类型构件共享一次 Draw Call，即使有数千个管件也能保持良好性能
- 注意：构件总数超过 10,000 时仍可能影响编辑器帧率
5.2 程序化网格
幕布资产使用 Procedural Mesh Component 渲染：
- 优点：可以生成任意形状的褶皱表面
- 注意：褶皱数量过多（>100）或开启双面渲染会增加三角面数量
5.3 建议
- 远景中的脚手架可适当减少跨数和层数
- 不可见面的幕布可关闭双面渲染
- 大场景中避免同时放置过多高复杂度的 Stage Asset
6. 文档目录
| 序号 | 文档名称 | 内容 |
|---|---|---|
| 00 | 总览 | 本文档。Stage Assets 模块概述、通用操作指南 |
| 01 | 桁架龙门架 | Super Truss Gantry 的完整用户手册 |
| 02 | 直线脚手架 | Super Scaffold 的完整用户手册 |
| 03 | 弧度脚手架 | Super Curved Scaffold 的完整用户手册 |
| 04 | 舞台幕布 | Super Drape 的完整用户手册 |
| 05 | 投影仪 | Super Projector 的完整用户手册 |
| 06 | NDI 视频屏幕 | Super NDI Screen 的完整用户手册 |
7. 版本信息
- 插件名称：SuperStage
- 模块：Stage Assets
- 兼容引擎：Unreal Engine 5.6 ~ 5.7
- 文档版本：1.1
- 最后更新：2026-03
- 开发团队：LimxTeam