Professional Documents
Culture Documents
One Touch For Windows SDK Java Developer Guide
One Touch For Windows SDK Java Developer Guide
Set property
using "setter"
method
Add event listener using
Receive event
with index value
Delete appropriate fingerprint
template from fingerprint data
storage subsystem
Use , or throw
to indicate enrollment failure, to
request more captures or to veto enrollment respectively.
Store new
value in fingerprint data storage
subsystem
Chapter 4: Overview Fingerprint Enrollment with UI Support
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 30
8. *Use the set Per f or med( f al se) or set St opCapt ur e( f al se) methods of the
DPFPEnr ol l ment Event ; or throw DPFPEnr ol l ment Vet oExcept i on to indicate enrollment
failure, to request more captures or to veto enrollment (page 73).
Chapter 4: Overview Fingerprint Verification
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 31
Fingerprint Verification
This section contains a typical workflow for performing fingerprint verification. The workflow is illustrated in
Figure 5 and is followed by explanations of the One Touch for Windows SDK: Java Edition API functions used to
perform the tasks in the workflow.
Figure 5. Typical fingerprint verification workflow
Fingerprint Sample Capture (BPFPCaptuie class)
Create BPFPFeatuieSet object using
BataPuipose of veiification
FeatuieExtiactionCieateFeatuieSet
Sample BataPuipose ief CaptuieFeeuback ief
FeatuieSet
Create FeatuieExtiaction
object
Receive
BPFPFeatuieSet object
Fingerprint Feature Extraction (BPFPFeatuieExtiaction class)
Set property
FARRequesteu
Create veiification object
Fingerprint Verification (BPFPveiification class)
Receive BPFPveiificationResult
object
One Touch for Windows SDK: Java
Application (not part of SDK)
Fingerprint reader
Legend
Optional step
A
Retrieve deserialized
BPFPTemplate object
Create Captuie object
Load event handler to
receive event notifications
EventBanulei
Perform system function
of fingerprint verification and return
BPFPveiificationResult object
veiifyFeatuieSet
Templateief Result
Begin capturing fingerprint
samples from fingerprint
reader(s)
StaitCaptuie
Capture fingerprint sample
Receive 0nComplete
event with
BPFPSample object
Stop capturing
fingerprint samples
StopCaptuie
Chapter 4: Overview Fingerprint Verification
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 32
Fingerprint Sample Capture (DPFPCapture Class)
1. Create a new instance of the DPFPCapt ur e class (page 50).
2. Load a fingerprint sample capture operation event handler for receiving event notifications by adding
event listeners (page 54).
3. Begin capturing fingerprint samples from the fingerprint reader(s) connected to a system by calling the
st ar t Capt ur e( ) method (page 52).
4. **Capture a fingerprint sample from a fingerprint reader. Note that you cannot change the priority or the
reader(s) setting of a DPFPCapt ur e object after it is started.
5. *Receive the dat aAcqui r ed( ) event from the fingerprint sample capture event handler along with a
DPFPSampl e object when the fingerprint sample is successfully captured by the fingerprint reader
(page 54).
6. *Pass the DPFPFeat ur eExt r act i on. cr eat eFeat ur eSet ( DPFPSampl e sampl e,
DPFPDat aPur pose pur pose) ; method. (See step 2 in the next section.)
7. Stop capturing fingerprint samples by calling the st opCapt ur e method (page 52).
Fingerprint Feature Extraction (DPFPFeatureExtraction Class)
1. Create a new instance of the DPFPFeat ur eExt r act i on class (page 65).
2. Create DPFPFeat ur eSet objects by calling the cr eat eFeat ur eSet ( DPFPSampl e sampl e,
DPFPDat aPur pose pur pose) method using the value Ver i f i cat i on for Dat aPur pose and
passing the DPFPSampl e object from step 6 of the previous section (page 65).
3. *Pass the DPFPFeat ur eSet objects created in the previous step to the addFeat ur es method.
(See step 2 in the next section.)
Fingerprint Verification (DPFPVerification Class)
1. Create a new instance of the DPFPVer i f i cat i on class (page 81).
Example:
DPFPVer i f i cat i on mat cher = DPFPGl obal
. get Ver i f i cat i onFact or y( )
. cr eat eVer i f i cat i on( ) ;
2. Optionally, set the FARRequest ed property (page 82). You can use this property to set or to change
the value of the FAR from the default or from a specified value.
Example:
mat cher . set FARRequest ed( DPFPVer i f i cat i on. MEDI UM_SECURI TY_FAR) ;
3. *Retrieve serialized fingerprint template data from the fingerprint data storage subsystem.
Chapter 4: Overview Fingerprint Verification
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 33
4. Create a DPFPTempl at e object from the serialized data (see Deserializing a Serialized Fingerprint Data
Object on page 37).
5. Perform the system function of fingerprint verification by calling the ver i f y( f eat ur eSet ,
t empl at e) method and passing the DPFPTempl at e object created in the previous step and the
DPFPFeat ur eSet object from step 3 of the previous section (page 82).
Example:
DPFPVer i f i cat i onResul t r esul t = mat cher . ver i f y( f eat ur eSet , t empl at e) ;
i f ( r esul t . i sVer i f i ed( ) ) { . . . }
6. *Receive the DPFPVer i f i cat i onResul t object, which provides the comparison decision of match
or non-match (page 83).
Chapter 4: Overview Fingerprint Verification with UI Support
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 34
Fingerprint Verification with UI Support
This section contains a typical workflow for performing fingerprint verification with UI support. The workflow is
illustrated in Figure 6 and is followed by explanations of the One Touch for Windows SDK: Java Edition API
functions used to perform the tasks in the workflow.
Figure 6. Typical fingerprint verification with UI support workflow
Fingerprint Verification Control
( class)
Receive
event with
object
Set FAR using
Create object
Set property
or use method
Chapter 4: Overview Fingerprint Verification with UI Support
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 35
Fingerprint Verification Control (DPFPVerificationControl Class)
1. Create a new instance of the DPFPVer i f i cat i onCont r ol class (page 76).
2. Optionally, set the Reader Ser i al Number property (page 76).
3. Add an event listener using addVer i f i cat i onLi st ener ( DPFPVer i f i cat i onLi st ener )
(page 76).
4. **Capture a fingerprint sample from a fingerprint reader.
5. Receive the capt ur eCompl et ed event from the fingerprint verification control event handler along
with the DPFPFeat ur eSet object (page 80).
Fingerprint Verification (DPFPVerification Class)
1. Create a new instance of the DPFPVer i f i cat i on class (page 81).
Example:
DPFPVer i f i cat i on mat cher = DPFPGl obal
. get Ver i f i cat i onFact or y( )
. cr eat eVer i f i cat i on( ) ;
2. Optionally, set the FARRequest ed property (page 82). You can use this property to set or to change
the value of the FAR from the default or from a specified value.
Example:
mat cher . set FARRequest ed( DPFPVer i f i cat i on. MEDI UM_SECURI TY_FAR) ;
3. *Retrieve serialized fingerprint template data from the fingerprint data storage subsystem.
4. Create a DPFPTempl at e object from the serialized data (see Deserializing a Serialized Fingerprint Data
Object on page 37).
5. Perform the system function of fingerprint verification by calling the ver i f y( f eat ur eSet ,
t empl at e) method and passing the DPFPTempl at e object created in the previous step and the
DPFPFeat ur eSet object from step 3 of the previous section (page 82).
Example:
DPFPVer i f i cat i onResul t r esul t = mat cher . ver i f y( f eat ur eSet , t empl at e) ;
i f ( r esul t . i sVer i f i ed( ) ) { . . . }
6. *Receive the DPFPVer i f i cat i onResul t object, which provides the comparison decision of match
or non-match (page 83).
Chapter 4: Overview Fingerprint Data Object Serialization/Deserialization
DigitalPersona One Touch for Windows SDK: Java Edition | Developer Guide 36
Fingerprint Data Object Serialization/Deserialization
This section contains two workflows: one for serializing a fingerprint data object and one for deserializing a
serialized fingerprint data object. The workflows are illustrated in Figure 7 and Figure 8 and are followed by
explanations of the One Touch for Windows SDK: Java Edition API functions used to perform the tasks in the
workflows.
Serializing a Fingerprint Data Object
Figure 7. Fingerprint data object serialization workflow: DPFPTempl at e object
1. Begin with a DPFPTempl at e object. (See DPFPTemplate on page 47 for more information on how a
DPFPTempl at e object is constructed or supplied).
2. Serialize the DPFPTempl at e object by calling the ser i al i ze method (page 46).
3. *Store the serialized fingerprint template data in a fingerprint data storage subsystem.
One Touch for Windows SDK: Java
Application (not part of SDK)
Legend
Serialize fingerprint data object
com.digitalpersona.onetouch.DPFPTemplate
B
object
Serialize object