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   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XCopyPlane()							  XCopyPlane()

Name
  XCopyPlane  –	 copy  a  single plane of a drawable into a drawable with
  depth, applying pixel values.

Synopsis
  XCopyPlane(display, src, dest, gc, src_x, src_y, width, height,
	    dest_x, dest_y, plane)
	Display *display;
	Drawable src, dest;
	GC gc;
	int src_x, src_y;
	unsigned int width, height;
	int dest_x, dest_y;
	unsigned long plane;

Arguments
  display   Specifies  a  connection  to  an  X	 server;  returned   from
	    XOpenDisplay().

  src	    Specify the source and destination drawables.
  dest

  gc	    Specifies the graphics context.

  src_x	    Specify  the  x and y coordinates of the upper-left corner of
  src_y	    the source rectangle relative to the origin of the drawable.

  width	    Specify the width and height in pixels.  These are the dimen‐
  height    sions of both the source and destination rectangles.

  dest_x    Specify the x and y coordinates at which the copied area will
  dest_y    be placed relative to the origin of the destination drawable.

  plane	    Specifies the source bit-plane.  You  must	set  exactly  one
	    bit, and the bit must specify a plane that exists in src.

Description
  XCopyPlane()	copies	a  single plane of a rectangle in the source into
  the entire depth of a corresponding rectangle in the destination.   The
  plane of the source drawable and the foreground/background pixel values
  in gc are combined to form a pixmap of the same depth as  the	 destina‐
  tion	drawable, and the equivalent of an XCopyArea() is performed, with
  all the same exposure semantics.

  XCopyPlane()	uses  these  graphics  context	 components:	function,
  plane_mask, foreground, background, subwindow_mode, graphics_exposures,
  clip_x_origin, clip_y_origin, and clip_mask.

  The src and dest drawables must have the same root, but need	not  have
  the same depth.

  For more information, see Volume One, Chapter 5, The Graphics Context.

Errors
  BadDrawable

  BadGC

  BadMatch  src and dest do not have the same root.

  BadValue  plane  does not have exactly one bit set, or bit specified in
	    plane is not a plane in src.

See Also
  XClearArea(),	  XClearWindow(),   XCopyArea(),    XDraw,    XDrawArc(),
  XDrawArcs(),	XDrawFilled(),	XDrawLine(),  XDrawLines(), XDrawPoint(),
  XDrawPoints(),  XDrawRectangle(),  XDrawRectangles(),	 XDrawSegments(),
  XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectan‐
  gles().

Xlib - Drawing Primitives					  XCopyPlane()

Vote for polarhome