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
- Clone repository
git clone https://github.com/biometric-technologies/nist-biometric-image-software-nbis - Follow commands to install:
./setup.sh <INSTALLATION DIR> --without-X11 [--32 | --64]
make config
make it
make install LIBNBIS=no- Clone repository
git clone https://github.com/usnistgov/biomdi.git - Edit
common/common.mkif you want to install to custom location - Follow commands to install:
make
make install-
Modify
CMakeLists.txt, set path to dependencies libraries and installation directory -
Run commands to install:
mkdir build
cd build
cmake ..
make install - Run commands to install:
cd web-service
./gradlew clean build- Modify
example/CMakeLists.txt, set path to dependencies libraries and installation directory - Run commands to install:
mkdir build
cd build
cmake ..
makeConvert file.
convert -i <input_file> -ti <input_type> -o <output_file> -to <output_type>| Param | Description |
|---|---|
| input_file | path to file you want convert from |
| input_type | input file type format (image or minutiae) |
| output_file | path to file you want convert to |
| output_type | output file type format (minutiae) |
You can also use docker image from Docker Hub to use CLI without building/installing software.
- Pull image
docker pull biometrictechnologies/biometric-converter-cli- 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>
- 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)- Import header
#include <converter.h> - Use library methods
img2fmr(unsigned char *, int , char *, unsigned char **, int *)| Param | Description |
|---|---|
| input_data | image data want to convert from |
| input_length | image data length you want to convert from |
| output_type | output file type format (minutiae) |
| output_data | output data |
| output_length | output data length |
fmr2fmr(unsigned char *, int , unsigned char **, int *, char *, char *)| Param | Description |
|---|---|
| input_data | file data want to convert from |
| input_length | file data length you want to convert from |
| output_data | output data |
| output_length | output data length |
| input_type | input file type format (minutiae) |
| output_type | output file type format (minutiae) |
int fmr2fmr_iso_card(unsigned char *, int , unsigned char **, int *,char *, char *, int , int )| Param | Description |
|---|---|
| input_data | file data want to convert from |
| input_length | file data length you want to convert from |
| output_data | output data |
| output_length | output data length |
| input_type | input file type format (minutiae) |
| output_type | output file type format (minutiae, ISOC/ISOCC only) |
| x resolution | image resolution x |
| y resolution | image resolution y |
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"
}'
| Param | Description |
|---|---|
| input | image data in BASE64 encoding you want to convert from |
| inputType | input file type format (image or minutiae) |
| outputType | output file type format (minutiae) |
| imageResX | image x resolution for ISO Card format (optional) |
| imageResY | image y resolution for ISO Card format (optional) |
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": "..."
}
| Param | Description |
|---|---|
| output | BASE64 encoded output data |
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": [...]
}'
| Param | Description |
|---|---|
| data | Array of files to convert |
File to convert
| Param | Description |
|---|---|
| id | id of the requested image |
| input | image data in BASE64 encoding you want to convert from |
| inputType | input file type format (image or minutiae) |
| outputType | output file type format (minutiae) |
| imageResX | image x resolution for ISO Card format (optional) |
| imageResY | image y resolution for ISO Card format (optional) |
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": [...]
}
| Param | Description |
|---|---|
| data | Array of converted files |
Converted file
| Param | Description |
|---|---|
| id | id of the requested image |
| output | BASE64 encoded output data |
- Pull image
docker pull biometrictechnologies/biometric-converter- Start Web Service
docker run -it -p 8080:8080 biometrictechnologies/biometric-converterIf 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.