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 What’s 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
[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.
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). Libraries to access the GBS Fingerprint SDK in your
lib
C++ and C++.NET applications. Contains the samples source codes and binaries.
samples
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
Win XP 32 Bits
32 Bits
Win 7 64 Bits
32 Bits
Win 8 64 Bits
32 Bits
32 Bits
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
Architecture
64 Bits
Win 10 64 Bits
Operational System
4
Win 8.1
System.
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
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
Integrated Biometrics Watson Mini
5
Reader
6
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
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:
7
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;
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.
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.
9
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).
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.
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
