1
Original version written by Frank Solensky <solenskyf@acm.org>,
2
updates by Hari Nair <hari@alumni.caltech.edu>
4
This file is aimed at those who are upgrading from earlier versions of
7
The first thing you should be aware of is that the default behaviour
8
of xplanet is to change the display of the root window. As a result,
9
the "xplanetbg" program is no longer needed and should be removed.
10
To get the same behavior as xplanetbg, run xplanet as a background
11
process and ignore output ("xplanet [options] 2>/dev/null &")
13
The command line interface has changed significantly as well. The
14
format of some options has been changed while other options may only
15
be specified in the configuration file. If an option isn't described
16
in this file, it can be used as before.
18
Input image dimensions should be powers of 2, where the height is half
19
the width (e.g. 2048x1024). Other image dimensions will work, but
20
will be slower and may not look as good. Input images are specified
21
in the configuration file.
23
Command line argument changes:
25
Version 0.95 Version 1.0
26
------------ -----------
27
-center <x>,<y> -center <x><+y>
28
-date "%d %b %Y %H:%M:%S" [specifying local time]
29
-date %Y%b%d.%H%M%S [specifying GMT]
31
-earthside -origin earth
32
-labelformat <string> -date_format <string>
33
-moonside -origin moon
34
-nightside -origin -sun
37
The following command line options should instead be set as parameters in
38
the file specified with the '-config' option or the file "config/default"
39
in the '-searchdir' directory.
41
greatarcfile <file> arc_file=<file>
42
cloud_gamma <number> cloud_gamma=<number>
43
cloud_image <cloud_file> cloud_map=<file>
44
cloud_threshold <number> cloud_threshold=<number>
46
grid1 <number> grid1=<number>
47
grid2 <number> grid2=<number>
48
mapbounds <lat1,lon1,lat2,lon2> mapbounds=<lat1,lon1,lat2,lon2>
49
markers marker_file=<file>
50
markerfile marker_file=<file>
51
night_image <file> night_map=<file>
52
satfile <file> satellite_file=<file>
53
shade <number> shade=<number>
54
specular_file <file> specular_map=<file>
57
Finally, these options are not currently supported
81
-sunrel <number,number>
83
-terminator <termtype>