4 XScreenSaver(1) XScreenSaver(1)
8 bubbles - frying pan / soft drink simulation
10 S
\bSY
\bYN
\bNO
\bOP
\bPS
\bSI
\bIS
\bS
11 b
\bbu
\bub
\bbb
\bbl
\ble
\bes
\bs [-display _
\bh_
\bo_
\bs_
\bt_
\b:_
\bd_
\bi_
\bs_
\bp_
\bl_
\ba_
\by_
\b._
\bs_
\bc_
\br_
\be_
\be_
\bn] [-foreground _
\bc_
\bo_
\bl_
\bo_
\br]
12 [-background _
\bc_
\bo_
\bl_
\bo_
\br] [-window] [-root] [-mono] [-install]
13 [-visual _
\bv_
\bi_
\bs_
\bu_
\ba_
\bl] [-simple] [-broken] [-3D] [-file file-
14 name] [-directory directoryname]
16 D
\bDE
\bES
\bSC
\bCR
\bRI
\bIP
\bPT
\bTI
\bIO
\bON
\bN
17 _
\bB_
\bu_
\bb_
\bb_
\bl_
\be_
\bs sprays lots of little random bubbles all over the
18 window which then grow until they reach their maximum size
19 and go pop. The inspiration for this was watching little
20 globules of oil on the bottom of a frying pan and it also
21 looks a little like bubbles in fizzy soft drink. The
22 default mode uses fancy ray-traced bubbles but there is
23 also a mode which just draws circles in case the default
24 mode is too taxing on your hardware.
26 O
\bOP
\bPT
\bTI
\bIO
\bON
\bNS
\bS
27 Depending on how your _
\bb_
\bu_
\bb_
\bb_
\bl_
\be_
\bs was compiled, it accepts the
30 -
\b-f
\bfo
\bor
\bre
\beg
\bgr
\bro
\bou
\bun
\bnd
\bd
31 Colour of circles if _
\b-_
\bs_
\bi_
\bm_
\bp_
\bl_
\be mode is selected.
33 -
\b-b
\bba
\bac
\bck
\bkg
\bgr
\bro
\bou
\bun
\bnd
\bd
34 Colour of window background.
36 -
\b-w
\bwi
\bin
\bnd
\bdo
\bow
\bw Draw on a newly-created window. This is the
39 -
\b-r
\bro
\boo
\bot
\bt Draw on the root window.
41 -
\b-m
\bmo
\bon
\bno
\bo If on a color display, pretend we're on a
44 -
\b-i
\bin
\bns
\bst
\bta
\bal
\bll
\bl
45 Install a private colormap for the window.
47 -
\b-v
\bvi
\bis
\bsu
\bua
\bal
\bl _
\bv_
\bi_
\bs_
\bu_
\ba_
\bl
48 Specify which visual to use. Legal values are the
49 name of a visual class, or the id number (decimal
50 or hex) of a specific visual.
52 -
\b-d
\bde
\bel
\bla
\bay
\by m
\bmi
\bic
\bcr
\bro
\bos
\bse
\bec
\bco
\bon
\bnd
\bds
\bs
53 How much of a delay should be introduced between
54 steps of the animation. Default 1, or about 1
55 microsecond. Actually, this is the delay between
56 each group of 15 new bubbles since such a delay
57 between each step results in a very slow animation
64 X Version 11 14-Dec-95 1
70 XScreenSaver(1) XScreenSaver(1)
73 -
\b-n
\bno
\bod
\bde
\bel
\bla
\bay
\by
74 Same as _
\b-_
\bd_
\be_
\bl_
\ba_
\by _
\b0.
76 -
\b-s
\bsi
\bim
\bmp
\bpl
\ble
\be Don't use the default fancy pixmap bubbles. Just
77 draw circles instead. This may give more bearable
78 performance if your hardware wasn't made for this
81 -
\b-b
\bbr
\bro
\bok
\bke
\ben
\bn Don't hide bubbles when they pop. This was a bug
82 during development but the results were actually
83 quite attractive. (This option is only available
84 if you have the XPM library available and the
85 imake generated Makefile has defined HAVE_XPM).
87 -
\b-3
\b3D
\bD Normally, the simulation is done completely in two
88 dimensions. When a bubble swallows up another
89 bubble, the areas of each are added to get the
90 area of the resulting bubble. This option changes
91 the algorithm to instead add volume (imagining
92 each to be a sphere in 3D space). The whole thing
93 looks more realistic but I find it attracts atten-
94 tion to the flickering of each bubble as they are
95 move and are redrawn. Your mileage may vary.
97 -
\b-f
\bfi
\bil
\ble
\be f
\bfi
\bil
\ble
\ben
\bna
\bam
\bme
\be
98 Use the pixmap definitions in the given file,
99 instead of the default (if one is compiled in).
100 This is ignored if _
\b-_
\bs_
\bi_
\bm_
\bp_
\bl_
\be is specified. If the
101 file is compressed (either with compress or gzip),
102 it is decompressed before use. (This option only
103 works if you have XPM compiled into your binary
104 and you have compiled with BUBBLES_IO set in bub-
105 bles.h. This is n
\bno
\bot
\bt the default).
107 -
\b-d
\bdi
\bir
\bre
\bec
\bct
\bto
\bor
\bry
\by d
\bdi
\bir
\bre
\bec
\bct
\bto
\bor
\bry
\byn
\bna
\bam
\bme
\be
108 Similar to _
\b-_
\bf_
\bi_
\bl_
\be except the file is taken randomly
109 from the contents of the specified directory.
110 (Again, this option is only available if you have
111 XPM and BUBBLES_IO was set when compiling. See
114 -
\b-q
\bqu
\bui
\bie
\bet
\bt Don't print messages explaining why one or several
115 command line options were ignored. This is dis-
119 If you find the pace of things too slow, remember that
120 there is a delay even though you specify no _
\b-_
\bd_
\be_
\bl_
\ba_
\by option.
121 Try using _
\b-_
\bn_
\bo_
\bd_
\be_
\bl_
\ba_
\by although beware of the effects of irri-
122 tation of other users if you're on a shared system as you
123 bleed their CPU time away.
125 Some tools to assist in creation of new bubbles are
126 included in the source distribution. These can either be
130 X Version 11 14-Dec-95 2
136 XScreenSaver(1) XScreenSaver(1)
139 loaded with the _
\b-_
\bf_
\bi_
\bl_
\be or _
\b-_
\bd_
\bi_
\br_
\be_
\bc_
\bt_
\bo_
\br_
\by options (if available)
140 or they can be used in place of the distributed default
141 bubble (bubble_default.c). You might like to copy these
142 scripts to a permanent location and use them. Read bub-
145 Rendered bubbles are not supported on monochrome displays.
146 I'm not convinced that small bubbles, even dithered prop-
147 erly are going to look like anything more than a jumble of
151 There is a delay before something appears on the screen
152 when using rendered bubbles. The XPM library seems to
153 take a l
\blo
\bon
\bng
\bg time to make pixmaps out of raw data. This
154 can be irritating on slower systems.
156 The movement of the bubbles looks jerky if an incomplete
157 set of bubbles is used.
159 The hide/display algorithm could do with some work to
160 avoid flickering when _
\b-_
\bn_
\bo_
\bd_
\be_
\bl_
\ba_
\by is set.
162 E
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT
163 D
\bDI
\bIS
\bSP
\bPL
\bLA
\bAY
\bY to get the default host and display number.
165 X
\bXE
\bEN
\bNV
\bVI
\bIR
\bRO
\bON
\bNM
\bME
\bEN
\bNT
\bT
166 to get the name of a resource file that overrides
167 the global resources stored in the RESOURCE_MAN-
170 S
\bSE
\bEE
\bE A
\bAL
\bLS
\bSO
\bO
171 X
\bX(1), x
\bxs
\bsc
\bcr
\bre
\bee
\ben
\bns
\bsa
\bav
\bve
\ber
\br(1)
173 D
\bDI
\bIS
\bST
\bTR
\bRI
\bIB
\bBU
\bUT
\bTI
\bIO
\bON
\bN P
\bPO
\bOL
\bLI
\bIC
\bCY
\bY
174 This work is Copyright (C) 1995, 1996 by James Macnicol.
175 Distribution is allowed under the terms of the GNU General
176 Public License. Look at the sources for the legalese.
178 A
\bAU
\bUT
\bTH
\bHO
\bOR
\bR
179 James Macnicol <J.Macnicol@student.anu.edu.au>.
196 X Version 11 14-Dec-95 3