git.hungrycats.org Git - xscreensaver/blob - hacks/glx/dymaxionmap.man

   1 .TH XScreenSaver 1 "" "X Version 11"
   2 .SH NAME
   3 dymaxionmap - An animation of Buckminster Fuller's unwrapped icosahedral globe.
   4 .SH SYNOPSIS
   5 .B dymaxionmap
   6 [\-display \fIhost:display.screen\fP]
   7 [\-visual \fIvisual\fP]
   8 [\-window]
   9 [\-root]
  10 [\-delay \fInumber\fP]
  11 [\-speed \fIratio\fP]
  12 [\-no-wander]
  13 [\-no-roll]
  14 [\-no-stars]
  15 [\-no-grid]
  16 [\-flat]
  17 [\-satellite]
  18 [\-image \fIfile\fP]
  19 [\-image2 \fIfile\fP]
  20 [\-frames \fInumber\fP]
  21 [\-wireframe]
  22 [\-fps]
  23 .SH DESCRIPTION
  24 Buckminster Fuller's map of the Earth projected onto the surface of an
  25 unfolded icosahedron. It depicts the Earth's continents as one island, or
  26 nearly contiguous land masses.
  27
  28 This screen saver animates the progression of the dusk terminator across
  29 the flattened globe. It includes both satellite and flat-colored map
  30 imagery, and can load and convert other Equirectangular-projected maps.
  31 .SH OPTIONS
  32 .TP 8
  33 .B \-visual \fIvisual\fP
  34 Specify which visual to use.  Legal values are the name of a visual class,
  35 or the id number (decimal or hex) of a specific visual.
  36 .TP 8
  37 .B \-window
  38 Draw on a newly-created window.  This is the default.
  39 .TP 8
  40 .B \-root
  41 Draw on the root window.
  42 .TP 8
  43 .B \-delay \fInumber\fP
  44 Per-frame delay, in microseconds.  Default: 20000 (0.02 seconds).
  45 .TP 8
  46 .B \-speed \fIratio\fP
  47 Speed of the animation. 0.5 means half as fast, 2 means twice as fast.
  48 .TP 8
  49 .B \-wander | \-no-wander
  50 Whether the object should wander around the screen. Default yes.
  51 .TP 8
  52 .B \-roll | \-no-roll
  53 Whether the object should roll randomly. Default yes.
  54 .TP 8
  55 .B \-stars | \-no-stars
  56 Whether to display a star field. Default yes.
  57 .TP 8
  58 .B \-grid | \-no-grid
  59 Whether to overlay a latitude/longitude grid over the map. Default yes.
  60 .TP 8
  61 .B \-flat
  62 Display a flat-colored map of the Earth. This is the default.
  63 .TP 8
  64 .B \-satellite
  65 Display a day-time satellite map of the Earth.
  66 .TP 8
  67 .B \-image \fIfile\fP
  68 An image to use for the day-time map.
  69 .TP 8
  70 .B \-image2 \fIfile\fP
  71 An image to use for the night-time map.
  72 The two images can be the same: the night-time one will be darkened.
  73 .TP 8
  74 .B \-frames \fInumber\fP
  75 The number of frames in the day/night animation. Default 720.
  76 Larger numbers are smoother, but use more memory.
  77 The day/night animation happens if \fIimage2\fP is set, or
  78 if \fIframes\fP is greater than 1.
  79 .TP 8
  80 .B \-wireframe | \-no-wireframe
  81 Render in wireframe instead of solid.
  82 .TP 8
  83 .B \-fps | \-no-fps
  84 Whether to show a frames-per-second display at the bottom of the screen.
  85 .SH ENVIRONMENT
  86 .PP
  87 .TP 8
  88 .B DISPLAY
  89 to get the default host and display number.
  90 .TP 8
  91 .B XENVIRONMENT
  92 to get the name of a resource file that overrides the global resources
  93 stored in the RESOURCE_MANAGER property.
  94 .SH SEE ALSO
  95 .BR X (1),
  96 .BR xscreensaver (1)
  97 .BR glplanet (1)
  98 .SH COPYRIGHT
  99 Copyright \(co 2016-2018 by Jamie Zawinski.  Permission to use, copy, modify,
 100 distribute, and sell this software and its documentation for any purpose is
 101 hereby granted without fee, provided that the above copyright notice appear
 102 in all copies and that both that copyright notice and this permission notice
 103 appear in supporting documentation.  No representations are made about the
 104 suitability of this software for any purpose.  It is provided "as is" without
 105 express or implied warranty.
 106
 107 "Dymaxion Map" and "The Fuller Projection Map" are trademarks of
 108 The Buckminster Fuller Institute.
 109
 110 The original Dymaxion Map image is copyright \(co 1982 by
 111 The Buckminster Fuller Institute. (This program does not use their
 112 imagery, only similar trigonometry.)
 113
 114 The Dymaxion Map was covered by now-expired US Patent 2,393,676
 115 (Richard Buckminster Fuller, 1946).
 116 .SH AUTHOR
 117 Jamie Zawinski.