X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=local%2Fman%2Fcat.1%2Fbubbles.1;fp=local%2Fman%2Fcat.1%2Fbubbles.1;h=27e7ed826bd871a545a480be6450f3af6b11bd83;hb=41fae2ad67bc37e31c4d967bae81e4f3f50fa55a;hp=0000000000000000000000000000000000000000;hpb=278c59e14c53fd412b734e699bd4f314f766f804;p=xscreensaver diff --git a/local/man/cat.1/bubbles.1 b/local/man/cat.1/bubbles.1 new file mode 100644 index 00000000..27e7ed82 --- /dev/null +++ b/local/man/cat.1/bubbles.1 @@ -0,0 +1,198 @@ + + + +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 + +