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)

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.