![]() |
Some types of devices can hold a factory default calibration file. Reading the file from the device may take a long time, which consequently slows down the system startup. To save time the file is automatically copied to the local file system at the first attempt of using the device.
The new image correction and calibration technology became much more difficult, so devices using this technology can only be calibrated with factory calibration software and images, but not with the standard calibration function.
The calibration state of the device can be tested with the IsCalibrated function. New calibration process can be started with the Calibrate function, and the resulted calibration file can be placed in one of the following three different directories where our system searches for the newest version of this file:
%CommonProgramFiles%\gx\pr
directory on Windows systems,/var/gx/pr
directory on Linux systems.%SystemRoot%\system32\gx\pr
directory on Windows systems,/usr/share/gx/pr
directory on Linux systems.The exact path and filename of the used calibration file can be read from the calib_file property. The calibration file contains information about the device only and may be freely copied from a computer to another.
Between two capturing processes the light and camera control modules are in a so called freerun mode. In this mode the system can run a set of the following tasks that the user can enable through the freerun_mode property:
The usable modes are defined in the PR_FREERUNMODE
enumeration. Depending on the type of the device some tasks cannot be combined.
The warming up and cooling down times of the UV tubes are approximately 25 seconds. Though acceptable images can be obtained in less warming time, the best image quality is achieved when the UV tubes are warmed up completely. The needed warming quality can be controlled by the uvwarm_quality property in range of 0 to 1000. If the quality is set to 1000 and the tubes are cool, it takes 25 seconds to capture an UV image.
If the UV tube warming task is set in the freerun mode and the uvwarm_quality property is set too, the system waits for the UV tube to warm up before the first capture and the warmed state of the UV tube is continuously preserved between successive captures.
The lighting conditions of the preview image can be set by the preview_light property. Possible values are defined in the PR_LIGHT
enumeration.
To capture a real-time preview image, the user can either call the CapturePreview function or handle the preview related events (see Event handling). To view the captured image, the image display function is to be called with PR_IT_PREVIEW
image type. The preview light control works only if freerun mode is set properly.
There are different document detection modes for different devices, that can be set through the testdoc_mode property. The document detection uses both software and hardware elements. The hardware element checks the presence of the document, and the software element detects the motion.
The available document detection modes are defined in the PR_TESTDOCMODE
enumeration:
PR_TD_IN
.Some types of devices can detect dark documents such as the back side of blue or green passports. To enable this functionality the ctrl/detdark property has to be set to 1.
User data space access is on block level, using device dependent fixed-size blocks. One can use the GetUDInfo function to get general information about the user data space - the size of one block and the number of available blocks. The first block index and the number of blocks to use must be defined at each user data read or write.