10350 Santa Monica Blvd. Suite 285,
Phone: 310-691-8920, 310-788-9840, Fax: 419-735-2419
Card Scanning Solutions 25
1.1.26. GetSignImage
Format
Parameters
[in] SourceFileName – Null terminated string that holds the full path of the scanned id image. If this
string is empty the internal image is used as image source.
[in] DestFileName – Null terminated string that holds the full name of the destination
image file that will contain the signature image from the id document.
[in] stateId – The state index value as defined in idLibDef.bas file.
Return
If function succeeds, the return value is ID_TRUE
If the function fails one of the following values is returned:
LICENSE_INVALID – Library was not initialized with proper license.
ID_ERR_FILE_OPEN – Failing to load source image (if SourceFileName is not empty)
INVALID_INTERNAL_IMAGE – No internal image is loaded. This value return when attempting to
use the internal image without scanning an image first.
ID_ERR_STATE_NOT_SUPORTED – The requested state is not supported.
ID_BAD_DESTINATION_FILE – Bad destination path (could not create destination file).
ID_ERR_FILE_OPEN – Bad source image file (used only when using a file as the source image).
This value return if the source file is missing or cannot be accessed for reading.
INVALID_INTERNAL_IMAGE– Bad internal image (used only when extracting the signature
image from the image stored in the internal buffer). This value returned if there is no image in the
buffer.
ID_FALSE– Internal processing error.
ID_ERR_FACE_IMAGE_NOT_FOUND– Returned when the analyzer cannot detect the face image
in the driver’s license image.
ID_ERR_CANNOT_DELETE_DESTINATION_IMAGE– Returned when a file with the same
name as the destination file already exist and cannot be overwritten.
ID_ERR_CANNOT_COPY_TO_DESTONATION– Returned when the destination file cannot be
opened for write on the disk.
Remarks
Use this function to extract the image rectangle of the person’s signature from the source id image.
Signature extraction is relatively new feature and is not implemented yet for all the state templates (For
supported states see Appendix F). The source image can be one of two:
Internal image : The last scanned image (stored in the internal memory). This image will be used only
if the SourceFileName string is empty
External image file: The full file name is given in SourceFileName parameter. If an external file is
used as the source image it must be a 24 bit image (true color) and have a resolution of 300dpi. The
source and file destination can be one of the following formats: BMP, TIFF, JPG, PCX, TGA, PNG,
PSD.
To set the image format use the proper file extension (xxx.bmp for bitmap, xxx.jpg for Jpeg, etc.)
GetSignImage (SourceFileName As String, DestFileName As String, stateId As
Integer) As Long