XScreenSaver(1) XScreenSaver(1) NNAAMMEE bubbles - frying pan / soft drink simulation SSYYNNOOPPSSIISS bbuubbbblleess [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] [-visual _v_i_s_u_a_l] [-simple] [-broken] [-3D] [-file file- name] [-directory directoryname] DDEESSCCRRIIPPTTIIOONN _B_u_b_b_l_e_s 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. OOPPTTIIOONNSS Depending on how your _b_u_b_b_l_e_s was compiled, it accepts the following options: --ffoorreeggrroouunndd Colour of circles if _-_s_i_m_p_l_e mode is selected. --bbaacckkggrroouunndd Colour of window background. --wwiinnddooww Draw on a newly-created window. This is the default. --rroooott Draw on the root window. --mmoonnoo If on a color display, pretend we're on a monochrome display. --iinnssttaallll Install a private colormap for the window. --vviissuuaall _v_i_s_u_a_l 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. --ddeellaayy mmiiccrroosseeccoonnddss 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) --nnooddeellaayy Same as _-_d_e_l_a_y _0. --ssiimmppllee 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. --bbrrookkeenn 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). --33DD 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. --ffiillee ffiilleennaammee Use the pixmap definitions in the given file, instead of the default (if one is compiled in). This is ignored if _-_s_i_m_p_l_e 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 nnoott the default). --ddiirreeccttoorryy ddiirreeccttoorryynnaammee Similar to _-_f_i_l_e 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). --qquuiieett Don't print messages explaining why one or several command line options were ignored. This is dis- abled by default. NNOOTTEESS If you find the pace of things too slow, remember that there is a delay even though you specify no _-_d_e_l_a_y option. Try using _-_n_o_d_e_l_a_y 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 _-_f_i_l_e or _-_d_i_r_e_c_t_o_r_y 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. BBUUGGSS There is a delay before something appears on the screen when using rendered bubbles. The XPM library seems to take a lloonngg 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 _-_n_o_d_e_l_a_y is set. EENNVVIIRROONNMMEENNTT DDIISSPPLLAAYY to get the default host and display number. XXEENNVVIIRROONNMMEENNTT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MAN- AGER property. SSEEEE AALLSSOO XX(1), xxssccrreeeennssaavveerr(1) DDIISSTTRRIIBBUUTTIIOONN PPOOLLIICCYY 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. AAUUTTHHOORR James Macnicol . X Version 11 14-Dec-95 3