KGeography/Making Maps

    From KDE UserBase Wiki
    Revision as of 09:57, 10 March 2011 by Annma (talk | contribs)

    A map in KGeography is formed at least by two files, one is the image of the map and another is the description of it.

    Helper tool

    Here you can find a tool made by Yann Verley to help him with the map of France. To see its usage simply execute it and see the help message, but it basically creates the .kgm from a plain text file and creates a file with the colors it has assigned to each division so you can fill the map according to them.

    Description file

    Its file extension is .kgm Should begin with <map> and end with </map>. Inside of that tags there should be:

    • <mapFile> and </mapFile>: the name of the file containing the map image. e.g: europe.png
    • <name> and </name>: the name of map. e.g: Europe
    • A <division> and </division> for each division in the map.

    Each division has this tags:

    • <name> and </name>: the name of the division. e.g: Albania
    • <capital> and </capital>: the name of the capital of the division. e.g: Tirana
    • <ignore> and </ignore>: must be yes if the division should be ignored when asking for divisions in that map. This tag is optional e.g: Algeria has this tag set to yes in Europe map
    • <flag> and </flag>: the file containing the flag of the division. This tag is optional. Not needed for the divisions whose ignore tag is set to yes e.g: albania.png
    • <color> and </color>: the color the division has in the map.

    The color is defined using three tags:

    • <red> and </red>: red component of the color. Valid values are between 0 and 255.
    • <green> and </green>: green component of the color. Valid values are between 0 and 255.
    • <blue> and </blue>: blue component of the color. Valid values are between 0 and 255.

    It is convenient to create 2 or 3 false divisions like Water, Frontier and Coast and set them with ignore=yes.

    Important: All names (capital and division) must be in English.