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

XCopyArea()							   XCopyArea()

Name
  XCopyArea – copy an area of a drawable.

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

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

  src	    Specify the source and destination rectangles to be combined.
  dest	    src and dest must have the same root and depth.

  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  source
	    drawable.

  width	    Specify  the dimensions in pixels of both the source and des‐
  height    tination rectangles.

  dest_x    Specify the x and y coordinates within the	destination  win‐
	    dow.
  dest_y

Description
  XCopyArea()  combines the specified rectangle of src with the specified
  rectangle of dest.  src and dest must have the same root and depth.

  If regions of the source rectangle  are  obscured  and  have	not  been
  retained  in backing_store, or if regions outside the boundaries of the
  source drawable are specified,  then	those  regions	are  not  copied.
  Instead,  the following occurs on all corresponding destination regions
  that are either visible or are retained in backing_store.  If dest is a
  window  with a background other than None, the corresponding regions of
  the destination are tiled (with plane_mask  of  all  1's  and	 function
  GXcopy) with that background.	 Regardless of tiling, if the destination
  is a window and graphics_exposures in gc is True,  then  GraphicsExpose
  events  for  all  corresponding  destination regions are generated.  If
  graphics_exposures is True but no regions are exposed, then a	 NoExpose
  event is generated.

  If  regions of the source rectangle are not obscured and graphics_expo‐
  sures is False, one NoExpose event is generated on the destination.

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

Errors
  BadDrawable

  BadGC

  BadMatch    The src and dest rectangles do not have the same	root  and
	      depth.

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

Xlib - Drawing Primitives					   XCopyArea()

Vote for polarhome