Manual GBS Fingerprint SDK 2014

(1)

GBS Fingerprint SDK 2014

(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 [email protected] and must be installed in C:\ProgramData\Griaule.

For questions, please contact the Griaule Biometrics support sending an email to

[email protected].

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.

(4)

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.

Operational System

W in 10 W in 8. 1 W in 8 W in 7 W in XP

Architecture

64 Bi ts 32 Bi ts 64 Bi ts 32 Bi ts 64 Bi ts 32 Bi ts 64 Bi ts 32 Bi ts 32 Bi ts

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

Futronic FS52 NO YES NO YES NO YES NO YES YES

(5)

Futronic FS80H YES YES YES YES YES YES YES YES YES

Futronic FS88 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

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

Mini YES YES YES YES YES YES YES YES YES 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

(6)

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

(7)

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 [email protected].

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;

(8)

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 What’s 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.

(9)

 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).

(10)

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 ([email protected]).

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.

(11)

(12)

(13)

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.

(14)

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++

(15)