GIS1 File Formats

<?xml version="1.0" encoding="utf-8"?>
<TerrainSettings>
<PlanetRadius>#.#</PlanetRadius>
<CoType>WGS84</CoType>
<MinHeight>#.#</MinHeight>
<MaxHeight>#.#</MaxHeight>
<MinHC>#.#</MinHC>
<MaxHC>#.#</MaxHC>
  <MinVC>#.#</MinVC>
<MaxVC>#.#</MaxVC>
<UnitQuadExtRatio>#</UnitQuadExtRatio>
<PreloadRadius>#</PreloadRadius>
<RepositoryXml>filename.xml</RepositoryXml>
</TerrainSettings>

Parameters have the following meaning:

The repository description file has the following format:

<?xml version="1.0" encoding="utf-8"?>

<Repository>

<Mapping>

<WorldPoint X="#.#" Z="#.#"/>

<GISPoint Long="#.#" Lat="#.#"/>

</Mapping>

<Heightmaps>

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">hmap_filename1.ext</file>

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">hmap_filename2.ext</file>

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">hmap_filename3.ext</file>

<!-- ... etc ... -->

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">hmap_filenameN.ext</file>

</Heightmaps>

<Textures>

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">tex_filename1.ext</file>

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">tex_filename2.ext</file>

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">tex_filename3.ext</file>

<!-- ... etc ... -->

<file minLong="#.#" maxLong="#.#" minLat="#.#"maxLat="#.#">tex_filenameN.ext</file>

</Textures>

<CoverGen>cg_filename.xml</CoverGen>

<Marking>mk_filename.xml</Marking>

<Shapemapping>sm_filename.xml</Shapemapping>

<Tuning>

<OptionName1>value_1</OptionName1>

<OptionName2>value_2</OptionName2>

<OptionName3>value_3</OptionName3>

<!-- ... etc ... -->

<OptionNameK>value_K</OptionNameK>

</Tuning>

</Repository>

Blue color selects optional nodes of the xml-document. Remaining knots are mandatory and should follow in a specified order.

Section of Mapping controls mapping between the world co-ordinate system and the GIS co-ordinate system. The point with co-ordinates (X, Z) specified in appropriate attributes of WorldPoint node is mapped to a point (Long, Lat) in the GIS co-ordinate system, set by attributes of GISPoint node.

The Heightmaps section contains the enumeration of elevation maps used for generation of cache of GIS geometrical data. It consists of an arbitrary gang of nodes like this: <file minLong = "#. #" maxLong = "#. #" minLat = "#. #" maxLat = "#. #"> hmap_filename.ext </file>, thus attributes minLong, maxLong, minLat, maxLat define a binding of a raster with a elevation map to a rectangle in GIS co-ordinate system and the file with the specified name is used as a source of raster data. It is most recommended to use files in GeoTiff format, containing 32-bit float point values.

Similarly, the Textures section contains the enumeration of the textures used for generation of cache of GIS textural data. The section format completely coincides with a format of Heightmaps section. The recommended type of raster files are files with the JPEG- or PNG-compressed images.

Optional CoverGen section contains a name of a xml-file with the data used at generation of splatting atlases. The file format is described further.

Optional Marking section Marking contains a name of a xml-file with the information used for loading of static vector data. The file format is described further.

Optional Shapemapping section contains a name of a xml-file with the information used for drawing of static vector data on cache-stored textures. The file format is described further.

Optional Tuning section contains the enumeration of the options which are for thin customisation of functioning GIS. The enumeration of options and their admissible values is next:

The file with data for generation of splatting atlases has the following format:

<CoverGen>

<Layer no="0" resolution="#">filename.ext</Layer>

<Layer no="1" resolution="#" random_seed="#" alt_ange="range" slope_range="range" red_range="range" green_range="range" blue_range="range" random_min="#.#" random_max="#.#" glaciating="#" smoothing="#.#" locality="#.#">filename.ext</Layer>

<Layer no="2" resolution="#" random_seed="#" alt_ange="range" slope_range="range" red_range="range" green_range="range" blue_range="range" random_min="#.#" random_max="#.#" glaciating="#" smoothing="#.#" locality="#.#">filename.ext</Layer>

<Layer no="3" resolution="#" random_seed="#" alt_ange="range" slope_range="range" red_range="range" green_range="range" blue_range="range" random_min="#.#" random_max="#.#" glaciating="#" smoothing="#.#" locality="#.#">filename.ext</Layer>

<Layer no="4" resolution="#" random_seed="#" alt_ange="range" slope_range="range" red_range="range" green_range="range" blue_range="range" random_min="#.#" random_max="#.#" glaciating="#" smoothing="#.#" locality="#.#">filename.ext</Layer>

</CoverGen>

In GIS1 5-layered splatting with usage of coefficients of reflexion of layers is implemented. Local value of coefficient of reflexion for each layer, except for 0th is defined proceeding from layer parameters; for a zero layer the reflexion coefficient is equal 1.

The evaluation of coefficient of reflexion for a surface site happens under the following scheme:

Parameters of splatting have the following sense:

The range can be set in one of three sorts:

(xx[yy-the range opened from above

xx]yy)-The range opened from below

(xx[yy:zz]tt)-Double-sided range

For example, when parametrs are as next: alt_range ="(100 [200:500] 600)" slope_range ="45] 50)" red_range = "(100 [120" the appropriate splatting layer will appear at heights from 100 to 600, accepting the greatest values at heights from 200 to 500, angles of declination to 50, accepting the greatest values at angles to 40, and on the sites covered with texture with the red component from above 100, accepting greatest of value for sites with the red component above 120.

The ranges not specified explicitly are considered as the infinite. For example, if the range alt_range is not specified, the coefficient of reflexion of a layer does not depend on height and is defined by other factors.

The file with description of static vectorial data has the following format:

<?xml version="1.0" encoding="utf-8"?>

<Marking>

<Linestrings layername="Roads">filename.shp</Linestrings>

<Linestrings layername="Rivers">filename.shp</Linestrings>

<Polygons layername="Frontier">filename.shp</Polygons>

<Polygons layername="Regions">filename.shp</Polygons>

<Polygons layername="WaterAreas">filename.shp</Polygons>

<Points layername="Samples" namefield="Label" colorfield="Color">filename.shp</Points>

</Marking>

The node name (Linestrings, Polygons, Points) defines a data type which will be read from a file with data.

The layername parameter defines a name of a layer for the reference when static vector data drawing and inquiries to the manager of vector data processing.

Optional namefield parameter defines a field name from which the object name of vector data will be extracted.

Optional colorfield parameter defines a field name from which color of the object will be extracted when drawing.

The file with data for drawing static vector data on textural cache GIS1 has a format:

<?xml version="1.0" encoding="utf-8"?>

<Shapemapping>

<Linestrings source="Roads" style="." width="200" color="Road.png/1"/>

<Polygons source="Frontier" width="10" style="-.."color="Red"/>

<Polygons source="Regions" width="5" style="-." color="Yellow"/>

<Linestrings source="Rivers" width="15" color="Water.jpg/2"/>

<Polygons source="WaterAreas" width="10" color="Water.jpg/2" ink="Water.jpg/1"/>

<DefColor deflayer="Roads" color="Violet"/>

<DefColor deflayer="Regions" color="100:100:200"/>

</Shapemapping>

The node name (Linestrings, Polygons) defines a data type will be draw. Drawing of points is not supported.

The source parameter specifies a layer name from which data for drawing are extracted.

The width parameter defines width of drawn lines.

The style parameter defines style of lines will be draw, possible values are "-", ".", "-.", ".".

The parameter color sets draw color in a format "rr:gg:bb", a name of color or a filename with texture for mapping.

The ink parameter similarly sets color of outline for polygons.