IKResize

This function changes the size of raster images. Use this function in Visual Basic and Visual C++. For C++Builder and Delphi, please refer to the IKResizeEx function.

[Visual Basic] Function IKResize(SrcHandle As IKSELECT_IMAGE, ByVal Width As Long, ByVal Height As Long, ByVal Mode As Long, ByVal UserProc As Long, ByVal Caption As String, ByVal Message As String, ByVal Button As String) As IKSELECT_IMAGE

[Visual C++] IKSELECT_IMAGE IKResize(PTR_IKSELECT_IMAGE SrcHandle, long Width, long Height, BOOL Mode, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

Parameters

Name	Explanation
SrcHandle	A structure containing the image handle and the mask image handle member variables hImgBmh can be 1, 4, 8, 16, 24, or 32 bit images
Width	The width of the new image (in pixels)
Height	The height of the new image (in pixels)
Mode	Sets whether Interpolation is used. (False (0): does not interpolate, True (nonzero): interpolates). When enlarging the image, the linear interpolation method is used, when reducing the image, the average method is used. The interpolation can be used for 8 bit grayscale, 16, 24, and 32 bit images.
UserProc	The address of the user function (If not using the user function then set to 0)
Caption	Sets the text displayed in the title bar of the progress dialog box
Message	Sets the message displayed in the progress dialog box
Button	Sets the name of the button displayed in the progress dialog box

Return Value

Returns the raster image handle and mask image handle in the structure members if successful. If unsuccessful, 0 is returned in the structure member variables.

Explanation

The IKResize function changes the size of raster images. When the Mode parameter is false (No interpolation) then changes in size can adversely affect the quality of the Image. Use this function in Visual Basic and Visual C++. For C++Builder and Delphi, please refer to the IKResizeEx function.

Note: the image handles passed to IKSELECT_IMAGE are NOT automatically freed after executing this function.

If the user function is set or if the Caption, Message, and Button parameters are blank then the Progress dialog box is not displayed. If the Progress dialog box is displayed, it indicates the percentage of the current process completed. For more information about the user function please refer to the Definition of User Function in the Ik10Effect.dll, Ik10EffectA.dll, Ik10Effect64.dll, Ik10Effect64A.dlll section.