IG_load_size

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.

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.