MagTek IMAGESAFE99875500 - Manual (Page 13)

Section 2. ImageSafe Software Architecture
5
HOW TO PROCESS DOCUMENT USING IMAGESAFE API
To process document, follow these steps:
1. Find the attached ImageSafe device by calling function MTMICRGetDevice .
2. Use function MTMICROpenDevice to open the device.
3. ImageSafe is now ready to accept the XML options using function
MTMICRProcessCheck . For every document that is processed, a set of options must be
sent to the device. These options define how the document will be processed, i.e., image
color, image type, image resolution, print back, print front etc. The options are stored as
key/value pairs in a buffer. The memory for this buffer must be allocated big enough to
store all selected options. These options must be sent to the ImageSafe device using
function
MTMICRProcessCheck . Use function MTMICRSetValue and function
MTMICRSetIndexValue to store the key/value pairs in the option buffer. The options can
be set in the buffer only once.
4. Use function MTMICRProcessCheck to send the process options to the ImageSafe
device.
5. ImageSafe processes the document with the given process options and returns the result
of the process operation. The result is stored in the third parameter of the function
MTMICRProcessCheck . The result contains only the information of the operation and
information of the device. It does not contain scanned data. Information such as the size
of the scanned images and the image identifier are included. The image information can
be found under ImageInfo section. Use function
MTMICRGetValue and function
MTMICRGetIndexValue to retrieve key/value pair for image information. If there is no
error returned in the document information, use function MTMICRGetImage or function
MTMICRGetImages to get image data.
6. Go to step 4 to process the next check.