Xplanet 0.90

Xplanet now uses its own simple graphics file library to read, resize,
and write image files.  Currently gif, jpg, png, pnm, and tiff formats
are supported.  Make sure you have at least one of these libraries
installed on your computer before compiling Xplanet.  Writing of BMP
images works on little-endian machines.

Either OpenGL (www.opengl.org) or Mesa (www.mesa3d.org), along with
GLUT (http://reality.sgi.com/opengl/#glut), should be installed.  If
you don't have these libraries and don't want to install them, you can
use the --disable-animation option of the configure script, described
below.  As of Mesa 3.1, the graphics libraries are named libGL and
libGLU instead of libMesaGL and libMesaGLU.  If you're using an older
version of Mesa, edit the Makefile to link to -lMesaGL and -lMesaGLU
instead of -lGL -lGLU.

On some systems, the configure script might not find the OpenGL or
GLUT libraries even though they're installed in standard
locations. This might be because the GL libraries depend on different
X libraries than are assumed in the configure script.  In those cases,
try passing --with-glut or --with-gl to the configure script, and the
script will assume the libraries exist and won't check for them.
Compilation of Xplanet might fail if the proper X libraries aren't
included in the Makefile; you'll have to add them by hand.

Xplanet works without a DISPLAY variable set if you want to output to
a file.  Text annotation will not work in this case unless Xplanet has
been compiled with either the FreeType 2 or ImageMagick libraries.  If
the program freetype-config is in your PATH, FreeType support will be
compiled in by default.  If you want to compile with ImageMagick, use
the --with-magick option to the configure script and make sure that
the program Magick++-config is in your PATH.  In this case FreeType
support is disabled.  Xplanet may not compile successfully with
versions of ImageMagick earlier than 5.2.7.  I strongly discourage
anyone from compiling with ImageMagick support unless you have a
compelling reason to do so.  FreeType works *much* faster (6 seconds
versus 2 minutes for one timing test!).

Xplanet works fine with X11 with Darwin.  Under Mac OS X with Aqua,
pass the --with-aqua option to the configure script.  Currently, only
the -animate option works with Aqua.

If you have Microsoft Windows and have the Cygwin environment
installed (www.cygwin.com), use the --with-mswin option within Cygwin.

All that being said, the usual sequence of "./configure; make" should
build the program.  Additional options to the configure script are:

  --with-x               use the X window system [yes]
  --with-mswin           use Microsoft Windows [no]
  --with-auxdir=DIR      subdirectory under PREFIX containing map and 
			 marker files [share/xplanet]
  --with-map-extension=EXTENSION
                         use EXTENSION as default map extension [jpg]
  --with-freetype        Use Freetype libraries for TrueType font
			 support [yes]
  --with-gif             Enable GIF support [yes]
  --with-jpeg            Enable JPEG support [yes]
  --with-png             Enable PNG support [yes]
  --with-pnm             Enable PNM support [yes]
  --with-tiff            Enable TIFF support [yes]
  --with-magick          Use ImageMagick libraries [no]
  --with-animation       Enable --animation option (OpenGL/Mesa 
                         must be installed in this case) [yes]
  --with-gl              Assume GL libraries exist [no]
  --with-glut            Assume GLUT libraries exist [no]
  --with-gl-dir=DIR      Location of OpenGL/Mesa headers and libraries
  --with-glut-dir=DIR    Location of GLUT headers and libraries

In the event autoconf doesn't work for you, I've also supplied a
Makefile.  Check to see that the flags all point to the proper
directories and libraries.  If you compile xplanet on a new platform,
I'd appreciate hearing about it.

In order to run Xplanet, you'll need at least one map file.  Some good
sources are: 
The Xglobe & Xplanet Maps page (www.radcyberzine.com/xglobe)
Whole-Earth Images (www.vterrain.org/Imagery/whole_earth.html)
The Ssystem Home Page (www.wam.umd.edu/~kamelkev/Ssystem)
JPL's Maps of the Solar System (maps.jpl.nasa.gov)
The Planetary Maps Hub (www.lancs.ac.uk/postgrad/thomasc1/render/maps.htm)

If no image is specified with the -image option, Xplanet looks in the
directory specified by the -mapdir option (if this option is used),
and then the current directory.  If no appropriate image file is
found, Xplanet will search the directory specified at compilation time
(usually /usr/local/share/xplanet/images or
/usr/X11R6/share/xplanet/images for the precompiled rpm) for the file
to use as the day map.  This file should be named body.extension,
where body can be mercury, venus, earth, moon, mars, jupiter, io,
europa, ganymede, callisto, saturn, titan, uranus, neptune, or pluto.
The extension of the file by default is jpg but this can be changed
using the --with-map-extension option to the configure script.

A useful trick I've found with configure is that if you set your
CPPFLAGS and LIBS environment variables, configure will search the
appropriate directories.  For example, RedHat Linux puts the Mesa
header files and libraries under /usr/X11R6 and the ImageMagick header
files in /usr/X11R6/include/X11/magick although Magick-config reports
the include directory as /usr/X11R6/include.  So under csh,
    setenv CPPFLAGS "-I/usr/X11R6/include/X11"
    setenv LIBS "-L/usr/X11R6/lib"
    ./configure --with-magick
should do the job.

Other OS dependent things:
On Digital Unix, with the native C++ compiler, compile with the option
-ieee_with_no_inexact.  

Solaris: with gcc 2.95.2, compile with the flag -fpermissive.  The
configure script should add this for you.
The Sun Workshop C++ compiler doesn't like the FreeType headers.  Use
gcc or don't use FreeType (--with-freetype=no in the configure script).

Hari Nair
hari@alumni.caltech.edu
