XGlobe 0.5 command line options:

-pos pos_spec  pos_spec consists of one of the keywords "fixed", "sunrel",
               "random" or "orbit", possibly followed by additional arguments:
               fixed: Followed by two numerical arguments latitude and
                 longitude (given in decimal degrees) of a viewing position.
                 - positive lat. - north of equator
                 - negative lat. - south of equator
                 - positive long. - east of prime meridian
                 - negative long. - west of prime meridian
               sunrel: Followed by to numerical arguments lat. and long.,
                 indicating offsets of current sun position.
               moonpos: Viewing position follows current moon position.
               random: selects a random viewing position each time a frame is
                 redrawn.
               orbit:  The position specifier keyword orbit should be followed
                 by three arguments, interpreted as numerical values indicating
                 the period (in hours), orbital inclination (in decimal degrees)
                 of a simple circular orbit, and an experimental shift modifier
                 that adjusts the orbit with each circuit; the viewing position
                 follows this orbit.
                 Astute  readers will surely note that these parameters are not
                 sufficient to uniquely specify a single circular orbit. This
                 problem is solved by limiting the space of possible orbits to
                 those positioned over 0 degrees latitude, 0 degrees longitude
                 at time zero (the Un*x epoch, see time(3)).
               Examples explaining characters to delimit specifier components:
                  -pos 'fixed 30.0 40.53'
                  -pos sunrel,-12.3,130
                  -pos fixed/20.0/30.0}
                  -pos 'orbit 4.2 26.3'
               (default: -pos 'sunrel 0 0')

-wait secs     Specifies the interval in seconds between screen updates.
               (default: -wait 300)

-mag factor    Specifies the size of the globe in relation to the screen size.
               The diameter of the globe is factor times the shorter of the
               width and height of the screen.
               (default: -mag 1.0)

-rot angle     A positive angle rotates the globe clockwise, a negative one
               counterclockwise.

-markers       Enable displaying of built-in display markers.
-nomarkers     Disable displaying of built-in display markers.
               (default: -marker)

-markerfile file  Load an additional location marker file. (Have a look at
                  file "xglobe-markers" for reference.)

-label         Enable displaying of label indicating current date and time etc.
-nolabel       Disable displaying of label
               (default: -label)

-labelpos geom  geom specifies the screen location of the label.
                Syntax: {+-}<xoffset>{+-}<yoffset>
                   positive xoffset - offset from right display edge
                   negative xoffset - offset from left display edge
                   positive yoffset - offset from top display edge
                   negative yoffset - offset from bottom display edge
                (default: -labelpos -5+5)

-ambientlight level  Indicates how the dark side of the globe appears:
                     0 means totally black, 100 means totally bright (= no
                     difference between day and night side).
                     (default: -ambientlight 15)

-ambientrgb rgblevel Works like -ambientlight but takes 3 parameters (red,
                     green and blue value) defining the color of ambient
                     light. This can be useful in conjunction with a night
                     map that is tinted towards blue, for example. Using a
                     blueish ambient light makes the transition from day to
                     night look better.
                     Use either -ambientlevel or -ambientrgb, not both.
                     (example: -ambientrgb "1 4 20"  - This will make the
                     night side appear blueish.)

-nice priority Run the xglobe process with the given priority (see nice(1) and
               setpriority(2) manual pages).

-nightmap      Use default night world map for the night side. The switch
               -ambientlight will be ignored.
-nonightmap    Disable use of night map.

-mapfile file  Use another than the default world map. Supported image formats:
               BMP, GIF, XBM, XPM and PNM

-nightmapfile file  Same as -mapfile, but for the night map.

-cloudmapfile file  Same as -mapfile, but for the cloud map.

-cloudfilter n Used in conjunction with -cloudmapfile, this controls how much
               cloud is displayed.  n is a value between 0 and 255, where 0
               will show all cloud, and 255 will only show the brightest clouds.
               The default value is 110.
-backg file    Use the image in file as the screen background, instead of a
               black screen, which is the default.

-tiled         The background image specified using -backg is by default
               expanded to fill the screen.  This option will cause it to
               be tiled instead.

-kde           Use this option when the globe disappears after switching
               virtual screens. This is needed when using KDE.

-dump          Saves the rendered image to the file specified with the -outfile
               option (default: "xglobe-dump.bmp") instead of displaying it
               on screen.

-dumpcmd cmd   Saves the rendered image to "xglobe.bmp" in the current
               directory, then executes "cmd", passing the image filename
               as an argument, eg '-dumpcmd Esetroot'.

-outfile file  Specifies the output file name for the -dump option.

-once          With this option, XGlobe renders an image once and exits.

-grid          Enable displaying of grid on the globe.
-nogrid        Disable displaying of grid on the globe.
-newgrid       Enable displaying of a more fancy grid.

-grid1 grid1   Specify the spacing of major grid lines: they are drawn with a
               90/grid1 degree spacing.
               (default: -grid1 6 which corresponds to 15 between grid lines)

-grid2 grid2   Specify spacing of dots along major grid lines. Along the
               equator and lines of longitude, grid dots are drawn with a
               90/(grid1 x grid2) degree spacing.
               (default: -grid2 15 which corresponds, along with -grid1 6,
               to a 1 spacing)

-timewarp factor  Scale the apparent rate at which time progresses by 'factor'.
                  (default: -timewarp 1.0)

-size size_spec Specify the size of the image to be rendered (useful in
                conjuntion with -dump). size_spec consists of two components,
                both positive integers. They are interpreted as the width and
                height (in pixels) of the image.
                The details provided for position specifiers (see above) about
                the characters used to delimit specifier components apply to
                size specifiers as well.
                (default: size of the desktop)

-shift spec    Specify that the center of the rendered image should be shifted
               by some amount from the center of the image. The spec consists
               of two components, both integers; these components are
               interpreted as the offsets (in pixels) in the X and Y
               directions.
               By default, the center of the rendered image is aligned with the
               center of the image.

-stars         Enable displaying of stars in the background (default)
-nostars       Disable displaying of stars in the background

-starfreq frequency    If displaying of stars is enabled, frequency percent
                       of the background pixels are turned into stars
                       (default: 0.002%)

-term pct      Specify the shading discontinuity at the terminator (day/night
               line). Pct should be between 0 and 100, where 100 is maximum
               discontinuity and 0 makes a very smooth transition.
               (default: -term 0)

-shade_area pct Specify the proportion of the day-side to be progressively
                shaded prior to a transition with the night-side.  A value of
                100 means all the day area will be shaded, whereas 0 will result
                in no shading at all.  60 would keep 40% of the day area nearest
                the sun free from shading. (default: -shade_area 100)

-help          Display this help text.

