Портал документации Рутокен

Page tree

О программе

Тестовая утилита FAPI — это консольная утилита, которая демонстрирует возможности библиотеки fapi.dll (Fingerprint API). Библиотека генерирует байтовое представление шаблона отпечатков пальцев, соответствующее стандарту ГОСТ 19794-2-2013, на основе изображения.

Условия применения

Поддерживаемые ОС:

  • Windows (64-бит и 32-бит);
  • Linux (64-бит).

Начало работы

Установка тестовой утилиты не требуется.

Для корректной работы утилиты поместите библиотеку fapi.dll  в ту же директорию, где находится исполняемый файл утилиты.

Запуск утилиты осуществляется через команды в терминале. 

Вывести шаблон отпечатка пальца

Чтобы вывести байты шаблона отпечатка пальца:

  1. Запустите терминал.
  2. Перейдите в директорию с исполняемым файлом утилиты.

  3. Введите команду "fapi-cli <путь_к_изображениям> <опции>", где

  • <путь_к_изображениям> — путь к изображению или изображениям, из которых необходимо получить шаблон.

Для корректной работы функции формирования шаблона в FAPI изображение отпечатка пальца в оттенках серого должно иметь следующие характеристики:

  • ширина не менее 260 пикселей;
  • высота не менее 300 пикселей;
  • частота пространственной дискретизации изображения — 500 dpi;
  • битовая глубина — 8 бит;
  • папиллярные гребни на изображении представлены «темными» пикселями, впадины — светлыми и образуют темные контуры на светлом фоне.

Рекомендуется использовать изображения форматов *.bmp или *.png. 

В комплексный шаблон биометрических образцов рекомендуется помещать четыре отпечатка пальца.

  • <опции> — дополнительные опции:

    -p [ --position-finger ]— задать позицию пальца.

    Опция доступна только при использовании нескольких изображений.

    Возможные значения (по умолчанию 0):

    • 0 — позиция пальца неизвестна;

    • 1 — большой палец правой руки;

    • 2 — указательный палец правой руки;

    • 3 — средний палец правой руки;

    • 4 — безымянный палец правой руки;

    • 5 — мизинец правой руки;

    • 6 — большой палец левой руки;

    • 7 — указательный палец левой руки;

    • 8 — средний палец левой руки;

    • 9 — безымянный палец левой руки;

    • 10 — мизинец левой руки.

    -f [ --format ] — задать формат вывода результата работы утилиты.

          Возможные значения (по умолчанию plain):

    • plain — формат, в виде строки байтов;

    • cstyle — C-подобный формат;
    • pretty — удобочитаемый формат, строка байтов через пробел.

В результате утилита выведет байтовое представление шаблона отпечатков пальцев.

Пример с одним отпечатком (файл находится в папке с утилитой):

> fapi-cli finger1_1.bmp
464d520030333000000000cc000100000000bdffffffffffffffffff000000000000000000c500c500014001e0501f408700
c69f0061018a2b409100ca15009200e0ab4083019ea2409601b0280050018f2940a500dd044064013a32409900780900be00
7684010200b6dd0106010ed1011100e8d800b700ffde405001182b40580158b040720114b000680188a30068019029009f00
fa1440b00118b940c60164b440da0174b2411e012cc8011c0160c240540143b2404a0142b0405c01869740b900f48940bc01
56b60000

Пример с одним отпечатком (файл находится в папке fingers):

> fapi-cli fingers/215_1_24214.jpg  
464d520030333000000000db000100000000ccffffffffffffffffff000000000000000000c500c500014001e05022403c00
748b404b011e1b406d018a1a00b0009c7240c0012cdf40e4007ce840c601706d00ad0030f200b1004072407c014ab1007501
7032009e00fe6500fb00ac6240dd01485f003a01599240670127ed403700ba0b0058008808008801788400ce00346b009601
54d64092016c4d4093017a6f00ef007a64005f00dd08004c00b68d405c012ea300780156b2408001366700840146c600bf01
887d40f800d65d4073011bec00e40099e40000

Пример с несколькими отпечатками:

> fapi-cli fingers/215_1_24214.jpg fingers/215_1_24215.jpg
464d520030333000000001ac000200000000ccffffffffffffffffff0000000000000000000000c500014001e05022403c00
748b404b011e1b406d018a1a00b0009c7240c0012cdf40e4007ce840c601706d00ad0030f200b1004072407c014ab1007501
7032009e00fe6500fb00ac6240dd01485f003a01599240670127ed403700ba0b0058008808008801788400ce00346b009601
54d64092016c4d4093017a6f00ef007a64005f00dd08004c00b68d405c012ea300780156b2408001366700840146c600bf01
887d40f800d65d4073011bec00e40099e40000000000d1ffffffffffffffffff0000000000000001000000c500014001e050
2300660080040088008c8240750112f00084013cc200bc002cee00a700f66400da00306d009e01788800c60128dc40f0007c
e540e5014262004201538400f00097e1404400b20b005600ae8b405201161b00bf003c70009e014ed640af016c5b00fa0076
6400c801827b4041006e8e404801104f40cf016a6e410200d45d00e7017272006700d5084032013aa3408c016642008e0172
8400bc009670010600aa62410500ecd90092013dc940ba00c5e20000

Пример для мизинца правой руки (-p 5):

> fapi-cli fingers/215_1_24214.jpg fingers/215_1_24215.jpg fingers/215_1_24218.jpg -p 5
464d52003033300000000296000300000000ccffffffffffffffffff0000000000000500000000c500014001e05022403c007
48b404b011e1b406d018a1a00b0009c7240c0012cdf40e4007ce840c601706d00ad0030f200b1004072407c014ab100750170
32009e00fe6500fb00ac6240dd01485f003a01599240670127ed403700ba0b0058008808008801788400ce00346b00960154d
64092016c4d4093017a6f00ef007a64005f00dd08004c00b68d405c012ea300780156b2408001366700840146c600bf01887d
40f800d65d4073011bec00e40099e40000000000d1ffffffffffffffffff0000000000000501000000c500014001e05023006
60080040088008c8240750112f00084013cc200bc002cee00a700f66400da00306d009e01788800c60128dc40f0007ce540e5
014262004201538400f00097e1404400b20b005600ae8b405201161b00bf003c70009e014ed640af016c5b00fa00766400c80
1827b4041006e8e404801104f40cf016a6e410200d45d00e7017272006700d5084032013aa3408c016642008e01728400bc00
9670010600aa62410500ecd90092013dc940ba00c5e20000000000eaffffffffffffffffff0000000000000502000000c5000
14001e05028408400f4f000900134b20092014837009b011ec640c000a4e700b2015888010d00826340f5011a63410c00ac61
411100c2d800ae012bd8009701c106404600960f00be00767200ff004c6900fb014c74404a00e1a300f3006fe740f90193884
02a010c28005c009091406000f81e006201841b00840120b0408a01641c40ad00d66b40a7014a9040660117a80082010faf40
f40053e9404700508f00660062060087007082006e01b20940c301485e40d60102e140e101446e00dc015e7f00f501647d407
300c3060000

Пример для среднего пальца правой руки (-p 8):

> fapi-cli fingers/215_1_24214.jpg fingers/215_1_24215.jpg fingers/215_1_24218.jpg -p 8
464d52003033300000000296000300000000ccffffffffffffffffff0000000000000800000000c500014001e05022403c007
48b404b011e1b406d018a1a00b0009c7240c0012cdf40e4007ce840c601706d00ad0030f200b1004072407c014ab100750170
32009e00fe6500fb00ac6240dd01485f003a01599240670127ed403700ba0b0058008808008801788400ce00346b00960154d
64092016c4d4093017a6f00ef007a64005f00dd08004c00b68d405c012ea300780156b2408001366700840146c600bf01887d
40f800d65d4073011bec00e40099e40000000000d1ffffffffffffffffff0000000000000801000000c500014001e05023006
60080040088008c8240750112f00084013cc200bc002cee00a700f66400da00306d009e01788800c60128dc40f0007ce540e5
014262004201538400f00097e1404400b20b005600ae8b405201161b00bf003c70009e014ed640af016c5b00fa00766400c80
1827b4041006e8e404801104f40cf016a6e410200d45d00e7017272006700d5084032013aa3408c016642008e01728400bc00
9670010600aa62410500ecd90092013dc940ba00c5e20000000000eaffffffffffffffffff0000000000000802000000c5000
14001e05028408400f4f000900134b20092014837009b011ec640c000a4e700b2015888010d00826340f5011a63410c00ac61
411100c2d800ae012bd8009701c106404600960f00be00767200ff004c6900fb014c74404a00e1a300f3006fe740f90193884
02a010c28005c009091406000f81e006201841b00840120b0408a01641c40ad00d66b40a7014a9040660117a80082010faf40
f40053e9404700508f00660062060087007082006e01b20940c301485e40d60102e140e101446e00dc015e7f00f501647d407
300c3060000

Пример с форматом в виде строки байтов:

> fapi-cli finger1_1.bmp -f plain
464d520030333000000000cc000100000000bdffffffffffffffffff000000000000000000c500c500014001e0501f40
8700c69f0061018a2b409100ca15009200e0ab4083019ea2409601b0280050018f2940a500dd044064013a3240990078
0900be007684010200b6dd0106010ed1011100e8d800b700ffde405001182b40580158b040720114b000680188a30068
019029009f00fa1440b00118b940c60164b440da0174b2411e012cc8011c0160c240540143b2404a0142b0405c018697
40b900f48940bc0156b60000

Пример с C-подобным форматом:

> fapi-cli finger1_1.bmp -f cstyle
0x46, 0x4D, 0x52, 0x00, 0x30, 0x33, 0x30, 0x00, 0x00, 0x00, 0x00, 0xCC, 0x00, 0x01, 0x00, 0x00, 
0x00, 0x00, 0xBD, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x00, 0x00, 0x00, 0x00, 
0x00, 0x00, 0x00, 0x00, 0x00, 0xC5, 0x00, 0xC5, 0x00, 0x01, 0x40, 0x01, 0xE0, 0x50, 0x1F, 0x40, 
0x87, 0x00, 0xC6, 0x9F, 0x00, 0x61, 0x01, 0x8A, 0x2B, 0x40, 0x91, 0x00, 0xCA, 0x15, 0x00, 0x92, 
0x00, 0xE0, 0xAB, 0x40, 0x83, 0x01, 0x9E, 0xA2, 0x40, 0x96, 0x01, 0xB0, 0x28, 0x00, 0x50, 0x01, 
0x8F, 0x29, 0x40, 0xA5, 0x00, 0xDD, 0x04, 0x40, 0x64, 0x01, 0x3A, 0x32, 0x40, 0x99, 0x00, 0x78, 
0x09, 0x00, 0xBE, 0x00, 0x76, 0x84, 0x01, 0x02, 0x00, 0xB6, 0xDD, 0x01, 0x06, 0x01, 0x0E, 0xD1, 
0x01, 0x11, 0x00, 0xE8, 0xD8, 0x00, 0xB7, 0x00, 0xFF, 0xDE, 0x40, 0x50, 0x01, 0x18, 0x2B, 0x40, 
0x58, 0x01, 0x58, 0xB0, 0x40, 0x72, 0x01, 0x14, 0xB0, 0x00, 0x68, 0x01, 0x88, 0xA3, 0x00, 0x68, 
0x01, 0x90, 0x29, 0x00, 0x9F, 0x00, 0xFA, 0x14, 0x40, 0xB0, 0x01, 0x18, 0xB9, 0x40, 0xC6, 0x01, 
0x64, 0xB4, 0x40, 0xDA, 0x01, 0x74, 0xB2, 0x41, 0x1E, 0x01, 0x2C, 0xC8, 0x01, 0x1C, 0x01, 0x60, 
0xC2, 0x40, 0x54, 0x01, 0x43, 0xB2, 0x40, 0x4A, 0x01, 0x42, 0xB0, 0x40, 0x5C, 0x01, 0x86, 0x97, 
0x40, 0xB9, 0x00, 0xF4, 0x89, 0x40, 0xBC, 0x01, 0x56, 0xB6, 0x00, 0x00

Пример с удобочитаемым форматом:

> fapi-cli finger1_1.bmp -f pretty
46 4D 52 00 30 33 30 00 00 00 00 CC 00 01 00 00 00 00 BD FF FF FF FF FF FF FF FF FF 00 00 00 00
00 00 00 00 00 C5 00 C5 00 01 40 01 E0 50 1F 40 87 00 C6 9F 00 61 01 8A 2B 40 91 00 CA 15 00 92
00 E0 AB 40 83 01 9E A2 40 96 01 B0 28 00 50 01 8F 29 40 A5 00 DD 04 40 64 01 3A 32 40 99 00 78
09 00 BE 00 76 84 01 02 00 B6 DD 01 06 01 0E D1 01 11 00 E8 D8 00 B7 00 FF DE 40 50 01 18 2B 40
58 01 58 B0 40 72 01 14 B0 00 68 01 88 A3 00 68 01 90 29 00 9F 00 FA 14 40 B0 01 18 B9 40 C6 01 
64 B4 40 DA 01 74 B2 41 1E 01 2C C8 01 1C 01 60 C2 40 54 01 43 B2 40 4A 01 42 B0 40 5C 01 86 97 
40 B9 00 F4 89 40 BC 01 56 B6 00 00

Вывести справку по использованию утилиты

Чтобы вывести справку по использованию утилиты:

  1. Запустите терминал.
  2. Перейдите в директорию с исполняемым файлом утилиты.

  3. Введите команду "fapi-cli -h".

В результате отобразится справка по использованию утилиты.

Вывести текущую версию утилиты

Чтобы вывести текущую версию утилиты:

  1. Запустите терминал.
  2. Перейдите в директорию с исполняемым файлом утилиты.

  3. Введите команду "fapi-cli -v".

В результате отобразится текущая версия утилиты.

  • No labels