# Fingerprint O GBS Fingerprint SDK é uma biblioteca de reconhecimento de impressões digitais que vem empacotada com um Kit de Desenvolvimento de Software (SDK), permitindo que você integre biometria em uma ampla variedade de aplicações. Graças ao suporte a várias linguagens de programação, exemplos de código e sua documentação, você começará a desenvolver sua aplicação em questão de minutos. ## Instalando o SDK ### Licenciamento O GBS Fingerprint SDK requer uma licença de software para funcionar corretamente. Ele é distribuído com uma licença de avaliação válida por 90 dias\*. Após este período, uma licença deve ser adquirida enviando um e-mail para e deve ser instalada em `C:\ProgramData\Griaule.` {% hint style="info" %} Para dúvidas, por favor entre em contato com o suporte da Griaule Biometrics enviando um e-mail para . {% endhint %} ### Instalação Você deve possuir uma das seguintes versões do SDK para realizar a instalação. Verifique se a versão que você possui é compatível com seu sistema operacional. * GBS Fingerprint SDK (x86-64) * GBS Fingerprint SDK (x86) * GBS Fingerprint SDK (Linux) Para instalar o SDK, clique duas vezes no arquivo e siga as instruções na tela. ### Visão Geral das Pastas

Diretório	Descrição
bin	Contém todos os arquivos necessários pela biblioteca GBS Fingerprint SDK. Esta pasta contém principalmente DLLs.
doc	Os arquivos de documentação do Fingerprint SDK.
inc	Arquivos de importação para algumas das linguagens suportadas (somente DLL).
lib	Bibliotecas para acessar o GBS Fingerprint SDK em suas aplicações C++ e C#.NET.
samples	Contém os códigos-fonte e binários dos exemplos.

### Sistemas Operacionais e dispositivos Leitores de Impressão digital suportados Uma vez que o GBS Fingerprint SDK esteja instalado, os dispositivos suportados também são instalados. A tabela a seguir especifica quais modelos são suportados de acordo com o Sistema Operacional.

Arquitetura do Sistema Operacional	Win 10 64 Bits	Win 10 32 Bits	Win 8.1 64 Bits	Win 8.1 32 Bits	Win 8 64 Bits	Win 8 32 Bits	Win 7 64 Bits	Win 7 32 Bits
Cogent Cs500e	✅	✅	✅	✅	✅	✅	✅	✅
Crossmatch EF200 / Watson	✅	✅	✅	✅	✅	✅	✅	✅
Crossmatch LSCAN Guardian	❌	✅	❌	✅	❌	✅	❌	✅
Crossmatch Verifier 320 LC	✅	✅	✅	✅	✅	✅	✅	✅
Digent Izzix FD1000	❌	✅	❌	✅	❌	✅	❌	✅
Digital Persona U.are.U 4000	✅	✅	✅	✅	✅	✅	✅	✅
Digital Persona U.are.U 4500	✅	✅	✅	✅	✅	✅	✅	✅
Digital Persona U.are.U 5100	✅	✅	✅	✅	✅	✅	✅	✅
Futronic FS52	❌	✅	❌	✅	❌	✅	❌	✅
Futronic FS80	✅	✅	✅	✅	✅	✅	✅	✅
Futronic FS80H	✅	✅	✅	✅	✅	✅	✅	✅
Futronic FS81H	✅	✅	✅	✅	✅	✅	✅	✅
Futronic FS88	✅	✅	✅	✅	✅	✅	✅	✅
Futronic FS88H	✅	✅	✅	✅	✅	✅	✅	✅
Greenbit Multiscan 527	✅	✅	✅	✅	✅	✅	✅	✅
Lumidigm M301	✅	✅	✅	✅	✅	✅	✅	✅
Lumidigm V302	✅	✅	✅	✅	✅	✅	✅	✅
Lumidigm V311	✅	✅	✅	✅	✅	✅	✅	✅
Lumidigm V371	✅	✅	✅	✅	✅	✅	✅	✅
IDTech Biomag IDT-4012-DP	✅	✅	✅	✅	✅	✅	✅	✅
IDTech Biomag IDT-4033-NG	✅	✅	✅	✅	✅	✅	✅	✅
IB Sherlock	✅	✅	❌	❌	❌	❌	❌	❌
Integrated Biometrics Watson Mini	✅	✅	✅	✅	✅	✅	✅	✅
IB Kojak	✅	✅	❌	✅	❌	✅	❌	✅
Nitgen eNBioScan-D	❌	✅	❌	❌	❌	❌	❌	❌
Nitgen Hamster DX	❌	✅	❌	✅	❌	✅	❌	✅
Nitgen Hamster II	❌	✅	❌	✅	❌	✅	❌	✅
Nitgen Hamster II DX / III	❌	✅	❌	✅	❌	✅	❌	✅
Secugen Hamster IV	✅	✅	✅	✅	✅	✅	✅	✅
Secugen Hamster Plus	✅	✅	✅	✅	✅	✅	✅	✅
Secugen Hamster Pro 20	✅	✅	✅	✅	✅	✅	✅	✅
Suprema BioMini	❌	✅	❌	✅	❌	✅	❌	✅
Suprema BioMini Plus	❌	✅	❌	✅	❌	✅	❌	✅
Suprema BioMini Slim	❌	✅	❌	✅	❌	✅	❌	✅
Suprema RealScan-D	✅	✅	✅	✅	✅	✅	✅	✅
Suprema RealScan-G10	✅	✅	✅	✅	✅	✅	✅	✅
Suprema SFU-S20	❌	✅	❌	✅	❌	✅	❌	✅
TechMag Biopass	✅	✅	✅	✅	✅	✅	✅	✅
UPEK Eikon	❌	✅	❌	✅	❌	✅	❌	✅
UPEK Eikon Touch	❌	✅	❌	✅	❌	✅	❌	✅
Virdi FOH02	✅	✅	✅	✅	✅	✅	✅	✅
Virdi FOH04	✅	✅	✅	✅	✅	✅	✅	✅
Zvetco Verifi P5000	❌	✅	❌	✅	❌	✅	❌	✅
Zvetco Verifi P6000-B	❌	✅	❌	✅	❌	✅	❌	✅

Leitor	Bibliotecas
CrossMatch V320	GBSFingerprintCapPluginCrossMatch320.dll LScanEssentials.dll QtCore4.dll QtGui4.dll QtNetwork4.dll QtWebKit4.dll
Outros CrossMatch	GBSFingerprintCapPluginCrossMatchP.dll GBSFingerprintCapPluginCrossMatch300.dll intl.dll libglib-2.0-0.dll USB4XX.dll
Digent	GBSFingerprintCapPluginDigent.dll FingerAPI22Ex.dll IZZIX20.dll TCI.dll
Futronic FS	GBSFingerprintCapPluginFutronicFS50.dll ftrScanAPI.dll
Outras Futronic	GBSFingerprintCapPluginFutronic.dll ftrScanAPI.dll
Nitgen Hamster	GBSFingerprintCapPluginHams.dll NBioBSP.dll
Nitgen eNBioScan-D	GBSFingerprintCapPluginNitgenD.dll eNBioScan-D NBioScan.dll
Nitgen eNBioScan-F	GBSFingerprintCapPluginNitgenF.dll eNBioScan-F NBioBSP.dll
Integrated Biometrics Watson Mini	GBSFingerprintCapPluginIB.dll IBScanUltimate.dll
Lumidigm	GBSFingerprintCapPluginLumi.dll LumiAPI.dll LumiCore.dll LumiInOpAPI.dll plugin/AlgoDvc.dll plugin/IEngine_Plus.dll plugin/MercuryDvc.dll plugin/PreProcV31_INT16.dll plugin/SDvc.dll plugin/VenusDvc.dll
Suprema RealScan-D	GBSFingerprintCapPluginRealD.dll RS_SDK.dll
Outras Suprema	GBSFingerprintCapPluginSuprema.dll UFLicense.dat UFScanner.dll
UPEK TouchChip	GBSFingerprintCapPluginUpek.dll bsapi.dll TCI.dll
Virdi FOH02	GBSFingerprintCapPluginVirdi2.dll UCBioBSP.dll VHMLib.dll

{% hint style="info" %} Se o seu leitor de impressões digitais não estiver listado na tabela acima e para mais informações, por favor contate-nos por e-mail . {% endhint %} ### Suporte a Linguagens de Programação O GBS Fingerprint SDK suporta múltiplas linguagens de programação, incluindo Java, C++ e C#/.NET. ## Recursos ### Características Técnicas **Captura:** * Detecta plug/unplug de leitores de impressão digital; * Detecção automática de dedo; * Suporta arquivos BMP para salvar/carregar imagens de impressão digital; * Tamanho máximo de imagem de 1280 x 1280 pixels; * Tamanho mínimo de imagem de 50 x 50 pixels; * Resolução máxima de 1000 DPI; * Resolução mínima de 125 DPI; **Extração:** * Tempo médio de extração de 100ms; > Imagens de 300 x 300 pixels. Máquina: Pentium4 2.8GHz, 512MB RAM. * Tamanho máximo de imagem de 500 x 500 pixels; > Imagens maiores são cortadas. * Tamanho mínimo de imagem de 50 x 50 pixels; * Tamanho médio de template de 400 bytes; **Comparação:** {% hint style="info" %} A identificação one-to-many não é realizada pelo GBS Fingerprint SDK. {% endhint %} * Velocidade de verificação: até 100/s. > Imagens de 100 x 100 pixels. Máquina: Pentium4 2.8GHz, 512MB RAM. ### Limiar e Tolerância de Rotação A função de verificação na biblioteca Fingerprint SDK é regida por dois parâmetros importantes: limiar e tolerância de rotação. O limiar é a pontuação mínima necessária para afirmar que duas impressões digitais correspondem. O valor padrão é 20 para o processo de verificação, garantindo um FRR de 1%. A tolerância de rotação define a variação máxima aceitável de ângulo (em graus) entre duas impressões digitais comparadas que resultará em uma correspondência. Esse valor é válido tanto no sentido horário quanto no sentido anti-horário, portanto o valor máximo que pode ser definido é 180. O valor padrão é -1. ### Novidades no Fingerprint SDK * Adicionada funcionalidade AFIS (Sistema Automático de Identificação de Impressões Digitais): padrões são identificados por software em imagens de impressões digitais e são usados para comparação com padrões de outra imagem de impressão digital para determinar se vieram do mesmo dedo e, por fim, da mesma pessoa. * Adicionado conversor para funcionalidade WSQ. O WSQ é o melhor formato de imagem para impressões digitais. Alcança uma grande compressão com alta qualidade de imagem. * Formatos de imagem suportados ao converter para WSQ: BMP, JPEG, JPEG 2000, TIFF, GIF e PNG. * Adicionado suporte a mais Leitores de Impressão Digital; * Adicionado suporte ao Windows 7, 8 e 8.1 32-bit e 64-bit. * Corrigidos alguns bugs do Fingerprint SDK 2009; * Removido o conceito de Context; * Removidas as edições IDENTIFICATION e VERIFICATION; * Não realiza operações multi-thread como identificação one-to-many; * Realiza extração e verificação de impressão digital (comparação one-to-one). ## Como migrar do Fingerprint SDK 2009 para o novo GBS Fingerprint SDK Esta seção destaca as principais diferenças introduzidas ao comparar o novo Fingerprint SDK com o Fingerprint SDK 2009. ### O GBS Fingerprint SDK No Fingerprint SDK 2009, um objeto MatchingContext é onde as operações biométricas (extração de minúcias de impressão digital e comparação de impressões digitais) ocorrem. Todos os métodos em um objeto MatchingContext são sincronizados, assim, para executar N operações biométricas ao mesmo tempo, N objetos MatchingContext devem ser criados. No novo Fingerprint SDK, o Matching Context não é mais aplicável. A aplicação continua sendo thread-safe, mas apenas operações single-threaded são realizadas por vez. Para operações multi-thread, como Identificação (one-to-many), o GBS Server é necessário. Para mais informações sobre este software da Griaule Biometric Suite, por favor contate o suporte da Griaule Biometrics (). #### Nova API: métodos descontinuados e novos As tabelas a seguir correspondem os métodos descontinuados dos softwares anteriores (Fingerprint SDK 2009, AFIS 2.0 e WSQ 1.2) com os novos que os substituem, se aplicável. O valor NA indica que a funcionalidade do método foi descontinuada na versão atual do SDK. | Fingerprint 2009 | Afis | WSQ | GBS Fingerprint | | --------------------------- | ----------------------------------- | --------------------------------------- | --------------------------- | | GrInitialize | GriauleAfisInitialize | | GrInitialize | | GrCapInitialize | GriauleAfisCapInitialize | | GrCapInitialize | | GrFinalize | GriauleAfisFinalize | | GrFinalize | | GrCapFinalize | GriauleAfisCapFinalize | | GrCapFinalize | | GrExtract | GriauleAfisExtract | | NA | | GrExtractEx | GriauleAfisExtractEx | | GrExtract | | GrConvertTemplate | GriauleAfisConvertTemplate | | GrConvertTemplate | | GrCreateContext | GriauleAfisCreateContex | | NA | | GrDestroyContext | GriauleAfisDestroyContext | | NA | | GrVerify | GriauleAfisVerify | | GrVerify | | GrSetVerifyParameters | GriauleAfisSetVerifyParameters | | GrSetVerifyParameters | | GrGetVerifyParameters | GriauleAfisGetVerifyParameters | | GrGetVerifyParameters | | GrIdentify | GriauleAfisIdentify | | NA | | GrIdentifyPrepare | GriauleAfisIdentifyPrepare | | NA | | GrSetIdentifyParameters | GriauleAfisSetIdentifyParameters | | NA | | GrGetIdentifyParameters | GriauleAfisGetIdentifyParameters | | NA | | GrCapStartCapture | GriauleAfisCapStartCapture | | GrCapStartCapture | | GrCapStopCapture | GriauleAfisCapStopCapture | | GrCapStopCapture | | | GriauleAfisCapCapture | | NA | | | GriauleAfisGetProcessedImage | | NA | | | GriauleAfisGetTemplate | | NA | | | GriauleAfisGetTemplateEx | | NA | | | GriauleAfisSetTemplate | | NA | | | GriauleAfisGetTemplateInfo | | NA | | | GriauleAfisGetMinutiaInfo | | NA | | | GriauleAfisGetSegmentInfo | | NA | | | GriauleAfisAddMinutia | | NA | | | GriauleAfisRemoveMinutia | | NA | | | GriauleAfisGetNearestMinutia | | NA | | | GriauleAfisGetNearestSegment | | NA | | | GriauleAfisRecalculateSegment | | NA | | | GriauleAfisSetPatternClassification | | NA | | | GriauleAfisGetPatternClassification | | NA | | | GriauleAfisGetMatchInfo | | NA | | | GriauleAfisGetMatchMinutia | | NA | | | GriauleAfisGetMatchSegment | | NA | | | GriauleAfisRawImageToHandle | | NA | | | GriauleAfisSaveRawImageToFile | | NA | | | GriauleAfisLoadImageFromFile | | NA | | | GriauleAfisDisplay | | NA | | | GriauleAfisSegmentTwoFingers | | GrSegmentNFingers | | | GriauleAfisSegmentFourFingers | | GrSegmentNFingers | | | GriauleAfisFreeBlockData | | | | | GriauleAfisSetCaptureParameters | | GrSetCaptureParameters | | | GriauleAfisGetCaptureParameters | | GrGetCaptureParameters | | | GriauleAfisSetCaptureThresholds | | GrSetCaptureThresholds | | | GriauleAfisGetCaptureThresholds | | GrGetCaptureThresholds | | | GriauleAfisSetDisplayColors | | NA | | | GriauleAfisGetDisplayColors | | NA | | | GriauleAfisSetExtractParameters | | NA | | | GriauleAfisGetExtractParameters | | NA | | | GriauleAfisSetPostMatchParameters | | NA | | | GriauleAfisGetPostMatchParameters | | NA | | | GriauleAfisGetVersion | | NA | | | GriauleAfisInitializeStandard | | NA | | | GriauleAfisAddFingerprintToStandard | | NA | | | GriauleAfisExportStandard | | NA | | | GriauleAfisAddicaoToStandard | | NA | | | GriauleAfisAddExceptionToStandard | | NA | | | GriauleAfisAddBioDataToStandard | | NA | | GrCapAddPlugin | | | NA | | GrCapRawImageToHandle | | | NA | | GrCapSaveRawImageToFile | | | NA | | GrCapLoadImageFromFile | | | NA | | GrBiometricDisplay | | | GrBiometricDisplay | | GrBiometricDisplayRaw | | | NA | | GrSetBiometricDisplayColors | | | GrSetBiometricDisplayColors | | GrGetGrFingerVersion | | | GrGetVersion | | GrSetLicenseFolder | | | GrSetLicenseFolder | | GrInstallLicense | | | GrInstallLicense | | GrGetLicensePath | | | NA | | GrStartEnroll | | | GrStartConsolidation | | GrEnroll | | | GrConsolidate | | GrEncodeBase64 | | | GrExtract | | GrDecodeBase64 | | | GrExtract | | GrisBase64Encoding | | | GrExtract | | | | griaulewsq\_raw2wsq | GrConvertImage | | | | griaulewsq\_wsq2raw | GrConvertImage | | | | griaulewsq\_free | GrConvertImage | | | | griaulewsq\_loadFromFile | GrLoadFromFile | | | | | GrSaveToFile | | | | griaulewsq\_getVersion | GrConvertImage | | | | griaulewsq\_saveToBMPFile | GrConvertImage | | | | griaulewsq\_saveToJPEGFile | GrConvertImage | | | | griaulewsq\_saveToJPEG200OFile | GrConvertImage | | | | griaulewsq\_saveToGIFFile | GrConvertImage | | | | griaulewsq\_saveToTIFFFile | GrConvertImage | | | | griaulewsq\_iso197944\_to\_raw | GrConvertImage | | | | griaulewsq\_iso197944\_to\_raw\_single | GrConvertImage | | | | griaulewsq\_raw\_to\_iso197944\_single | GrConvertImage | | | | griaulewsq\_raw\_to\_iso197944 | GrConvertImage | | | | griaulewsq\_saveToiso197944File\_single | GrConvertImage | | | | griaulewsq\_saveToiso197944File | GrConvertImage | | | | griaulewsq\_saveToWSQFile | GrConvertImage | | | | griaulewsq\_saveToPNGFile | GrConvertImage | | | | griaulewsq\_setComment | GrConvertImage | | | | griaulewsq\_getComment | GrConvertImage | | | | griaulewsq\_setLicenseFolder | GrConvertImage | | | | griaulewsq\_requestAuthorization | GrConvertImage | | | | griaulewsq\_rawmageToHandle | GrConvertImage | | | | griaulewsq\_memleak\_start | GrConvertImage | | | | griaulewsq\_memleak\_chec | GrConvertImage | | GrGetCaptureInfo | | | GrGetCaptureInfo | | GrGetReaderInfo | | | GrGetReaderInfo | | GrSetReaderInfo | | | GrSetReaderInfo | | GrSetCrypt | | | NA | | GrDecrypt | | | NA | #### Assinatura de Métodos Simplificada: Gr\_IMAGE e Gr\_TEMPLATE No Fingerprint SDK 2009, vários tipos primitivos devem ser passados como parâmetros das funções da API para definir uma imagem ou um template. No GBS Fingerprint SDK, novas classes definem como os dados de Imagem e Template devem ser definidos. Elas encapsulam as informações necessárias e permitem uma compreensão mais clara da API.