ApplyTransformationParameters method (Main Control)

C++ Builder example

Delphi example

 

Builder Syntax

int ApplyTransformationParameters(int nXTranslation, int nYTranslation, int nAngle, unsigned uXScale, unsigned uYScale, unsigned uFlags);

Delphi Syntax

Function ApplyTransformationParameters (nXTranslation: INT; nYTranslation: INT; nAngle: INT; uXScale: UINT; uYScale: UINT; uFlags: UINT): INT;

Overview

Refer to Detecting Registration Marks

Remarks

(Document/Medical only) Corrects the image by removing the translation, rotation, and scaling deformations that have been applied on the image.

This method corrects the image by removing the translation, rotation, and scaling deformations that have been applied to the image. These transformations make this bitmap match a reference bitmap.

This method is designed to work with the GetTransformationParameters method.

You can get the translation, rotation, and scaling information by calling the GetTransformationParameters method. The values obtained by the GetTransformationParameters method must be passed as they are to the ApplyTransformationParameters method.

The shift operation is performed first, followed by the rotation and resize operations.

If you simply want to automatically straighten a bitmap, use the Deskew method.

This method supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.

This method does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this method.

See Also

Elements:

Combine method, Rotate method, Size method, Deskew method, GetTransformationParameters method, IsRegMark method, SearchRegMarks method, GetMarksCenterMass method.

Topics:

Raster Images: Document Imaging