MapMirror Readme

===Introduction===
MapMirror is a map generator for RA2 (and possibly other games which use the
same map format). It can be used to create symmetrical maps using part of an
existing map.

===Usage===
See help text

===Tips===
* For the most consistent results, keep only one octant
* Don't use ramp tiles at a boundary unless the boundary bisects it perfectly
* The same goes for multi-celled tiles
* Most things aren't implemented, see changelog
* Mirror order can be ignored unless keeping multiple octants
* Many things can only be mirrored in V (aka from left to right or right to
  left), notably cliffs

===Terminology===
* FA2 refers to Final Alert 2
* A map is split into 8 sectors called octants. The octants are labelled 0-7,
  clockwise starting at the north-north-east octant as you see it in game. See
  diagram:
  \   |   /
   \ 7|0 /
    \ | /
   6 \|/ 1
 ----- -----
   5 /|\ 2
    / | \
   / 4|3 \
  /   |   \

* X Y V and H are the axis that we mirror the sectors around. See diagram:
 Y    V    X
  \   |   /
   \  |  /
    \ | /
     \|/
 ----- -----H
     /|\
    / | \
   /  |  \
  /   |   \

===Typical steps to make a symmetrical map===
* Create a new square map in FA2 (as an example, 50x50)
* Mark the centre of the map (50,50)
* Pick an octant to design the map in and do so
* Save map to file
* Call MapMirror, giving it the octant the design is, D for mirror_order,
  the correct theater ini file, the map you've just created, and a new file to
  save the output map to
* Open the newly created map in FA2
* Check for any problems with the mirroring, optionally edit the map further
* Even if you haven't edited the map, RESAVE IT in FA2. MapMirror doesn't
  create a preview, or a digest, or compress the overlay data

===To make a non-square symmetrical map===
* Make a square symmetrical map as normal
* Resize with FA2 to make a centred rectangle