DagorEngine项目AssetViewer天气预设缺失问题解析

问题背景

在DagorEngine项目的AssetViewer工具中，开发者可能会遇到一个常见问题：当打开3D模型时，整个视口呈现为黑色，无法正常查看模型内容。这种情况通常是由于缺少默认的天气预设配置导致的。

问题原因分析

AssetViewer作为DagorEngine的资产查看工具，需要正确的光照环境设置才能正常渲染3D模型。当天气预设(weather preset)未被正确配置时，场景中将没有任何光源，导致渲染结果为全黑。

解决方案

要解决这个问题，开发者需要手动配置天气预设。具体步骤如下：

1. 定位到项目目录下的develop/.asset-local/_av.blk文件
2. 添加或修改以下配置内容：

skies{
  preset:t="../gamedata/environments/weather_preset_1.blk"
  env:t="morning"
  wtype:t="clear"
}

这段配置指定了：

• 使用预设的天气配置文件weather_preset_1.blk
• 环境设置为"morning"(早晨)
• 天气类型为"clear"(晴朗)

技术细节

在DagorEngine中，天气预设系统负责管理场景的光照环境，包括：

• 太阳光方向与强度
• 环境光设置
• 天空盒配置
• 雾效等大气效果

当这些参数缺失时，引擎无法正确计算光照，导致渲染失败。通过手动配置预设文件，可以确保AssetViewer有基本的光照环境来展示3D资产。

最佳实践建议

1. 建议项目团队在模板项目中包含默认的天气预设配置
2. 开发者在创建新项目时，应检查AssetViewer的光照设置
3. 对于不同的展示需求，可以创建多个天气预设并在配置中切换

总结

DagorEngine的AssetViewer工具依赖正确的天气预设配置来提供渲染环境。通过理解这一机制并正确配置，开发者可以避免"黑屏"问题，确保3D资产能够正常展示和预览。这个问题也提醒我们，在游戏引擎开发中，环境设置的基础配置同样重要。