IKAffine

This function corrects a warped raster image.

[C++Builder/Visual C++] HANDLE IKAffine(HANDLE Handle, int Px1, int Py1, int Px2, int Py2, int Px3, int Py3, int Px4, int Py4, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

[Delphi] function IKAffine(Handle: THandle; Px1, Py1, Px2, Py2, Px3, Py3, Px4, Py4: Integer; UserProc: LONG_PTR; Caption, Message, Button: PChar): THandle;

[Visual Basic] Function IKAffine(ByVal Handle As Long, ByVal Px1 As Long, ByVal Py1 As Long, ByVal Px2 As Long, ByVal Py2 As Long, ByVal Px3 As Long, ByVal Py3 As Long, ByVal Px4 As Long, ByVal Py4 As Long, ByVal UserProc As Long, ByVal Caption As String, ByVal Message As String, ByVal Button As String) As Long

Parameters

Name	Explanation
Handle	The image handle of the raster image (Supports 1, 4, 8, 16, 24, and 32 bit images)
Px1 to Px4	The x coordinates of the four points defining the area for Affine changes. (in pixels)
Py1 to Py4	The y coordinates of the four points defining the area for Affine changes. (in pixels)
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 image handle of the corrected image if successful. Returns False (0) if unsuccessful.

Explanation

The IKAffine function corrects a warped raster image.

(Px1,Py1), (Px2,Py2), (Px3,Py3), (Px4,Py4) are the points of the (irregular) quadrangle that surrounds the area of the image to be corrected. The corrected area is squared and scaled to fit into a regular rectangle. Note: the image handle of the original image data is NOT 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 Ik9Effect.dll, Ik9EffectA.dll, Ik9Effect64.dll, Ik9Effect64A.dll section.