Hand Held Products 4X00 - Manual (Page 80)

2 - 66 IMAGETEAM™ 4X00 Series Software Development Kit (SDK) User’s Guide
This function uses the dimensions of the bar code as its coordinate system. Thus, all 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.
Once the transfer has started, use oemGetImageData (page 12) to retrieve the image. The dimensions of the resulting image
can be calculated using the following formula:
Resulting Width = Specified Width * Specified Resolution
Resulting Height = Specified Height * Specified Resolution
In the following figure, the center of the image of interest is at location (20, 18), its width is 28, and its height is 8. Again, all values
are in Intelligent Bar Code Units. To convert measurements to Intelligent Bar Code Units, recall that each Intelligent Bar Code
Unit is equal to the narrow element width. Thus, use the following formula:
Val in Intelligent Bar code Units = (Measurement in Inches) / ( Size of an Intelligent Bar code Unit)
or
Val in Intelligent Bar code Units = (Measurement in Inches) / (narrow element width)
Result_t oemStartIntellImgXfer (
const IntellImgDesc_t *pImageDesc
)
Return Values
RESULT_SUCCESS
RESULT_ERR_PARAMETER
RESULT_ERR_BADREGION
RESULT_ERR_BADSMARTIMAGE
RESULT_ERR_SMARTIMAGETOOLARGE
-Y axis
+Y
22
18
14
-X
Bar Code Height
20 34
+X axis
Image of Interest
Narrow Element
Width (Intelligent
Bar Code Unit)