Convertimage; Card Scanning Solutions - CSSN ScanShell 2000 Description

10350 Santa Monica Blvd. Suite 285, Los Angeles, CA 90025
Phone: 310-691-8920, 310-788-9840, Fax: 419-735 -2419
If the function fails it returns one of the following values:
LICENSE_INVALID – Library was not initialized with proper license.
IMG_ERR_BAD_ANGLE_0 – bad rotation parameter.
IMG_ERR_BAD_DESTINATION – Bad destination parameter (the destination parameter is neither
file or clipboard)
IMG_ERR_FILE_OPEN – Cannot open input file. This value is returned if the SourceImage string is
not empty but it points to a missing or invalid source image file.
INVALID_INTERNAL_IMAGE – This value is returned if the SourceImage string is empty but no
document was scanned so there is no internal image in the memory.
IMG_ERR_FILE_SAVE_TO_CLIPBOARD – Cannot save image to clipboard due to an error.
IMG_ERR_FILE_SAVE_TO_FILE – Cannot save destination file due to invalid destination file or
disk save error.
Remarks
Use this function to rotate an image in 0, 90, 180 or 270 degrees and save it to a file in any one of
seven formats. The manipulated image may be loaded from an external file (if
holds a string value equal to the source image file name) or performed on the internal image buffer (if
SourceImage
string is empty). When using a file as the image source, it is important to use the
proper file extension to indicate the image format. Proper extension types are: BMP, JPG, TIFF, PCX,
PNG, TGA and PSD. If an image has unrecognizable extension due to an error (e.g. TIFF instead of
TIF) the function refers to the file as BITMAP.
After the image is rotated it can be exported to either the clipboard or to external image file. The
destination file name may be one of the seven file formats indicated above. If an image has
unrecognizable extension due to an error (e.g. TIFF instead of TIF) the function exports to the file in a
BITMAP format. The destination file name may be the same as the source file name. In such case the
new file, resulting with a rotated image, will overwrite the original file. If no destination image file
name is given (empty string) no save is done.
Do not be misled by the name of this function. This function flexibility actually allows implicitly to do
the following:
Use the following function call to convert an image file from one type to another:
RotateImage ("xxx.bmp", ANGLE_0, SAVE_TO_FILE, "xxx.jpg")
Use the following function call to copy an image file to the clipboard:
RotateImage ("xxx.bmp", ANGLE_0, SAVE_TO_CLIPBOARD, "")
Use the following function call to rotate the internal image :
RotateImage ("", ANGLE_0, SAVE_TO_FILE, "")
Use the following function call to save the internal image to a file:
RotateImage ("", ANGLE_0, SAVE_TO_FILE, "xxx.bmp")
1.1.43.

ConvertImage

Format
ConvertImage ( _
SourceImage
As String, _
DestImage
As String _
)

Card Scanning Solutions

SourceImage
string
36