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