Stride 新游戏模板默认天空盒立方体贴图(Cubemap)生成指南:HDR/LDR 双管线流程与运行时采样原理
Stride 新游戏模板默认天空盒立方体贴图(Cubemap)生成指南:HDR/LDR 双管线流程与运行时采样原理
本篇技术指南以 sources/data/images/NewGame/BUILD.md 为骨架,完整还原 Stride 引擎"新建游戏(NewGame)"模板默认天空盒立方体贴图的生成链路:从 hemisphere_cube_32_glay.psd 源图出发,经 Photoshop、PTgui、NVIDIA DDS 插件与 texconv.exe 四步工具链,产出 HDR(F16)与 LDR(BC7)两套 DDS 贴图。读完本篇,你将掌握这套可复用的 cubemap 构建配方、每个步骤的格式与参数决策依据,并能结合仓库源码理解该贴图在 Stride 中从资产导入、运行时采样到环境光贡献的完整实现路径。
背景:新游戏模板里的天空盒资产
在 Stride 仓库中,"新建游戏"模板位于 samples/NewGame/NewGame/MyTemplate.Game。打开其 Assets 目录可以看到一组与天空盒直接相关的资产:
- Skybox.sdsky:
!SkyboxAsset类型,通过CubeMap字段引用名为 "Skybox texture" 的纹理资产; - Skybox texture.sdtex:
!Texture类型,Source指向../Resources/skybox_texture_hdr.dds,Type为ColorTextureType,UseSRgbSampling: false; - Resources/skybox_texture_hdr.dds 与 Resources/skybox_texture_ldr.dds:正是 BUILD.md 中 HDR/LDR 两条构建流程的最终产物。
也就是说,BUILD.md 记录的是一份"资源制作配方",它产出的 .dds 文件直接决定了模板中天空盒与 IBL 环境光的观感。该贴图不仅是背景,还作为环境光源参与材质渲染(详见下文源码分析),因此其构建质量直接影响新项目默认场景的光照表现。
HDR 立方体贴图构建流程(全步骤)
HDR 流程的目标产物是 skybox_texture_hdr.dds:一个 R16G16B16A16_FLOAT(F16)格式、带 8 级 mipmap 的立方体贴图,用于保留高动态范围的亮度信息。
1. 在 Photoshop 中准备源图
- 打开源文件 hemisphere_cube_32_glay.psd(仓库
sources/data/images/NewGame/目录下可找到原稿); - 将画布缩放到 128(此处为模板贴图的基准尺寸);
- 隐藏太阳(sun)图层——这一步是为了去除单一强光源方向,避免天空盒自带高亮太阳导致环境光分布失衡;
- 将图像导出为 HDR 格式(保留 32 位浮点亮度信息)。
2. 用 PTgui 将全景图转换为立方体面(QTVR/Cubic)
- 在 PTgui 中执行
Tools => Convert to QTVR/Cubic; - 投影方式选择 Cylindrical(圆柱投影);
- 输出尺寸设为 256,Cube face strip 布局为 6x1(六个面横向拼接成一条),格式为 hdr;
- 保存结果。
这一步把半球全景图重新投影为立方体贴图的六个面(Side/Top/Bottom),是全景图到 cubemap 的核心转换环节。
3. 面序修正与补洞
- 用 Photoshop 重新打开上一步导出的 HDR 文件;
- 填补底部与顶部(bottom/top)的孔洞——圆柱投影在顶底区域会产生采样空洞,需要手动修复;
- 交换面序,使最终排列为:
Side, Side, Top, Bottom, Side, Side(原始导出中 Top 与 Bottom 位于末尾,需要移动到中间位置)。这个顺序必须与 DDS cubemap 约定及渲染端采样期望保持一致。
4. 导出 RGBA32 并用 texconv 转 F16
- 使用 NVIDIA DDS 插件(Photoshop 的
.dds导出插件)将修复后的图像导出为 RGBA32 格式的 DDS; - 使用
texconv.exe(微软 DirectXTex 工具包提供的命令行转换工具)转换为 F16 并生成 mipmap:
texconv.exe test128.dds -o converted -f R16G16B16A16_FLOAT -m 8
参数含义:
| 参数 | 作用 |
|---|---|
-f R16G16B16A16_FLOAT |
目标像素格式,16 位浮点 RGBA,保留 HDR 亮度范围,是 Stride 默认天空盒采样格式 |
-m 8 |
生成 8 级 mipmap 链(从 256 逐步降到 1x1),保证不同距离采样无闪烁 |
-o converted |
指定输出目录 |
最终产物即为模板中 Skybox texture.sdtex 引用的 skybox_texture_hdr.dds。
LDR 立方体贴图构建流程(全步骤)
LDR 流程的目标产物是 skybox_texture_ldr.dds:BC7 压缩格式、8-bit 动态范围,作为 HDR 的轻量替代(例如在部分平台或低配配置下使用,模板中提供了 Skybox.LDR.sdsky、GameSettings.LDR.sdgamesettings 等整套 LDR 变体资产)。
- 打开
hemisphere_cube_32_glay.psd,缩放到 128,隐藏太阳层(与 HDR 流程相同的准备步骤); - 在 Photoshop 中执行
Image => Mode => 8 Bits/Channel将图像从 32 位降到 8 位:- 弹窗询问合并图层时选择 "Merge"(合并);
- HDR toning 方式选择 "Exposure and Gamma"(曝光与伽马)——这是把 HDR 亮度映射回 LDR 的色调映射方法;
- 使用 NVIDIA DDS 插件导出为 RGB8 格式的 DDS;
- 使用
texconv.exe转换为 BC7:
texconv.exe test128.dds -o converted -f BC7
BC7 是高质量有损块压缩格式,相比 RGB8 可显著减小显存占用与加载体积,同时保持较好的颜色精度,适合 LDR 天空盒这类不要求浮点精度的用途。
关键格式与参数决策解析
结合构建配方与仓库源码,可以梳理出几个重要的技术决策点:
- F16 与线性空间:Skybox texture.sdtex 中
UseSRgbSampling: false表明该纹理不做 sRGB 解码,采样结果直接按线性值参与光照计算——这正是 HDR 天空盒用于 IBL 环境光所必需的,避免二次伽马变换导致颜色失真。 - 6x1 面序:DDS cubemap 对面片顺序有严格约定,BUILD.md 特意强调把 Top/Bottom 移到中间,说明该模板的着色器按
Side, Side, Top, Bottom, Side, Side的布局采样六个面。 - 尺寸策略:源图 128 作为基准、PTgui 输出 256,最终以 256 起步的 mipmap 链满足天空盒这种"无限远、任意角度采样"场景的分辨率需求;尺寸与 mip 级数需匹配渲染分辨率,过大无益、过小则产生明显色块。
- 两套管线并存:模板同时维护 HDR 与 LDR 资产(
Skybox.sdsky/Skybox.LDR.sdsky、GameSettings.sdgamesettings/GameSettings.LDR.sdgamesettings等),由模板针对不同目标平台或画质档位选择,对应Resources目录下两份.dds产物。
从资产到运行时:仓库源码印证
构建好的 cubemap 在 Stride 中经历了完整的资产—运行时链路,仓库源码可以逐环印证:
- 资产层:Skybox.sdsky 声明为
SkyboxAsset,运行时对应 Skybox.cs 中的Skybox类——它承载Parameters、DiffuseLightingParameters、SpecularLightingParameters三组参数集合,分别用于背景绘制与漫反射/镜面反射环境光计算。 - 采样层:SkyboxShaderCubemap.sdsl 声明
stage TextureCube CubeMap,用LinearSampler对float3(samplingDir.x, samplingDir.y, -samplingDir.z)方向采样——注意 z 分量取反,这是 DDS cubemap 的坐标系约定与 Stride 左手坐标系之间的翻转适配。 - 环境光层:LightSkyboxShader.sdsl 定义了天空盒作为
EnvironmentLight的着色逻辑:漫反射方向由SkyMatrix旋转后的法线采样,镜面反射方向由reflect(-viewWS, normalWS)求反射向量后采样,两者都乘以Intensity、环境光遮蔽与材质的matDiffuseSpecularAlphaBlend混合权重——这正是 BUILD.md 强调"隐藏太阳层、保留干净亮度分布"的原因:天空盒既当背景又当光源。 - 渲染器层:LightSkyboxRenderer.cs 声明
IsEnvironmentLight = true并只接受LightSkybox类型光源,负责把天空盒参数编译进灯光组;此外 CubemapFromTextureRenderer.cs 与 CubemapRendererBase.cs 还支持从普通纹理或场景运行时捕获生成 cubemap,说明同一套渲染管线对"离线构建贴图"与"运行时生成贴图"两种来源均兼容。
构建产物校验与再制作建议
制作完成后,可通过以下方式验证产物是否可用:
- 确认
.dds头部信息与预期一致:HDR 应为R16G16B16A16_FLOAT且带 8 级 mipmap,LDR 应为BC7;可用texconv.exe的-list类命令或 DirectXTex 配套工具核对; - 检查面序是否为
Side, Side, Top, Bottom, Side, Side,若顺序错误,运行时天空盒各面会错位; - 在 Stride 编辑器中打开模板的
MainScene.sdscene,观察背景与物体受光是否正常,无太阳光斑残留、顶底无黑孔; - 若要替换为自己的天空,可沿用本配方:任意全景图 → PTgui 转 6x1 cubemap → 修面序补洞 → texconv 转目标格式,产出后放入模板
Resources目录并更新Skybox texture.sdtex的Source引用即可。
这套流程与 samples/NewGame/NewGame/MyTemplate.Game 模板内的资产一一对应,是 Stride 项目中最完整、可直接照搬的一套天空盒资源生产管线参考。