git.hungrycats.org Git - xscreensaver/blob - local/man/cat.1/bubbles.1

   1
   2
   3
   4 XScreenSaver(1)                                   XScreenSaver(1)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        bubbles - frying pan / soft drink simulation
   9
  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]
  15
  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.
  25
  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
  28        following options:
  29
  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.
  32
  33        -\b-b\bba\bac\bck\bkg\bgr\bro\bou\bun\bnd\bd
  34                Colour of window background.
  35
  36        -\b-w\bwi\bin\bnd\bdo\bow\bw Draw on  a  newly-created  window.   This  is  the
  37                default.
  38
  39        -\b-r\bro\boo\bot\bt   Draw on the root window.
  40
  41        -\b-m\bmo\bon\bno\bo   If   on  a  color  display,  pretend  we're  on  a
  42                monochrome display.
  43
  44        -\b-i\bin\bns\bst\bta\bal\bll\bl
  45                Install a private colormap for the window.
  46
  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.
  51
  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
  58                rate.
  59
  60
  61
  62
  63
  64 X Version 11                14-Dec-95                           1
  65
  66
  67
  68
  69
  70 XScreenSaver(1)                                   XScreenSaver(1)
  71
  72
  73        -\b-n\bno\bod\bde\bel\bla\bay\by
  74                Same as _\b-_\bd_\be_\bl_\ba_\by _\b0.
  75
  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
  79                sort of thing.
  80
  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).
  86
  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.
  96
  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).
 106
 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
 112                above).
 113
 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-
 116                abled by default.
 117
 118 N\bNO\bOT\bTE\bES\bS
 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.
 124
 125        Some  tools  to  assist  in  creation  of  new bubbles are
 126        included in the source distribution.  These can either  be
 127
 128
 129
 130 X Version 11                14-Dec-95                           2
 131
 132
 133
 134
 135
 136 XScreenSaver(1)                                   XScreenSaver(1)
 137
 138
 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-
 143        bles.README.
 144
 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
 148        random dots.
 149
 150 B\bBU\bUG\bGS\bS
 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.
 155
 156        The  movement  of the bubbles looks jerky if an incomplete
 157        set of bubbles is used.
 158
 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.
 161
 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.
 164
 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-
 168                AGER property.
 169
 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)
 172
 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.
 177
 178 A\bAU\bUT\bTH\bHO\bOR\bR
 179        James Macnicol <J.Macnicol@student.anu.edu.au>.
 180
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196 X Version 11                14-Dec-95                           3
 197
 198