<map>

A map configuration that describes how to render geospatial data as a unified terrain model.

osgEarth can render maps in one of two ways:

• Geocentric - If the value of the map's type attribute is geocentric, round, globe or earth then the map will be displayed as a whole earth, geocentric globe. Please note that only geodetic and mercator profiles can be rendered as a Geocentric globe.
  
• Projected - If the value of the map's type attribute is projected or flat then the map will be displayed in a flat projection. This is useful for displaying data that is in a projected coordinate system such as UTM, but you can also render whole earth geodetic or mercator data in a flat projection, e.g., for 2D mapping applications.

Attributes

name	Human-readable name of the map.	optional
type	Type of map to render: geocentric for round-earth (default), projected for flat-earth (default: geocentric)	optional
version	Specified the version of the earth-file format. Should be "2" when using osgEarth 2.x.	required

Sub-elements

<options>	Configures the map and all runtime behavior of the terrain engine.	optional
<image>	An image layer. Your graphics hardware, along with the compositor that osgEarth is using, will determine the maximum number of <image> layers you can display.	optional
<elevation>	An elevation layer. Elevation layers of different sizes and resolutions can be stacked. There is no artificial limit to the number of elevation layers osgEarth supports.	optional
<model>	A model data source (e.g., feature data, external models)	optional
<overlay>	A layer that drapes geometry over the terrain	optional

Example

<map name="earth" type="geocentric" version="2">

   <options>
      ...
   </options>

   <image ...>
   </image>

   <elevation...>
   </elevation>

</map>

---

• Back to Documentation