GBS Fingerprint SDK 2014

Manual

1
Table of Contents
1.1 The GBS Fingerprint SDK ....................................................................................................... 3
1.2 Installing the SDK ................................................................................................................. 3
1.2.1 Licensing ........................................................................................................................ 3
1.2.2 Download and Installation.............................................................................................. 3
1.2.3 Folders Overview ........................................................................................................... 4
1.2.4 Operating Systems and Fingerprint Reader devices supported ........................................ 4
1.2.5 Programming Language Support ..................................................................................... 7
1.3 Features ............................................................................................................................... 7
1.3.1 Technical Characteristics ................................................................................................ 7
1.3.2 Threshold and Rotation Tolerance .................................................................................. 8
1.4 Whats New on Fingerprint SDK ............................................................................................ 8
2.1 The GBS Fingerprint SDK ..................................................................................................... 10
2.1.1 New API: discontinued and new methods ..................................................................... 10
3.1 SDK API Description ............................................................................................................ 14
3.1.1 API Java........................................................................................................................ 14
3.1.2 API C/C++ ..................................................................................................................... 14
3.1.3 API C# .NET .......................................................................... Error! Bookmark not defined.

2
1 Getting Started
1.1 The GBS Fingerprint SDK
The GBS Fingerprint SDK is a fingerprint recognition library that comes packaged with a
Software Development Kit (SDK), allowing you to integrate biometrics in a wide range of
applications. Thanks to its support for several programming languages, code samples, and its
documentation, you'll start developing your application in a matter of minutes.

1.2 Installing the SDK

1.2.1 Licensing
The GBS Fingerprint SDK requires a software license to work correctly.
It is distributed with a trial license valid for 90 days*. After this period a license must be
purchased by sending an email to info@griaule.com and must be installed in
C:\ProgramData\Griaule.
For questions, please contact the Griaule Biometrics support sending an email to
support@griaule.com.

1.2.2 Download and Installation

Download the correct version for your OS below:
GBS Fingerprint SDK (x86-64)
GBS Fingerprint SDK (x86)
GBS Fingerprint SDK (Linux)
Once downloaded, please double click on the downloaded file and follow the on-screen
instructions.

3
1.2.3 Folders Overview
Directory Description
bin Contains all the files needed by the GBS
Fingerprint SDK library. This folder mainly
contains DLLs.
doc The Fingerprint SDK documentation files.

inc Import files for some of the supported languages

(DLL only).
lib Libraries to access the GBS Fingerprint SDK in your
C++ and C++.NET applications.
samples Contains the samples source codes and binaries.

1.2.4 Operating Systems and Fingerprint Reader devices supported

Once the GBS Fingerprint SDK is installed the supported devices are also installed.
The following table specifies which models are supported according to the Operating
System.
Win 8.1

Win XP
Win 10

Operational System
Win 8

Win 7
64 Bits

32 Bits

64 Bits

32 Bits

64 Bits

32 Bits

64 Bits

32 Bits

32 Bits
Architecture

Crossmatch EF200 / Watson YES YES YES YES YES YES YES YES YES
Crossmatch LSCAN Guardian NO YES NO YES NO YES NO YES YES
Crossmatch Verifier 320 LC YES YES YES YES YES YES YES YES YES
Digent Izzix FD1000 NO YES NO YES NO YES NO YES YES
Digital Persona U.are.U 4000 YES YES YES YES YES YES YES YES YES
Digital Persona U.are.U 4500 YES YES YES YES YES YES YES YES YES
Digital Persona U.are.U 5100 YES YES YES YES YES YES YES YES YES
Futronic FS52 NO YES NO YES NO YES NO YES YES
Futronic FS80 YES YES YES YES YES YES YES YES YES
4
 Futronic FS80H YES YES YES YES YES YES YES YES YES
Futronic FS81H YES YES YES YES YES YES YES YES YES
Futronic FS88 YES YES YES YES YES YES YES YES YES
Futronic FS88H YES YES YES YES YES YES YES YES YES
Lumidigm M301 YES YES YES YES YES YES YES YES YES
Lumidigm V302 YES YES YES YES YES YES YES YES YES
Lumidigm V311 YES YES YES YES YES YES YES YES YES
Lumidigm V371 YES YES YES YES YES YES YES YES YES
IDTech Biomag IDT-4012-DP YES YES YES YES YES YES YES YES YES
IDTech Biomag IDT-4033-NG YES YES YES YES YES YES YES YES YES
IB Sherlock YES YES NO NO NO NO NO NO NO
Integrated Biometrics Watson
YES YES YES YES YES YES YES YES YES
Mini
Nitgen eNBioScan-D NO YES NO NO NO NO NO NO NO
Nitgen Hamster DX NO YES NO YES NO YES NO YES YES
Nitgen Hamster II NO YES NO YES NO YES NO YES YES
Nitgen Hamster II DX / III NO YES NO YES NO YES NO YES YES
Secugen Hamster IV YES YES YES YES YES YES YES YES YES
Secugen Hamster Plus YES YES YES YES YES YES YES YES YES
Secugen Hamster Pro 20 YES YES YES YES YES YES YES YES YES
Suprema BioMini NO YES NO YES NO YES NO YES YES
Suprema BioMini Plus NO YES NO YES NO YES NO YES YES
Suprema BioMini Slim NO YES NO YES NO YES NO YES YES
Suprema RealScan-D YES YES YES YES YES YES YES YES YES
Suprema RealScan-G10 YES YES YES YES YES YES YES YES YES
Suprema SFU-S20 NO YES NO YES NO YES NO YES YES
TechMag Biopass YES YES YES YES YES YES YES YES YES
UPEK Eikon NO YES NO YES NO YES NO YES YES
UPEK Eikon Touch NO YES NO YES NO YES NO YES YES
Virdi FOH02 YES YES YES YES YES YES YES YES YES
Virdi FOH04 YES YES YES YES YES YES YES YES YES
Zvetco Verifi P5000 NO YES NO YES NO YES NO YES YES
Zvetco Verifi P6000-B NO YES NO YES NO YES NO YES YES

5
 Reader Libraries

CrossMatch V320 GBSFingerprintCapPluginCrossMatch320.dll

LScanEssentials.dll
QtCore4.dll
QtGui4.dll
QtNetwork4.dll
QtWebKit4.dll

Other CrossMatch GBSFingerprintCapPluginCrossMatchP.dll

GBSFingerprintCapPluginCrossMatch300.dll
intl.dll
libglib-2.0-0.dll
USB4XX.dll

Digent GBSFingerprintCapPluginDigent.dll
FingerAPI22Ex.dll
IZZIX20.dll TCI.dll

Futronic FS GBSFingerprintCapPluginFutronicFS50.dll
ftrScanAPI.dll

Other Futronic GBSFingerprintCapPluginFutronic.dll

ftrScanAPI.dll

Nitgen Hamster GBSFingerprintCapPluginHams.dll

NBioBSP.dll

Nitgen eNBioScan-D GBSFingerprintCapPluginNitgenD.dll

eNBioScan-D
NBioScan.dll

Nitgen eNBioScan-F GBSFingerprintCapPluginNitgenF.dll

eNBioScan-F
NBioBSP.dll

Integrated Biometrics Watson Mini GBSFingerprintCapPluginIB.dll

IBScanUltimate.dll

Lumidigm GBSFingerprintCapPluginLumi.dll
LumiAPI.dll
LumiCore.dll
LumiInOpAPI.dll
plugin/AlgoDvc.dll
plugin/IEngine_Plus.dll
plugin/MercuryDvc.dll
plugin/PreProcV31_INT16.dll
plugin/SDvc.dll

6
 plugin/VenusDvc.dll

Suprema RealScan-D GBSFingerprintCapPluginRealD.dll

RS_SDK.dll

Other Suprema GBSFingerprintCapPluginSuprema.dll

UFLicense.dat
UFScanner.dll

UPEK TouchChip GBSFingerprintCapPluginUpek.dll

bsapi.dll
TCI.dll

Virdi FOH02 GBSFingerprintCapPluginVirdi2.dll

UCBioBSP.dll
VHMLib.dll

If your fingerprint reader is not listed in the table above and for further information,
please contact us by email info@griaule.com.

1.2.5 Programming Language Support

GBS Fingerprint SDK supports multiple programming languages, including Java, C++ and
C# / .NET.

1.3 Features
1.3.1 Technical Characteristics
Capture:
Detects fingerprint readers plug/unplug;
Automatic finger detection;
Supports BMP files for fingerprint image saving/loading;
Maximum image size of 1280 x 1280 pixels;
Minimum image size of 50 x 50 pixels;
Maximum resolution of 1000 DPI;
Minimum resolution of 125 DPI;

7
Extraction:
Average extraction time of 100ms 1;
Maximum image size of 500 x 500 pixels 2;
Minimum image size of 50 x 50 pixels;
Average template size of 400 bytes;

Matching 3:
Verification speed: up to 100/s 4.

Notes:
1. Images of 300 x 300 pixels. Machine: Pentium4 2.8GHz, 512MB RAM.
2. Larger images are cropped.
3. The Identification one-to-many is not performed by the GBS Fingerprint SDK.
4. Images of 100 x 100 pixels. Machine: Pentium4 2.8GHz, 512MB RAM.

1.3.2 Threshold and Rotation Tolerance

The verification function in Fingerprint SDK library are governed by two important
parameters: threshold and rotation tolerance.
The threshold is the minimum score needed to state that two fingerprints do match. The
default value is 20 for the verification process, ensuring a 1% FRR.
The rotation tolerance defines the maximum acceptable angle variation (in degrees)
between two fingerprints being compared that will result in a match. This value is valid in both
clockwise and counterclockwise directions, so the maximum value that can be set is 180. The
default value is 180.

1.4 Whats New on Fingerprint SDK

Added AFIS (Automatic Fingerprint Identification System) functionality: patterns are
identified by software in fingerprint images and are used for comparison with another
fingerprint image patterns to determine if they came from the same finger and ultimately,
from the same person.

8
 Added converter to WSQ functionality. The WSQ is the best image format for fingerprints.
It reaches a great compression with high image quality.

Image formats supported when converting to WSQ: BMP, JPEG, JPEG 2000, TIFF, GIF and
PNG.

Added support to more Fingerprint Readers;

Added support to Windows 7, 8 and 8.1 32-bit and 64-bit.

Fixed some bugs from the Fingerprint SDK 2009;

Dropped the concept of Context;

Dropped the editions IDENTIFICATION and VERIFICATION;

Does not perform multi-thread operations such as identification one-to-many;

Performs fingerprint extraction and verification (matching one-to-one).

9
2 How to migrate from the Fingerprint SDK
2009 to the new GBS Fingerprint SDK
This section highlights the main differences introduced when comparing the new
Fingerprint SDK and the Fingerprint SDK 2009.

2.1 The GBS Fingerprint SDK

In the Fingerprint SDK 2009, a MatchingContext object is where the biometric operations
(fingerprint minutiae extraction and fingerprint matching) occur. All methods in a
MatchingContext object are synchronized, thus to execute N biometric operations at the same
time, N MatchingContext objects must be created.
In the new Fingerprint SDK, the Matching Context is not applicable anymore. The
application continues to be thread-safe, but only single-threaded operations are performed at a
time. For multi-thread operations, such as Identification (one-to-many), the GBS Server is
needed. For further information regarding this software of the Griaule Biometric Suite, please
contact the Griaule Biometrics support (support@griaule.com).

2.1.1 New API: discontinued and new methods

The following tables match the discontinued methods of the previous softwares
(Fingerprint SDK 2009, AFIS 2.0 and WSQ 1.2) with the new ones that replace them, if applicable.
The value NA indicates that the method's functionality has been discontinued in the
current release of the SDK.

10
11
12
2.1.1.1 Methods Signature Simplified: Gr_IMAGE and Gr_TEMPLATE
In the Fingerprint SDK 2009, several primitive types must be passed as parameters of the
API functions in order to define an image or a template. In the GBS Fingerprint SDK, new classes
define how Image and Template data must be defined. They encapsulate the necessary
information and allow a clearer understanding of the API.

13
3 Developing using the Fingerprint SDK
3.1 SDK API Description
3.1.1 API Java
The GBS Fingerprint SDK Javadoc is available here.

3.1.2 API C/C++

The GBS Fingerprint SDK C/C++ is available here.

14
griaulebiometrics.com