10350 Santa Monica Blvd. Suite 285,
Phone: 310-691-8920, 310-788-9840, Fax: 419-735-2419
Card Scanning Solutions 20
1.1.18. AutoDetectStateEx
Format
Parameters
[in] Reserved – Null terminated empty string - reserved. This parameter is not used.
[out] angle – Return the amount of clockwise 90 degrees turns that the image was rotated to be aligned
horizontally.
Return
LICENSE_INVALID: The license is invalid. All scanner operations are disabled.
ID_ERR_USA_TEMPLATES_NOT_FOUND: The template database file for the USA states
(UsaIds.bin) is missing. The file should be located in the SDK files location.
INVALID_INTERNAL_IMAGE – No internal image is loaded. This value return when attempting to
use this function without scanning an image first.
ID_ERR_STATE_NOT_SUPORTED : The license image doe not match any state template.
ID_ERR_STATE_NOT_RECOGNIZED : The license image doe not match any state template.
If non of the above error values is returned, the function return the state id value.
Remarks
Use this function to automatically align the internal image horizontally and then to detect the. If the
function returns with non of the above error values then the return value is the state id. This value can
be assigned to the input parameter IdState in the function ProcState for data extraction. The function
loads in the parameter angle one of the following values:
ANGLE_0: The image was received in the proper alignment.
ANGLE_90: The image was rotated once in 90 degrees (clockwise).
ANGLE_180: The image was rotated twice in 90 degrees (clockwise).
ANGLE_270: The image was rotated three times in 90 degrees (clockwise).
You can dump the rotated image from the internal buffer to a file using the function RotateImage