[原][osgearth]API加載earth文件的解析

參考：http://blog.csdn.net/cccstudyer/article/details/17691893

 

通過\src\osgEarthDrivers\earth\ReaderWriterOsgEarth.cpp文件

ReaderWriterEarth類，用來解析“earth”文件

在文件225行的readNode函數

  virtual ReadResult readNode(std::istream& in, const osgDB::Options* readOptions) const
        {
            // pull the URI context from the options structure (since we're reading
            // from an "anonymous" stream here)
            URIContext uriContext( readOptions ); 

            osg::ref_ptr<XmlDocument> doc = XmlDocument::load( in, uriContext );
            if ( !doc.valid() )
                return ReadResult::ERROR_IN_READING_FILE;

            Config docConf = doc->getConfig();

            // support both "map" and "earth" tag names at the top level
            Config conf;
            if ( docConf.hasChild( "map" ) )
                conf = docConf.child( "map" );
            else if ( docConf.hasChild( "earth" ) )
                conf = docConf.child( "earth" );

            osg::ref_ptr<osg::Node> node;

            if ( !conf.empty() )
            {
                // see if we were given a reference URI to use:
                std::string refURI = uriContext.referrer();

                if ( conf.value("version") == "1" )
                {
                    OE_INFO << LC << "Detected a version 1.x earth file" << std::endl;
                    EarthFileSerializer1 ser;
                    node = ser.deserialize( conf, refURI );
                }

                else
                {
                    if ( conf.value("version") != "2" )
                        OE_DEBUG << LC << "No valid earth file version; assuming version='2'" << std::endl;

                    // attempt to parse a "default options" JSON string:
                    std::string defaultConfStr;
                    if ( readOptions )
                    {
                        defaultConfStr = readOptions->getPluginStringData("osgEarth.defaultOptions");
                        if ( !defaultConfStr.empty() )
                        {
                            Config optionsConf("options");
                            if (optionsConf.fromJSON(defaultConfStr))
                            {
                                //OE_NOTICE << "\n\nOriginal = \n" << conf.toJSON(true) << "\n";
                                Config* original = conf.mutable_child("options");
                                if ( original )
                                {
                                    recursiveUniqueKeyMerge(optionsConf, *original);
                                }
                                if ( !optionsConf.empty() )
                                {
                                    conf.set("options", optionsConf);
                                }
                                //OE_NOTICE << "\n\nMerged = \n" << conf.toJSON(true) << "\n";
                            }
                        }
                    }

                    EarthFileSerializer2 ser;
                    node = ser.deserialize( conf, refURI );
                }
            }

            MapNode* mapNode = MapNode::get(node.get());
            if (mapNode)
            {
                // If the user passed in a cache object, apply it to the map now
                CacheSettings* cacheSettings = CacheSettings::get(readOptions);
                if (cacheSettings && cacheSettings->getCache())
                {
                    mapNode->getMap()->setCache( cacheSettings->getCache() );
                    OE_INFO << LC << "Applied user-supplied cache to the Map\n";
                }
            }

            return ReadResult(node.get());
        }
};

看到65行的讀取調用

進入\src\osgEarthDrivers\earth\EarthFileSerializer2.cpp文件

 

EarthFileSerializer2類的deserialize函數

 

 void addImageLayer(const Config& conf, Map* map)
    {
        ImageLayerOptions options( conf );
        options.name() = conf.value("name");
        ImageLayer* layer = new ImageLayer(options);
        map->addLayer(layer);
        if (layer->getStatus().isError())
            OE_WARN << LC << "Layer \"" << layer->getName() << "\" : " << layer->getStatus().toString() << std::endl;
    }

    void addElevationLayer(const Config& conf, Map* map)
    {
        ElevationLayerOptions options( conf );
        options.name() = conf.value( "name" );
        ElevationLayer* layer = new ElevationLayer(options);
        map->addLayer(layer);
        if (layer->getStatus().isError())
            OE_WARN << LC << "Layer \"" << layer->getName() << "\" : " << layer->getStatus().toString() << std::endl;
    }

    void addModelLayer(const Config& conf, Map* map)
    {
        ModelLayerOptions options( conf );
        options.name() = conf.value( "name" );
        options.driver() = ModelSourceOptions( conf );
        ModelLayer* layer = new ModelLayer(options);
        map->addLayer(layer);
        if (layer->getStatus().isError())
            OE_WARN << LC << "Layer \"" << layer->getName() << "\" : " << layer->getStatus().toString() << std::endl;
    }

    void addMaskLayer(const Config& conf, Map* map)
    {
        MaskLayerOptions options(conf);
        options.name() = conf.value( "name" );
        options.driver() = MaskSourceOptions(options);
        MaskLayer* layer = new MaskLayer(options);
        map->addLayer(layer);
        if (layer->getStatus().isError())
            OE_WARN << LC << "Layer \"" << layer->getName() << "\" : " << layer->getStatus().toString() << std::endl;
    }

    // support for "special" extension names (convenience and backwards compat)
    Extension* createSpecialExtension(const Config& conf)
    {
        // special support for the default sky extension:
        if (conf.key() == "sky" && !conf.hasValue("driver"))
            return Extension::create("sky_simple", conf);

        if (conf.key() == "ocean" && !conf.hasValue("driver"))
            return Extension::create("ocean_simple", conf);

        return 0L;
    }

    bool addLayer(const Config& conf, Map* map)
    {
        std::string name = conf.key();
        Layer* layer = Layer::create(name, conf);
        if (layer)
        {
            map->addLayer(layer);
            if (layer->getStatus().isError())
                OE_WARN << LC << "Layer \"" << layer->getName() << "\" : " << layer->getStatus().toString() << std::endl;
        }
        return layer != 0L;
    }

osg::Node*
EarthFileSerializer2::deserialize( const Config& conf, const std::string& referrer ) const
{
    // First, pre-load any extension DLLs.
    preloadExtensionLibs(conf);
    preloadExtensionLibs(conf.child("extensions"));
    preloadExtensionLibs(conf.child("external"));

    MapOptions mapOptions( conf.child( "options" ) );

    // legacy: check for name/type in top-level attrs:
    if ( conf.hasValue( "name" ) || conf.hasValue( "type" ) )
    {
        Config legacy;
        if ( conf.hasValue("name") ) legacy.add( "name", conf.value("name") );
        if ( conf.hasValue("type") ) legacy.add( "type", conf.value("type") );
        mapOptions.mergeConfig( legacy );
    }

    Map* map = new Map( mapOptions );

    // Start a batch update of the map:
    map->beginUpdate();

    // Read all the elevation layers in FIRST so other layers can access them for things like clamping.
    for(ConfigSet::const_iterator i = conf.children().begin(); i != conf.children().end(); ++i)
    {
        if ( i->key() == "elevation" || i->key() == "heightfield" )
        {
            addElevationLayer( *i, map );
        }
    }

    Config externalConfig;
    std::vector<osg::ref_ptr<Extension> > extensions;

    // Read the layers in LAST (otherwise they will not benefit from the cache/profile configuration)
    for(ConfigSet::const_iterator i = conf.children().begin(); i != conf.children().end(); ++i)
    {
        if (i->key() == "options" || i->key() == "name" || i->key() == "type" || i->key() == "version")
        {
            // nop - handled earlier
        }

        else if ( i->key() == "image" )
        {
            addImageLayer( *i, map );
        }

        else if ( i->key() == "model" )
        {
            addModelLayer( *i, map );
        }

        else if ( i->key() == "mask" )
        {
            addMaskLayer( *i, map );
        }

        else if ( i->key() == "external" || i->key() == "extensions" )
        {
            externalConfig = *i;
            
            for(ConfigSet::const_iterator e = i->children().begin(); e != i->children().end(); ++e)
            {
                Extension* extension = loadExtension(*e);
                if (extension)
                    extensions.push_back(extension);
                //addExtension( *e, mapNode.get() );
            }
        }

        else if ( !isReservedWord(i->key()) ) // plugins/extensions.
        {
            bool addedLayer = addLayer(*i, map); //mapNode.get());

            if ( !addedLayer )
            {
                Extension* extension = loadExtension(*i);
                if (extension)
                    extensions.push_back(extension);
                //OE_INFO << LC << "Tried to load \"" << i->key() << "\" as a layer; now trying extension\n";
                //addExtension( *i, mapNode.get() );
            }
        }
    }

    // Complete the batch update of the map
    map->endUpdate();

    // Yes, MapOptions and MapNodeOptions share the same Config node. Weird but true.
    MapNodeOptions mapNodeOptions( conf.child("options") );

    // Create a map node.
    osg::ref_ptr<MapNode> mapNode = new MapNode( map, mapNodeOptions );

    // Apply the external conf if there is one.
    if (!externalConfig.empty())
    {
        mapNode->externalConfig() = externalConfig;
    }

    // Install the extensions
    for (unsigned i = 0; i < extensions.size(); ++i)
    {
        mapNode->addExtension(extensions.at(i).get());
    }

    // return the topmost parent of the mapnode. It's possible that
    // an extension added parents!
    osg::Node* top = mapNode.release();

    while( top->getNumParents() > 0 )
        top = top->getParent(0);

    return top;
}

 

從上面可以看到

1 earth插件 map 統籌OE中所有"層"的概念，支持多層影像，高程，模型，鏤空層（mask）等

2各個層相應配置的屬性由指定的Option類從Config中獲取，如果對應Config中有Option類指定元素相應值的配置Option將其寫入

為了統籌OE各個層的屬性配置，OE提供了ConfigOptions類，ConfigOptions類就是對某個Config類的封裝，提供了到Config層次上的調用，例如Config賦值，拼接等

 

為不同層的屬性配置提供了存儲載體,結合上文map包含的圖層有以下關系

 

通過這些類，可以很方便的將特定的XML節點下屬性配置生成Config歸類到某一個圖層中，以下列出部分圖層的屬性(僅供參考)

MapOptions：XML<<options>>節點下配置的信息，主要是配置地形渲染時的屬性；包括如下

 

<elevation_interploation> 插值，nearset 最近點插值  average 最近點平均值 bilinear 線性插值，  triangulate 三角面片插值
<elevation_tile_size> 瓦片大小
<elevation_texture_size> 紋理大小
<overlay_wapring> 紋理裝載
<overlay_blending>混合
<overlay_minmapping>  紋理映射
<overlay_texture_size>
<overlay_attach_stencil>模板

 

ImageLayerOptions： XML<<image>>節點下配置的信息，很明顯，影像屬性配置，部分屬性值

 

<nodata_image> 無數據顯示的url
<opacity>    透明度
<min_range> 最小可視范圍
<max_range> 最大可視范圍
<min_level>  最小顯示細節層級
<max_level>  最大顯示細節層級
<min_resolution> 數據的最小分辨率，單位的像素
<max_resolution>數據的最大分辨率，單位的像素
<enable> 是否包含進map層
<visible> 可視

 

 

ElevationLayerOptions： XML<<elevation>>or<<heightfield>>節點下配置的信息，高程層

 

<min_level>  最小顯示細節層級
<max_level>  最大顯示細節層級
<min_resolution> 數據的最小分辨率，單位的像素
<max_resolution>數據的最大分辨率，單位的像素
<enable> 是否包含進map層

 

 

ModelLayerOptions： XML<<Model>>節點下配置的信息 模型層裝載 矢量數據，模型，幾何體等

 

<name>
<driver>
<enable><span style="font-family:Arial, Helvetica, sans-serif;">是否包含進map層</span>
<visible>是否可見
<overLay>

 

MaskLayerOptions： XML<<mask>>節點配置下的信息，鏤空層

 

一個比較特殊的節點 ext(Config); 暫且叫他功能層，XML <<external>>,它由mapNode直接讀取配置信息，實現一些經常用到的功能點，例如 視點定位 <<<viewpoint>> 星空時刻設置<<sky>>等