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