ImageGear Professional DLL v17.1 for Windows Accusoft
IG_REC_image_deskew
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Recognition Image Preprocessing Functions > IG_REC_image_deskew

Glossary Item Box

Performs immediate deskewing on the given image.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_image_deskew(
   HIG_REC_IMAGE hImage,
   AT_INT Slope
);

Arguments:

hImage Handle of the image.
Slope Integer slope value for deskewing. The value given here is the number of pixels of vertical ascent on 1000 horizontal pixels. That is, the tangent of the deskew angle multiplied by 1000. The Slope parameter must be in the range -577 to 577; that means the maximal slope value is 30 degrees.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

See IG_REC_image_import.

Remarks:

  1. Recognition component ignores a skew value if it is 0.5 degree or less.
  2. When this function is called, the coordinates of all defined zones in the zone list will be automatically recalculated.
  3. The image to be deskewed can be of any type (bi-tonal, grayscale, or color).
  4. The function IG_REC_image_skew_detect can detect the skew of a specified image, but only up to 15 degrees.
  5. This function ignores the current Image deskewing mode setting as set by a previous IG_REC_deskew_mode_set call and also the value in IG_REC_slope_set. Those settings relate only to deskewing performed during pre-processing initiated by IG_REC_image_preprocess, which supports programmed or auto-deskewing.

Example:

  Copy Code
AT_ERRCOUNT ErrCount = 0;
AT_INT nSlope = 0;
enumIGRecImgRotate eImgRotate = IG_REC_IMG_ROTATE_AUTO;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0;

ErrCount += IG_load_file("Image.tif", &higImage);
ErrCount += IG_REC_image_import(higImage, &higRecImage);
ErrCount += IG_REC_image_skew_detect(higRecImage, &nSlope, &eImgRotate);
ErrCount += IG_REC_image_deskew(higRecImage, nSlope);

//...

ErrCount += IG_REC_image_delete(higRecImage);
ErrCount += IG_image_delete(higImage);

See Also

HIG_REC_IMAGE

©2012. Accusoft Corporation. All Rights Reserved.