1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156
|
RCS $Id: README,v 1.20 1995/09/29 18:23:25 tuna Exp $
README file for xearth, version 1.0
Kirk Lauritz Johnson <tuna@cag.lcs.mit.edu>
29 September 1995
WHAT IS IT?
Xearth sets the X root window to an image of the Earth, as seen
from your favorite vantage point in space, correctly shaded for
the current position of the Sun. By default, xearth updates the
displayed image every five minutes; the time between updates can
be changed using either X resources or a command line
option. Xearth can also render directly into PPM and GIF files
instead of drawing in the root window; see the man page for
details.
See the HISTORY file for a list of changes since earlier versions
of xearth.
IMPORTANT!
This version of xearth (version 1.0) is an evolution of the only
version(s) of xearth that I ever released (versions 0.5, 0.9,
0.91, and 0.92). Unfortunately, after I released version 0.5, some
net.weenies chose to make some minor mods (and introduce bugs!)
and "release" a bogus version 0.6 without even notifying or
consulting with me; this may be the version of xearth that you are
currently using.
Some of the command line options supported in the bogus version
0.6 (e.g, those having to do with "geostatic") don't exist in this
version -- their functionality (and more!) is available through
other means. In addition, the meaning and syntax of some of the
xearth command line options have changed, so you should probably
give the new man page a good reading if things don't seem to be
working as you expect.
WHERE TO GET IT?
The latest-and-greatest version of xearth should be available via
anonymous ftp from cag.lcs.mit.edu:/pub/tuna (or, for those web
surfers out there, via a link from the xearth WWW home page
http://cag-www.lcs.mit.edu/~tuna/xearth/index.html).
NOTES
If you are trying to build xearth under SunOS 4.x using /bin/cc,
make sure to read the section of the INSTALL file entitled
"BUILDING UNDER SUNOS 4.x" regarding a compiler bug.
There are a number of improvements that I'd love to make, but I
really should be working on my thesis instead of hacking on this.
The map information used in xearth was derived from the "CIA World
Data Bank II map database," as taken from some "cbd" files that
were apparently originally generated by Brian Reid at DEC WRL.
Running in the background on a SPARCstation 5/70, xearth requires
five to seven CPU seconds each time it redraws an image in the
root window. With the default time-between-redraws of 300 seconds,
I simply don't notice the extra CPU load. Your mileage may vary,
of course, especially on slower machines.
The Graphics Interchange Format(c) is the Copyright property of
CompuServe Incorporated. GIF(sm) is a Service Mark property of
CompuServe Incorporated.
Thanks to Robert Berger for allowing me to include his nifty Gamma
Measurement Image and associated text in the xearth source
distribution.
Thanks to Jamie Zawinski for suggesting that I look at his
xscreensaver package for a good example of how to use the resource
and command line option parts of Xt; his code saved me piles of
lossage.
Thanks to Chris Metcalf for the -bigstars stuff, a pile of general
source code cleaning, and spell checking everything carefully.
Thanks to Chris Hayward, Chris Metcalf, Sherman Mui, Dan Rich, and
Leonard Zubkoff for giving the pre-release of version 1.0 a test
drive.
Kudos to Jef Poskanzer for his excellent PBMPLUS toolkit.
Finally, thanks to everybody that sent encouragement, suggestions,
and patches. Apologies to the many people whose good ideas didn't
make it into this release.
IDEAS FOR FUTURE WORK
Better error recovery (better than "assert()", anyway).
Add options/resources that specify colors other than the default
green, blue, red, white, and black.
Code for tracking real-life orbits ("-pos hubble").
Support for supersampling/antialiasing.
AUTHOR
Kirk Johnson <tuna@cag.lcs.mit.edu>
Patches, bug reports, and suggestions are welcome, although I
can't guarantee that I'll get around to doing anything about them
in a timely fashion.
LEGAL STUFF
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.
Unisys Corporation holds worldwide patent rights on the Lempel Zev
Welch (LZW) compression technique employed in the CompuServe GIF
image file format as well as in other formats. Unisys has made it
clear, however, that it does not require licensing or fees to be
paid for freely distributed, non-commercial applications (such as
xearth) that employ LZW/GIF technology. Those wishing further
information about licensing the LZW patent should contact Unisys
directly at (lzw_info@unisys.com) or by writing to
Unisys Corporation
Welch Licensing Department
M/S-C1SW19
P.O. Box 500
Blue Bell, PA 19424
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.
|