com.machinezoo.sourceafis
Class FingerprintCompatibility
- java.lang.Object
-
- com.machinezoo.sourceafis.FingerprintCompatibility
-
public class FingerprintCompatibility extends Object
Collection of methods for export and import of foreign fingerprint template formats. Only publicly documented formats are supported. Three versions of ANSI 378 can be both imported and exported. Limited support for import of ISO 19794-2 is also provided. 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.
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method and Description static FingerprintTemplateconvert(byte[] template)Convert foreign fingerprint template to native SourceAFIS template.static List<FingerprintTemplate>convertAll(byte[] template)Convert foreign fingerprint template to a list of native SourceAFIS templates.static byte[]toAnsiIncits378v2004(FingerprintTemplate... templates)Convert native fingerprint template to ANSI 378-2004 template.static byte[]toAnsiIncits378v2009(FingerprintTemplate... templates)Convert native fingerprint template to ANSI 378-2009 template.static byte[]toAnsiIncits378v2009AM1(FingerprintTemplate... templates)Convert native fingerprint template to ANSI 378-2009/AM1 template.
-
-
-
Method Detail
-
convert
public static FingerprintTemplate convert(byte[] template)
Convert foreign fingerprint template to native SourceAFIS template. This is a convenience wrapper aroundconvertAll(byte[])that returns the first fingerprint in the template or throws if there are none. This method accepts all template formats documented on the template formats website, specifically all versions of ANSI 378 and the initial version of ISO 19794-2. Foreign template can come from feature extractor other than SourceAFIS.- Parameters:
template- imported foreign template in one of the supported formats- Returns:
- converted native template
- Throws:
NullPointerException- iftemplateisnullIllegalArgumentException- iftemplatecontains no fingerprintsRuntimeException- iftemplateis in an unsupported format or it is corrupted- See Also:
convertAll(byte[]),toAnsiIncits378v2004(FingerprintTemplate...), Supported fingerprint template formats
-
convertAll
public static List<FingerprintTemplate> convertAll(byte[] template)
Convert foreign fingerprint template to a list of native SourceAFIS templates. This method accepts all template formats documented on the template formats website, specifically all versions of ANSI 378 and the initial version of ISO 19794-2. Foreign template can come from feature extractor other than SourceAFIS. Several native templates can be returned, because many foreign template formats can contain multiple fingerprints.- Parameters:
template- imported foreign template in one of the supported formats- Returns:
- list of native templates containing fingerprints from the foreign template
- Throws:
NullPointerException- iftemplateisnullRuntimeException- iftemplateis in an unsupported format or it is corrupted- See Also:
convert(byte[]),toAnsiIncits378v2004(FingerprintTemplate...), Supported fingerprint template formats
-
toAnsiIncits378v2004
public static byte[] toAnsiIncits378v2004(FingerprintTemplate... templates)
Convert native fingerprint template to ANSI 378-2004 template. This method produces fingerprint template conforming to ANSI INCITS 378-2004. The template can then be used by fingerprint matcher other than SourceAFIS. Several native templates can be supplied, because ANSI 378 template can contain multiple fingerprints.- Parameters:
templates- list of native SourceAFIS templates to export- Returns:
- ANSI 378-2004 template
- Throws:
NullPointerException- iftemplatesor any of its items isnull- See Also:
toAnsiIncits378v2009(FingerprintTemplate...),toAnsiIncits378v2009AM1(FingerprintTemplate...),convertAll(byte[]), ANSI INCITS 378-2004
-
toAnsiIncits378v2009
public static byte[] toAnsiIncits378v2009(FingerprintTemplate... templates)
Convert native fingerprint template to ANSI 378-2009 template. This method produces fingerprint template conforming to ANSI INCITS 378-2009[R2014]. The template can then be used by fingerprint matcher other than SourceAFIS. Several native templates can be supplied, because ANSI 378 template can contain multiple fingerprints.- Parameters:
templates- list of native SourceAFIS templates to export- Returns:
- ANSI 378-2009 template
- Throws:
NullPointerException- iftemplatesor any of its items isnull- See Also:
toAnsiIncits378v2004(FingerprintTemplate...),toAnsiIncits378v2009AM1(FingerprintTemplate...),convertAll(byte[]), ANSI INCITS 378-2009[R2014]
-
toAnsiIncits378v2009AM1
public static byte[] toAnsiIncits378v2009AM1(FingerprintTemplate... templates)
Convert native fingerprint template to ANSI 378-2009/AM1 template. This method produces fingerprint template conforming to ANSI INCITS 378:2009/AM 1:2010[R2015]. The template can then be used by fingerprint matcher other than SourceAFIS. Several native templates can be supplied, because ANSI 378 template can contain multiple fingerprints.- Parameters:
templates- list of native SourceAFIS templates to export- Returns:
- ANSI 378-2009/AM1 template
- Throws:
NullPointerException- iftemplatesor any of its items isnull- See Also:
toAnsiIncits378v2004(FingerprintTemplate...),toAnsiIncits378v2009(FingerprintTemplate...),convertAll(byte[]), ANSI INCITS 378:2009/AM 1:2010[R2015]
-
-