.TH "chbg-1.5" "1" "" "" "" .SH "NAME" chbg \- root background image changer & manager for X .SH "SYNOPSIS" .B chbg .I [OPTIONS..] [IMAGE FILES] .SH "DESCRIPTION" .B chbg is a simple program for managing & changing desktop pictures that can also be used as a .BR xscreensaver(1) client. .SH "OPTIONS" .TP \fB\-v\fR Prints version number and exit. .TP \fB\-h \-\-help\fR Prints help message and exit. .TP \fB\-setup\fR Starts setup window. .TP \fB\-scenario \fIfilename\fR Fetch parameters from specified file. .TP \fB\-mode \fItype\fR Set picture rendering mode from following types : \fItile\fR, \fImirror\fR, \fIcenter\fR, \fImaximize\fR, \fIsmart\fR, \fIcentertile\fR, \fIinttile\fR, \fIsymtile\fR, \fIintmirror\fR, \fIsymmirror\fR. (Default: smart) .TP \fB\-effect \fIn\fR Effect type for changing pictures [0\-29]. 0 : no effect. (Default) 1 : random effect. 2\-29 : various picture changing effects. .TP \fB\-bg \fI"#rrggbb"\fR Set default background color 1. (Default: #000000) .TP \fB\-bg2 \fI"#rrggbb"\fR Set default background color 2. (Default: #ffffff) .TP \fB\-rand_colors\fR Randomize background colors. .TP \fB\-shader \fIn\fR Set background color shading effect type [0\-564]. 0 : no shading. (Default) 1 : random shading style. 2\-564 : various shading types. .TP \fB\-interval \fIn.n\-n.n\fR Picture change time in [min].[sec] format. Adding second time value ChBg generates random changetime using user defined values as boundaries. New changetime is generated during picture change. (Default: 5) .TP \fB\-max_grow \fIn.n\fR Maximal growing ratio of picture in smart mode. (Default: 1.0) .TP \fB\-max_size \fIpercentage\fR Maximal size of picture in % of screen size used in smart mode, acceptable value 10\-100. (Default: 90) .TP \fB\-xpos \fIn.n\fR Adjust picture's horizontal position in screen when using smart mode. (Value between 0.0\-1.0 Default: 0.5) .TP \fB\-ypos \fIn.n\fR Adjust picture's vertical position in screen when using smart mode. (Value between 0.0\-1.0 Default: 0.5) .TP \fB\-randomize\fR Randomize picture order. .TP \fB\-screensaver\fR Act as screensaver. .TP \fB\-xscreensaver\fR Act as xscreensaver client. .TP \fB\-speed \fIn\fR Speed ratio for picture changing effects. Smaller value means faster change. (Default: 100) .TP \fB\-blank\fR Show blank screen, when unable to load picture. .TP \fB\-cycle_blank\fR When pictures not present cycle with blanking screen. (optionaly with shading) .TP \fB\-R\fR Recurse through directory and search pictures. See also options \fI\-pattern\fR and \fI\-min\_psize\fR. .TP \fB\-pattern \fIpattern\fR Wildcard pattern for picture selection in recursion through directories. When you want to use more patterns, use more \fI\-pattern\fR options. (effects only when used with \fI\-R\fR option) .TP \fB\-inwindow\fR Run in own window not on root. .TP \fB\-windowid \fIid\fR Run in existing window. .TP \fB\-run\fR Start run after setup window is popped up. (effects only when used with \fI\-setup\fR option) .TP \fB\-min_psize \fIn\fR Minimal size of picture when recursing through directory. This option allows you to exclude small pictures or possible thumbnails. (effects only when used with \fI\-R\fR option) .TP \fB\-deffects \fIlist\fR List of disabled picture changing effects when randomizing. This option allows you to omit some picture changing effects, which you don't like or which doesn't suit your needs. Usable, when you want to reject some of slow effects when faster changing is required. .TP \fB\-dshaders \fIlist\fR List of disabled background shading effects when randomizing. This option allows you to omit some picture changing effects, which you don't like or which doesn't suit your needs. .TP \fB\-notooltips\fR Disable showing description tooltips for setup controls. .TP \fB\-friter \fIn\fR Set number of iterations in fractal based shading effects. (Default: 30) .TP \fB\-rect_size \fIn\fR Set size of used rectangle in any of picture changing effects. (Default: 16) .TP \fB\-grad_dir \fIdir\fR Directory where GIMP gradients can be located on your system. As default following directories are scanned to search gradient files. \fI/usr/share/gimp/gradients\fR \fI/usr/share/gimp\-1.1/gradients\fR \fI/usr/share/gimp\-1.2/gradients\fR \fI/opt/share/gimp/gradients\fR \fI/opt/share/gimp\-1.1/gradients\fR \fI/opt/share/gimp\-1.2/gradients\fR \fI/usr/local/share/gimp/gradients\fR \fI/usr/local/share/gimp\-1.1/gradients\fR \fI/usr/local/share/gimp\-1.2/gradients\fR When GIMP gradient files are elsewhere than default directories, use this option to force ChBg to load GIMP gradients from your directory. When ChBg can't find gradient, it will automatically disable all gradient shading features. .TP \fB\-use_grad\fR Enable the use of GIMP gradients for coloring background shading effects. .TP \fB\-grad \fIn\fR Set gradient number to use for coloring background shading effects. 0 means random. .TP \fB\-remember\fR Allow remembering of last shown picture. This is very usable when you maintain very long list of pictures and next time when you run ChBg with same scenario file you want to continue from that point where you left ChBg last time. WARNING: this feature requires to have saved scenarion and that scenario must be writable by user. .TP \fB\-enlightenment\fR If you are running \fIEnlightenment\fR window manager on your desktop, you may want to use its functions to manage desktop background images. When you enable this option, ChBg will try to use its capabilities. This works only with enlightenment 0.16 and above using \fIeesh\fR program. .TP \fB\-once\fR This option have only effect when used directly from commandline and ChBg will run without GUI environment. When this option is used, ChBg will run only one cycle of background changing and after that it will exit. This is usable if you want to change background once per session (for example from \fI.xinitrc\fR or \fI.xsession\fR startup scripts or Gnome/KDE session managers). .TP \fB\-thumb \fItype\fR You can use this option when you just want to use directly one of ChBg's thumbnail previews. As \fItype\fR use one of \fIall\fR/\fIdir\fR/\fIpage\fR. .TP \fB\-use_tiles\fR This option activates coloring of shading effects by tiled pixmaps. To activate it fully, you must also use \fI\-tile\fR option. .TP \fB\-tile \fIfile\fR With this option you can set picture which will be used as tile for coloring background shading effects or just plain drawn on backround when no shading effect will be used. To activate this feature you must also use \fI\-use\_tiles\fR option, otherwise it won't work. You can also set the \fIfile\fR parameter to \fIrandom\fR and ChBg will select randomly one of tiles set by \fI\-add\_tile\fR option. .TP \fB\-add_tile \fIfile\fR Use this option, when you want to use multiple tiles for coloring background shading effects. Parameter \fIfile\fR can be one picture file or directory with pictures, which will be scanned recursively for pictures. See also \fI\-tile\fR and \fI\-use\_tiles\fR options. .TP \fB\-use_banners\fR This options activates use of banner pictures on top of normal background pictures. Banner pictures will be drawn in mode similar to \fIsmart\fR mode for normal background pictures. To fully use this feature, you must also set banner pictures with \fI\-banner\fR and or \fI\-add\_banner\fR options. .TP \fB\-banner \fIfile\fR Parameter \fIfile\fR of this options sets particular banner picture file or when it is set to "\fIrandom\fR" it can randomly select one banner from banner files added by \fI\-add\_banner\fR option. .TP \fB\-add_banner \fIfile\fR Set a directory where to find banner pictures or file which will be use as a banner. .TP \fB\-banner_mode \fImode\fR ChBg allows various drawing modes for drawing banner on top of background. You can set one of \fInormal\fR, \fIaverage\fR, \fIlighten\fR, \fIdarken\fR, \fIdivide\fR, \fImultiply\fR, \fImultiplybg\fR, \fImultiplyfg\fR, \fIadd\fR, \fIsubtractbg\fR, \fIsubtractfg\fR, \fIgrayscale\fR, \fIbumpmap\fR, \fIbumpmapself\fR or number \fI0\-13\fR. .TP \fB\-banner_xpos \fIpos\fR Horizontal position of banner on the screen. It is similar to \fI\-xpos\fR. .TP \fB\-banner_ypos \fIpos\fR Vertical position of banner on the screen. It is similar to \fI\-ypos\fR. .TP \fB\-banner_max_grow \fIratio\fR Maximal banner growing ratio. This option is equal to \fI\-max_grow\fR option, it is just applied to banners. .TP \fB\-banner_max_size \fInr\fR Maximal allowed area of screen taken by banner. It is equal to \fI\-max\_size\fR option. .TP \fB\-to_file\fR Render the composite picture directly to file. To work fully \fI\-out\_file\fR, \fI\-out\_file\_width\fR and \fI\-out\_file\_height\fR have to be given. Fileformat of the rendered picture is PNG. .TP \fB\-out_file \fIfilename\fR Set the composite picture's filename. .TP \fB\-out_file_width \fIn\fR Set composite picture's width. (Default value 0 means that ChBg takes size from X root window.) .TP \fB\-out_file_height \fIn\fR Set composite picture's height. (Default value 0 means that ChBg takes size from X root window.) .TP \fB\-force_nautilus\fR Force Nautilus to use ChBg generated picture. .TP \fB\-send_expose\fR Send expose event to foreign window to force redraw. .SH "FILES" .I chbgrc.sample .RS Sample configuration file. .SH "BUGS" See file \fIBUGS\fR in chbg source distribution. .SH "AUTHOR" Programm \- Stefan Ondrejicka .br Manual page \- Mikko Kilponen .SH "SEE ALSO" .BR X(1), .BR xscreensaver(1), .BR xscreensaver\-command(1).