Map Configuration File

 

Map configuration file stores information used to represent georeferenced items. Map configurations are used by the Map viewer to display such items. A map configuration stores two kinds of information :

• A group of image files used as layers to display in maps <layer_item>. All layers must have the same size and limits, in order to be superimposed.
• Description of the different UTM fuses included in the map: which limits they have in map pixels, angle...

Map configuration files have XML file format. In each file there is just one <map_configuration> tag. A default map configuration file can be specified in Quercus project file, or loaded with Open Map Configuration in Map menu.

 

Map Configuration file example

 

Map Configuration tags

<map_configuration/> : Each map confguration file contains just one configuration. It may contain one <icon_file/> used as a may in little format. It must contain at least one <layer_item/> tag and one <map_info/> tag.

<icon_file/> : Specifies the file used to display the map as an icon. This is useful when the map you are working with is too large to display it in the window, so you keep track of which part you are viewing in the icon map.

<layer_item/> : Describes a map image layer. It has attributes auto_load to show it automatically (when several layers are used, one may not want to load them all every time), grid_layer which tells the program this is a grid and must be drawn in top of any symbol in the map. This tag has 4 subtags:

• <label/> : Layer's name.
• <file/> : Image file
• <order/> : Layer's drawing order relatively to other layers.
• <alpha/> : Layer's opacity, between 0 (transparent) -255 (opaque).

<map_info/> : Describes map in terms of size and also relates UTM coordinates to image coordinates. Attributes number and angle specify the UTM zone number and angle with respect to the map image. It contains the following subtags:

• <map_width/> : Map's width in pixels.
• <map_height/> : Map's height in pixels.
• <fuse_info/> : UTM band zone description. There can be several UTM bands in one map. This tag has the following subtags:
  • <UTM_top_left/> : Specifies the top left UTM coordinates x and y of this zone, in numerical UTM format.
  • <UTM_bottom_left/> : Specifies the bottom left UTM coordinates x and y of this zone, in numerical UTM format.
  • <Image_top_left/> : Specifies the top left image coordinates x and y in pixels.
  • <Image_bottom_left/> : Specifies the bottom left image coordinates x and y in pixels.
  • <Image_top_right/> : Specifies the top right image coordinates x and y in pixels.
  • <Image_bottom_right/> : Specifies the bottom right image coordinates x and y in pixels.