Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   31559 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

BGPASTE(6D)							   BGPASTE(6D)

NAME
     bgpaste - paste an image onto the root window

SYNOPSIS
     bgpaste [-t r g b] [-o xorig yorig] inimage
     bgpaste [-t r g b] -n numimgs xorg yorg img [xorg yorg img . . . ]

DESCRIPTION
     bgpaste works in one of two distinct ways:	 either feed it one image,
     which by default is automatically centered (or explicitly specify the
     image's origin), or feed it a list of one or more images preceeded by
     their respective x/y origins to be painted as a composite in the root
     window.

     In the first case, bgpaste centers and pastes inimage onto the root
     window regardless of inimage's size.

     You can override the "centering" default and explicitly position your own
     image manually by using the -o option to specify the image's absolute-
     screenspace origin as measured from the bottom-left corner of the
     graphics display screen.  The xorig,yorig pair is defined in terms of the
     image's bottom-left corner.  Negative values are legal to specify and
     will "plant" the image's origin offscreen to the left and/or the bottom
     of the screen origin.

     In the second case, the -n flag tells bgpaste you are including a list of
     n images, where each image is preceeded by its respective x/y origin pair
     (again, negative values are legal).  The intersection of the composite
     set of images with that of the root window size is calculated and a
     buffer of that size is allocated which will contain the composite.	 The
     images will be painted in the order enumerated:  the first image listed
     will be painted first, the last will be painted last.  Any "background"
     within the composite, as well as any remaining area of the root window
     not included in the intersection, will be painted with the default gray
     color or one defined using the -t flag.

     In either of the above descriptions, if either the X or the Y size (or
     both) of inimage/composite is smaller than the screen size, a gray
     background is painted where the image/composite doesn't appear.  This
     gray default color can be redefined to be a specific RGB triplet using
     the -t option followed by the r g b integer triplet.  Use izoom(6D) if
     you wish to blowup an inmage that is smaller than the screen's X and/or Y
     size.

NOTE
     When employing bgpaste -n performance will degrade because of the
     creation of the buffer which stores the composite root window image.

SEE ALSO
     izoom(6D)

									Page 1

Vote for polarhome