棱镜预设编辑器 (Prism Preset Editor) — 用户手册
1. 概述
棱镜预设编辑器 是 SuperStage 提供的可视化棱镜图案编辑工具。它允许你直接在 2D 画布上拖拽棱镜分光点的位置和大小，实时预览棱镜效果，并将结果保存为 棱镜预设数据资产（USuperPrismPreset），供灯具使用。
核心能力
- 2D 可视化拖拽 — 在画布上直接拖拽棱镜点的位置
- 三层独立配置 — 每个棱镜预设支持 3 层（Layer），每层最多 48 个分光点
- 多选操作 — 框选或 Ctrl+点击多选，批量移动/删除
- 预设模板 — 内置 Circle、Line、Triangle、Square、Pentagon、Hexagon、Star、Cross、Diamond、Arc、Honeycomb 共 11 种预设
- 精确数值编辑 — 每个点的位置(X/Y)和缩放可精确输入
- 预设重排生成器 — 基于模板快速生成规则图案
- 3D 预览视口 — 实时查看棱镜在灯光中的实际效果
- 缩略图渲染 — Content Browser 中显示预设缩略图
2. 创建棱镜预设
方法一：Content Browser 右键创建
- 在 Content Browser 中右键 → Miscellaneous → Prism Preset
- 命名新资产
- 双击打开棱镜预设编辑器
方法二：使用内置模板
- 创建空白预设后打开编辑器
- 在预设面板中点击模板按钮（Circle / Triangle / Square 等）
- 模板会自动填充当前层的分光点
3. 编辑器界面
编辑器采用左右布局：
左侧 — 2D 画布
- 参考圆 — 画布中央的圆形边界，棱镜点不超出此范围
- 棱镜点 — 圆形标记，可拖拽移动
- 点的大小 — 反映 Facet.Scale 值
画布操作
| 操作 | 功能 |
|---|---|
| 鼠标拖拽棱镜点 | 移动位置 |
| Ctrl + 点击 | 多选/取消选中 |
| 框选 | 批量选中 |
| Delete | 删除选中的点 |
右侧 — 属性面板
- 层选择 — Layer 0 / 1 / 2 切换
- 模板按钮 — 11 种预设模板一键生成
- 点列表 — 当前层所有分光点的精确数值
- 全局参数 — 全局缩放等
4. 坐标系
棱镜编辑器使用 UV 空间坐标：
| 维度 | 范围 | 含义 |
|---|---|---|
| X | -0.5 ~ +0.5 | 水平位置 |
| Y | -0.5 ~ +0.5 | 垂直位置 |
| Scale | 0.0 ~ 1.0 | 分光点大小 |
- 坐标系与着色器 UV 坐标系一致
- 圆形约束确保点不超出参考圆边界
5. 预设模板
| 模板 | 点数 | 说明 |
|---|---|---|
| Circle | 可调 | 圆形排列 |
| Line | 可调 | 直线排列 |
| Triangle | 3 | 三角形 |
| Square | 4 | 方形 |
| Pentagon | 5 | 五边形 |
| Hexagon | 6 | 六边形 |
| Star | 5 | 星形 |
| Cross | 4 | 十字形 |
| Diamond | 4 | 菱形 |
| Arc | 可调 | 弧形排列 |
| Honeycomb | 7 | 蜂巢结构（中心1+周围6） |
6. 技术架构
位置查找纹理
每个棱镜预设生成一张 48×1 RGBA16F 位置查找纹理：
| 通道 | 含义 |
|---|---|
| R | X 偏移 |
| G | Y 偏移 |
| B | 缩放 |
| A | 预留 |
材质中的 SuperPrismDraw 材质表达式循环读取此纹理来渲染多分光图案。
数据资产
USuperPrismPreset继承自UDataAssetGetPositionTexture()懒创建/缓存纹理- 修改预设后纹理自动更新
7. 在灯具中使用
- 创建并编辑好棱镜预设
- 在灯具蓝图的 Prism 属性中引用该预设
- 通过 PrismLayerIndex 选择使用哪一层（0/1/2）
- 灯光中即可看到对应的棱镜分光效果
8. 使用提示
- 每层最多 48 个分光点（受位置查找纹理分辨率限制）
- 修改预设后灯具中实时更新，无需重启
- 缩略图自动从预设点分布生成，方便在 Content Browser 中辨识
- 建议将常用棱镜预设统一放在项目中的
Content/PrismPresets/文件夹