Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
View | Details | Raw Unified | Return to bug 277937 | Differences between
and this patch

Collapse All | Expand All

(-)a/trunk/src/Satellite.cpp (+1 lines)
Lines 1-4 Link Here
1
#include <clocale>
1
#include <clocale>
2
#include <cstdio>
2
#include <cstring>
3
#include <cstring>
3
#include <iostream>
4
#include <iostream>
4
using namespace std;
5
using namespace std;
(-)a/trunk/src/Separation.cpp (+1 lines)
Lines 1-4 Link Here
1
#include <cmath>
1
#include <cmath>
2
#include <cstdio>
2
#include <iostream>
3
#include <iostream>
3
4
4
#include "Separation.h"
5
#include "Separation.h"
(-)a/trunk/xplanet.1 (-57 / +57 lines)
Lines 31-37 dec1 ra1 dec2 ra2 Link Here
31
.sp
31
.sp
32
.fi
32
.fi
33
where declination is in degrees and right ascension is in hours.  This
33
where declination is in degrees and right ascension is in hours.  This
34
option has no effect if -projection is specified.
34
option has no effect if \-projection is specified.
35
35
36
.TP
36
.TP
37
.B \-arc_spacing spacing
37
.B \-arc_spacing spacing
Lines 48-55 use the arc_thickness option there too. Link Here
48
.TP
48
.TP
49
.B \-background background_file
49
.B \-background background_file
50
Use background_file as the background image, with the planet to be
50
Use background_file as the background image, with the planet to be
51
superimposed upon it.  A color may also be supplied (e.g. -background
51
superimposed upon it.  A color may also be supplied (e.g. \-background
52
"navy blue" or -background 0xff00ff).
52
"navy blue" or \-background 0xff00ff).
53
53
54
.TP
54
.TP
55
.B \-base_magnitude magnitude
55
.B \-base_magnitude magnitude
Lines 67-86 miranda, ariel, umbriel, titania, oberon, neptune, triton, nereid, Link Here
67
pluto, charon, random, and major.  
67
pluto, charon, random, and major.  
68
68
69
The field of view can also be centered on a satellite location using
69
The field of view can also be centered on a satellite location using
70
"naif" or "norad", along with the satellite id.  For example, "-body
70
"naif" or "norad", along with the satellite id.  For example, "\-body
71
naif-82" will center the field of view on NAIF ID -82, which is the
71
naif-82" will center the field of view on NAIF ID \-82, which is the
72
Cassini orbiter.  Xplanet must be compiled with SPICE support and the
72
Cassini orbiter.  Xplanet must be compiled with SPICE support and the
73
required kernels must be present.  See the README in the spice
73
required kernels must be present.  See the README in the spice
74
subdirectory for more details.  Using "-body norad20580" will center
74
subdirectory for more details.  Using "\-body norad20580" will center
75
the field of view on NORAD ID 20580, which is the Hubble Space
75
the field of view on NORAD ID 20580, which is the Hubble Space
76
Telescope.  The appropriate TLE files must be present in this case.
76
Telescope.  The appropriate TLE files must be present in this case.
77
See the README in the satellites subdirectory for more information.
77
See the README in the satellites subdirectory for more information.
78
78
79
Using "path" will center the field of view on the direction of motion
79
Using "path" will center the field of view on the direction of motion
80
of the origin.  This direction is relative to the direction of motion
80
of the origin.  This direction is relative to the direction of motion
81
of the body specified by -path_relative_to.
81
of the body specified by \-path_relative_to.
82
82
83
Earth is the default body.  This option is the same as -target.
83
Earth is the default body.  This option is the same as \-target.
84
84
85
.TP
85
.TP
86
.B \-center +x+y
86
.B \-center +x+y
Lines 92-104 negative. The default value is the center of the screen. Link Here
92
.B \-color color
92
.B \-color color
93
Set the color for the label.  The default is "red".  Any color in the
93
Set the color for the label.  The default is "red".  Any color in the
94
rgb.txt file may be used.  Colors may also be specified by RGB hex
94
rgb.txt file may be used.  Colors may also be specified by RGB hex
95
values; for example -color 0xff and -color blue mean the same thing,
95
values; for example \-color 0xff and \-color blue mean the same thing,
96
as do -color 0xff0000 and -color red.
96
as do \-color 0xff0000 and \-color red.
97
97
98
.TP
98
.TP
99
.B \-config config_file
99
.B \-config config_file
100
Use the configuration file config_file.  The format of config_file is
100
Use the configuration file config_file.  The format of config_file is
101
described in README.config.  See the description of -searchdir to see
101
described in README.config.  See the description of \-searchdir to see
102
where xplanet looks in order to find the configuration file.
102
where xplanet looks in order to find the configuration file.
103
103
104
.TP
104
.TP
Lines 116-122 representation. Link Here
116
.TP
116
.TP
117
.B \-dynamic_origin file
117
.B \-dynamic_origin file
118
Specify an observer location.  The location is relative to the body
118
Specify an observer location.  The location is relative to the body
119
specified with -origin (by default, this is the Sun).  The last line
119
specified with \-origin (by default, this is the Sun).  The last line
120
of the file must be of the form
120
of the file must be of the form
121
.nf
121
.nf
122
.sp
122
.sp
Lines 126-132 YYYYMMDD.HHMMSS range lat lon localtime Link Here
126
For example,
126
For example,
127
.nf
127
.nf
128
.sp
128
.sp
129
19951207.120000     10.328   -3.018   97.709    9.595
129
19951207.120000     10.328   \-3.018   97.709    9.595
130
.sp
130
.sp
131
.fi
131
.fi
132
The specified time is ignored and the current time is used.  The range
132
The specified time is ignored and the current time is used.  The range
Lines 134-140 is in planetary radii, and lat and lon are in degrees. Localtime (in Link Here
134
hours) is optional, but if present, it will be used in place of the
134
hours) is optional, but if present, it will be used in place of the
135
longitude.  Only the last line of the file is used.  This file may be
135
longitude.  Only the last line of the file is used.  This file may be
136
updated between renderings using a script executed with the
136
updated between renderings using a script executed with the
137
-prev_command or -post_command options.
137
\-prev_command or \-post_command options.
138
138
139
.TP
139
.TP
140
.B \-ephemeris_file filename
140
.B \-ephemeris_file filename
Lines 144-156 for computing planetary positions. Xplanet uses Bill Gray's code Link Here
144
little endian binary files.  The ephemeris files found at
144
little endian binary files.  The ephemeris files found at
145
ftp://ssd.jpl.nasa.gov/pub/eph/export/unix are big endian files, but
145
ftp://ssd.jpl.nasa.gov/pub/eph/export/unix are big endian files, but
146
you do not need to do any additional byte-swapping to use them.  See
146
you do not need to do any additional byte-swapping to use them.  See
147
the description of -searchdir to see where xplanet looks in order to
147
the description of \-searchdir to see where xplanet looks in order to
148
find the ephemeris file.
148
find the ephemeris file.
149
149
150
.TP
150
.TP
151
.B \-font fontname 
151
.B \-font fontname 
152
Set the font for the label.  Only TrueType fonts are supported.  If
152
Set the font for the label.  Only TrueType fonts are supported.  If
153
the -pango option is used, fontname is taken to be the font family
153
the \-pango option is used, fontname is taken to be the font family
154
name (e.g. "Arial").
154
name (e.g. "Arial").
155
155
156
.TP
156
.TP
Lines 168-176 xplanet in the background. Link Here
168
168
169
.TP
169
.TP
170
.B \-fov
170
.B \-fov
171
Specify the field of view, in degrees.  This option and the -radius
171
Specify the field of view, in degrees.  This option and the \-radius
172
option are mutually exclusive.  This option has no effect if the
172
option are mutually exclusive.  This option has no effect if the
173
-projection option is used.
173
\-projection option is used.
174
174
175
.TP
175
.TP
176
.B \-geometry string
176
.B \-geometry string
Lines 179-185 syntax, [<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>] Link Here
179
(e.g. 256x256-10+10 puts a window 256x256 pixels in size 10 pixels
179
(e.g. 256x256-10+10 puts a window 256x256 pixels in size 10 pixels
180
away from the right side and 10 pixels below the top of the root
180
away from the right side and 10 pixels below the top of the root
181
window).  The root window outside of the image will be black.  This
181
window).  The root window outside of the image will be black.  This
182
option may be used with -window or -output.
182
option may be used with \-window or \-output.
183
183
184
.TP
184
.TP
185
.B \-glare radius
185
.B \-glare radius
Lines 188-194 larger than the sun. The default value is 28. Link Here
188
188
189
.TP
189
.TP
190
.B \-gmtlabel
190
.B \-gmtlabel
191
Same as the -label option, but show GMT instead of local time.
191
Same as the \-label option, but show GMT instead of local time.
192
192
193
.TP
193
.TP
194
.B \-grs_longitude lon
194
.B \-grs_longitude lon
Lines 213-219 with the X Screensaver extension. Link Here
213
213
214
.TP
214
.TP
215
.B \-interpolate_origin_file
215
.B \-interpolate_origin_file
216
This option is only useful in conjunction with -origin_file.  It
216
This option is only useful in conjunction with \-origin_file.  It
217
computes the observer position at the current time by interpolating
217
computes the observer position at the current time by interpolating
218
between values specified in the origin file.  This is useful if you
218
between values specified in the origin file.  This is useful if you
219
have spacecraft positions tabulated in an origin file, but want a real
219
have spacecraft positions tabulated in an origin file, but want a real
Lines 232-243 Display a label in the upper right corner. Link Here
232
Specify the location of the label using the standard X window geometry
232
Specify the location of the label using the standard X window geometry
233
syntax.  The default position is "-15+15", or 15 pixels to the left
233
syntax.  The default position is "-15+15", or 15 pixels to the left
234
and below the top right corner of the display.  This option implies
234
and below the top right corner of the display.  This option implies
235
-label. 
235
\-label. 
236
236
237
.TP
237
.TP
238
.B \-label_body body
238
.B \-label_body body
239
Use the specified body to calculate the sub-observer, sub-solar, and
239
Use the specified body to calculate the sub-observer, sub-solar, and
240
illumination values in the label.  This is useful with the -separation
240
illumination values in the label.  This is useful with the \-separation
241
option.
241
option.
242
242
243
.TP
243
.TP
Lines 268-284 magnitude 3. A larger number makes stars brighter. Link Here
268
.B \-longitude longitude 
268
.B \-longitude longitude 
269
Place the observer above the specified longitude (in degrees).
269
Place the observer above the specified longitude (in degrees).
270
Longitude is positive going east, negative going west (for the earth
270
Longitude is positive going east, negative going west (for the earth
271
and moon), so for example Los Angeles is at -118 or 242.  The default
271
and moon), so for example Los Angeles is at \-118 or 242.  The default
272
value is 0.
272
value is 0.
273
273
274
.TP
274
.TP
275
.B \-make_cloud_maps
275
.B \-make_cloud_maps
276
If there is an entry in the config file for cloud_map, xplanet will
276
If there is an entry in the config file for cloud_map, xplanet will
277
output a day and night image with clouds overlaid and then exit.  The
277
output a day and night image with clouds overlaid and then exit.  The
278
images will be created in the directory specified by -tmpdir, or in
278
images will be created in the directory specified by \-tmpdir, or in
279
the current directory if -tmpdir is not used.  The names of the output
279
the current directory if \-tmpdir is not used.  The names of the output
280
images default to day_clouds.jpg and night_clouds.jpg, but may be
280
images default to day_clouds.jpg and night_clouds.jpg, but may be
281
changed by the -output option.  If "-output filename.extension" is
281
changed by the \-output option.  If "\-output filename.extension" is
282
specified, the output images will be named "day_filename.extension"
282
specified, the output images will be named "day_filename.extension"
283
and "night_filename.extension".  The dimensions of the output images
283
and "night_filename.extension".  The dimensions of the output images
284
are the same as the day image.
284
are the same as the day image.
Lines 290-300 the background stars. The format of each line is generally Link Here
290
declination, right ascension, string, as in the example below:
290
declination, right ascension, string, as in the example below:
291
.nf
291
.nf
292
.sp
292
.sp
293
-16.7161 6.7525 "Sirius"
293
\-16.7161 6.7525 "Sirius"
294
.sp
294
.sp
295
.fi
295
.fi
296
For additional options which may be specified, see the marker_file
296
For additional options which may be specified, see the marker_file
297
entry in README.config.  This option has no effect if -projection is
297
entry in README.config.  This option has no effect if \-projection is
298
specified.  This option is not meant for city markers; for that use
298
specified.  This option is not meant for city markers; for that use
299
the marker_file option in the configuration file.
299
the marker_file option in the configuration file.
300
300
Lines 321-329 Valid values for north_type are: Link Here
321
body:        body's north pole
321
body:        body's north pole
322
galactic:    galactic north pole
322
galactic:    galactic north pole
323
orbit:       body's orbital north pole (perpendicular to the orbit plane)
323
orbit:       body's orbital north pole (perpendicular to the orbit plane)
324
path:        origin's velocity vector  (also see -path_relative_to option)
324
path:        origin's velocity vector  (also see \-path_relative_to option)
325
separation:  perpendicular to the line of sight and the
325
separation:  perpendicular to the line of sight and the
326
	     target-separation target line (see -separation option)
326
	     target-separation target line (see \-separation option)
327
.sp
327
.sp
328
.fi
328
.fi
329
The default value is "body".
329
The default value is "body".
Lines 335-341 Run num_times before exiting. The default is to run indefinitely. Link Here
335
.TP
335
.TP
336
.B \-origin body
336
.B \-origin body
337
Place the observer at the center of the specified body.  Valid values
337
Place the observer at the center of the specified body.  Valid values
338
are the same as for -target.  In addition, "above", "below", or
338
are the same as for \-target.  In addition, "above", "below", or
339
"system" may be specified.  Using "above" or "below" centers the view
339
"system" may be specified.  Using "above" or "below" centers the view
340
on the body's primary and the field of view is large enough to show
340
on the body's primary and the field of view is large enough to show
341
the body's orbit.  Using "system" places the observer at the center of
341
the body's orbit.  Using "system" places the observer at the center of
Lines 351-365 in the same system if one of the following is true: Link Here
351
If the body name is preceded by a dash, the observer is placed on the
351
If the body name is preceded by a dash, the observer is placed on the
352
opposite side of the target from the specified body at a distance
352
opposite side of the target from the specified body at a distance
353
equal to the distance between the target and body.  For example,
353
equal to the distance between the target and body.  For example,
354
-target earth -origin sun places the observer at the center of the
354
\-target earth \-origin sun places the observer at the center of the
355
sun.  If -target earth -origin -sun is used, the observer is placed on
355
sun.  If \-target earth \-origin \-sun is used, the observer is placed on
356
a line connecting the centers of the earth and sun at a distance of 1
356
a line connecting the centers of the earth and sun at a distance of 1
357
AU farther from the sun than the earth.
357
AU farther from the sun than the earth.
358
358
359
.TP
359
.TP
360
.B \-origin_file origin_file
360
.B \-origin_file origin_file
361
Specify a list of observer positions in origin_file.  The positions
361
Specify a list of observer positions in origin_file.  The positions
362
are relative to the body specified with -origin (by default, this is
362
are relative to the body specified with \-origin (by default, this is
363
the Sun).  Each line should be of the form
363
the Sun).  Each line should be of the form
364
.nf
364
.nf
365
.sp
365
.sp
Lines 369-382 YYYYMMDD.HHMMSS range lat lon localtime Link Here
369
For example,
369
For example,
370
.nf
370
.nf
371
.sp
371
.sp
372
19951207.120000     10.328   -3.018   97.709    9.595
372
19951207.120000     10.328   \-3.018   97.709    9.595
373
.sp
373
.sp
374
.fi
374
.fi
375
Range is in planetary radii, and lat and lon are in degrees.  The date
375
Range is in planetary radii, and lat and lon are in degrees.  The date
376
is the only required value.  If the localtime (in hours) is supplied,
376
is the only required value.  If the localtime (in hours) is supplied,
377
it will be used in place of the longitude.  For each line in the
377
it will be used in place of the longitude.  For each line in the
378
origin file, the observer is placed at the specified position,
378
origin file, the observer is placed at the specified position,
379
relative to the body specified with -origin.  This option is useful
379
relative to the body specified with \-origin.  This option is useful
380
for showing spacecraft flybys or orbiting around a planet.  Any line
380
for showing spacecraft flybys or orbiting around a planet.  Any line
381
with a # in the first column is ignored.
381
with a # in the first column is ignored.
382
382
Lines 386-393 Output to a file instead of rendering to a window. The file format is Link Here
386
taken from the extension. Currently .gif, .jpg, .ppm, .png, and .tiff
386
taken from the extension. Currently .gif, .jpg, .ppm, .png, and .tiff
387
images can be created, if xplanet has been compiled with the
387
images can be created, if xplanet has been compiled with the
388
appropriate libraries.  The image size defaults to 512 by 512 pixels
388
appropriate libraries.  The image size defaults to 512 by 512 pixels
389
but this may be changed by the -geometry flag. If used with the
389
but this may be changed by the \-geometry flag. If used with the
390
-num_times option, each output file will be numbered sequentially.
390
\-num_times option, each output file will be numbered sequentially.
391
391
392
.TP
392
.TP
393
.B \-output_start_index index
393
.B \-output_start_index index
Lines 404-410 don't recommend letting xplanet run indefinitely with this option. Link Here
404
404
405
.TP
405
.TP
406
.B \-path_relative_to body
406
.B \-path_relative_to body
407
Only used with -north path or -target path.  The origin's velocity
407
Only used with \-north path or \-target path.  The origin's velocity
408
vector is calculated relative to the specified body.  By default, this
408
vector is calculated relative to the specified body.  By default, this
409
is the Sun.
409
is the Sun.
410
410
Lines 416-422 Run command either before or after each time xplanet renders an image. Link Here
416
On MS Windows, you may need to use unix-style paths.  For example:
416
On MS Windows, you may need to use unix-style paths.  For example:
417
.nf
417
.nf
418
.sp
418
.sp
419
xplanet.exe -prev_command ./prev.bat
419
xplanet.exe \-prev_command ./prev.bat
420
.sp
420
.sp
421
.fi
421
.fi
422
422
Lines 471-478 the -radius option. Link Here
471
.TP
471
.TP
472
.B \-rotate angle 
472
.B \-rotate angle 
473
Rotate the globe by angle degrees counterclockwise so that north (as
473
Rotate the globe by angle degrees counterclockwise so that north (as
474
defined by the -north argument) isn't at the top.  The default value
474
defined by the \-north argument) isn't at the top.  The default value
475
is 0.  My friends in the Southern Hemisphere can use -rotate 180 to
475
is 0.  My friends in the Southern Hemisphere can use \-rotate 180 to
476
make the earth look like it should!  For non-orthographic projections,
476
make the earth look like it should!  For non-orthographic projections,
477
the globe is rotated and then projected, if that helps you visualize
477
the globe is rotated and then projected, if that helps you visualize
478
what to expect.
478
what to expect.
Lines 481-487 what to expect. Link Here
481
.B \-save_desktop_file
481
.B \-save_desktop_file
482
On Microsoft Windows and Mac OS X, xplanet creates an intermediate
482
On Microsoft Windows and Mac OS X, xplanet creates an intermediate
483
image file which is used to set the desktop.  This file will be
483
image file which is used to set the desktop.  This file will be
484
created in the -tmpdir directory.  By default, this image is removed
484
created in the \-tmpdir directory.  By default, this image is removed
485
after the desktop has been set.  Specifying this option will leave the
485
after the desktop has been set.  Specifying this option will leave the
486
file in place.
486
file in place.
487
487
Lines 507-520 DATADIR is set at compile time and defaults to /usr/local/share. Link Here
507
.TP
507
.TP
508
.B \-separation body:dist
508
.B \-separation body:dist
509
Place the observer at a location where the target body and the
509
Place the observer at a location where the target body and the
510
separation body are dist degrees apart.  For example "-target earth
510
separation body are dist degrees apart.  For example "\-target earth
511
-separation moon:-3" means place the observer at a location where the
511
\-separation moon:-3" means place the observer at a location where the
512
moon appears 3 degrees to the left of the earth.
512
moon appears 3 degrees to the left of the earth.
513
513
514
.TP
514
.TP
515
.B \-spice_ephemeris index
515
.B \-spice_ephemeris index
516
Use SPICE kernels to compute the position of the named body.  The
516
Use SPICE kernels to compute the position of the named body.  The
517
index is the naif ID code (e.g. 599 for Jupiter).  The -spice_file
517
index is the naif ID code (e.g. 599 for Jupiter).  The \-spice_file
518
option must be used to supply the names of the kernel files.  This
518
option must be used to supply the names of the kernel files.  This
519
option may be used more than once for different bodies.
519
option may be used more than once for different bodies.
520
520
Lines 544-558 where Declination is in decimal degrees and Right Ascension is in Link Here
544
decimal hours.  For example, the entry for Sirius is
544
decimal hours.  For example, the entry for Sirius is
545
.nf
545
.nf
546
.sp
546
.sp
547
-16.7161  6.7525 -1.46
547
\-16.7161  6.7525 \-1.46
548
.sp
548
.sp
549
.fi
549
.fi
550
See the description of -searchdir to see where xplanet looks in order
550
See the description of \-searchdir to see where xplanet looks in order
551
to find the star map.
551
to find the star map.
552
552
553
.TP
553
.TP
554
.B \-target target
554
.B \-target target
555
Same as -body.
555
Same as \-body.
556
556
557
.TP
557
.TP
558
.B \-tt
558
.B \-tt
Lines 568-580 factor. The default is 1. Link Here
568
.TP
568
.TP
569
.B \-tmpdir tmpdir
569
.B \-tmpdir tmpdir
570
Specify a directory that xplanet will use to place images created
570
Specify a directory that xplanet will use to place images created
571
using -make_cloud_maps.  On Microsoft Windows, xplanet will write
571
using \-make_cloud_maps.  On Microsoft Windows, xplanet will write
572
a bitmap file called xplanet.bmp to the specified directory.  The
572
a bitmap file called xplanet.bmp to the specified directory.  The
573
default is the result of the GetWindowsDirectory call (C:\WINDOWS on
573
default is the result of the GetWindowsDirectory call (C:\WINDOWS on
574
Win95).  On Mac OS X, xplanet will create an intermediate PNG file in
574
Win95).  On Mac OS X, xplanet will create an intermediate PNG file in
575
order to set the background.  The default value is /tmp.  On Windows
575
order to set the background.  The default value is /tmp.  On Windows
576
and Mac OS X, the intermediate file will be removed unless the
576
and Mac OS X, the intermediate file will be removed unless the
577
-save_desktop_file option is specified.
577
\-save_desktop_file option is specified.
578
578
579
.TP
579
.TP
580
.B \-transparency
580
.B \-transparency
Lines 583-594 option only works under X11. Link Here
583
583
584
.TP
584
.TP
585
.B \-transpng filename
585
.B \-transpng filename
586
Same as the -output option, except set the background to be
586
Same as the \-output option, except set the background to be
587
transparent when writing a PNG file.  
587
transparent when writing a PNG file.  
588
588
589
.TP
589
.TP
590
.B \-utclabel
590
.B \-utclabel
591
Same as -gmtlabel.
591
Same as \-gmtlabel.
592
592
593
.TP
593
.TP
594
.B \-verbosity level
594
.B \-verbosity level
Lines 624-636 Update every wait seconds. Link Here
624
.TP
624
.TP
625
.B \-window
625
.B \-window
626
Render the image to its own X window.  The size defaults to 512 by 512
626
Render the image to its own X window.  The size defaults to 512 by 512
627
pixels but this may be set by the -geometry flag.
627
pixels but this may be set by the \-geometry flag.
628
628
629
.TP
629
.TP
630
.B \-window_title title
630
.B \-window_title title
631
Set the window's title to title.  This option implies -window.
631
Set the window's title to title.  This option implies \-window.
632
632
633
.TP
633
.TP
634
.B \-xscreensaver
634
.B \-xscreensaver
635
Same as -vroot.
635
Same as \-vroot.
636
636

Return to bug 277937