git.hungrycats.org Git - xscreensaver/blob - hacks/maze.man

   1 .TH XScreenSaver 1 "7-mar-93" "X Version 11"
   2 .SH NAME
   3 maze \- an automated X11 demo repeatedly creating and solving a random maze
   4 .SH SYNOPSIS
   5 .B maze
   6 [\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] [\-grid\-size \fIpixels\fP] [\-live\-color \fIcolor\fP] [\-dead\-color \fIcolor\fP] [\-solve\-delay \fIusecs\fP] [\-pre\-delay \fIusecs\fP] [\-post\-delay \fIusecs\fP]
   7 .SH DESCRIPTION
   8 The \fImaze\fP program creates a "random" maze and then solves it with
   9 graphical feedback.
  10 .SH OPTIONS
  11 .I maze
  12 accepts the following options:
  13 .TP 8
  14 .B \-window
  15 Draw on a newly-created window.  This is the default.
  16 .TP 8
  17 .B \-root
  18 Draw on the root window.
  19 .TP 8
  20 .B \-install
  21 Install a private colormap for the window.
  22 .TP 8
  23 .B \-visual \fIvisual\fP
  24 Specify which visual to use.  Legal values are the name of a visual class,
  25 or the id number (decimal or hex) of a specific visual.
  26 .TP 8
  27 .B \-grid\-size \fIpixels\fP
  28 The size of each block of the maze, in pixels; default is 0, meaning
  29 pick a random grid size.
  30 .TP 8
  31 .B \-live\-color \fIcolor\fP
  32 The color of the path.
  33 .TP 8
  34 .B \-dead\-color \fIcolor\fP
  35 The color of the failed path (it is also stippled with a 50% pattern.)
  36 .TP 8
  37 .B \-solve\-delay \fIinteger\fP
  38 Delay (in microseconds) between each step of the solution path.
  39 Default 5000, or about 1/200th second.
  40 .TP 8
  41 .B \-pre\-delay \fIinteger\fP
  42 Delay (in microseconds) between generating a maze and starting to solve it.
  43 Default 2000000 (2 seconds.)
  44 .TP 8
  45 .B \-post\-delay \fIinteger\fP
  46 Delay (in microseconds) after solving a maze and before generating a new one.
  47 Default 4000000 (4 seconds.)
  48 .PP
  49 Clicking the mouse in the maze window controls it.
  50 .TP 16
  51 .B "LeftButton
  52 Clears the window and restarts maze.
  53 .TP 16
  54 .B MiddleButton
  55 Pause or unpause the program.
  56 .TP 16
  57 .B RightButton
  58 Exit.
  59 .SH BUGS
  60 Expose events force a restart of maze.
  61
  62 Mouse actions are based on "raw" values (Button1, Button2 and Button3)
  63 instead of using the pointer map.
  64 .SH ENVIRONMENT
  65 .PP
  66 .TP 8
  67 .B DISPLAY
  68 to get the default host and display number.
  69 .TP 8
  70 .B XENVIRONMENT
  71 to get the name of a resource file that overrides the global resources
  72 stored in the RESOURCE_MANAGER property.
  73 .SH SEE ALSO
  74 .BR X (1),
  75 .BR xscreensaver (1)
  76 .SH COPYRIGHT
  77 .PP
  78 Copyright \(co 1988 by Sun Microsystems, Inc. Mountain View, CA.
  79 .PP
  80 All Rights Reserved
  81 .PP
  82 Permission to use, copy, modify, and distribute this software and its
  83 documentation for any purpose and without fee is hereby granted, provided that
  84 the above copyright notice appear in all copies and that both that copyright
  85 notice and this permission notice appear in supporting documentation, and that
  86 the names of Sun or MIT not be used in advertising or publicity pertaining to
  87 distribution of the software without specific prior written permission. Sun
  88 and M.I.T.  make no representations about the suitability of this software for
  89 any purpose. It is provided "as is" without any express or implied warranty.
  90 .PP
  91 SUN DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  92 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN
  93 NO EVENT SHALL SUN BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
  94 DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  95 WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  96 OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  97 .SH AUTHOR(s)
  98 .nf
  99 Jim Randell     [ XScreenSaver version ] jmr@mddjmr.fc.hp.com
 100   HPLabs, Bristol
 101 Richard Hess    [ X11 extensions ]      {...}!uunet!cimshop!rhess
 102   Consilium, Mountain View, CA
 103 Dave Lemke      [ X11 version ]         lemke@sun.COM
 104   Sun MicroSystems, Mountain View, CA
 105 Martin Weiss    [ SunView version ]
 106   Sun MicroSystems, Mountain View, CA
 107 .fi