IG_IP_deskew

This function automatically detects the angle of the 1-bit document referenced by hIGear, and rotates it so that it is straight (i.e., de-skews it).

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_deskew_auto ( HIGEAR hIGear, DOUBLE dblAngleThresh, AT_MODE nExpand_clip_option );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle of image to be decoded.
dblAngleThresh	DOUBLE	Do not de-skew if the skew angle is less than this parameter.
nExpand_clip_option	AT_MODE	An AT_MODE type variable, either: IG_ROTATE_CLIP or IG_ROTATE_EXPAND.

Return Value:

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

Supported Raster Image Formats:

Indexed RGB – 1 bpp;
Grayscale – 1 bpp.

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / DOUBLE angle_thresh;/ max angle above which should not perform skew / AT_MODE nExpand_clip_option;/ expand image or clip doc / AT_ERRCOUNT nErrcount; / will tally returned IG errors */ nErrcount = IG_IP_deskew_auto ( hIGear, 3.0, IG_ROTATE_CLIP);

Copy Code

HIGEAR    hIGear;      /* HIGEAR handle of image  */
DOUBLE   angle_thresh;/* max angle above which should not perform skew  */
AT_MODE nExpand_clip_option;/* expand image or clip doc  */
AT_ERRCOUNT nErrcount;    /* will tally returned IG errors */
nErrcount = IG_IP_deskew_auto ( hIGear, 3.0, IG_ROTATE_CLIP);

Remarks:

If the skew angle is less than dblAngleThresh, then the image is not de-skewed. If nExpand_clip_option is set to IG_ROTATE_EXPAND, the size of image width or height will be enlarged as necessary to accommodate the document when it has been rotated. Otherwise, any areas of the document that now fall outside the borders of the original width and height of the image, will be cropped.

If you want to first detect the angle and then decide whether to rotate it, you can make separate calls to IG_IP_deskew_angle_find() and IG_IP_rotate_any_angle() functions.