wesnoth/resources/cartography-tools/map-howto.txt

= Wesnoth Map Construction HOWTO =

=- Overview ==

This directory contains the resources needed to edit the Wesnoth main
map and variants thereof with the GIMP.

The most important file is great-continent.xcf.  This started out as a
straight conversion of mapmaker Kestenvarn's Photoshop file for the
main map as it existed on 9 Oct 2008 (still here as  bfw-htt-gimp.psd).
XCF is the layered format the GIMP uses for storing images.

The layers contain lots of hidden treasure, including isolated copies
of all the various icons and cartouches and things used to compose the
main map. To edit, hack a layer (you probably should not touch any of
the base maps).  When adding new features, put them in new layers.
Layers are cheap.

The font used for the legends (mostly at 13-point size) is Monotype
Corsiva. We cannot distribute it because it is issued under a
proprietary license, but copies are not hard to find on the Web.  To
fully enable that font in GIMP, copy the downloaded file to your GIMP
fonts directory; this will be something like ~/.gimp-M.N/fonts/, where
M.N is your GIMP version.

To generate maps, simply enable the layers you want and save with the
appropriate file extension.  GIMP will tell you it has to flatten
the layer stack; that's OK.

== Techniques ==

Here's a link to Kestenvarn's tutorial on mapmaking and the associated
forum thread:

http://www.wesnoth.org/forum/viewtopic.php?f=18&t=10131

It assumes Photoshop, but some of the advice transfers to GIMP.

Here's some more GIMP-specific advice on emulating the style of the
main Wesnoth map:

1. Draw your land outline with a hard white brush.

2. Select a width-3 pencil.  Dip it in the bluish-gray color of the
   land-sea border.

3. Select the land region with Select By Color.

4. Convert the selection boundary to a path (File -> Dialogs ->Paths).
   Delete the border bits you don't want from the path.

5. Stroke the path to draw your land-sea border.  (If you stroke
   the selection boundary it will have jaggies due to aliasing effects; 
   stroking paths, on the other hand, invokes some antialiasing
   algorithms. See GIMP bug #50730 for discussion.)

6. Fill the sea with a sea color from the main map.  Select it.

7. Drop the pencil width to 1. Shrink the selection by 5 or 6
   pixels.

8. Again, convert the selection to a path.

9. Stroke the path.  You now have a contour line
   following the coast.

10. Bucket-fill your coastal margin with some color not on the map.

11. Shrink the selection another 5 or 6 pixels and repeat steps 8 and 9
   You now have a double tidal contour line.

12. Delete all white and merge the result onto a copy of the plain
   parchment layer.

13. Select the parchment (land) parts and copy them with a new layer.
    Call this "Elevation".

14. Decide where you're going to place your mountains. Draw them
    (or frankenstein them from the main map) onto a new "Topography"
    layer.

15. Stack Topography on top of Elevation; select Elevation foe
    editing.  Use the Burn and Dodge tools to texture the parchment,
    dargening low areas and lightening high ones so they merge
    visually with your mountain bases.

Now you've got your base map.  The rest is pasting bits from old
Forest, swamp, and Workshop layers, or using the custom brushes.

== Text ==

As mentioned before, the text on the map uses Monotype Corsiva (mostly at 13-point).
Before you go crazy with the text tool, make sure that the following options are enabled:
hinting, force auto-hinter, and antialiasing.

Color values are presented in the following order: HTML notation, HSV, RGB.

The text that is not overlayed on the parchment labels uses the default color, pure black (000000, 0/0/0, 0/0/0).
Finally, the text that is overlayed on the parchment labels uses this color: 413422, 35/48/25, 65/52/34.

== Parchment Labels and Text ==

The parchment labels and the text that is overlayed onto them are stored in different layers.
The parchment labels are stored in layers like this: "<insert head name here> (overlay)", while
the text is stored in layers like this: "<insert head name here> text (overlay)".

The text overlayed onto parchment labels is to be set to 13-point and is to use this color: 413422, 35/48/25, 65/52/34.

The parchment layers that are to be overlayed onto forest pieces are to have their layer opacities set to 90%, while other
parchment layers are to have their opacities set to 75%.

== Brushes ==

Note: Aside from the city/town/fort/signpost marker brushes, the trail dot brush, and the swamp brush, do not bother with these.

In order to install the cartography brushes, just go to File >Preferences >Folders > Brushes
Then hit the button that is to the leftmost on the second pane; then type the path to the brushes or hit
the button next to the area where one would type the file path; then direct it to the directory where
the brushes are.

Or you could dump all the brushes in GIMP's brushes directory:

On Linux and similar boxes the path to GIMP's brushes directory is /usr/share/gimp/2.0/brushes/

On Windows boxes the path to GIMP's brushes directory is <GIMP install directory>/share/gimp/2.0/brushes/

== Recipes ==

The campaign maps in mainline need slightly varying maps depending on
the date; also, some of them have campaign-specific features.  Here's
a description of the layers of great-continent.xcf used to compose each.

All campaigns (Wesnoth early labels):
   Border
   Border BG
   Wesnoth early labels text
   Wesnoth early labels
   Wesnoth Forests
   Wesnoth Marsh
   Wesnoth topography

All campaigns after 25YW (Wesnoth late labels - this is what's in wesnoth.png):
   Wesnoth late labels text
   Wesnoth late labels
   Wesnoth Human Names
   Wesnoth Roads

An_Orcish_Incursion (8YW):
   Wesnoth An Orcish Incursion text overlay
   Wesnoth An Orcish Incursion overlay

Descent_Into_Darkness (389):
   Wesnoth late labels text
   Wesnoth late labels
   Wesnoth Descent Into Darkness overlay

Eastern_Invasion (625YW):
   Wesnoth late labels text
   Wesnoth late labels
   Wesnoth Eastern Invasion overlay

Heir_To_The_Throne (518YW):
   Wesnoth late labels text
   Wesnoth late labels

Legend_of_Wesmere (12YW):
   Wesnoth early labels text
   Wesnoth early labels
   Wesnoth Legend of Wesmere overlay

Liberty (501YW):
   Wesnoth late labels text
   Wesnoth late labels
   Wesnoth Liberty overlay

Northern_Rebirth (534YW):
   No overlays.

Sceptre_of_Fire (25YW):
   No overlays.

Son_Of_The_Black_Eye (842YW):
   All Layers named "Far North".

The_Hammer_of_Thursagan (550YW):
   No overlays.

The_Rise_Of_Wesnoth (1YW):
   No overlays.

The_South_Guard (607YW):
   No overlays.

Two_Brothers (353YW):
   No overlays.

Under_the_Burning_Suns (??):
   Has no map.