This repository has been archived by the owner on Aug 2, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
ReadMe.html
85 lines (81 loc) · 2.69 KB
/
ReadMe.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
<HTML>
<HEAD>
<TITLE>coral</TITLE>
</HEAD>
<BODY>
<H1>coral</H1>
<P>
Calculate and display an aggregating particle
<DL>
<DT><B>Authored and Contributed by</B>
<DD>Ronald Joe Record
<DT><B>Copyright</B>
<DD>Copyright 1993-2011 Ronald Joe Record
<DT><B>License</B>
<DD>Coral is distributed under the terms of the GNU General Public License V3
<DT><B>Description</B>
<DD>
The idea here is to calculate and display aggregating particles.
In order to accomplish this, a modified random walk algorithm is used.
Initial particles are "seeded" at the "bottom" or the "sea". Particles
are then "dropped" randomly from above. When a particle comes within a
pixel of an already existent particle, it "sticks". After N particles
have "stuck", the color is incremented. Thus, color indicates "age".
<DT><B>Acknowledgements</B>
<DD>
The algorithm was derived from lectures given by Dietmar Saupe at the
University of California at Santa Cruz. Assistance with colormaps and
spinning color wheels and X was gleaned from Hiram Clawson and Stacey Campbell.
<DT><B>Build</B>
<DD>
To build the coral binary, either use the Imakefile or the sample makefile,
Makefile.std. If your system doesn't support prototypes, uncomment the
PROTODEFINE line of the Imakefile.
<P>
After modifying the Imakefile appropriately, either use "xmkmf" or "imake"
to create a Makefile. Then just type "make" to compile coral.
<P>
The manual page can be formatted by typing "nroff -man coral.man > coral.6X".
<DT><B>Install</B>
<DD>
To install coral, copy the coral binary to the desired location (the sample
makefile puts it in /usr/games/X11)
Copy the formatted man page to wherever you keep your local doc (i use
/usr/games/X11/doc for games and imaging software), then add that location
to your MANPATH.
<DT><B>Productivity</B>
<DD>None
<DT><B>Safety</B>
<DD>I have used this for years without harm.
<DT><B>Work Planned</B>
<DD>None
<DT><B>Documentation</B>
<DD>manual page.
<DT><B>Verification</B>
<DD>
You can test coral by just invoking it with no arguments. It should display
a 512x480 image. Some workstations may be slow to calculate and display the
coral growth as there are many calculations involved.
<P>
Some "interesting" ways to run coral are as follows :
<BR>
% coral -F -n 10 -d
<BR>
(use the full screen, calculate 10 maps in demo mode)
<BR>
% coral -R
<BR>
(display on the root window)
<BR>
% coral -o coralgrowth.ppm
<BR>
(calculate and display with default parameters and save the resulting image
as a PPM file called coralgrowth.ppm. this can be viewed later using xv or
any PPM viewing utility)
<DT><B>Feedback</B>
<DD>
Ideas, comments, additions, deletions, suggestions, bug reports, code review,...
e-mail Ronald Record at rr@ronrecord.com
</DL>
</BODY>
</HTML>