Skip to content
GBG Documents & Biometrics Documentation

ScanX library

Overview

Section titled “Overview”

The AcuFill SDK continues to add new features and capabilities. The core AcuFill SDK library interface (ScanW.dll) is sealed due to backward compatibility, therefore GBG provides additional features and functions using the ScanX extended library.

The ScanX library includes the following sublibraries:

  • SlibEx – Controls the scanner activity and contains the last scanned image in an internal memory. This library controls the scanning settings such as scan size, color scheme and resolution. The scanned image is loaded to an internal memory and can be saved to an external file in a bitmap format.
  • IdData (in the ID version only) – Parses and refines the textual data extracted by the OCR. The data is kept in internal variables ready to be exported to the application.
  • Cimage – Used for internal image manipulation such as rotation, color scheme modification, dpi modification and image export to a file in various formats. This library can also be used for external image file manipulation.
  • COcr (in the OCR version only) – Extracts the textual data from the internal image.
  • CSSNLib – Used for VB Script code
  • CBarCode
  • CPassport
  • CMagLib
  • CActivate

Each sublibrary can function as an individual library regardless of the other libraries.

Distribution

Section titled “Distribution”

To install the AcuFill SDK files at the destination computer, copy all the AcuFill SDK files from the AcuFill SDK installation folder to the destination computer.

Note: Some files (such as COM and ActiveX objects) must be registered on the destination computer after installing the AcuFill SDK files.

The following files must be registered:

  • ScanW.dll (COM object)
  • ScanWex.dll (COM object)
  • ScanX.dll (ActiveX object used for VB scripts)

Note: If you do not use the COM interface in your application and you use the AcuFill SDK files directly like in VC++, then you do not need to install these files on the destination computer.

Licensing

Section titled “Licensing”

Each library must first be initialized with a license number to activate the library functionality. There are two types of licenses:

  • Temporary License - Using this type of license is common for library evaluation. This type of license normally expires after 60 days. You can obtain a temporary AcuFill SDK license from GBG Technical Support.
  • Permanent License - A unique key that is used to activate the library with no time limit and is also used to identify the customer when contacting GBG Technical Support.

Retrieving information from ID cards

Section titled “Retrieving information from ID cards”

Retrieving the data from an ID card involves four steps:

  1. Load the internal image - Scanning the ID card in True color and 300 dpi, 2.2 x 3.6 inches
  2. Process the internal image - Use ProcStateto activate the OCR on the scanner’s internal image
  3. Retrieve the data - Use the RefreshData function to retrieve the detected data
  4. Export the internal image - Export to a file in the proper dpi and color scheme.

Important: The internal image is overwritten in every new scan. It is the application’s responsibility to make sure that the scan is performed in the proper setting (True color, 300 dpi, 2.2 x 3.6 inch). Failing to do so may result in bad data retrieval.