NAME

XSubImage — create a subimage from part of an image. 

SYNOPSIS

XImage ∗XSubImage(ximage, x, y, subimage_width, subimage_height) XImage ∗ximage;  int x;y;  unsigned int subimage_width, subimage_height;

ARGUMENTS

ximageSpecifies a pointer to the image. 

x

ySpecify the x and y coordinates in the existing image where the subimage will be extracted. 

subimage_width

subimage_height
Specify the width and height (in pixels) of the new subimage.

RETURNS

The created image. 

DESCRIPTION

XSubImage() creates a new image that is a subsection of an existing one.  It allocates the memory necessary for the new XImage structure and returns a pointer to the new image.  The data is copied from the source image, and the rectangle defined by x, y, subimage_width, and subimage_height must by contained in the image. 

XSubImage() extracts a subimage from an image, while XGetSubImage() extracts an image from a drawable. 

For more information on images, see Volume One, Chapter 6, Drawing Graphics and Text. 

SEE ALSO

XImageByteOrder(), XAddPixel(), XCreateImage(), XDestroyImage(), XGetImage(), XGetPixel(), XGetSubImage(), XPutImage(), XPutPixel(). 

Xlib Reference Manual