Biometric converter is software that converts fingerprint images (WSQ, JPEG, JPEG2000, PNG) to finger minutiae formats (ANSI/INCITS 378 and ISO/IEC 29794-4) and finger minutiae format between each other. This repository serves as a formally recognized reference implementation of the international standard.

• Git
• Cmake 3.10.2+
• GCC 8+
• JDK 11* optional, required for WS
• Docker* optional

1. Clone repository
   git clone https://github.com/biometric-technologies/nist-biometric-image-software-nbis
2. Follow commands to install:

./setup.sh <INSTALLATION DIR> --without-X11 [--32 | --64]  
make config
make it
make install LIBNBIS=no

1. Clone repository
   git clone https://github.com/usnistgov/biomdi.git
2. Edit common/common.mk if you want to install to custom location
3. Follow commands to install:

make  
make install

1. Modify CMakeLists.txt, set path to dependencies libraries and installation directory

2. Run commands to install:

mkdir build
cd build
cmake ..
make install 

1. Run commands to install:

cd web-service
./gradlew clean build

1. Modify example/CMakeLists.txt, set path to dependencies libraries and installation directory
2. Run commands to install:

mkdir build
cd build
cmake ..
make

Convert file.

convert -i <input_file> -ti <input_type> -o <output_file> -to <output_type>

You can also use docker image from Docker Hub to use CLI without building/installing software.

1. Pull image

docker pull biometrictechnologies/biometric-converter-cli

2. Use CLI

docker run -i --rm -v ./work:/opt/work biometrictechnologies/biometric-converter-cli convert -i <input_file> -ti <input_type> -o <output_file> -to <output_type>

1. Add library to the project, include directory with a library header and link library files.

include_directories(/usr/local/lib/include)
link_directories(/usr/local/lib)

find_library(converter REQUIRED)

target_link_libraries(<your target> PUBLIC converter)

2. Import header #include <converter.h>
3. Use library methods

img2fmr(unsigned char *, int , char *, unsigned char **, int *)

fmr2fmr(unsigned char *, int , unsigned char **, int *, char *, char *)

int fmr2fmr_iso_card(unsigned char *, int , unsigned char **, int *,char *, char *, int , int )

Web service accepts and respond in JSON format, files should be transferred in base64 encoding.

POST /convert

curl --location --request POST 'http://localhost:8080/convert' \
--header 'Content-Type: application/json' \
--data-raw '{
"input": "...",
"inputType": "WSQ"
"outputType": "ANSI"
}'

HTTP/1.1 200 OK
Date: Thu, 24 Feb 2022 04:00:00 GMT+2
Status: 200 OK
Connection: close
Content-Type: application/json
Content-Length: 2

{
    "output": "..."
}

Convert multiple files, response array is not in the same order as requested. Use id field to map your files.

POST /convert-batch

curl --location --request POST 'http://localhost:8080/convert' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": [...]
}'

File to convert

HTTP/1.1 200 OK
Date: Thu, 24 Feb 2022 04:00:00 GMT+2
Status: 200 OK
Connection: close
Content-Type: application/json
Content-Length: 2

{
    "data": [...]
}

Converted file

1. Pull image

docker pull biometrictechnologies/biometric-converter

2. Start Web Service

docker run -it -p 8080:8080 biometrictechnologies/biometric-converter

If you found a bug and can provide steps to reliably reproduce it, or if you have a feature request, please open an issue. Other questions may be addressed to the Biometric Technologies project maintainers.

Biometric Converter is released under the GNU PUB3 License. See the LICENSE for details.