富士通掌静脉sdk开发包说明.docx

富士通掌静脉sdk开发包说明.docx

《富士通掌静脉sdk开发包说明.docx》由会员分享，可在线阅读，更多相关《富士通掌静脉sdk开发包说明.docx（38页珍藏版）》请在冰豆网上搜索。

富士通掌静脉sdk开发包说明

Chapter1BeforeUsingthe

AuthenticationLibrary

1.1Overview

1.2DownloadingtheAuthentication

Library

1.3ListofContents

Chapter1BeforeUsingtheAuthenticationLibrary

2

1.1Overview

TheAuthenticationlibraryisalibraryofprogramswhichenrollspalmveindata

andauthenticatesusers.

TheAuthenticationlibraryenablesdevelopmentofcustomizedapplicationsforthe

PalmveinauthenticationsystemwhichrunsonWindowsorLinux.

★TipTheAuthenticationlibraryinterface

TheAuthenticationlibraryinterfaceconformstotheBioAPI1.1

FrameworkwhichiscurrentlybeingstandardizedbytheBioAPI™

Consortium.

ThespecificationsofBioAPI1.1"BioAPISpecificationVersion1.1"can

bedownloadedfromthehomepageoftheBioAPI™Consortium.Refer

tothespecificationsasnecessary.

ThefollowingtablelistsmainfunctionsoftheAuthenticationlibrary.

FunctionDescriptions

PalmveindataenrollmentAfunctiontoenrollcapturedpalmveinsas

palmveindata.

Verification

Afunctiontoverifyandauthenticateby

matchingthecapturedpalmveinsagainstthe

palmveindatabyspecifiedenteredID.

"Verification"isalsocalled"1to1

Authenticationauthentication".

Identification

Afunctiontoauthenticatebyidentifyingifthe

capturedpalmveinsmatchanyoftheenrolled

palmveindata."Identification"isalsocalled"1

tomanyauthentication".

1.2DownloadingtheAuthenticationLibrary

3

1.2DownloadingtheAuthentication

Library

ThissectiondescribeshowtodownloadtheAuthenticationlibrary.

􀀬􀀬Operation

Step1DownloadtheAuthenticationlibraryfromtheSDKsupportWebsite.

!

CautionDownloadingtheAuthenticationlibrary

ThefollowingfourtypesofAuthenticationlibrariesare

provided.

・Windows2000/XP/Server2003/Vista（x86）

・WindowsVista（x64）

・RedHatEnterpriseLinuxv.3

・RedHatEnterpriseLinuxv.4

BesuretodownloadtheAuthenticationlibrarycorresponding

totheOSthatyouareusing.

>See>ForinformationontheSDKsupportWebsite,referto"System

developmentguide".

Step2ExtractthecompressedAuthenticationlibraryfiledownloadedfrom

thewebusinganextractiontool.

>See>Forinformationonthefolderstructureandfilescontainedin

eachfolder,referto"1.3ListofContents".

Chapter1BeforeUsingtheAuthenticationLibrary

4

1.3ListofContents

1.3.1WindowsVersion

◆Windows2000/XP/Server2003/Vista（x86）Version

ThefollowingliststheprovidedcontentsoftheAuthenticationlibraryfor

Windows2000/XP/Server2003/Vista（x86）version.

Folder

1st

Hierarchy2ndHierarchy3rd

Hierarchy

4th

Hierarchy

StoredFileDescription

PvFw.dll

F3BC1ENG.DLL

F3BC4COM.DLL

F3BC4CAP.DLL

F3BC4MAT.DLL

F3BC4FRM.DLL

F3BC1ENG.DAT

F3BC4COM.DAT

F3BC1SET.INI

dll

pvfwvl.txt

DLLfilesandoperational

environmentsettingfilesfor

theAuthenticationlibrary

（usedtorunapplications）

pvapi_api.h

pvapi_type.h

pvapi_err.h

bioapi_api.h

bioapi_type.h

include

bioapi_err.h

Headerfiles

（usedtobuildsourcecodes）

EnglishAuthentication

Library

Windows

libPvFw.libLibraryfile

（usedtobuildsourcecodes）

1.3ListofContents

5

◆WindowsVista（x64）Version

ThefollowingliststheprovidedcontentsoftheAuthenticationlibraryfor

WindowsVista（x64）version.

Folder

1st

Hierarchy2ndHierarchy3rd

Hierarchy

4th

Hierarchy

StoredFileDescription

F3BC4BIO.DLL

F3BC1ENG.DLL

F3BC4COM.DLL

F3BC4CAP.DLL

F3BC4MAT.DLL

F3BC4FRM.DLL

F3BC1ENG.DAT

F3BC4COM.DAT

F3BC1SET.INI

pvfwvl.txt

Microsoft.VC80.CR

T.manifest（Note）

msvcm80.dll（Note）

msvcp80.dll（Note）

dll

msvcr80.dll（Note）

DLLfilesandoperational

environmentsettingfilesfor

theAuthenticationlibrary

（usedtorunapplications）

pvapi_api.h

pvapi_type.h

pvapi_err.h

bioapi_api.h

bioapi_type.h

include

bioapi_err.h

Headerfiles

（usedtobuildsourcecodes）

EnglishAuthentication

Library

Windows

64

libF3BC4BIO.libLibraryfile

（usedtobuildsourcecodes）

Note）Thesefilesarestoredinthe"Microsoft.VC80.CRT"folder.

Chapter1BeforeUsingtheAuthenticationLibrary

6

1.3.2LinuxVersion

ThefollowingliststheprovidedcontentsoftheAuthenticationlibraryforRedHat

EnterpriseLinuxv.3andRedHatEnterpriseLinuxv.4.

Folder

1st

Hierarchy2ndHierarchy3rd

Hierarchy

4th

Hierarchy

StoredFileDescription

LMlibpvfw.so（Note）

libf3bc1eng.so

libf3bc4com.so

libf3bc4cap.so

libf3bc4mat.so

F3BC1ENG.DAT

F3BC4COM.DAT

F3BC1SET.INI

apivl.txt

engvl.txt

pvfwvl.txt

.sofilesandoperational

environmentsettingfilesfor

theAuthenticationlibrary

（usedtorunapplications）

EnglishAuthentication

Library

Linux

Incpvapi_api.h

pvapi_type.h

pvapi_err.h

bioapi_api.h

bioapi_type.h

bioapi_err.h

Headerfiles

（usedtobuildsourcecodes）

Note）"libpvfw.so"isalsousedtobuildsourcecodesasalibraryfile.

7

Chapter2RunningApplications

2.1RequiredHardware/Software

2.2PreparingforRunningApplications

Chapter2RunningApplications

8

2.1RequiredHardware/Software

Thefollowingtableliststherequiredhardwareandsoftwareforrunning

applicationsdevelopedusingtheAuthenticationlibrary.

RequiredHardware/SoftwareDetails

CPU（Note2）

:

Intel®Celeron®600MHz

ormore

Memory

（Note3）

:

256MBormore

USB（Note4）

（Note5）

:

USB2.0or1.1

（mustbeabletoprovide500mA

currenttotheSensor.IfUSB

1.1isused,theUSBcontroller

mustbecomplieswithUHCI.）

Personalcomputer

（Note1）

HDDspace

（Note6）

:

92MBormore

Hardware

Sensor（Note5）Includedinthisproduct.

Or,aSensorwhichispurchasedseparately.

OS

Eitherofthefollowing:

・Windows2000SP4orlater

・WindowsXPSP2orlater（Note7）

・WindowsServer2003SP1orlater（Note8）

・WindowsVista（Note9）

・RedHatLinuxV3

・RedHatLinuxV4

Authenticationlibrary

Software

Sensordriver（Note5）DownloadfromtheSDKsupportWebsite.

Note1）Thisdocumentassumesapersonalcomputerasatypicalexampleof

hardwareastheinstallationtargetoftheAuthenticationlibrary.

Note2）ACPUof1.0GHzorfasterisrecommendedforWindowsVista.

Anx64architectureCPUappliesforWindowsVista（x64）.

Also,anIntel®Pentium®4of3.0GHzorfasterisrecommendedfor

identificationinhigh-speedmode.

>See>ForinformationontheidentificationusingHigh-speedmode,

referto"Systemdevelopmentguide","2.2Preparingfor

RunningApplications",and"3.4.17PvAPI_SetProfile".

Note3）Memoryrequiredis1GBormoreforWindowsVista.

Note4）USB2.0isrecommended.TheprocessingspeedisreducedonUSB1.1.

UseUSB2.0whenconnectingmultipleSensors.

>See>ForinformationonmultipleSensorconnection,refertothe

"Systemdevelopmentguide"and"AppendixBConnecting

MultipleSensors（WindowsVersionOnly）".

2.1RequiredHardware/Software

9

Note5）RequiredwhenconnectingaSensor.

Note6）MinimumrequiredspaceonlyfortheAuthenticationlibrary.

12MBappliesiftraceinformationisnotrequired.

ThefollowingspaceisrequiredwhenconnectingmultipleSensors.

・Withthetraceinformationoutput

92MBperSensor（736MBfor8Sensors）

・Withoutthetraceinformationoutput

12MBperSensor（96MBfor8Sensors）

>See>Forinformationontraceinformation,refertothe"2.2Preparing

forRunningApplications".

>See>ForinformationonmultipleSensorconnection,refertothe

"Systemdevelopmentguide"and"AppendixBConnecting

MultipleSensors（WindowsVersionOnly）".

Note7）EditionsofWindowsXPforwhichoperationswiththeAuthentication

libraryareguaranteedaretheProfessionalandHomeEdition.

Note8）WindowsServer2003canbeusedwhenperformingmanagementofpalm

veindata,andverificationandidentificationprocessesonaserver.

（TheoperationsofcapturingpalmveinsbyconnectingaSensorona

WindowsServer2003arenotguaranteed.）

Note9）Allx86andx64editionsofWindowsVistaexcepttheStarterEdition

guaranteeoperationswiththeAuthenticationlibraryandSensordriver.

>See>ForinformationontheSDKsupportWebsite,referto"System

developmentguide".

!

CautionLinuxenvironment

TheAuthenticationlibraryisguaranteedtoproperlyworkunderthe

followingLinuxenvironment:

DistributionKernel

VersionGccVersionGlibc

Version

RedHatLinuxV32.4.21-4.EL3.2.320030502

（RedHatLinux3.2.3-20）2.3.2

2.6.9-5.EL3.4.320041212

（RedHat3.4.3-9.EL4）2.3.4

RedHatLinuxV4

2.6.9-42.0.3.EL3.4.620060404

（RedHat3.4.6-3）2.3.4

Chapter2RunningApplications

10

2.2PreparingforRunningApplications

2.2.1RunningonaWindowsEnvironment

Thissectiondescribesthepreparationforrunningapplicationsdevelopedusing

theAuthenticationlibraryinaWindows2000,WindowsXP,WindowsServer2003,

orWindowsVistaenvironment.

􀀬􀀬Operation

Step1IfthepersonalcomputerisdesignatedtobeconnectedtoaSensor,

installtheSensordriver（Windows2000/XP/Vista（x86）versionor

WindowsVista（x64）version）onthepersonalcomputer.

>See>Forinformationonhowtoinstallthedriver,referto"Sensor

driverinstallationguide".

Step2InstalltheAuthenticationlibraryonthepersonalcomputerasfollows.

（1）InaWindows2000,WindowsXP,WindowsServer2003orWindows

Vista（x86）environment,copythe"dll"folderunderthe"\English\

AuthenticationLibrary\Windows"folderwhichiscreatedby

downloadinganddecompressingtheAuthenticationlibrary,toany

folderonthepersonalcomputer.

InaWindowsVista（x64）environment,copythe"dll"folderunderthe

"\English\AuthenticationLibrary\Windows64"folderwhichis

createdbydownloadinganddecompressingtheAuthentication

library,toanyfolderonthepersonalcomputer.

!

CautionWindowsVistaenvironment

Avoidusingsystemdirectories（"C\","C:

\ProgramFiles",

"C:

\Windows",etc.）onthepersonalcomputerasthe

destinationfolderto