osgEarth项目中的Controls API使用与演进

背景介绍

osgEarth是一个基于OpenSceneGraph(OSG)的开源地理空间可视化引擎，它提供了强大的3D地球渲染功能。在osgEarth 3.7.0版本中，Controls API被标记为"legacy"选项，这引发了一些开发者关于如何继续使用相关功能的疑问。

Controls API的现状

Controls API最初设计用于支持osgEarth的演示程序，提供了诸如LabelControl、VBox、ControlCanvas等UI控件。这些控件被广泛应用于各种功能实现中，包括：

• 测量工具(MeasureTool)
• 网格线(Graticule)显示
• 各种信息标注

在最新版本中，Controls API仍然可用，但需要显式地在CMake配置中启用OSGEARTH_BUILD_LEGACY_CONTROLS_API选项才能使用。这表明开发团队已将其视为遗留功能，不再进行主动维护和扩展。

替代方案与技术演进

osgEarth团队现在推荐使用ImGui作为新的UI解决方案。ImGui是一个即时模式的图形用户界面库，具有以下优势：

1. 更现代的架构设计
2. 更高的性能
3. 更活跃的维护状态
4. 更丰富的功能集

值得注意的是，并非所有功能都依赖于Controls API。例如：

• 网格线(Graticule)功能完全不依赖Controls API
• 测量工具已被集成到TerrainGUI中，开发者可以参考其实现

迁移建议

对于现有项目，开发者可以：

1. 继续使用Controls API，通过CMake选项启用
2. 逐步迁移到ImGui，特别是新开发的功能
3. 参考TerrainGUI中的实现，重构现有功能

对于特定功能：

• 网格线显示：无需修改，不受Controls API状态影响
• 测量工具：可考虑采用TerrainGUI中的实现
• 其他UI元素：评估迁移到ImGui的成本和收益

总结

osgEarth的Controls API虽然被标记为遗留功能，但仍然可以继续使用。开发团队推荐转向ImGui作为长期解决方案，这反映了项目技术栈的现代化演进。开发者应根据项目需求和技术路线，合理规划UI层的技术选型和迁移策略。