X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=local%2Fman%2Fcat.1%2Fwebcollage.1;fp=local%2Fman%2Fcat.1%2Fwebcollage.1;h=e0234797618d4555ecaa6269b72896393fd294da;hb=41fae2ad67bc37e31c4d967bae81e4f3f50fa55a;hp=0000000000000000000000000000000000000000;hpb=278c59e14c53fd412b734e699bd4f314f766f804;p=xscreensaver diff --git a/local/man/cat.1/webcollage.1 b/local/man/cat.1/webcollage.1 new file mode 100644 index 00000000..e0234797 --- /dev/null +++ b/local/man/cat.1/webcollage.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + webcollage - decorate the screen with random images from + the web + +SSYYNNOOPPSSIISS + wweebbccoollllaaggee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-root] [-ver- + bose] [-delay _s_e_c_s] [-timeout _s_e_c_s] [-background _b_g] + [-filter _c_o_m_m_a_n_d] [-filter2 _c_o_m_m_a_n_d] + +DDEESSCCRRIIPPTTIIOONN + The _w_e_b_c_o_l_l_a_g_e program pulls random image off of the World + Wide Web and scatters them on the root window. It finds + these images by doing random web searches, and extracting + images from the returned pages. It places the images on + the root window by using the xxvv(1), ggiiffttooppnnmm(1), and + ddjjppeegg(1) tools. + + _w_e_b_c_o_l_l_a_g_e also works as a CGI program: simply make a sym- + bolic link to the _w_e_b_c_o_l_l_a_g_e executable called _n_p_h_-_w_e_b_c_o_l_- + _l_a_g_e_._c_g_i. If this program sees that it is being run as a + CGI, then it will behave appropriately. (The generated + web page will list the images one after another, rather + than tiling them together.) + + _w_e_b_c_o_l_l_a_g_e is written in ppeerrll(1) and requires Perl 5. + +OOPPTTIIOONNSS + _w_e_b_c_o_l_l_a_g_e accepts the following options: + + --rroooott Draw on the root window. This option is mandi- + tory: drawing to a window other than the root win- + dow is not yet supported. + + --vveerrbboossee or --vv + Print diagnostics to stderr. Multiple _-_v switches + increase the amount of output. _-_v will print out + only the URLs of the images; _-_v_v will print all + the commands being run; and _-_v_v_v will print more + than you care about. + + --ddeellaayy _s_e_c_o_n_d_s + How long to sleep between images. Default 1 sec- + ond. (Remember that this program probably spends + a lot of time waiting for the network.) + + --bbaacckkggrroouunndd _c_o_l_o_r_-_o_r_-_p_p_m + What to use for the background onto which images + are pasted. This may be a color name, a hexadeci- + mal RGB specification in the form '#rrggbb', or + the name of a PPM file. + + --ttiimmeeoouutt _s_e_c_o_n_d_s + How long to wait for a URL to complete before giv- + ing up on it and moving on to the next one. + + + +X Version 11 17-Jun-99 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + Default 30 seconds. + + --ffiilltteerr _c_o_m_m_a_n_d + Filter all source images through this command. + The command must take a PPM file on stdin, and + write a new PPM file to stdout. One good choice + for a filter would be: + + webcollage -root -filter 'vidwhacker -stdin -stdout' + + + --ffiilltteerr22 _c_o_m_m_a_n_d + Filter the _c_o_m_p_o_s_i_t_e image through this command. + The _-_f_i_l_t_e_r option applies to the sub-images; the + _-_f_i_l_t_e_r_2 applies to the final, full-screen image. + +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. + +FFIILLEESS AANNDD UURRLLSS + _/_u_s_r_/_d_i_c_t_/_w_o_r_d_s or _/_u_s_r_/_s_h_a_r_e_/_l_i_b_/_d_i_c_t_/_w_o_r_d_s + To find the random words to feed to search engines. + + _h_t_t_p_:_/_/_r_a_n_d_o_m_._y_a_h_o_o_._c_o_m_/_b_i_n_/_r_y_l_, + _h_t_t_p_:_/_/_i_m_a_g_e_._a_l_t_a_v_i_s_t_a_._c_o_m_/ To find random web pages. + +BBUUGGSS + When drawing on the root window, it always uses the + default colormap. This is actually a limitation of xv. + But regardless, when using this program with xscreensaver, + it must be given the ddeeffaauulltt--nn visual specification (see + the xxssccrreeeennssaavveerr(1) manual for more details.) + + Only the GIF and JPEG image formats are supported. + + Transparent and animating GIFs are not supported. + + It's slow. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxvv(1), ggiiffttooppnnmm(1), ddjjppeegg(1), vviidd-- + wwhhaacckkeerr(1), ppeerrll(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998, 1999 by Jamie Zawinski. Permission to + use, copy, modify, distribute, and sell this software and + its documentation for any purpose is hereby granted with- + out fee, provided that the above copyright notice appear + in all copies and that both that copyright notice and this + + + +X Version 11 17-Jun-99 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + permission notice appear in supporting documentation. No + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 24-May-98. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 17-Jun-99 3 + +