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