http://www.jwz.org/xscreensaver/xscreensaver-5.10.tar.gz
[xscreensaver] / hacks / deco.man
1 .TH XScreenSaver 1 "27-Apr-97" "X Version 11"
2 .SH NAME
3 deco - draw tacky 70s basement wall panelling
4 .SH SYNOPSIS
5 .B deco
6 [\-display \fIhost:display.screen\fP]
7 [\-foreground \fIcolor\fP]
8 [\-background \fIcolor\fP]
9 [\-window]
10 [\-root]
11 [\-mono]
12 [\-install]
13 [\-visual \fIvisual\fP]
14 [\-delay \fIseconds\fP]
15 [\-max\-depth \fIint\fP]
16 [\-min\-width \fIint\fP]
17 [\-min\-height \fIint\fP]
18 [\-line-width \yIint\fP]
19 [\-smooth\-colors]
20 [\-golden\-ratio]
21 [\-mondrian]
22 [\-fps]
23 .SH DESCRIPTION
24 The \fIdeco\fP program subdivides and colors rectangles randomly.
25 It looks kind of like Brady-Bunch-era rec-room wall paneling.
26 (Raven says: "This screensaver is ugly enough to peel paint.")
27 Can also produce more aesthetically pleasing displays via options.
28 .SH OPTIONS
29 .I deco
30 accepts the following options:
31 .TP 8
32 .B \-window
33 Draw on a newly-created window.  This is the default.
34 .TP 8
35 .B \-root
36 Draw on the root window.
37 .TP 8
38 .B \-mono 
39 If on a color display, pretend we're on a monochrome display.
40 .TP 8
41 .B \-install
42 Install a private colormap for the window.
43 .TP 8
44 .B \-visual \fIvisual\fP
45 Specify which visual to use.  Legal values are the name of a visual class,
46 or the id number (decimal or hex) of a specific visual.
47 .TP 8
48 .B \-delay \fIseconds\fP
49 How long to wait before starting over.  Default 5 seconds.
50 .TP 8
51 .B \-max\-depth \fIinteger\fP
52 How deep to subdivide.  Default 12.
53 .TP 8
54 .B \-min\-width \fIinteger\fP
55 .TP 8
56 .B \-min\-height \fIinteger\fP
57 The size of the smallest rectangle to draw.  Default 20x20.
58 .TP 8
59 .B \-line\-width \fIinteger\fP
60 Width of lines drawn between rectangles. Default zero (minimal width).
61 .TP 8
62 .B \-smooth\-colors
63 .TP 8
64 .B \-no\-smooth\-colors
65 Whether to use a smooth color palette instead of a random one.
66 Less jarring. Default False.
67 .TP 8
68 .B \-golden\-ratio
69 .TP 8
70 .B \-no\-golden\-ratio
71 Whether to subdivide rectangles using the golden ratio instead of 1/2.
72 This ratio is supposed to be more aesthetically pleasing. Default false.
73 .TP 8
74 .B \-mondrian
75 .TP 8
76 .B \-no\-mondrian
77 Whether to imitiate style of some famous paintings by Piet Mondrian.
78 Overrides line-width and colormap options. Default false.
79 .TP 8
80 .B \-fps
81 Display the current frame rate and CPU load.
82 .SH ENVIRONMENT
83 .PP
84 .TP 8
85 .B DISPLAY
86 to get the default host and display number.
87 .TP 8
88 .B XENVIRONMENT
89 to get the name of a resource file that overrides the global resources
90 stored in the RESOURCE_MANAGER property.
91 .SH SEE ALSO
92 .BR X (1),
93 .BR xscreensaver (1)
94 .SH COPYRIGHT
95 Copyright \(co 1997 by Jamie Zawinski.  Permission to use, copy, modify, 
96 distribute, and sell this software and its documentation for any purpose is 
97 hereby granted without fee, provided that the above copyright notice appear 
98 in all copies and that both that copyright notice and this permission notice
99 appear in supporting documentation.  No representations are made about the 
100 suitability of this software for any purpose.  It is provided "as is" without
101 express or implied warranty.
102 .SH AUTHOR
103 Jamie Zawinski <jwz@jwz.org>, 26-Apr-97, based on code by
104 Michael D. Bayne <mdb@go2net.com>. Golden ratio and 
105 Mondrian settings by Lars Huttar.