1Original version written by Frank Solensky <solenskyf@acm.org>,
2updates by Hari Nair <hari@alumni.caltech.edu>
3
4This file is aimed at those who are upgrading from versions of Xplanet
5earlier than 1.0.
6
7Xplanet 1.0 is a completely rewritten program from the older (0.95)
8version.  I should have called it Xplanet2 to avoid confusion, but I
9didn't think of it, and I apologize for any trouble.
10
11The default behaviour of Xplanet is run continuously instead of just
12once. As a result, the "xplanetbg" program is no longer needed.
13
14Xplanet in its default mode will now draw multiple bodies.  For
15example, when drawing Jupiter, any of the Galilean satellites in the
16field of view will also be drawn.  For this reason, options that are
17specific to a body, such as the image map or marker files, are now
18specified in a configuration file.  Options that affect the way the
19image is drawn, such as geometry or label, are still specified on the
20command line.
21
22There is a [default] section at the top of the configuration file.  Be
23careful to specify options that apply to only one planet under that
24planet's section, and not under [default].  For example, a common
25mistake is to put cloud_map=clouds.jpg under [default] and not under
26[earth].  This will overlay clouds on every planet which is probably
27not what you want, and is a huge waste of time!
28
29Input image dimensions should be powers of 2, where the height is half
30the width (e.g. 2048x1024).  Other image dimensions will work, but
31performance will be slower.  Input images are specified in the
32configuration file.
33
34Marker files must now be in UTF-8 encoding.  Font files must now be
35TrueType fonts.
36
37The subdirectories under share/xplanet (e.g. arcs, markers,
38satellites) each contain README and example files for more
39information.
40
41Command line argument changes:
42
43Version 0.95			                    Version 1.0
44------------					    -----------
45-center <x>,<y>					    -center +x+y
46-date "%d %b %Y %H:%M:%S" [specifying local time]   -date YYYYMMDD.HHMMSS [specifying GMT]
47-dayside					    -origin sun
48-earthside					    -origin earth
49-labelformat <string>				    -date_format <string>
50-moonside					    -origin moon
51-nightside					    -origin -sun
52
53
54The following command line options should instead be set as parameters in
55the file specified with the '-config' option or the file "config/default"
56in the '-searchdir' directory.
57
58greatarcfile <file>             arc_file=<file>
59cloud_gamma <number>            cloud_gamma=<number>
60cloud_image <cloud_file>        cloud_map=<file>
61cloud_ssec <cloud_file>		cloud_ssec=true  (Use in conjunction with cloud_map)
62cloud_threshold <number>        cloud_threshold=<number>
63fuzz				twilight=<number>
64grid                            grid=true
65grid1 <number>                  grid1=<number>
66grid2 <number>                  grid2=<number>
67mapbounds <lat1,lon1,lat2,lon2> mapbounds=<lat1,lon1,lat2,lon2>
68markers                         marker_file=<file>
69markerfile                      marker_file=<file>
70night_image <file>              night_map=<file>
71satfile <file>                  satellite_file=<file>
72shade <number>                  shade=<number>
73specular_file <file>            specular_map=<file>
74
75
76Finally, these options are not currently supported:
77
78-animate
79-blend
80-cloud_shade <number>
81-demfile <file>
82-demscale <demscale>
83-fontdir <dir>
84-fullscreen
85-labelname
86-labelrot
87-mapdir <dir>
88-nice <number>
89-notransparency
90-orbit <spec>
91-print_coords
92-root
93-sattrackid <id>
94-spacing <number>
95-start_cloud <file>
96-start_index <number>
97-stop_cloud <file>
98-sunrel <number,number>
99-swap
100-terminator <termtype>
101-truetype
102