从osgEarth 2升级到3.7.2版本的关键变化与适配指南

osgEarth作为一款优秀的地理空间可视化引擎，在3.x版本中对API进行了重大重构。本文将重点介绍从2.x版本升级到3.7.2版本时，关于OSGOptions和OGRFeatureOptions等关键组件的适配方法。

核心变化概述

在osgEarth 3.x版本中，开发团队移除了所有Options结构体，转而采用更直接的层配置方式。这一变化使得API更加简洁直观，同时也提高了代码的可读性和可维护性。

OGRFeatureOptions的替代方案

在2.x版本中，我们使用OGRFeatureOptions来配置要素源，而在3.x版本中，这一方式已被完全重构：

// 创建要素源并直接设置属性
auto* features = new OGRFeatureSource();
features->setURL(aFilename);  // 设置数据源路径
features->setBuildSpatialIndex(true);  // 启用空间索引

// 添加属性过滤器
features->getFilters().emplace_back(new AttributesFilter({"attr"}));

// 创建要素模型层
auto* layer = new FeatureModelLayer();
layer->setFeatureSource(features);

// 添加到地图
map->addLayer(layer);

样式设置的更新

对于要素样式的配置，3.x版本也做了相应调整：

// 创建样式
Style sstyle;
sstyle.setName("outlines");

// 配置线符号
LineSymbol* ls = sstyle.getOrCreateSymbol<LineSymbol>();
ls->stroke()->color() = Color(aRed, aGreen, aBlue);
ls->stroke()->width() = 2.0f;

// 创建样式表并添加样式
auto stylesheet = new StyleSheet();
stylesheet->addStyle(sstyle);

// 创建要素层并设置样式
auto* layer = new FeatureModelLayer();
layer->setStyleSheet(stylesheet);
layer->setEnableLighting(false);

OSGOptions的替代方案

在3.x版本中，OSGOptions驱动已被移除，取而代之的是更规范的GDALImageLayer：

auto* layer = new GDALImageLayer();
layer->setURL(aFilename);

需要注意的是，osgEarth 3.x严格要求所有影像数据都必须具有地理参考信息。如果您的数据尚未地理参考，可以使用gdal_translate工具进行处理：

gdal_translate -a_srs EPSG:4326 input.jpg output.tif

升级建议

1. 逐步迁移：建议先在新项目中尝试3.x版本的API，熟悉后再迁移现有项目
2. 测试验证：特别注意空间参考系统和坐标转换的验证
3. 性能优化：利用3.x版本的新特性优化应用性能
4. 文档参考：详细阅读3.x版本的API文档，了解新增功能

通过以上调整，您可以顺利将项目从osgEarth 2.x迁移到3.7.2版本，并享受新版本带来的性能提升和功能增强。