• Author / Uploaded
• Kainã Almeida

• Categories
• Interfaz de programación de aplicaciones
• Tecnología de sistema operativo
• Software
• Áreas de informática
• Ingeniería de software

Citation preview

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