1maze(6x)                      XScreenSaver manual                     maze(6x)
2
3
4

NAME

6       maze  -  an automated X11 demo repeatedly creating and solving a random
7       maze
8

SYNOPSIS

10       maze [--display host:display.screen] [--foreground color] [--background
11       color]  [--window]  [--root]  [--window-id number][--install] [--visual
12       visual] [--grid-size pixels] [--live-color color] [--dead-color  color]
13       [--solve-delay  usecs] [--pre-delay usecs] [--post-delay usecs] [--gen‐
14       erator integer] [--max-length integer] [--fps]
15

DESCRIPTION

17       The maze program creates a "random" maze and then solves it with graph‐
18       ical feedback.
19

OPTIONS

21       maze accepts the following options:
22
23       --window
24               Draw on a newly-created window.  This is the default.
25
26       --root  Draw on the root window.
27
28       --window-id number
29               Draw on the specified window.
30
31       --install
32               Install a private colormap for the window.
33
34       --visual visual
35               Specify  which  visual  to use.  Legal values are the name of a
36               visual class, or the id number (decimal or hex) of  a  specific
37               visual.
38
39       --grid-size pixels
40               The  size  of  each block of the maze, in pixels; default is 0,
41               meaning pick a random grid size.  Minimum meaningful  value  is
42               2.
43
44       --live-color color
45               The color of the path.
46
47       --dead-color color
48               The  color  of  the failed path (it is also stippled with a 50%
49               pattern.)
50
51       --skip-color color
52               The maze solver will choose to not go down a  path  if  it  can
53               "see"  (in a straight line) that it is a dead end.  This is the
54               color to use for paths that are skipped for this reason.
55
56       --surround-color color
57               If the maze solver ever completely encloses an area within  the
58               maze,  then it knows that the exit is not in there (and in fact
59               the interior of that area might not  even  be  reachable.)   It
60               will mark out those cells using this color.
61
62       --solve-delay integer
63               Delay (in microseconds) between each step of the solution path.
64               Default 5000, or about 1/200th second.
65
66       --pre-delay integer
67               Delay (in microseconds) between generating a maze and  starting
68               to solve it.  Default 2000000 (2 seconds.)
69
70       --post-delay integer
71               Delay  (in microseconds) after solving a maze and before gener‐
72               ating a new one.  Default 4000000 (4 seconds.)
73
74       --generator num
75               Sets the algorithm that will be used to generate the mazes. The
76               default  is  -1,  which  randomly selects an algorithm for each
77               maze that is generated. Generator 0 is the  original  one,  and
78               works  by  walking  around  randomly until we hit a place we've
79               been before, then backtracking and trying a new direction some‐
80               where.  Generator 1 picks a random spot in the maze, then draws
81               a straight wall from that spot in a random direction  until  it
82               hits  another  wall (and continues until the maze is complete).
83               Generator 2 is based on sets. Initially all cells are  in  dif‐
84               ferent  sets. Then two neighboring cells are chosen and if they
85               are in different sets, their sets are joined. If they  were  in
86               the  same set, a wall is built between them. This continues un‐
87               til the maze is complete.
88
89               All generators generate mazes with a certain  'characteristic'.
90               See if you can spot them!
91
92               The  three  algorithms  are  essentially  Kruskal,  Prim, and a
93               depth-first recursive backtracker.
94
95       --max-length num
96               Controls the maximum length of walls drawn in one go by genera‐
97               tor 1.
98
99       Clicking the mouse in the maze window controls it.
100
101       LeftButton      Clears the window and restarts maze.
102
103       MiddleButton    Pause or unpause the program.
104
105       RightButton     Exit.
106
107       --fps   Display the current frame rate and CPU load.
108

BUGS

110       Expose events force a restart of maze.
111
112       Mouse  actions are based on "raw" values (Button1, Button2 and Button3)
113       instead of using the pointer map.
114

ENVIRONMENT

116       DISPLAY to get the default host and display number.
117
118       XENVIRONMENT
119               to get the name of a resource file that  overrides  the  global
120               resources stored in the RESOURCE_MANAGER property.
121
122       XSCREENSAVER_WINDOW
123               The window ID to use with --root.
124

SEE ALSO

126       X(1), xscreensaver(1)
127
129       Copyright © 1988 by Sun Microsystems, Inc. Mountain View, CA.
130
131       All Rights Reserved
132
133       Permission  to  use, copy, modify, and distribute this software and its
134       documentation for any purpose and without fee is hereby  granted,  pro‐
135       vided  that  the  above  copyright notice appear in all copies and that
136       both that copyright notice and this permission notice  appear  in  sup‐
137       porting  documentation, and that the names of Sun or MIT not be used in
138       advertising or publicity pertaining to  distribution  of  the  software
139       without specific prior written permission. Sun and M.I.T.  make no rep‐
140       resentations about the suitability of this software for any purpose. It
141       is provided "as is" without any express or implied warranty.
142
143       SUN  DISCLAIMS  ALL  WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
144       ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A  PARTICULAR
145       PURPOSE.  IN  NO EVENT SHALL SUN BE LIABLE FOR ANY SPECIAL, INDIRECT OR
146       CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS  OF
147       USE,  DATA  OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
148       OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE  OR
149       PERFORMANCE OF THIS SOFTWARE.
150

AUTHOR(s)

152       Zack Weinberg [ Smarter maze-solver ] zack@rabi.phys.columbia.edu
153       Johannes Keukelaar [ Generators 1 and 2 ] johannes@nada.kth.se
154         Royal Institute of Technology, Stockholm, Sweden
155       Jim Randell    [ XScreenSaver version ] jmr@mddjmr.fc.hp.com
156         HPLabs, Bristol
157       Richard Hess   [ X11 extensions ]       {...}!uunet!cimshop!rhess
158         Consilium, Mountain View, CA
159       Dave Lemke     [ X11 version ]          lemke@sun.COM
160         Sun MicroSystems, Mountain View, CA
161       Martin Weiss   [ SunView version ]
162         Sun MicroSystems, Mountain View, CA
163
164
165
166X Version 11               6.06-1.fc37 (12-Dec-2022)                  maze(6x)
Impressum