ImageGear for C and C++ on Windows v19.1 - Updated
IG_IP_resize_canvas
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_resize_canvas

This function resizes the image referenced by hIGear without scaling it.

Declaration:

 
Copy Code
AT_ERRCOUNT LACCUAPI IG_IP_resize_canvas(
   HIGEAR hIGear,
   AT_DIMENSION new_width,
   AT_DIMENSION new_height,
   AT_PIXPOS nXPos,
   AT_PIXPOS nYPos,
   LPAT_PIXEL lpBkgColor
);

Arguments:

Name Type Description
hIGear HIGEAR Image to process.
new_width AT_DIMENSION Width of the image after resizing.
new_height AT_DIMENSION Height of the image after resizing.
nXPos AT_PIXPOS X offset at which to put left top corner of the image after resizing.
nYPos AT_PIXPOS Y offset at which to put left top corner of the image after resizing.
lpBkgColor LPAT_PIXEL Color to fill the empty area. Ignored for vector images.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

See GUI component source code.

Remarks:

The image data in the bitmap is not stretched or compressed, but copied to the specified offset in the new image.