Introduction to

Veridis Biometric SDK

SDK version: 5.0 2013 Veridis Biometrics

VERIDIS

BIOMETRICS

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Document Version

Version

Date

Modifications

03/23/2011

Original Version

05/17/2011

Expansion and Introduction.

New supported readers
Hamster III and Hamster DX

07/29/2011

SDK 3.0. High level library

10/03/2011

SDK 3.2. Biometric SDK FREE.

NET HighLevelBiometricServices

02/18/2013

SDK 5.0. API fully reformulated

Supports several images formats
Dynamic readers loading
FREE licensing model

02

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Index
Introduction
Features
Supported Functionalities
Operational Systems
Supported Readers
Instalation
SDK Structure
Licensing
Reader instalation
Deployment
Demo application
Features
Developing
Development in NET
Instalation
Documentation
Programming examples
Deployment
Development in Java
Installation
Documentation
Programming examples
Deployment
Development using DLL
Documentation
Programming examples
Configuration
Deployment

03

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Introduction
Veridis Biometric SDK is a software development kit with biometrics algorithms and an easy to use
interface. It controls biometric sensors, extract features and match templates. Veridis Biometric SDK is
the first biometric SDK on market that is FREE and supports sensors from different manufacturers.
It is avaiable in a .NET Library, Java package, or a DLL (.SO). It is easy to use, has an excelent performance,
supports international standards and is FREE.
The following picture shows a complete biometric process, from capture to matching.

04

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Technical Characteristics
Supported Functionalities
Capture of biometric samples.
Synchronous and asynchronous capture modes.
Templates extraction.
Support to international standards, including ISO 19794-2 and ANSI 378-2004.
Support to ISO 19794-4.
Template representation in Base64.
SmartEnroll. Templates merged into one high quality template.
Biometric comparison in Verification mode (one-to-one).
Biometric comparison in Identification Mode (one-to-many).
Multi-platform. Windows (32 and 64 bits) and Linux (32 and 64 bits).
Low level libraries (DLL and SO) to develop in any programming language.
.NET and Java components.
Full documenting of all components, including those integrated to IntelliSense.

Operational Systems
Windows XP SP2 (x86 and x64)
Windows Vista (x86 and x64)
Windows 7 (x86 and x64)
Windows Server 2003 (x86 and x64)
Windows Server 2008 (x86 and x64)
Ubuntu (x86 and x64)
Fedora (x86 and x64)
Suse (x86 and x64)
Supported readers
Futronic FS-80, FS-88 and FS-90
Techmag BioTouch
Nitgen Hamster I,III and DX
Suprema Biomini, Biomini Plus.
Microsoft Fingerprint Reader*
DigitalPersona U.are.U 4000B*
*Use LibUSB driver

06

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Installation and Licensing

SDK Structure
Folder

Description

\demo

Folder with the demo application and its external dependencies.

\samples\dotNet\c#

C#.NET programming example with source code.

\samples\cpp

C++ programming examples with source code.

\samples\java

Java programming example with source code.

\bin\86

Windows DLLs (32 bits)

\bin\x64

Windows DLLs ( 64 bits)

\inc

Header files

\lib\x86

Static library for Windows (32 bits)

\lib\x64

Static library for Windows (64 bits)

\doc

SDK documentation

Licensing
Veridis Biometric SDK doesnt require any paid license. It is unlimited, and can be used in any
application, by any number of users. When creating an account on Veridis website, the user is
going to receive a key. This key must be passed to VInstallLicense method.

Readers Installation
The Microsoft Fingerprint Reader and Digital Persona U.are.U 4000B Readers make use of
libUSB.
When connecting the reader, choose the manual installation of the driver and point to
driver\Windows\veridis_biometric_driver.inf.
For other supported readers, use the driver supplied by the manufacturer.

Deployment
To deploy your application with Veridis Biometric SDK:
Add to your installation package the files contained in the folder bin/x86 or bin/x64.
In each machine in which the application is going to be deployed:
Install the fingerprint sensor correctly.

07

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Demo application
The demo application was developed to show the power of Veridis Biometric SDK and how it can
be used to develop an application to register people.
Figure 1 shows the main screen. This screen shows the registred people and the options to create
a new register, to remove one and the option to perform an identification (1 to many matching).

Figure 1 - Main Screen

Features
Register: click on Register to start a new register, a new window will open
Edit: double click on a list name to edit the registry of the person
Identification: click on Identification and then capture an image. If the person is found,
his form will open. The identification works with the current list (with filter)
Search: Type the name or part of the name in the search field to filter the results in real time.
Delete: select a name from the list and click on Remove to delete it from the database.

08

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Figure 2 - Register Screen

Biographic fields: The document is mandatory and must be the unique in the database.
Biometric register: click on the rectangles above the fingers to register the finger. A new
window will open for this registration. Each finger must be captured three times.
Photo: Click on the button with the camera icon to start capturing images. A new button will
appear. Click on it to capture the final image, or cancel it by clicking on the camera icon button
again.
Verification: If editing a registry, a verification must be made to confirm the changes. Click on
check and place a finger on the reader. If the verification is successful, the 'Confirm' button will
be enabled.
Cancel: cancel the registration or editing at any time by clicking cancel.
Confirm: to confirm the registration or alteration, click on confirm.

12

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Development in .NET
Requirements
Visual Studio.
.NET Framework 2.0 or superior
Installation
Add a reference to Veridis.Biometric in your project
1
At the Solution Explorer, select the project.
2
At the menu Project, click on Add Reference.
3
The Add Reference dialog box will open
4
Select the tab Browse.
5
Locate the file Veridis.Biometric.dll in the folder \bin of our package.
6
Click on OK, after locating the file.
The selected reference (Veridis.Biometric) will appear in the list of project references. The
project documentation will also be available via IntelliSense automatically.

Documentation
When referencing the Veridis.Biometric in your project, the inline documentation is imported and
appears in IntelliSense automatically. The documentation is also available in HTML format in the
folder \docs of our package.
Programming Example

Figure 3 - C#.NET
Figure 3 represents the main screen of the C#.NET. sample application. The source code is
deployed with the SDK package and can be used during the development of applications that uses
the .NET Framework.

08

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Development in Java
Installation of the Java Component
The Java component is distributed in a JAR package, veridisbiometric.jar present in the folder
bin/java of the SDK.
To use it, you must:
Add this package to the classpath of your project
At the command line, use the parameter "-classpath path/to/veridisbiometric.jar"
In Eclipse and NetBeans, follow the instructions avaiable in our website.

Although the Java component uses native libraries (.dll./So), it is not necessary to take any further
action, the libraries are loaded automatically.
Documentation
The Javadocs documents of the component are present in the folder doc/javadoc.
Programming example
The component comes with a programming example demonstrating the main features of the
library.
Deployment
Distribute the file veridisbiometric.jar and the binary files (DLL) along with your project.

14

Introduction to Veridis Biometric SDK, 2013 Veridis Biometrics.

Development using DLL

The direct use of DLL allows direct access to the functions of Biometric SDK in many different
environments, but it is particularly suitable for the development in C/C++. The package includes:
Header (inc\VrBio.h, inc\VTypes.h, inc\VConsts.h)
Import library (VrBio.lib) required by the Visual C++ and other tools.
GCC and some other tools do not need the Import library for the link.
Documentation (docs/c), generated through the doxygen.

It is also possible to access the DLL from other languages / platforms, such as Delphi, Visual Basic,
Python, etc.. For such languages, the programmer will be responsible for creating the necessary
import libraries.

Documentation
The API Doxygen files are in the folder docs/c.
Sample
The SDK comes with a Visual Studio solution (CPPExamples.sln) that brings together various
Console Application projects, which demonstrate the use of most functions of the DLL.
The samples can be found in the folder sample/CPPExamples.
Configuration
All projects uses the path ../../../inc to find the header files and the path ../../../lib/x86 to find the
static library. Some projects loads image files from the path ../../../images.
If the solution was saved on a different path, from the SDK installation one, this paths must be
configured.
Distribution
To distribute Veridis Biometric SDK along with its application on client machines you must:
Enter all required DLLs in the same folder as your application. These can be found in the bin
folder, inside the sub-folder corresponding to your system (e.g. bin/x86).
Install the reader according to the section "Installing the Reader."

15

VERIDIS

BIOMETRICS