3.1. General settings

Table 3.1. The properties for general settings

Property nameValue typeDefault valueDescription
Setting.AllowNetwork boolean true Determines whether tiles may be retrieved from the internet.
Setting.Center.Latitude double 0.0 Specifies the initial center coordinate latitude after loading.
Setting.Center.Longitude double 0.0 Specifies the initial center coordinate longitude after loading.
Setting.Scale integer 0 Specifies the initial scale after loading. Note that this will be limited to lie within the scale boundaries of the active provider.
Setting.Zoom integer 0 Specifies the initial zoom level after loading. Note that this will be limited to lie within the zoom boundaries of the active provider.

Table 3.2. The properties for the scale information overlays

Property nameValue typeDefault valueDescription
Setting.ScaleInfo.Background color lightGray Determines the background color of the scale info overlays.
Setting.ScaleInfo.FontColor color black Determines the font color of the scale info overlays. This is used for the scale and distance estimation texts as well as for the distance length marker lines.
Setting.ScaleInfo.FontName string Dialog-PLAIN-12 Determines the font name of the scale info overlays.
Setting.ScaleInfo.Visible boolean false Determines whether the scale info overlays are visible.

Table 3.3. The properties for the tile grid display

Property nameValue typeDefault valueDescription
Setting.TileGrid.Color color black Determines the color of the tile grid lines.
Setting.TileGrid.FontColor color black Determines the font color of the tile grid coordinates.
Setting.TileGrid.FontName string Dialog-BOLD-18 Determines the font name of the tile grid coordinates.
Setting.TileGrid.FontShadow color lightGray Determines the font shadow color of the tile grid coordinates. This should be a color that has a good contrast in respect to the font color in order to ensure that the coordinates are legible on all kinds of backgrounds.
Setting.TileGrid.Visible boolean false Determines whether the tile grid lines and coordinates are visible.

Note that the color property values can be given in a number of different styles:

Font name property values are to be given in the following form:

  1. The name of the font, e.g. "Arial", "Courier", "Serif", "Dialog", etc.

  2. A single dash: "-"

  3. One of the strings "PLAIN", "BOLD", "ITALIC", "BOLDITALIC"

  4. A single dash: "-"

  5. The font size as an integer, e.g. "12", "28"

The parsing of such a font name will accept some deviations from that pattern (as specified in the java.awt.Font.decode() method documentation), but can quickly lead to undesired results if not adhered to.