public class FingerprintCompatibility extends Object
ANSI and ISO template specs prescribe specific ways to calculate minutia position and angle. They even vary these calculations between versions of the same spec. SourceAFIS has its own algorithms to determine minutia positions and angles. Conversion routines currently don't attempt to compensate for this difference. They just copy minutia positions and angles to the target template without any adjustments. This may result in some loss of accuracy when matching against templates from other sources.
Note that the use of these so-called "standard" templates for fingerprint exchange is strongly discouraged in favor of plain fingerprint images.
Modifier and Type | Method and Description |
---|---|
static FingerprintTemplate |
convert(byte[] template)
Deprecated.
Use
importTemplate(byte[]) instead.
|
static List<FingerprintTemplate> |
convertAll(byte[] template)
Deprecated.
Use
importTemplates(byte[]) instead.
|
static byte[] |
exportTemplates(TemplateFormat format, FingerprintTemplate... templates)
Converts one or more native templates to non-native template format.
|
static FingerprintTemplate |
importTemplate(byte[] template)
Converts non-native fingerprint template to native SourceAFIS template.
|
static List<FingerprintTemplate> |
importTemplates(byte[] template)
Converts non-native fingerprint template to a list of native SourceAFIS templates.
|
static byte[] |
toAnsiIncits378v2004(FingerprintTemplate... templates)
Deprecated.
|
static byte[] |
toAnsiIncits378v2009(FingerprintTemplate... templates)
Deprecated.
|
static byte[] |
toAnsiIncits378v2009AM1(FingerprintTemplate... templates)
Deprecated.
|
static String |
version()
Gets version of the currently running SourceAFIS.
|
public static String version()
public static List<FingerprintTemplate> importTemplates(byte[] template)
This method accepts publicly documented template formats implemented in FingerprintIO library, specifically ANSI 378 (2004, 2009, and 2009/Am1) and ISO 19794-2 (2005 and 2011 off-card variants).
If you just need to deserialize native SourceAFIS template, call FingerprintTemplate(byte[])
instead. To create template from fingerprint image, call FingerprintTemplate(FingerprintImage)
.
template
- non-native template in one of the supported formats
NullPointerException
- if template
is null
TemplateFormatException
- if template
is in an unsupported format or it is corrupted
importTemplate(byte[])
, exportTemplates(TemplateFormat, FingerprintTemplate...)
, FingerprintIO
public static FingerprintTemplate importTemplate(byte[] template)
importTemplates(byte[])
that returns the first fingerprint in the template or throws if there are none.
This method accepts publicly documented template formats implemented in FingerprintIO library, specifically ANSI 378 (2004, 2009, and 2009/Am1) and ISO 19794-2 (2005 and 2011 off-card variants).
If you just need to deserialize native SourceAFIS template, call FingerprintTemplate(byte[])
instead. To create template from fingerprint image, call FingerprintTemplate(FingerprintImage)
.
template
- non-native template in one of the supported formats
NullPointerException
- if template
is null
TemplateFormatException
- if template
is in an unsupported format or it is corrupted
IllegalArgumentException
- if template
contains no fingerprints
FingerprintTemplate(byte[])
, importTemplates(byte[])
, exportTemplates(TemplateFormat, FingerprintTemplate...)
, FingerprintIO
public static byte[] exportTemplates(TemplateFormat format, FingerprintTemplate... templates)
This method supports publicly documented template formats implemented in FingerprintIO library, specifically ANSI 378 (2004, 2009, and 2009/Am1) and ISO 19794-2 (2005 and 2011 off-card variants). To tweak contents of the exported template, deserialize it with FingerprintIO, perform required changes, and serialize it again with FingerprintIO.
If you just need to serialize native SourceAFIS template, call FingerprintTemplate.toByteArray()
instead.
format
- target non-native template format
templates
- list of native SourceAFIS templates to export
NullPointerException
- if format
, templates
, or any of the templates are null
TemplateFormatException
- if format
is unsupported or export fails for some reason
FingerprintTemplate.toByteArray()
, importTemplates(byte[])
, FingerprintIO
@Deprecated public static List<FingerprintTemplate> convertAll(byte[] template)
importTemplates(byte[])
instead.
template
- foreign template in one of the supported formats
NullPointerException
- if template
is null
TemplateFormatException
- if template
is in an unsupported format or it is corrupted
@Deprecated public static FingerprintTemplate convert(byte[] template)
importTemplate(byte[])
instead.
template
- foreign template in one of the supported formats
NullPointerException
- if template
is null
TemplateFormatException
- if template
is in an unsupported format or it is corrupted
IllegalArgumentException
- if template
contains no fingerprints
@Deprecated public static byte[] toAnsiIncits378v2004(FingerprintTemplate... templates)
exportTemplates(TemplateFormat, FingerprintTemplate...)
instead.
templates
- list of native SourceAFIS templates to export
NullPointerException
- if templates
or any of its items is null
@Deprecated public static byte[] toAnsiIncits378v2009(FingerprintTemplate... templates)
exportTemplates(TemplateFormat, FingerprintTemplate...)
instead.
templates
- list of native SourceAFIS templates to export
NullPointerException
- if templates
or any of its items is null
@Deprecated public static byte[] toAnsiIncits378v2009AM1(FingerprintTemplate... templates)
exportTemplates(TemplateFormat, FingerprintTemplate...)
instead.
templates
- list of native SourceAFIS templates to export
NullPointerException
- if templates
or any of its items is null
Copyright © 2009–2021 Robert Važan. All rights reserved.