Penguin
Recent Changes
Annotated edit history of bubbles(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 XScreenSaver
2 !!!XScreenSaver
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 NOTES
8 BUGS
9 ENVIRONMENT
10 SEE ALSO
11 DISTRIBUTION POLICY
12 AUTHOR
13 ----
14 !!NAME
15
16
17 bubbles - frying pan / soft drink simulation
18 !!SYNOPSIS
19
20
21 __bubbles__ [[-display ''host:display.screen'']
22 [[-foreground ''color''] [[-background ''color'']
23 [[-window] [[-root] [[-mono] [[-install] [[-visual ''visual'']
24 [[-simple] [[-broken] [[-3D] [[-file filename] [[-directory
25 directoryname]
26 !!DESCRIPTION
27
28
29 ''Bubbles'' sprays lots of little random bubbles all over
30 the window which then grow until they reach their maximum
31 size and go pop. The inspiration for this was watching
32 little globules of oil on the bottom of a frying pan and it
33 also looks a little like bubbles in fizzy soft drink. The
34 default mode uses fancy ray-traced bubbles but there is also
35 a mode which just draws circles in case the default mode is
36 too taxing on your hardware.
37 !!OPTIONS
38
39
40 Depending on how your ''bubbles'' was compiled, it
41 accepts the following options:
42
43
44 __-foreground__
45
46
47 Colour of circles if ''-simple'' mode is
48 selected.
49
50
51 __-background__
52
53
54 Colour of window background.
55
56
57 __-window__
58
59
60 Draw on a newly-created window. This is the
61 default.
62
63
64 __-root__
65
66
67 Draw on the root window.
68
69
70 __-mono__
71
72
73 If on a color display, pretend we're on a monochrome
74 display.
75
76
77 __-install__
78
79
80 Install a private colormap for the window.
81
82
83 __-visual__ ''visual''
84
85
86 Specify which visual to use. Legal values are the name of a
87 visual class, or the id number (decimal or hex) of a
88 specific visual.
89
90
91 __-delay microseconds__
92
93
94 How much of a delay should be introduced between steps of
95 the animation. Default 1, or about 1 microsecond. Actually,
96 this is the delay between each group of 15 new bubbles since
97 such a delay between each step results in a very slow
98 animation rate.
99
100
101 __-nodelay__
102
103
104 Same as ''-delay 0''.
105
106
107 __-simple__
108
109
110 Don't use the default fancy pixmap bubbles. Just draw
111 circles instead. This may give more bearable performance if
112 your hardware wasn't made for this sort of
113 thing.
114
115
116 __-broken__
117
118
119 Don't hide bubbles when they pop. This was a bug during
120 development but the results were actually quite attractive.
121 (This option is only available if you have the XPM library
122 available and the imake generated Makefile has defined
123 HAVE_XPM).
124
125
126 __-3D__
127
128
129 Normally, the simulation is done completely in two
130 dimensions. When a bubble swallows up another bubble, the
131 areas of each are added to get the area of the resulting
132 bubble. This option changes the algorithm to instead add
133 volume (imagining each to be a sphere in 3D space). The
134 whole thing looks more realistic but I find it attracts
135 attention to the flickering of each bubble as they are move
136 and are redrawn. Your mileage may vary.
137
138
139 __-file filename__
140
141
142 Use the pixmap definitions in the given file, instead of the
143 default (if one is compiled in). This is ignored if
144 ''-simple'' is specified. If the file is compressed
145 (either with compress or gzip), it is decompressed before
146 use. (This option only works if you have XPM compiled into
147 your binary and you have compiled with BUBBLES_IO set in
148 bubbles.h. This is __not__ the default).
149
150
151 __-directory directoryname__
152
153
154 Similar to ''-file'' except the file is taken randomly
155 from the contents of the specified directory. (Again, this
156 option is only available if you have XPM and BUBBLES_IO was
157 set when compiling. See above).
158
159
160 __-quiet__
161
162
163 Don't print messages explaining why one or several command
164 line options were ignored. This is disabled by
165 default.
166 !!NOTES
167
168
169 If you find the pace of things too slow, remember that there
170 is a delay even though you specify no ''-delay'' option.
171 Try using ''-nodelay'' although beware of the effects of
172 irritation of other users if you're on a shared system as
173 you bleed their CPU time away.
174
175
176 Some tools to assist in creation of new bubbles are included
177 in the source distribution. These can either be loaded with
178 the ''-file'' or ''-directory'' options (if available)
179 or they can be used in place of the distributed default
180 bubble (bubble_default.c). You might like to copy these
181 scripts to a permanent location and use them. Read
182 bubbles.README.
183
184
185 Rendered bubbles are not supported on monochrome displays.
186 I'm not convinced that small bubbles, even dithered properly
187 are going to look like anything more than a jumble of random
188 dots.
189 !!BUGS
190
191
192 There is a delay before something appears on the screen when
193 using rendered bubbles. The XPM library seems to take a
194 __long__ time to make pixmaps out of raw data. This can
195 be irritating on slower systems.
196
197
198 The movement of the bubbles looks jerky if an incomplete set
199 of bubbles is used.
200
201
202 The hide/display algorithm could do with some work to avoid
203 flickering when ''-nodelay'' is set.
204 !!ENVIRONMENT
205
206
207 __DISPLAY__
208
209
210 to get the default host and display number.
211
212
213 __XENVIRONMENT__
214
215
216 to get the name of a resource file that overrides the global
217 resources stored in the RESOURCE_MANAGER
218 property.
219 !!SEE ALSO
220
221
4 perry 222 X(1), xscreensaver(1)
1 perry 223 !!DISTRIBUTION POLICY
224
225
226 This work is Copyright 1995, 1996 by James Macnicol.
227 Permission to use, copy, modify, distribute, and sell this
228 software and its documentation for any purpose is hereby
229 granted without fee, provided that the above copyright
230 notice appear in all copies and that both that copyright
231 notice and this permission notice appear in supporting
232 documentation. No representations are made about the
233 suitability of this software for any purpose. It is provided
234 !!AUTHOR
235
236
237 James Macnicol
238 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.