Stride 新游戏模板默认天空盒立方体贴图(Cubemap)生成指南:HDR/LDR 双管线流程与运行时采样原理

原创2026-09-27 16:05:371,358 阅读
文章标签:游戏开发图形学3D渲染桌面应用物理引擎VR高性能计算

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 目录可以看到一组与天空盒直接相关的资产:

也就是说,BUILD.md 记录的是一份"资源制作配方",它产出的 .dds 文件直接决定了模板中天空盒与 IBL 环境光的观感。该贴图不仅是背景,还作为环境光源参与材质渲染(详见下文源码分析),因此其构建质量直接影响新项目默认场景的光照表现。

HDR 立方体贴图构建流程(全步骤)

HDR 流程的目标产物是 skybox_texture_hdr.dds:一个 R16G16B16A16_FLOAT(F16)格式、带 8 级 mipmap 的立方体贴图,用于保留高动态范围的亮度信息。

1. 在 Photoshop 中准备源图

  1. 打开源文件 hemisphere_cube_32_glay.psd(仓库 sources/data/images/NewGame/ 目录下可找到原稿);
  2. 将画布缩放到 128(此处为模板贴图的基准尺寸);
  3. 隐藏太阳(sun)图层——这一步是为了去除单一强光源方向,避免天空盒自带高亮太阳导致环境光分布失衡;
  4. 将图像导出为 HDR 格式(保留 32 位浮点亮度信息)。

2. 用 PTgui 将全景图转换为立方体面(QTVR/Cubic)

  1. 在 PTgui 中执行 Tools => Convert to QTVR/Cubic;
  2. 投影方式选择 Cylindrical(圆柱投影);
  3. 输出尺寸设为 256,Cube face strip 布局为 6x1(六个面横向拼接成一条),格式为 hdr;
  4. 保存结果。

这一步把半球全景图重新投影为立方体贴图的六个面(Side/Top/Bottom),是全景图到 cubemap 的核心转换环节。

3. 面序修正与补洞

  1. 用 Photoshop 重新打开上一步导出的 HDR 文件;
  2. 填补底部与顶部(bottom/top)的孔洞——圆柱投影在顶底区域会产生采样空洞,需要手动修复;
  3. 交换面序,使最终排列为:Side, Side, Top, Bottom, Side, Side(原始导出中 Top 与 Bottom 位于末尾,需要移动到中间位置)。这个顺序必须与 DDS cubemap 约定及渲染端采样期望保持一致。

4. 导出 RGBA32 并用 texconv 转 F16

  1. 使用 NVIDIA DDS 插件(Photoshop 的 .dds 导出插件)将修复后的图像导出为 RGBA32 格式的 DDS;
  2. 使用 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 变体资产)。

  1. 打开 hemisphere_cube_32_glay.psd,缩放到 128,隐藏太阳层(与 HDR 流程相同的准备步骤);
  2. 在 Photoshop 中执行 Image => Mode => 8 Bits/Channel 将图像从 32 位降到 8 位:
    • 弹窗询问合并图层时选择 "Merge"(合并);
    • HDR toning 方式选择 "Exposure and Gamma"(曝光与伽马)——这是把 HDR 亮度映射回 LDR 的色调映射方法;
  3. 使用 NVIDIA DDS 插件导出为 RGB8 格式的 DDS;
  4. 使用 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 中经历了完整的资产—运行时链路,仓库源码可以逐环印证:

  1. 资产层:Skybox.sdsky 声明为 SkyboxAsset,运行时对应 Skybox.cs 中的 Skybox 类——它承载 Parameters、DiffuseLightingParameters、SpecularLightingParameters 三组参数集合,分别用于背景绘制与漫反射/镜面反射环境光计算。
  2. 采样层:SkyboxShaderCubemap.sdsl 声明 stage TextureCube CubeMap,用 LinearSampler 对 float3(samplingDir.x, samplingDir.y, -samplingDir.z) 方向采样——注意 z 分量取反,这是 DDS cubemap 的坐标系约定与 Stride 左手坐标系之间的翻转适配。
  3. 环境光层:LightSkyboxShader.sdsl 定义了天空盒作为 EnvironmentLight 的着色逻辑:漫反射方向由 SkyMatrix 旋转后的法线采样,镜面反射方向由 reflect(-viewWS, normalWS) 求反射向量后采样,两者都乘以 Intensity、环境光遮蔽与材质的 matDiffuseSpecularAlphaBlend 混合权重——这正是 BUILD.md 强调"隐藏太阳层、保留干净亮度分布"的原因:天空盒既当背景又当光源。
  4. 渲染器层: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 项目中最完整、可直接照搬的一套天空盒资源生产管线参考。

登录后查看全文
stride