Trees visualization user guide
==============================

Map editor
----------

With the map editor, you can create and edit maps.
Maps are stored as json files on your computer.
To open an existing map file, drag it into the window.
Enter the file name into the text box, and save with the button or Ctrl+S.
If you use a Chromium-based browser, you can save your changes in the file you opened, rather than downloading a new file.

You can zoom the map using the scroll wheel, and pan it by dragging with the middle mouse button, or by scrolling while holding the Ctrl key.
If you have a touch screen, you can pan and zoom with two fingers.

With the + button, you can toggle the add mode.
You can also press and hold the Alt key to quickly enter add mode.
If add mode is active, you can add nodes to the map by clicking into an empty spot.
You can add edges either by clicking the start and then the end node, or click and hold while drawing an edge.
To delete an existing edge, just draw it again.

If add mode is inactive, you can select nodes by clicking on them.
When a node is selected, a side panel opens, where you change its settings.
You can select multiple nodes if you hold down Ctrl and click on nodes, or using rectangle selection.

You can only save a map if it is valid.
A map is valid if the graph is connected, an both start nodes are set.

Log playback
------------

Drop a log file into the window to open it.

You can play/pause by pressing Space, and navigate with the left and right arrow keys.
You can also navigate between rounds with the page up and page down keys, and navigate to the start or end with the home and end keys.

Each round is displayed in five frames.

1. Current ownership is displayed by node colors
2. Income is added to the stockpile
3. Planted saplings of player 1 are revealed.
   The part above the center shows how many saplings were planted.
   The part below in a darker color shows how many saplings were lost on the way.
4. Planted saplings of player 2 are revealed.
5. The round is evaluated: The lost "bids" are dimmed, and the new points and income are displayed.
