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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

src

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

gcSpecifies the graphics context. 

src_x

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

width

heightSpecify the dimensions in pixels of both the source and destination rectangles. 

dest_x

dest_ySpecify the x and y coordinates within the destination window. 

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_exposures 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

BadMatchThe 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(), XFillRectangles(). 

Xlib Reference Manual