<model> Element

A model data source is used to incorporate any non-raster data into the scene. Use a model source to add vector feature data (e.g. shapefiles), external 3D models (e.g. buildings), or other custom models to your map.

Models work independently of osgEarth's image/elevation tiling system. A model driver is responsible for its own level-of-detail and data paging management.

Attributes

name Readable name of the model source. Must be unique within the <map>. Also must be legal for use in a pathname, since this name is used by some caching mechanisms. required
driver Defines which driver to use for creating models. required
min_range The minimum visibility range (LOD range). Note: when using the <gridding> directive, the LOD range will apply to each grid cell rather than the entire model. optional
max_range The maximum visibility range (LOD range). Note: when using the <gridding> directive, the LOD range will apply to each grid cell rather than the entire model. optional
overlay Projects the model geometry onto the terrain as a draped overlay. optional

Sub-elements

<layout>? Describes the layout and levels of detail for feature rendering. (TODO: documentation) optional
<features> (Feature models only) Defines a source for vector feature data

Other sub-elements of <model> are driver-dependent. Please refer to the drivers list for information on the specifics of each model driver.

Example

    <model name="world boundaries" driver="feature_stencil">

        <features name="world" driver="ogr">
            <url>../data/world.shp</url>
        </features>

        <style type="text/css">
            world {
                stroke: #ffff00;                
            }
        </style>

    </model>