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.

See Also:

Fingerprint template formats, Why "standard" templates are a bad idea

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static FingerprintTemplate`	`convert(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.
`static String`	`version()` Get version of the currently running SourceAFIS.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - version
```
public static String version()
```
    Get version of the currently running SourceAFIS. This is useful during upgrades when the application has to deal with possible template incompatibility between versions.
    
    Returns:
    
    SourceAFIS version in a three-part 1.2.3 format
  - convert
```
public static FingerprintTemplate convert(byte[] template)
```
    Convert foreign fingerprint template to native SourceAFIS template. This is a convenience wrapper around convertAll(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 - if template is null
    
    IllegalArgumentException - if template contains no fingerprints
    
    RuntimeException - if template is 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 - if template is null
    
    RuntimeException - if template is 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 - if templates or any of its items is null
    
    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 - if templates or any of its items is null
    
    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 - if templates or any of its items is null
    
    See Also:
    
    toAnsiIncits378v2004(FingerprintTemplate...), toAnsiIncits378v2009(FingerprintTemplate...), convertAll(byte[]), ANSI INCITS 378:2009/AM 1:2010[R2015]

Class FingerprintCompatibility

Method Summary

Methods inherited from class java.lang.Object

Method Detail

version

convert

convertAll

toAnsiIncits378v2004

toAnsiIncits378v2009

toAnsiIncits378v2009AM1