view docs/Maps.txt @ 57:35999e551d7a server tip

Call state's update method 2 times per second
author Josef "Jeff" Sipek <jeffpc@josefsipek.net>
date Sun, 03 Jun 2007 01:25:28 -0400
parents 05245904f997
children
line wrap: on
line source

Map pack description:
=====================

By default, maps are located in maps/, but this can be changed in the config
file. In this file, we'll assume that the config file contains the default
settings.

Here is a sample directory structure we'll work with:

maps/
 |-- map1/
 |    |-- map.info
 |    |-- map.png
 |    `-- navaid.info
 |-- map2/
 |    |-- map.info
 |    |-- map.png
 |    `-- navaid.info
 `-- default/
      |-- map.info
      |-- map.png
      `-- navaid.info

As you can see, the maps/ contains directories, one per map. Each of the map
directories contains the three basic files:
 * map.info	= information about the map
 * map.png	= the map "background" image
 * navaid.info	= navigation aids information
Let's look at each of these files individually.

map.info:
=========

There are 5 lines (separated by "\n") they contain the following information:
* number (decimal) of degrees to be added to the longitude. Internally, the
  center of the image is (0,0), but to allow different geographic locations
  this number is simply added whenever we want to display the true longitude
* number (decimal) of degrees to be added to the latitude. Internally, the
  center of the image is (0,0), but to allow different geographic locations
  this number is simply added whenever we want to display the true latitude
* number (decimal) of meters per pixel
* ATC offset from the center of the background image, left is negative, right
  is positive (pixels)
* ATC offset from the center of the background image, down is negative, up is
  positive (pixels)

map.png:
========

A standard, non-transparent 1024x768 PNG image to be used as the map itself.

navaid.info:
============

Contains an unlimited number of navigation aiding beacons. Each beacon takes
up one line (separated by "\n"). Each line can be split by spaces into six
parts:
* beacon offset from the center, left is negative, right is positive (pixels)
* beacon offset from the center, down is negative, up is positive (pixels)
* beacon frequency (MHz)
* beacon name (string)
* beacon range (meters)