ImageGear for C and C++ on Windows v19.1 - Updated
IG_load_size_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Load Functions > IG_load_size_set

This function instructs ImageGear to resize images to specified dimensions during the loading.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_load_size_set(
   AT_DIMENSION nWidth,
   AT_DIMENSION nHeight
);

Arguments:

Name Type Description
nWidth AT_DIMENSION Specifies the width the images should have after loading.
nHeight AT_DIMENSION Specifies the height the images should have after loading.

Return Value:

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

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Example:

 
Copy Code
/* On loading, map the image into a 512 x 256 image bitmap: */
IG_load_size_set ( 512, 256 );

Remarks:

ImageGear will resize the images according to the specified dimensions, regardless of the dimensions in the source image file. The effect is similar to loading and then resizing the image. To reset ImageGear so that it will default to loading the entire image, set both parameters to 0. See also IG_load_size_get.

ImageGear does not apply interpolation for image resizing during the loading.