http://www.jwz.org/xscreensaver/xscreensaver-5.07.tar.gz
[xscreensaver] / hacks / julia.man
1 .TH XScreenSaver 1 "28-May-97" "X Version 11"
2 .SH NAME
3 julia - draws spinning, animating julia-set fractals
4 .SH SYNOPSIS
5 .B julia
6 [\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] [\-mouse] [\-nomouse]
7
8 [\-fps]
9 .SH DESCRIPTION
10 The \fIjulia\fP program draws spinning, animating julia-set fractals.
11
12 It uses ifs {w0 = sqrt(x-c), w1 = -sqrt(x-c)} with random iteration 
13 to plot the julia set, and sinusoidially varied parameters for the set,
14 and plots parameters with a circle.
15
16 One thing to note is that count is the \fIdepth\fP of the search tree,
17 so the number of points computed is (2^count)-1.  I use 8 or 9 on a
18 dx266 and it looks okay.  The sinusoidal variation of the parameter
19 might not be as interesting as it could, but it still gives an idea 
20 of the effect of the parameter.
21
22 .SH OPTIONS
23 .I julia
24 accepts the following options:
25 .TP 8
26 .B \-window
27 Draw on a newly-created window.  This is the default.
28 .TP 8
29 .B \-root
30 Draw on the root window.
31 .TP 8
32 .B \-mono 
33 If on a color display, pretend we're on a monochrome display.
34 .TP 8
35 .B \-install
36 Install a private colormap for the window.
37 .TP 8
38 .B \-visual \fIvisual\fP
39 Specify which visual to use.  Legal values are the name of a visual class,
40 or the id number (decimal or hex) of a specific visual.
41 .TP 8
42 .B \-ncolors \fIinteger\fP
43 How many colors should be used (if possible).  Default 200.
44 The colors used cycle through the hue, making N stops around
45 the color wheel.
46 .TP 8
47 .B \-cycles \fIinteger\fP
48
49 .TP 8
50 .B \-count \fIinteger\fP
51
52 .TP 8
53 .B \-mouse
54 .TP 8
55 .B \-nomouse
56 If \fI\-mouse\fP is specified, the control point of the Julia set will
57 be derived from the position of the mouse in the window.  When the mouse
58 is not in the window, the control point is chosen the normal way.
59 .TP 8
60 .B \-fps
61 Display the current frame rate and CPU load.
62 .SH ENVIRONMENT
63 .PP
64 .TP 8
65 .B DISPLAY
66 to get the default host and display number.
67 .TP 8
68 .B XENVIRONMENT
69 to get the name of a resource file that overrides the global resources
70 stored in the RESOURCE_MANAGER property.
71 .SH SEE ALSO
72 .BR X (1),
73 .BR xscreensaver (1),
74 .BR xlock (1)
75 .SH COPYRIGHT
76 Copyright \(co 1995 by Sean McCullough.
77
78 Permission to use, copy, modify, and distribute this software and its
79 documentation for any purpose and without fee is hereby granted,
80 provided that the above copyright notice appear in all copies and that
81 both that copyright notice and this permission notice appear in
82 supporting documentation. 
83 .SH AUTHOR
84 Sean McCullough <bankshot@mailhost.nmt.edu>, 1995.
85
86 Ability to run standalone or with \fIxscreensaver\fP added by 
87 Jamie Zawinski <jwz@jwz.org>, 10-May-97.