--- /dev/null
+
+
+
+XScreenSaver(1) XScreenSaver(1)
+
+
+N\bNA\bAM\bME\bE
+ bubbles - frying pan / soft drink simulation
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+ 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]
+ [-background _\bc_\bo_\bl_\bo_\br] [-window] [-root] [-mono] [-install]
+ [-visual _\bv_\bi_\bs_\bu_\ba_\bl] [-simple] [-broken] [-3D] [-file file-
+ name] [-directory directoryname]
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+ _\bB_\bu_\bb_\bb_\bl_\be_\bs sprays lots of little random bubbles all over the
+ window which then grow until they reach their maximum size
+ and go pop. The inspiration for this was watching little
+ globules of oil on the bottom of a frying pan and it also
+ looks a little like bubbles in fizzy soft drink. The
+ default mode uses fancy ray-traced bubbles but there is
+ also a mode which just draws circles in case the default
+ mode is too taxing on your hardware.
+
+O\bOP\bPT\bTI\bIO\bON\bNS\bS
+ Depending on how your _\bb_\bu_\bb_\bb_\bl_\be_\bs was compiled, it accepts the
+ following options:
+
+ -\b-f\bfo\bor\bre\beg\bgr\bro\bou\bun\bnd\bd
+ Colour of circles if _\b-_\bs_\bi_\bm_\bp_\bl_\be mode is selected.
+
+ -\b-b\bba\bac\bck\bkg\bgr\bro\bou\bun\bnd\bd
+ Colour of window background.
+
+ -\b-w\bwi\bin\bnd\bdo\bow\bw Draw on a newly-created window. This is the
+ default.
+
+ -\b-r\bro\boo\bot\bt Draw on the root window.
+
+ -\b-m\bmo\bon\bno\bo If on a color display, pretend we're on a
+ monochrome display.
+
+ -\b-i\bin\bns\bst\bta\bal\bll\bl
+ Install a private colormap for the window.
+
+ -\b-v\bvi\bis\bsu\bua\bal\bl _\bv_\bi_\bs_\bu_\ba_\bl
+ Specify which visual to use. Legal values are the
+ name of a visual class, or the id number (decimal
+ or hex) of a specific visual.
+
+ -\b-d\bde\bel\bla\bay\by m\bmi\bic\bcr\bro\bos\bse\bec\bco\bon\bnd\bds\bs
+ How much of a delay should be introduced between
+ steps of the animation. Default 1, or about 1
+ microsecond. Actually, this is the delay between
+ each group of 15 new bubbles since such a delay
+ between each step results in a very slow animation
+ rate.
+
+
+
+
+
+X Version 11 14-Dec-95 1
+
+
+
+
+
+XScreenSaver(1) XScreenSaver(1)
+
+
+ -\b-n\bno\bod\bde\bel\bla\bay\by
+ Same as _\b-_\bd_\be_\bl_\ba_\by _\b0.
+
+ -\b-s\bsi\bim\bmp\bpl\ble\be Don't use the default fancy pixmap bubbles. Just
+ draw circles instead. This may give more bearable
+ performance if your hardware wasn't made for this
+ sort of thing.
+
+ -\b-b\bbr\bro\bok\bke\ben\bn Don't hide bubbles when they pop. This was a bug
+ during development but the results were actually
+ quite attractive. (This option is only available
+ if you have the XPM library available and the
+ imake generated Makefile has defined HAVE_XPM).
+
+ -\b-3\b3D\bD Normally, the simulation is done completely in two
+ dimensions. When a bubble swallows up another
+ bubble, the areas of each are added to get the
+ area of the resulting bubble. This option changes
+ the algorithm to instead add volume (imagining
+ each to be a sphere in 3D space). The whole thing
+ looks more realistic but I find it attracts atten-
+ tion to the flickering of each bubble as they are
+ move and are redrawn. Your mileage may vary.
+
+ -\b-f\bfi\bil\ble\be f\bfi\bil\ble\ben\bna\bam\bme\be
+ Use the pixmap definitions in the given file,
+ instead of the default (if one is compiled in).
+ This is ignored if _\b-_\bs_\bi_\bm_\bp_\bl_\be is specified. If the
+ file is compressed (either with compress or gzip),
+ it is decompressed before use. (This option only
+ works if you have XPM compiled into your binary
+ and you have compiled with BUBBLES_IO set in bub-
+ bles.h. This is n\bno\bot\bt the default).
+
+ -\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
+ Similar to _\b-_\bf_\bi_\bl_\be except the file is taken randomly
+ from the contents of the specified directory.
+ (Again, this option is only available if you have
+ XPM and BUBBLES_IO was set when compiling. See
+ above).
+
+ -\b-q\bqu\bui\bie\bet\bt Don't print messages explaining why one or several
+ command line options were ignored. This is dis-
+ abled by default.
+
+N\bNO\bOT\bTE\bES\bS
+ If you find the pace of things too slow, remember that
+ there is a delay even though you specify no _\b-_\bd_\be_\bl_\ba_\by option.
+ Try using _\b-_\bn_\bo_\bd_\be_\bl_\ba_\by although beware of the effects of irri-
+ tation of other users if you're on a shared system as you
+ bleed their CPU time away.
+
+ Some tools to assist in creation of new bubbles are
+ included in the source distribution. These can either be
+
+
+
+X Version 11 14-Dec-95 2
+
+
+
+
+
+XScreenSaver(1) XScreenSaver(1)
+
+
+ loaded with the _\b-_\bf_\bi_\bl_\be or _\b-_\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by options (if available)
+ or they can be used in place of the distributed default
+ bubble (bubble_default.c). You might like to copy these
+ scripts to a permanent location and use them. Read bub-
+ bles.README.
+
+ Rendered bubbles are not supported on monochrome displays.
+ I'm not convinced that small bubbles, even dithered prop-
+ erly are going to look like anything more than a jumble of
+ random dots.
+
+B\bBU\bUG\bGS\bS
+ There is a delay before something appears on the screen
+ when using rendered bubbles. The XPM library seems to
+ take a l\blo\bon\bng\bg time to make pixmaps out of raw data. This
+ can be irritating on slower systems.
+
+ The movement of the bubbles looks jerky if an incomplete
+ set of bubbles is used.
+
+ The hide/display algorithm could do with some work to
+ avoid flickering when _\b-_\bn_\bo_\bd_\be_\bl_\ba_\by is set.
+
+E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+ D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
+
+ X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+ to get the name of a resource file that overrides
+ the global resources stored in the RESOURCE_MAN-
+ AGER property.
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+ X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1)
+
+D\bDI\bIS\bST\bTR\bRI\bIB\bBU\bUT\bTI\bIO\bON\bN P\bPO\bOL\bLI\bIC\bCY\bY
+ This work is Copyright (C) 1995, 1996 by James Macnicol.
+ Distribution is allowed under the terms of the GNU General
+ Public License. Look at the sources for the legalese.
+
+A\bAU\bUT\bTH\bHO\bOR\bR
+ James Macnicol <J.Macnicol@student.anu.edu.au>.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+X Version 11 14-Dec-95 3
+
+