magellan -- Map drawing
=======================

This is a placeholder for the first release.

Building the software
=====================

You will need X libraries, and either paintlib or libjpeg to build
this release. Future releases will support more graphics libraries and
make them optional to build.

To build:

$ ./configure
$ make
$ make install

Using the software
==================

$ magellan configfile

Finding data
============

In order to produce nice-looking "realistic" output, magellan needs
maps. High-detail digital maps of even the Earth (let alone any other
planet) are difficult to come by. The best that I have found so far
are JHT's Planetary Pixel Maps, from

   http://planetpixelemporium.com/planets.html

These are freely downloadable in small(ish) sizes, and cost small
amounts of money for larger sizes. The 1K map of Earth produces
reasonable output. These maps are not distributed with magellan for
both bandwidth and licensing reasons.

Some outline-format data -- altitude contours and time zones -- will
be made available as separate downloads with later magellan releases.
