Iimage::readimage - Intermec 700 Series User Manual

Scanner Support
Remarks:

IImage::ReadImage

Syntax:
Parameters:
Returns:
Remarks:
6-68 700 Series Color Mobile Computer User's Manual
ReadSigCapFile() will write the image from the last decoded label with
dimensions identified by the calling parameter. If the file already exists, its
contents will be overwritten.
This signature capture region must include the signature capture bar code.
The supported bar codes for signature capture are: PDF 417, Code 128, and
Code 39. The caller specifies the width, height, and center of the image to
be retrieved. This image is independent of any rotation of the bar code
relative to the imager. Thus, if the bar code is decoded with the code itself
upside down to the imager, the retrieved image will still be right side up.
However, if the specified image is outside the field of view a result code of
ITC_RESULT_ERR_BADREGION_E will be returned.
This function uses the dimensions of the last decoded bar code as its
coordinate system. Thus, all the parameters describing the image size and
position are in units called "Intelligent Bar Code Units". An Intelligent Bar
Code Unit is equivalent to the narrow element width of the bar code.
The dimensions of the resulting image can be calculated using this formula:
Resulting Width = Specified Width * Specified Resolution
Resulting Height = Specified Height * Specified Resolution
HRESULT IImage::Read( ITCFileFormat eFormat, DWORD nDepth,
ITC_IMAGE_SPEC *pImgBuffer, DWORD dwTimeout );
eFormat [in]
ITC_FILE_KIM =
ITC_FILE_TIFF_BIN =
ITC_FILE_TIFF_BIN_GROUP4 =
ITC_FILE_TIFF_GRAY_SCALE =
ITC_FILE_RAW =
ITC_FILE_JPEG =
nDepth [in]
pImgBuffer [in/out] Pointer to the buffer containing the image.
dwTimeout [in]
HRESULT identifying success or error. On error, the following codes will be
returned:
S_OK
Image successfully returned.
ITC_IMGBUFF_TOO_SMALL_E
pImgBuffer is too small to contain the signature captured image.
ITC_TIMEOUT_E
Timeout.
ITC_INV_PARAMETER_E
One of the parameters is invalid.
S_DEVICE_NOT_OPENED_E
The device had not been opened.
The image is returned in pImgBuffer in the caller specified format.
Format of the image buffer returned as follows.
Currently, only ITC_FILE_RAW is supported.
0, // Returns data a KIM file
1, // TIFF Binary file
2, // TIFF Binary Group 4 compressed
3, // TIFF Gray Scale
4, // Raw image
5, // JPEG image
Number of bits per pixel. Currently, only eight
(gray-scale) is supported.
Milliseconds to wait for the image to be returned.
SECTION 6