Affine (ImageKit Control/ Effect Method)

This method corrects a warped raster image

[Visual Basic] [ Boolean = ]imagekitcontrolname.Effect.Affine(Px1 As Long, Py1 As Long, Px2 As Long, Py2 As Long, Px3 As Long, Py3 As Long, Px4 As Long, Py4 As Long)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetEffect().Affine(long Px1, long Py1, long Px2, long Py2, long Px3, long Py3, long Px4, long Py4)

[VB.NET] [ Boolean = ]imagekitcontrolname.Effect.Affine(Px1 As Integer, Py1 As Integer, Px2 As Integer, Py2 As Integer, Px3 As Integer, Py3 As Integer, Px4 As Integer, Py4 As Integer)

[C#.NET] [ bool = ]imagekitcontrolname.Effect.Affine(int Px1, int Py1, int Px2, int Py2, int Px3, int Py3, int Px4, int Py4)

Parameters

Name	Explanation
Px1-Px4	The x coordinates of the four points defining the area for Affine changes. (in pixels)
Py1-Py4	The y coordinates of the four points defining the area for Affine changes. (in pixels)

Return Value

Returns True (nonzero) if successful, otherwise returns False (0).

Explanation

The Affine method corrects a warped raster image. (Px1,Py1), (Px2,Py2), (Px3,Py3), (Px4,Py4) are the points of the (irregular) quadrangle that surrounds the area in the image to be corrected. The corrected area is squared and scaled to fit into a regular rectangle.

To execute the Affine method, set the image handle of the image in the ImageHandle property or the Layer(LayerNo).ImageHandle property. The Affine method supports 1, 4, 8, 16, 24, and 32 bit color images. If successful the resulting raster image data is set in the LayerNo property (the ImageHandle property or the Layer(LayerNo).ImageHandle property. If unsuccessful, 0 is returned.

When the Caption, Message, and ButtonName properties are blank, the progress dialog box will not be displayed. When the progress dialog box is displayed, the percentage that the processing has completed will be shown in the dialog box.