Dolomynum v1.0.0
 Copyright (C) 2007  Gergely Ksa
 gergely@euroharmony.com

This software is licensed under the GPL. See license.txt for more info.

For any request or bug report, contact the author via mail. Before contacting, please read the Manual and FAQ to see if your question / problem is answered there. When reporting a bug, please describe the problem as detailed as possible (when did it occur, can you reproduce it, what is your PC config, does the problem appear with similar software like IvAe etc).


THE DOLOMYNUM WINDOW
--------------------

Although all elements were coded in OpenGL, the Dolomynum window was created to resemble a classic Windows window to facilitate operation. However there are some limitations:
- Resizing won't work by dragging the window borders; to resize, click on the button in the bottom right (that resembles a reversed L) and drag the mouse
- Windows cannot be moved and text cannot be copied
- If you have an auto-hiding taskbar, maximizing Dolomynum will prevent the taskbar to appear. To avoid this, you should rather resize the Dolomynum window to cover the screen (minus the taskbar) instead of maximizing it. The program memorizes its last position and size.

To change the colour scheme, modify the ColourTheme line in the [Display] section of dlmn.ini. The schemes are stored in the \colours folder; you can load any of them by changing the ColourTheme line, and create new scemes of your own (either by editing the files in notepad, or using the colour editor in the \tools folder).


DOWNLOADING DATA
----------------

To view the current status of networks, use the buttons in the bottom left:
* Click on the blue button (or press I) to download and display IVAO.aero data
* Click on the green button (or press V) to download and display VATSIM data
* Click on the blue/green (third) button (or press B) to display both networks on the same map. This is only for comparation and not for viewing actual information; functions (e.g. clicks on planes, lists, most Companion functions) will not work in this mode.

There is a delay between two downloads (to protect the servers); you can download new data only if the symbol disappears from the blue/green button.

Auto-download option can be enabled in dlmn.ini - it will download new data in regular intervals of time (3 - 30 minutes) from the last queried network (does not work in 'both networks' mode). It is recommended NOT to enable the auto-download feature in order to prevent wasting bandwidth of the servers; please download data only when you need it and want to look at it.


MAP FUNCTIONS
-------------

Left-click and drag (or Arrows) to pan. Right-click and drag (or use mouse wheel or F11/F12) to zoom.

Function keys for map:
 F1 - toggle all labels
 F2 - toggle Display Friends only
 F3 - toggle arrows for inbounds at airports
 F4 - toggle airport labels
  Shift+F4 - toggle airports
 F5 - toggle ATC labels
  Shift+F5 - toggle ATC
 F6 - toggle plane labels (note: labels are never displayed for planes on the ground, except for friends)
  Shift+F6 - toggle planes

 C - toggle country (political) borders
 G - toggle lat/lon grid

 1, 2, 3 - recall preset views 1, 2 or 3
 Shift + 1, 2, 3 - store current view as presets 1, 2 or 3 (view 1 is the startup view)
 4 - view yourself (if you are online, and set your VID/PID correctly in dlmn.ini)


CLIENTS
-------

Left-click on any ATC/aircraft to view related data, or right-click on any aircraft to view its route. In the ATC/aircraft popup, you can use the buttons to center on it, add as a friend or view profile. Centering works also for 'invisible' clients, e.g. Observers.

To view lists of clients, click on the button with 3 parallel lines in the lower right (or press L). Click anywhere on the list header to change between sorting by callsign (default - e.g. for finding a plane or position, or just a general overview) and sorting by name (e.g. for finding a person). Other sorting options were not considered necessary and were not added.

Click on the button with a diamond shape in the lower right (or press 4) to view yourself if you are online. For this to work, please set your IVAO / VATSIM ID in dlmn.ini under [User].

Press Esc to close all popups/windows.


AIRPORT TRAFFIC
---------------

Shift+Left-click on any airport to view a list (similar to the 'traffic' command in the Companion) or a graphical radar-like representation of its traffic. The radar-mode shows all inbounds (even those who are not within range), and outbounds (within range); except if their speed is 0. The planes on the radar are not clickable (please use the list, map or Companion for more info).

Shift+Right-click on any airport to view inbound/outbound routes on the map.


FRIENDS
-------

You can add members to your Friends list so that you can view later which of them are online without having to search in the complete clients list. You can add a friend in two ways:
- in the ATC or aircraft popup, click on Add Friend to add that member to the list
- open data\friends.dat and add the VIDs/PIDs of your friends (e.g. 128367), one per line

Online friends can be seen on the first page of the Clients list, or press F2 in map view to show only your friends on the map.


COMPANION
---------

The Dolomynum Companion is an always-on-top console that can display various data about online clients, and is thus very useful for controllers and pilots alike - a lot of information can be accessed instantly even when Dolomynum is minimized, instead of having to search lists or to check web pages. It can be displayed by pressing Space in Dolomynum. For Companion commands check companion.txt.


FUTURE DEVELOPMENT
------------------

There are plans to include Scheduling / Booking display of the networks in future versions of Dolomynum.


DISCLAIMER
----------

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 


CREDITS
-------

* Software by Gergely Ksa, coded in Visual Basic 6 + OpenGL
* Uses the 'zlib' library created by Jean-loup Gailly and Mark Adler, licensed under the GPL. DLL support by Alessandro Iacopetti and Gilles Vollant. Support for gzip file decompress added by Kenny Moens (ported from minigz)
* Coastline and country border information created from public domain data, not subject to copyright protection
* Airports, FIRs and FIR boundaries from public domain data