IG_gui_load_options

This function shows the load options dialog that can be used to specify loading parameters for the image file.

Declaration:

	Copy Code
BOOL ACCUAPI IG_gui_load_options_dlg( HWND hWnd );

Arguments:

Name	Type	Description
hWnd	HWND	A handle of the parent window.

Return Value:

If the user specifies parameters and clicks the OK button, the return value is non-zero. If the user cancels or closes the dialog box or an error occurs, the return value is zero.

Supported Raster Image Formats:

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

Sample:

Filters

Example:

	Copy Code
case ID_SETTINGS_LOADOPTIONS: IG_gui_load_options_dlg( hWnd ); break;

Remarks:

This dialog can be used to specify the following:

Load size dimensions - the dimensions that the DIB image bitmap created by a load, are to have, regardless of the dimensions in the file from which the image is loaded. The effect is similar to loading and then re-sizing the image.
Color reduction - reducing the number of Bits Per Pixel whenever loading an image whose bit depth is greater than that specified by nColorReduceMode. The bit depth is reduced to 8, 4, or 1 as specified.
Load rectangle - this will cause an image loaded to be cropped. Portions of the image falling outside the coordinates of this rectangle will be discarded, and will not appear in the image bitmap of the DIB created by the load.