http://ftp.ksu.edu.tw/FTP/FreeBSD/distfiles/xscreensaver-4.20.tar.gz
[xscreensaver] / hacks / substrate.man
1 .TH Substrate 1 "08-Oct-04" "X Version 11"
2 .SH NAME
3 substrate - Grow crystal-like lines on a computational substrate
4 .SH SYNOPSIS
5 .B substrate
6 [\-display \fIhost:display.screen\fP]
7 [\-foreground \fIcolor\fP]
8 [\-background \fIcolor\fP]
9 [\-wireframe]
10 [\-max\-cycles \fIcyclecount\fP]
11 [\-growth\-delay \fIdelayms\fP]
12 [\-initial\-cracks \fInuminitial\fP]
13 [\-max\-cracks \fInummax\fP]
14 [\-sand\-grains \fInumgrains\fP]
15 [\-circle\-percent \fIcirclepercent\fP]
16 .SH DESCRIPTION
17 Lines like crystals grow on a computational substrate.  A simple 
18 perpendicular growth rule creates intricate city-like structures.  Optionally, cracks may also be circular, producing a cityscape more familiar to places for which city planning is a distant, theoretical concern.
19
20 Ported from the code by j.tarbell at http://complexification.net
21 .SH OPTIONS
22 .I substrate
23 accepts the following options:
24 .TP 8
25 .B \-wireframe (Default: \fIFalse\fP)
26 Don't draw sand-painting colored effects, only make a wireframe.
27 .TP 8
28 .B \-max\-cycles \fIcyclecount\fP (Default: \fI10000\fP)
29 Maximum number of growth cycles before restarting.  The higher this is,
30 the more complex the art.
31 .TP 8
32 .B \-growth\-delay \fIdelayms\fP (Default: \fI18000\fP)
33 Delay in ms between growth cycles.  More delay, slower (but smoother
34 and less CPU intensive)
35 art.
36 .TP 8
37 .B \-initial\-cracks \fInuminitial\fP (Default: \fI3\fP)
38 Initial number of cracks in the substrate
39 .TP 8
40 .B \-max\-cracks \fInummax\fP (Default: \fI100\fP)
41 Maximum number of cracks in the substrate at a single time
42 .TP 8
43 .B \-sand\-grains \fInumgrains\fP (Default: \fI64\fP)
44 Number of sand grains dropped during coloring.  More grains cause 
45 a denser colour but use more cpu power.
46 .TP 8
47 .B \-circle-percent \fIcirclepercent\fP (Default: \fI33\fP)
48 The percentage of the cracks will be circular.
49 .SH ENVIRONMENT
50 .PP
51 .TP 8
52 .B DISPLAY
53 to get the default host and display number.
54 .TP 8
55 .B XENVIRONMENT
56 to get the name of a resource file that overrides the global
57 resources stored in the RESOURCE_MANAGER property.
58 .SH SEE ALSO
59 .BR X (1),
60 .BR xscreensaver (1)
61 .SH COPYRIGHT
62 Copyright \(co 2003 by J. Tarbell
63 (complex@complexification.net, http://www.complexification.net).
64
65 Ported to XScreensaver 2004 by Mike Kershaw (dragorn@kismetwireless.net)
66 .SH AUTHOR
67 J. Tarbell <complex@complexification.net>, Jun-03
68
69 Mike Kershaw <dragorn@kismetwireless.net>, Oct-04