bggen man page on aLinux

Man page or keyword search:  
man Server   7435 pages
apropos Keyword Search (all sections)
Output format
aLinux logo
[printable version]

bggen(l)							      bggen(l)

       bggen - generates colored backgrounds on X11 displays

       bggen  [-d display] [-g geometry] [-G rptgeom] [-r rot] [-a] [-w width]
       [-h height] [-b bits] <color-spec> [<color-spec> ...]

       bggen is a program that generates a rectangular 24-bit  image,  with  a
       smooth vertical gradient between the listed colors.  (If you only spec‐
       ify one color, the image will be a single solid color.)	The top of the
       image  will be in color (r1,g1,b1), and the bottom of the image will be
       in color (rn,gn,bn).  Intermediate positions in the image are  interpo‐
       lated  between  these  colors.	If you specify more than 2 colors, the
       gradient passes through all the specified colors, in the	 order	speci‐

       The  '-d'  option  lets	you specify what display to connect to.	 bggen
       only connects to the display to find out the size of  the  screen  (and
       hence, the default size for the generated image).

       The '-g' option lets you control the size of the image, as a standard X
       geometry specification.	(ie, something like "512x348")

       The '-G' option lets you control the tile size, as a standard X	geome‐
       try  specification.   (ie,  something  like  "32x32") Normally, (if you
       don't give a -G option), the gradient fills the entire image.   If  you
       specify a -G option, the gradient will fill a portion of the image, and
       that portion will be 'center-tiled' to fill the rest of the image.

       The '-r' option lets you rotate the gradient counter-clockwise  by  the
       specified number of degrees.

       The  '-a'  option  lets	you  force  bggen  to generate an image in PPM
       'Ascii' format, rather than in PPM 'raw' format.

       The '-w' and '-h' options also let you set the size of the image.  They
       are provided only for backward compatibility.

       The  '-b'  option specifies the number of significant bits in the (out‐
       put) color specifications.  It must range between 1 and	8,  inclusive.
       Use  values  less than 8 (the default) to limit color use by increasing
       the color granularity.  Since XV can do this sort of thing better, this
       is of dubious value.

       A  <color-spec>	can  be three integers separated by spaces, forming an
       R,G,B triple ("0 255 0").  The values should be between 0 and 255.

       A <color-spec> can also be a standard X	color  specification  by  name
       ("green")  or  value  ("#00ff00").   This  is decidedly easier, and the
       'three integer' method remains mainly for backward compatibility.   One
       note:   the  '#'	 character  is	treated	 specially by many shells, and
       should probably be protected by putting a '\' character in front of it,
       or wrapping the entire value with a pair of single-quotes.

       bggen  doesn't  actually affect your background directly.  bggen merely
       generates a PPM (Portable Pixmap Format) datafile and dumps it to 'std‐
       out'.  It's up to some other program (such as XV) to read this file and
       display it.

       To use bggen, you should pipe its output into an XV command,  such  as:
       "xv -root -quit -"

       Light Blue to Dark Blue
	    bggen 100 100 255  0 0 100	| xv -root -quit  -
       RGB Rainbow
	    bggen red green blue | xv -root -quit -
       Green Cylinders
	    bggen black green black -h 128 | xv -root -quit -
       Blue to Magenta
	    bggen blue magenta | xv -root -quit -
       Full Rainbow
	    bggen black red yellow green blue purple black | xv -root -quit  -
       Repeating Rainbow
	    bggen red yellow green blue purple red -h 256 | xv -root -quit -
       Green Tiles
	    bggen green black  -r 30 -g 32x32 | xv -root -quit -
       Red Balls
	    bggen red black -r 45 -g 32x32 | xv -root -quit -rmode 3 -
       Red+Yellow Diamonds
	    bggen red yellow  -r 45 -g 32x32 | xv -root -quit -rmode 3 -

       John Bradley  -


List of man pages available for aLinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net