
XGLOBE 0.1
Thorsten Scheuermann <tscheuermann@usa.net>
10. December 1998


ABOUT XGLOBE:

XGlobe displays the earth from your favourite point in space, similar to
Xearth. The difference is that XGlobe uses a world map image which is mapped
to the globe. This can look pretty good depending on the map.

The XGlobe distribution does not contain any maps because I didn't find any
free ones. You can get maps usable with XGlobe on the net. See README.maps
for details.

XGlobe should work correctly when using virtual screens especially with KDE
(use -kde option).


INSTALLATION:

You need the Qt library (available at http://www.troll.no) version 1.4 or
later in order to build XGlobe.

- Edit the directory definitions in "Makefile"
- type "make" to build xglobe
- type "make install" to install the required files
- if you have the files map.bmp and mapnight.bmp type "make install-maps"

XGlobe has only been tested with Linux. If you are successful getting it
to work on other platforms, please tell me so.


CONFIGURATION AND USE:

Configuration is done through command line options.
Type 'xglobe -help' for an explanation of these options.


USING CUSTOM MAPS:

- For the image to the mapped correctly, position 0N 0W must be in the
  center of the image and the latitude must be linear from 90N to 90S.
- When using a night map, make sure that day and night map have the same
  dimensions.


LICENSE:

Copyright (C) 1998 Thorsten Scheuermann

This program is licensed under the terms of the GNU GPL, with the
exception that it may be compiled and linked with the TrollTech QT
library without implying that any of the rights or restrictions
associated with the GPL are applied to the QT library.

The code in 'sunpos.cpp' and the location-marker data is taken from Xearth
by Kirk Lauritz Johnson.
(Xearth Homepage: http://www.cs.colorado.edu/~tuna/xearth/index.html)

His Copyright notice:

<begin quote>

    Copyright (C) 1989, 1990, 1993, 1994, 1995 Kirk Lauritz Johnson

    Parts of the source code (as marked) are:
      Copyright (C) 1989, 1990, 1991 by Jim Frost
      Copyright (C) 1992 by Jamie Zawinski <jwz@lucid.com>

    Permission to use, copy, modify and freely distribute xearth for
    non-commercial and not-for-profit purposes is hereby granted
    without fee, provided that both the above copyright notice and
    this permission notice appear in all copies and in supporting
    documentation.

<end quote>

The author makes no representations about the suitability of this software 
for any purpose. It is provided "as is" without express or implied warranty.

THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.


CONTACT:

Send questions, comments, patches and enhancements to tscheuermann@usa.net.

XGlobe Homepage: http://www.uni-karlsruhe.de/~uddn/xglobe
