Está en la página 1de 59

Manual de Programacin Pro Fdx SDK para Java

Para las aplicaciones que utilizan Secugen lectores de huellas digitales

A1-0040SG-001 (05/13)
Copyright 1998-2012 Secugen Corporation. TODOS LOS DERECHOS RESERVADOS. Las especificaciones estn sujetas a cambios sin previo aviso. SECUGEN, Auto-On, FDP02, FDU01, FDU02, FDU03, FDU04, SDU03, SDU04 y Smart Capture son marcas comerciales o marcas comerciales registradas de Secugen Corporation. Todas las dems marcas o productos pueden ser marcas registradas, marcas de servicio o marcas comerciales registradas de sus respectivos propietarios.

FDX SDK Pro Manual de Programacin Java

Contenido
ANTES DE COMENZAR... ... ... ... ... 4 EL CAPTULO 1. DESCRIPCIN GENERAL... ... ... ... 6 EL CAPTULO 2. INSTALACIN... ... ... ... ... ... 8 EL CAPTULO 3. PROGRAMACIN EN JAVA... ... ... ... ... ... ... ... 9
3.1. CREAR JSGFPLIB..9 3.2. INICIALIZAR JSGFPLIB9. 3.3. TERMINAR JSGFPLIB.10... 3.4. ABRIR EL LECTOR DE huellas dactilares SECUGEN ..10 3.5. OBTENER INFORMACIN DEL DISPOSITIVO... ... ... ... 10 3.6. CAPTURAR UNA IMAGEN DE LA HUELLA 11. 3.7. OBTENGA CALIDAD DE IMAGEN... ... ... ... ... ... ... ... 11 3.8. USO DE SMART CAPTURE O CONTROLAR EL BRILLO MANUALMENTE..12. 3.9. CREAR UNA PLANTILLA.. 12 3.10. COINCIDIR CON PLANTILLAS..13 3.11. REGISTRAR UNA HUELLA DIGITAL16 3.12. VERIFICAR UNA HUELLA DACTILAR.17 3.13. OBTENER PUNTAJE CORRESPONDIENTE18 3.14. FORMATO DE LA PLANTILLA ..19 3.15. MANIPULAR ANSI378 PLANTILLAS... ... ... ... ... ... ..20 3.16. MANIPULAR ISO19794-2 PLANTILLAS... ... ... ... ... ... ... .........22 3.17. OBTENER INFORMACIN SOBRE LA VERSIN DEL MINEX ALGORITMOS COMPATIBLES CON23 4.1. JSGFPLIB CREACIN Y TERMINACIN 24... ... ... ... ... ... 4.2. INICIALIZACIN 24... ... ... ... ... ... 4.3. DISPOSITIVO Y CAPTURAR 25 FUNCIONES... ... ... ... .....28 4.4. FUNCIONES DE EXTRACCIN... ... ... ... ... ... ...29 4.5. FUNCIONES DE COINCIDENCIA... ... ... ... ... ... ...29 4.6. FUNCIONES DE ANSI378 31 PLANTILLAS... ... ... ... ... ... ... ...31 4.7. FUNCIONES DE LA NORMA ISO19794-233 PLANTILLAS... ... ... ... .....33. 4.8. OTROS... ... ... ... ... ... ... ...35 5.1. JAVA DOCUMENTACIN.36 6.1. SGFDXDEVICENAME-------------------------- 37. 6.2. SGFDXSECURITYLEVEL---------------------- 37 6.3. SGFDXTEMPLATEFORMAT37 6.4. SGIMPRESSIONTYPE.37 6.5. SGFINGERPOSITION38. 6.6. SGFDXERRORCODE. 38. 6.7. SGFDXCONSTANT..38 2.1. INSTALACIN... ... ... ... ... ... ... ... 2.2. INCLUYE 8 ARCHIVOS... ... ... ... ... ... 2.3. DISTRIBUCIN EN TIEMPO DE EJECUCIN 8... ... ... ... ... 1.1. CARACTERSTICAS.6. 1.2. REQUISITOS DEL SISTEMA.. 6... 1.3. ENTORNO DE DESARROLLO 7... ... ... ... LA biometra 4 DESCRIPCIN GENERAL... ... ... ... ... ... ... SOBRE SECUGEN... ... ... ... ... ... ... ... SOBRE SECUGEN 5 PRODUCTOS... ... ... ... ... ...

EL CAPTULO 4. REFERENCIA DE LA FUNCIN JSGFPLIB24

EL CAPTULO 5. REFERENCIA DE LA CLASE------------------------------- 36 EL CAPTULO 6. LAS CONSTANTES37

EL CAPTULO 7. 39 EJEMPLOS DE APLICACIONES... ... ... ... ... ... ... ... EL CAPTULO 8. SUBPROGRAMA FIRMADO Y INTEGRACIN DE EXPLORADOR WEB 41... ... ... ... ... ... ... ...
8.1. INSTALAR EL FDX SDK PRO PARA JAVA RUNTIME LIBRARY..41. 8.2. GENERAR UN CERTIFICADO DIGITAL Y EL PAR DE CLAVES (GENKEY.BAT)... ... ... ... 41 8.3. CREAR UN ARCHIVO JAR FIRMADO (BUILDSIGNEDAPPLET.BAT) ... ... ... ... ... ... ... ..41 8.4. EXPORTAR EL CERTIFICADO (EXPORTCERT.BAT)... ... ... ... ... ... ... 43 II 7.1. JSGD - PRUEBA DE HARDWARE PROGRAMA 39... ... ... ... ... ... 7.2. PROGRAMA DE PRUEBA JFPLIB 40... ... ... ... ...

FDX SDK Pro Manual de Programacin 8.5. IMPORTAR EL CERTIFICADO EN JAVA PLUG-IN43... ... ... ... ... ... ... ... Java

II

FDX SDK Pro Manual de Programacin Java 8.6. ABRIR EL APPLET DEMO ARCHIVO HTML.46 8.7. NAVEGADOR INTERNET EXPLORER47 8.8. NAVEGADOR FIREFOX..48 8.9. NAVEGADOR GOOGLE CHROME..49

III

FDX SDK Pro Manual de Programacin Java

Antes de comenzar
La biometra Resumen
La biometra es un mtodo automatizado de reconocer a una persona basndose en caractersticas fsicas o de comportamiento. Informacin biomtrica que se puede utilizar para determinar con precisin qu personas incluye huellas dactilares, voz, rostro, iris, escritura y ngulos. Hay dos funciones clave ofrecidos por un sistema biomtrico. Uno de los mtodos es la identificacin, un "uno-amuchos" proceso de coincidencia en que una muestra biomtrica se compara secuencialmente a un conjunto de muestras para determinar el modelo ms cercano. La otra es la verificacin, de un "uno-a-uno" proceso de conciliacin en la que el sistema biomtrico cheques previamente inscritos los datos de un usuario especfico para verificar si la persona es quin l o ella dice ser. El mtodo de verificacin ofrece la mejor combinacin de velocidad y seguridad, especialmente en los casos en que varios usuarios estn preocupados, y requiere un ID. de usuario u otro identificador de coincidencia. Con una creciente dependencia de la tecnologa en lnea y otros recursos compartidos, la era de l a informacin est revolucionando rpidamente el camino las transacciones se inici y termin. Las transacciones comerciales de todo tipo estn cada vez ms que se maneja en lnea y a distancia. Este crecimiento sin precedentes en las transacciones electrnicas ha puesto de relieve la necesidad de una ms rpida, ms segura y ms conveniente mtodo de verificacin de usuario de contraseas puede proporcionar. Mediante la utilizacin de datos biomtricos ofrece varias ventajas sobre mtodos tradicionales y actuales. Esto se debe a que slo autenticacin biomtrica se basa en la identificacin de una parte intrnseca de un ser humano. Fichas como las tarjetas inteligentes, las tarjetas de banda magntica y teclas fsicas, puede ser perdido, robado, duplicar o abandonado. Las contraseas se pueden olvidar, compartida, pirateadas o involuntariamente observado por un tercero. Al eliminar todos estos problemas potenciales, tecnologa biomtrica puede proporcionar una mayor seguridad, con comodidad, es necesario para el da de hoy el complejo paisaje electrnico.

Las ventajas de utilizar las huellas dactilares


Las ventajas de utilizar las huellas digitales incluyen una amplia aceptacin entre el pblico, comodidad y fiabilidad. No hace falta mucho tiempo y esfuerzo para capturar la huella dactilar con un lector de huellas dactilares, reconocimiento de huellas dactilares y por lo tanto se considera entre los menos intrusivo de todos las tcnicas de verificacin biomtrica. Los funcionarios antiguos utilizan huellas dactilares para sellar los documentos hace miles de aos, y los organismos de aplicacin de la ley han estado usando identificacin de huellas dactilares desde finales de 1800. Las huellas dactilares han sido usadas extensamente y por mucho tiempo, hay una gran acumulacin de datos cientficos apoyando la idea de que no hay dos huellas dactilares iguales.

Sobre Secugen
SECUGEN (www.secugen.com) ofrece soluciones biomtricas de seguridad fsica y de red que utiliza la avanzada tecnologa de reconocimiento de huellas dactilares. La compaa completa lnea de productos incluye ptico de alta calidad los lectores de huellas digitales y el sensor de componentes, software y kits de desarrollo que se utilizan para una variedad de aplicaciones innovadoras como Internet, red de la empresa y la seguridad de escritorio, control de acceso fsico, el tiempo y la asistencia financiera y de gestin de control y los registros mdicos. Secugen productos patentados de la industria de ms aos de garanta y son conocidos por su precisin, fiabilidad y versatilidad. Con base en Silicon Valley, Secugen ha estado sirviendo a la comunidad biomtrica mundial desde 1998 y es miembro activo de la biometra (www.biometrics.org) y el 4

FDX SDK Pro Manual de Programacin Consorcio BioAPI Consortium (www.bioapi.org). Java

FDX SDK Pro Manual de Programacin Java

Sobre Secugen Productos


Sensor Secugen Cualidades
Una excelente calidad de imagen: claro y sin distorsin, las imgenes de las huellas digitales se generan mediante avanzados patente pendiente mtodos pticos. Mejor calidad de imagen rendimiento caractersticos muestras de extraccin de datos. Resistencia: resistencia mecnica las pruebas muestran resistencia a los choques, golpes y araazos. Potente Software: precisa, procesamiento rpido algoritmo garantiza la mxima eficiencia y fiabilidad. Robustez y versatilidad: Una slida ingeniera y materiales de alta calidad permite su uso en condiciones extremas. Diseo Ergonmico: diseo compacto y modular para una integracin perfecta en los dispositivos de pequeo tamao, la facilidad de uso y Compatibilidad hacen que sea ideal para una amplia gama de aplicaciones. Bajo Costo: Los productos se han desarrollado para ofrecer un alto rendimiento, cero mantenimientos a precios muy asequibles para el uso general y uso industrial.

Las ventajas de los sensores de Secugen otros sensores pticos


nico mtodo ptico captura todos los detalles, incluso con la piel seca Extremadamente baja distorsin de la imagen Materiales reforzados Resistencia al desgaste Facilidad de integracin Listo para usar Bajo costo a travs vida til ms larga y sin necesidad de mantenimiento

Secugen Ventajas Sensores capacitivos de Semiconductor (Sensores)


No de metal, no de los componentes de silicio hace que sea menos susceptible a la corrosin cuando estn expuestos a sales, el aceite y la humedad de la piel y el medio ambiente elimina la necesidad de costosos procedimientos de tratamiento y revestimiento Mayor resistencia mecnica, resistencia al desgaste y durabilidad Amplia gama de aplicabilidad, especialmente para el uso en condiciones extremas y climas Inmunidad de descarga electrosttica Bajo costo a travs vida til ms larga y sin necesidad de mantenimiento

Puntos fuertes de Secugen Software y algoritmos


nico algoritmo de procesamiento de imgenes de huellas dactilares extractos minucias muy precisa Una alta relacin seal/ruido con algoritmo de procesamiento caractersticas pantallas falsas Altamente eficiente algoritmo de coincidencia Rpido proceso general de extraccin, verificacin y adaptacin Funcin de cifrado para proteger la privacidad del usuario Compatibilidad con equipos de sobremesa, ordenadores porttiles interfaz Facilidad para el desarrollo de aplicaciones para diversos fines

FDx SDK Pro Programming Manual - Java

Chapter 1. Overview

El Captulo 1. Descripcin general


Secugen Fdx SDK de Pro est diseado para proporcionar acceso a bajo nivel de Secugen lectores de huellas digitales con la siguiente generacin de algoritmo mdulo. La programacin con Secugen Fdx SDK Pro es simple y fcil de programa y proporciona la mayor flexibilidad en el desarrollo entre todos los SDK Secugen

1.1. Caracterstic as
Admite tres tipos de huellas digitales formatos caractersticos (o plantillas): O SG400: Secugen propiedad de minucias formato huella dactilar O ANSI378: Dedo minucias Formato para el Intercambio de Datos (ANSI INCITS 378-2004) O ISO19794-2: Intercambio de Datos biomtricos Formatos (Dedo Datos caractersticos (ISO/IEC 19794-2:2005) Proporciona Api de bajo nivel para la captura de la imagen, y de extraccin de caractersticas S La siguiente extraccin y algoritmos de coincidencia, que se han incorporado en sgfpamx.dll, que se
encuentra en el SDK, el apoyo de la norma ANSI INCITS 378-2004 estndar y han sido probados para ser MINEX compatible (http://fingerprint.nist.gov/MINEX/):

Permite un alto grado de flexibilidad a los desarrolladores de todo tipo de aplicaciones y es fcil de usar

Plantilla Matcher v3.5 (algoritmo)

1.2. Requisitos sistema

del

Los lectores de huellas digitales USB Secugen capturar una imagen de la huella y digitalizar la imagen a 8 bits imagen en escala de grises en 500 DPI de resolucin. El sistema host, a continuacin, recupera la imagen a travs de su puerto USB para su procesamiento posterior. Todos Secugen USB lectores de huellas digitales, excepto los que son a base de FDU01 sensores, son compatibles con esta. Requiere IBM-PC compatible 486 o posterior 1 Puerto USB (1.1 o superior) para el lector de huellas digitales USB Secugen 64 MB de RAM 80 MB de espacio disponible en el disco duro Windows 7 / Windows Vista / XP / 2000 / 98 SE, Windows Server 2008 R2 / 2003 Java SDK v1.6.0_30 o posterior Java JRE v1.6.0_30 o posterior

FDx SDK Pro Programming Manual - Java

Chapter 1. Overview

1.3. Entorno de desarrollo


Requiere: Secugen Fdx SDK Pro para Windows v is3.54 o posterior

1.3.1. Instalar el Fdx SDK Pro para Windows


FDX SDK Pro para Java es un Java Native Interface (JNI) contenedor de Fdx SDK Pro para Windows. La biblioteca en tiempo de ejecucin JNISGFPLIB incluidos en este SDK pasa las llamadas a la biblioteca en tiempo de ejecucin SGFPLIB Fdx SDK incluye en Pro para Windows. Consulte el Fdx SDK Pro para Windows Manual de instalacin para obtener instrucciones detalladas sobre la instalacin.

1.3.2. Instalar el Java 2 SDK v1.6.0_30


El SDK de Java se puede descargar de www.oracle.com/technetwork/java. Refer a la Java documentacin para obtener instrucciones detalladas sobre la instalacin. Despus de instalar el Java SDK, compruebe que ha instalado correctamente mediante el lanzamiento de una lnea de comandos y ejecutar los siguientes comandos Java -version Javac -version

1.3.3. Copie el Fdx SDK Pro para directorio de Java a la ubicacin de destino
FDX SDK Pro para Java se distribuye como una estructura de directorios que contiene todos los archivos Jar, la JNI biblioteca y diversos archivos de proceso por lotes que se pueden usar para compilar y ejecutar los ejemplos de aplicaciones. Mientras que el Java SDK y Fdx SDK Pro para Windows est instalado correctamente, el Fdx SDK Pro para Java puede ser instalado en cualquier ubicacin conveniente.

FDx SDK Pro Programming Manual - Java

Chapter 2. Installation

El Captulo 2. Instalacin
2.1. Instalacin
Copie el Fdx SDK Pro para distribucin de Java en un directorio nuevo en el equipo de desarrollo.

2.2. Archivos incluidos


Archivos de la biblioteca FDxSDKPRO.jar -Fdx SDK para Java jar jnifsgplib.dll Secugen biblioteca JNI. Contenedor para sgfplib.dll Absolutelayout.jar - NetBeans 4.x ejecucin diseo de giro Muestra archivos de programa Extract_samples.bat - Extractos cdigo fuente de ejemplo build_samples.bat - Crea aplicaciones de ejemplo run_JSGD.bat: ejecuta la aplicacin de ejemplo JSGD Run_jsgfplibtest.bat: ejecuta la aplicacin de ejemplo JFPLibTest Run_jsgmultidevicetest.bat: ejecuta la aplicacin de ejemplo JSGMultiDeviceTest Applet muestra archivos firmados Applet/ - Directorio que contiene subprograma firmado demo genkey.bat - Crea el certificado y par de claves buildsignedapplet.bat - Crea archivo jar firmado exportcert.bat - certificados de exportacin JSGDAppletDemo.html - archivo Html para cargar applet firmada Documentacin Readme.txt - informacin de la versin ms reciente de Pro Fdx SDK para Java doc/ - Directorio que contiene JavaDoc de Fdx SDK Pro Fdx SDK para Java Pro Manual de Programacin (Java) .pdf - Este documento

2.3. Distribucin en tiempo de ejecucin


Por favor, siga las instrucciones de distribucin Fdx SDK Pro para Windows. Adems, copie el Fdx SDK Pro para Archivos de tiempo de ejecucin Java de la siguiente manera:
Windows 7 32 bits: Copia jnifplib\win32 \jnisgfplib.dll en C: \windows\system32

Windows 7 64 bits: Copia jnifplib\win32 \jnisgfplib.dll en C: \Windows\syswow64 Copia jnifplib\x64 \jnisgfplib.dll en C: \Windows\system32

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

El Captulo 3. Programacin en Java


Secugen Fdx SDK de Pro se ha diseado para facilitar el aprendizaje y la mayor flexibilidad a los desarrolladores. Todos SDK las funciones estn integradas en el JSGFPLib clase. La JSGFPLib clase incluye inicializacin del dispositivo, captura de huellas digitales y minucias Extraccin y funciones de coincidencia.

3.1. Crear JSGFPLib


Para utilizar JSGFPLib, llamada JSGFPLib (), que crea una instancia de un objeto JSGFPLib.
JSGFPLib sgfplib = new JSGFPLib ((UsbManager) getSystemService (Context.USB_SERVICE));

3.2. JSGFPLib

Inicializar

Despus de que el objeto se crea JSGFPLib, se debe inicializar mediante JSGFPLib, Init () o JSGFPLib.InitEx (). JSGFPLib.Init () toma el nombre del dispositivo, el controlador se carga que corresponde al nombre del dispositivo e inicializa el algoritmo de huellas dactilares mdulo basado en informacin del dispositivo. JSGFPLib.InitEx () toma imagen ancho, altura de la imagen y la resolucin como parmetros. Llamada JSGFPLib.InitEx () cuando se usa el algoritmo de huellas digitales sin un mdulo lector Secugen. El cuadro que figura a continuacin se resume la correlacin entre nombre del dispositivo (tipo de dispositivo), cargar controladores de dispositivo y tamao de la imagen inicial cuando el Init (JSGFPLibDeviceName devName) funcin se llama.

Nombre del dispositivo, el controlador de dispositivo y el tamao de la imagen


Nombre del dispositivo SGDEV_FDP02 SGDEV_FDU02 SGDEV_FDU03 SGDEV_FDU04 JSGFPLib.Init ()
Largo error = sgfplib.Init (SGFDxDeviceName.SG_DEV_AUTO);

Valor 1 3 4 5

Controlador de Dispositivo Controlador de dispositivo paralelo FDU02 controlador USB USB FDU03 / SDU03 controlador FDU04 USB/SDU04 controlador

Tamao de imagen (pxeles) 260 * 300* 260 300 260 * 300 258 * 336

JSGFPLib.InitEx ()
DWORD image_width = 260; image_height DWORD = 300; DOWRD image_dpi = 500; Largo error = JSGFPLib.InitEx (image_width, image_height, image_dpi);

10

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.3. Terminar JSGFPLib


JSGFPLib.Close () debe ser llamada antes de terminar la aplicacin. Adems, libera la memoria usada por el objeto JSGFPLib.
Largo error = JSGFPLib.Close ();

3.4. Abra el Secugen Lector de huellas digitales


Para utilizar un lector de huellas dactilares Secugen, llamada JSGFPLib.OpenDevice (). El parmetro (devId) de JSGFPLib.OpenDevice () puede tener diferentes significados dependiendo del tipo de lector de huellas digitales. Si slo un lector de huellas digitales USB est conectado al PC, devId ser 0. Si hay varios lectores de huellas digitales USB estn conectados a un PC, devId puede variar de 0 a 9. El nmero mximo de Secugen lectores USB que se puede conectar a una PC es de 10. En general, si slo un lector USB_AUTO_DETECT. USB est conectado al PC, a continuacin, se recomienda

Largo error = sgfplib.OpenDevice (USB_AUTO_DETECT);

3.5. Obtener informacin del dispositivo


Informacin del dispositivo se pueden recuperar llamando JSGFPLib.GetDeviceInfo (), que obtiene informacin necesaria del dispositivo, tales como altura de la imagen y el ancho. La informacin del dispositivo se encuentra en la estructura SGDeviceInfoParam.
SGDeviceInfoParam device_info; Error = JSGFPLib.GetDeviceInfo (device_info); Si (error == SGFDxErrorCode.SGSGFDX_ERROR_NONE) { M_imgwidth = device_info.ImageWidth; M_imgheight = device_info.ImageHeight; }

11

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.6. Capturar una imagen de la huella


Despus de que el lector se inicializa, una imagen de la huella puede ser capturada. La SGFPM objeto proporciona tres tipos de huella digital image capture las funciones que figuran a continuacin. Capturar las huellas dactilares son 256 imgenes de color gris, y anchura de la imagen y se puede recuperar altura llamando SGFPM_GetDeviceInfo () .El bfer de imagen debe ser asignada por la aplicacin que realiza la llamada. JSGFPLib.GetImage () captura una imagen sin control de la presencia de un dedo o comprobacin de la calidad de las imgenes. JSGFPLib.GetImageEx () capta las imgenes de las huellas digitales continuamente, se comprueba la calidad de la imagen de un determinado valor de calidad y no tiene en cuenta la imagen que no contenga una huella digital o si la calidad de la huella dactilar no es aceptable. Si a la calidad de la imagen es capturada en el tiempo establecido (el segundo parmetro), JSGFPLib.GetImageEx () termina su proceso. Si un identificador de ventana es proporcionada por la aplicacin, los pilotos se dibujar una imagen de la huella en el Siempre ventana usando el valor del identificador. JSGFPLib.GetImage()
[Ejemplo] Byte[] buffer = new byte[m_ImageWidth * m_ImageHeight]; Si (JSGFPLib.GetImage(buffer) == SGFDxErrorCode.SGSGFDX_ERROR_NONE) Desde el dispositivo { // Imagen de pantalla // Imagen del Proceso }

// Obtener imagen

Los dato s

JSGFPLib.GetImageEx ()
[Ejemplo] Byte [] buffer = new byte [m_ImageWidth * m_ImageHeight]; Largo tiempo de espera = 10000; Largo calidad = 80; If (JSGFPLib.GetImageEx (buffer, tiempo de espera, null, calidad) == SGFDxErrorCode.SGFDX_ERROR_NONE) { // Imagen de pantalla }

3.7. Obtenga calidad de imagen


Para determinar la imagen de la huella calidad, uso GetImageQuality (). JSGFPLib.GetImageQuality () Int [] img_qlty;
JSGFPLib.GetImageQuality (ImageWidth, m_ImageHeight, fp_image, mg_qlty); Si (img_qlty [0] < 80) // Capturar nuevamente

12

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.8. Uso de Smart Capture o controlar el brillo manualmente


En funcin del lector de huellas dactilares, factores ambientales y las caractersticas del sistema anfitrin, el brillo de una imagen de la huella puede variar. La Secugen controladores de dispositivo utilizan una tecnologa llamada Smart Capture brillo para ajustar dinmicamente para asegurar la mejor calidad de imagen. Smart Capture est habilitada de forma predeterminada. Control manual de la calidad de la imagen capturada, el brillo de la imagen debe ser ajustado por cambiar el ajuste del brillo del lector usando JSGFPLib. .SetBrightness (). Esta funcin es ignorada, si se activa la captura inteligente. JSGFPLib. SetBrightness ().
JSGFPLib.aparato (70); // Set de 0 a 100.

3.9. Crear plantilla

una

Para registrar o verificar una huella, una imagen de la huella es capturada y, a continuacin, datos de la funcin (minucias) se extrae de la imagen en una plantilla. Caractersticos son los nicos puntos centrales cerca del centro de cada huella digital, como las cordilleras, finales de cresta, bifurcaciones, valles y verticilos. Utilice JSGFPLib.CreateTemplate () para extraer puntos caractersticos de una imagen de la huella para formar una plantilla. El bfer debe ser asignado por la aplicacin. Para obtener el tamao de almacenamiento intermedio de las minucias, llamada JSGFPLib.GetMaxTemplateSize (). Se le devolver el tamao mximo del bfer de datos en una plantilla. El tamao de la plantilla puede ser obtenido llamando JSGFPLib.GetTemplateSize () despus se crea la plantilla. La JSGFPLib.CreateTemplate () API slo crea un conjunto de datos de una imagen. Nota: Las plantillas de la norma ANSI 378 o ISO19794-2 formato podrn fusionarse. JSGFPLib.CreateTemplate ()
// Obtener una imagen de la huella Err = JSGFPLib.GetImage (m_ImgBuf); // Crear plantilla de imagen capturada Err = JSGFPLib.GetMaxTemplateSize (maxTemplateSize); Minbuffer byte [] = new byte [maxTemplateSize [0]; // Establecer informacin sobre plantilla SGFingerInfo finger_info; Finger_info.FingerNumber = SGFingerPosition.SG_FINGPOS_LI; finger_info.ImageQuality = cualitativa [0]; finger_info.ImpressionType = SG_IMPTYPE_LP; finger_info.ViewNumber = 1; Err = JSGFPLib.CreateTemplate (finger_info, m_ImgBuf, minBuffer);

13

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.10. Coincidir con plantillas


Las plantillas son acompaados durante el registro y verificacin de los procesos. Durante el proceso de registro, se recomienda para capturar al menos dos muestras de imgenes por huella dactilar de un mayor grado de precisin. Las minucias los datos de cada una de las imgenes muestra a continuacin se puede comparar uno en contra de las otras (es decir igualadas)) para confirmar la calidad de las huellas dactilares registradas. Esta comparacin es anloga a una rutina confirmacin de la contrasea que normalmente se requiere para introducir una nueva contrasea. Durante la verificacin, recin entrada datos caractersticos se compara con los datos registrados minucias. Similar al proceso de registro, verificacin requiere la captura de una imagen de la huella con la consiguiente extraccin de las minucias de la imagen capturada en una plantilla. Para que coincida con las plantillas, Fdx SDK Pro ofrece cuatro tipos de funciones de coincidencia. Cada funcin requiere dos conjuntos de datos de la plantilla para la comparacin. JSGFPLib.MatchTemplate (): Esta funcin coincide con plantillas con el mismo formato como formato predeterminado. Al llamar a esta funcin, cada plantilla debe incluir slo una muestra (o ver) por plantilla. El formato predeterminado es SG400 (Secugen formato propietario) pero puede ser cambiado llamando JSGFPLib.SetTemplateFormat (). JSGFPLib.MatchTemplateEx (): Esta funcin puede coincidir con plantillas plantilla con diferentes formatos. Esta funcin tambin puede especificar el formato de la plantilla para cada plantilla y puede coincidir con las plantillas que tienen varias vistas por plantilla. JSGFPLib.MatchAnsiTemplate (): Esta funcin es la misma que JSGFPLib.MatchTemplateEx (), excepto en que slo es compatible con ANSI 378 plantillas. JSGFPLib.MatchIsoTemplate (): Este bussines es el mismo que JSGFPLib.MatchTemplateEx (), excepto en que slo es compatible con ISO19794-2 plantillas.

Funcin SGFPM_MatchTemplate SGFPM_MatchTemplateEx SGFPM_MatchAnsiTemplate SGFPM_MatchIsoTemplate JSGFPLib.MatchTemplate ()

Formato de la plantilla SG400 (Sistema predeterminado) Formato de la plantilla especificada ANSI378 ISO19794-2

Puede coincidir con plantillas con formatos diferentes? No S No No

Byte [ ] RegTemplate1= new byte [maxTemplateSize [0]; Byte [ ] RegTemplate2= new byte [maxTemplateSize [0]; ... // Getfirst imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_RegTemplate1); // Obtener una segunda imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImageEx (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_RegTemplate2); Sl = largo SGFDxSecurityLevel.SL_NORMAL; // Establecer nivel de seguridad NORMAL Boolean [] con = new boolean [1]; Err = JSGFPLib.MatchTemplate (m_ RegTemplate1, m_ RegTemplate2, sl, conciliado);

14

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

JSGFPLib.MatchTemplateEx ()
Byte [ ] RegTemplate1= new byte [maxTemplateSize [0]; Byte [ ] RegTemplate2= new byte [maxTemplateSize [0]; ... // Hacer SG400 plantilla Err = JSGFPLib.SetTemplateFormat (SGFDxTemplateFormat.TEMPLATE_FORMAT_SG400); Err = JSGFPLib.GetImage (m_ImgBuf, 5000, NULL, cualitativa); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_RegTemplate1); // Hacer ANSI378 plantilla Err = JSGFPLib.SetTemplateFormat (TEMPLATE_FORMAT_ANSI378); Err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_RegTemplate2); Sl = largo SGFDxSecurityLevel.SL_NORMAL; // Establecer nivel de seguridad NORMAL Boolean [] con = new boolean [1]; Err = JSGFPLib.MatchTemplateEx (RegTemplate1, SGFDxTemplateFormat 0, // RegTemplate2, SGFDxTemplateFormat 0, // muestra sl, &Conciliad o); TEMPLATE_FORMAT_SG400, debe ser 0 si formato de plantilla es SG400 TEMPLATE_FORMAT_ANSI378, actualmente slo una

JSGFPLib.MatchAnsiTemplate ()
Long err. Boolean [] con = new boolean [1]; Corresponde [0] = false; SGANSITemplateInfo sample_info = new SGANSITemplateInfo (); Err = JSGFPLib.GetAnsiTemplateInfo (m_EnrollTemplate, sample_info); Finger_found boolean = false; (Int i = 0; i < sample_info.TotalSamples; i++) { If (sample_info.SampleInfo[i] .FingerNumber == finger_pos) // intentar hacer coincidir en el mismo dedo { Finger_found = true; Err = JSGFPLib.MatchAnsiTemplate (m_EnrollTemplate, i, M_fetbufm, 0, SGFDxSecurityLevel.SL_NORMAL conciliado); Si (coincidenci a) Romper . } }

15

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

JSGFPLib.MatchIsoTemplate ()
Long err. Boolean [] con = new boolean [1]; Corresponde [0] = false; // ISO19794-2 SGISOTemplateInfo sample_info = new SGISOTemplateInfo (); Err = JSGFPLib.GetIsoTemplateInfo (m_StoredTemplate, sample_info); Int found_finger = -1; (Int i = 0; i < sample_info.TotalSamples; i++) { // ISO19794-2 Err = JSGFPLib.MatchIsoTemplate (m_StoredTemplate, I, m_FetBufM, 0, SGFDxSecurityLevel.SL_NORMAL, conciliado); Si (coincidencia) { Found_finger = sample_info.SampleInfo[i] .FingerNumber; Romper. } }

16

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.11. Registrar una huella digital


Para registrar una huella digital, una imagen de la huella es la primera captura, y, a continuacin, los datos de (puntos caractersticos) se extraen de la imagen para crear una plantilla. Se recomienda para capturar al menos dos muestras de imgenes por huella dactilar de un mayor grado de precisin. Las minucias los datos de cada una de las imgenes pueden ser luego comparadas con los dems (es decir igualadas) para confirmar la calidad de las huellas dactilares registradas. Esta comparacin de dos de las huellas digitales es anloga a una confirmacin de la contrasea habitual que normalmente se requiere para introducir una nueva contrasea.

Proceso de registro de huella dactilar


1. Captura imgenes de huellas dactilares: JSGFPLib.GetImage () 2. Extraer puntos caractersticos de cada imagen de la huella capturada para crear una plantilla: JSGFPLib.CreateTemplate () 3. Cada plantilla para determinar si son aceptables para el registro: JSGFPLib.MatchTemplate () 4. Guardar las plantillas en un archivo o base de datos para completar el registro

Ejemplo: Utilizando dos imgenes de huellas dactilares para registrar una huella dactilar
Err = JSGFPLib.GetMaxTemplateSize (m_MaxTemplateSize); byte [] m_RegTemplate1 = new byte [MaxTemplateSize [0]]; BYTE * m_RegTemplate2 = new byte [MaxTemplateSize [0]; // Obtener la primera imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_RegTemplate1); // Obtener una segunda imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_RegTemplate2); Sl = DWORD SGFDxSecurityLevel.SL_NORMAL; // Establecer nivel de seguridad NORMAL Boolean [] = new Boolean coincidentes [1]; Err = JSGFPLib.MatchTemplate (m_RegTemplate1, m_RegTemplate2, sl, conciliado); Si (coincidencia) // Guardar estas plantillas en algn lugar

17

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.12. Verificar la huella digital


El proceso de verificacin de huella dactilar recin entrada trata de adaptar los datos caractersticos datos contra puntos caractersticos. Similar al proceso de registro, verificacin requiere la captura de una imagen de la huella con la consiguiente extraccin de las minucias de la imagen capturada y la creacin de una plantilla.

Proceso de Verificacin huellas digitales

de

1. Capturar imagen de la huella: JSGFPLib.GetImage () 2. Extrae minutia datos de imagen capturada para crear una plantilla: JSGFPLib.CreateTemplate () 3. Recin hecho con plantilla contra registrado(s): JSGFPLib.MatchTemplate () - Ajustar el nivel de seguridad segn el tipo de aplicacin. Por ejemplo, si las huellas digitales slo se utilizan la autenticacin, establezca el nivel de seguridad ms alto que SL_NORMAL a fin de reducir las posibilidades de falsa aceptacin (FAR).

Ejemplo: Introducir datos caractersticos se hace coincidir con dos puntos caractersticos muestras de datos registrados
DWORD err. Err = JSGFPLib.GetMaxTemplateSize &m_MaxTemplateSize); Byte [] VrfTemplate m_1= new [m_MaxTemplateSize];

(m_hFPM, byte

// Obtener la primera imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_ VrfTemplate1); Sl = DWORD SGFDxSecurityLevel.SL_NORMAL; // Establecer nivel de seguridad en funcin de la aplicacin. Boolean [] juego1 = new boolean [1]; Boolean [] juego2 = new boolean [1]; Err = JSGFPLib.MatchTemplate (m_RegTemplate1, m_ VrfTemplate1, sl, con1); Err = JSGFPLib.MatchTemplate (m_RegTemplate2, m_ VrfTemplate1, sl, con2); Si (err == SGFDxErrorCode.SGSGFDX_ERROR_NONE) { Si (coincidencia1 && acompaado2) // Coincide Otra cosa // No coinciden }

18

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.13. Obtener puntaje correspondiente


Para un mejor control de calidad durante el registro o proceso de verificacin, un puntaje correspondiente se puede utilizar en lugar de un nivel de seguridad para determinar el xito de la operacin. La puntuacin puede ser especificado para que slo conjuntos de puntos caractersticos los datos que superan la puntuacin ser aceptado; datos que se presentan a continuacin la puntuacin ser rechazada. La puntuacin puede tener un valor de 0 a 199. JSGFPLib.GetMatchingScore () requiere dos conjuntos de puntos caractersticos datos del mismo formato de la plantilla. JSGFPLib.GetMatchingScoreEx () requiere dos conjuntos de datos caractersticos, pero pueden tener diferentes formatos de plantilla.
Int [] resultado = new int [1]; Si (JSGFPLib.GetMatchingScore (m_RegTemplate1, m_RegTemplate2, puntuacin) == SGFDXErrorCode.SGFDX_ERROR_NONE) { Si (> 100) Estas huellas digitales // inscripcin a la base de datos ms // Vuelva a intentarlo }

Para comprender cmo el puntaje se correlaciona con los niveles de seguridad tpicas, consulte la siguiente tabla.

Nivel de seguridad vs. Correspondiente puntuacin


Constante SL_NONE SL_LOWEST SL_LOWER SL_LOW SL_BELOW_NORMAL SL_NORMAL SL_ABOVE_NORMAL SL_HIGH SL_HIGHER SL_HIGHEST Valor 0 1 2 3 4 5 6 7 8 9 Puntuacin correspondiente 0 30 50 60 70 80 90 100 120 140

Nota: a partir de la versin 3,53 de Fdx SDK Pro para Windows, el puntaje correspondiente han cambiado.

19

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.14. Formato de la plantilla


El Fdx SDK Pro admite tres tipos de plantillas de huellas digitales formatos: "SG400") ANSI INCITS 378-2004 "Dedo minucias Formato para el Intercambio de Datos" ("ANSI378) ISO/IEC 19794-2:2005 "Datos biomtricos formatos de intercambio -- Dedo Datos caractersticos" ("ISO19794-2) De manera predeterminada, crea Secugen propiedad JSGFPLib plantillas (TEMPLATE_FORMAT_SG400). Para cambiar el formato de la plantilla, utilice JSGFPLib.SetTemplateFormat (). SG400 plantillas estn cifrados de alta seguridad y tienen un tamao de 400 bytes. ANSI378 plantillas no estn cifrados y su tamao es variable, dependiendo de cuntos dedos estn registrados en la estructura y cmo muchos puntos caractersticos se encuentran. Fo ms informacin acerca de la norma ANSI378 plantilla, consulte el estndar del documento titulado "tecnologa de la Informacin - Dedo minucias Formato para el Intercambio de Datos", nmero de documento ANSI INCITS 378-2004, disponible en el sitio web ANSI http://webstore.ansi.org. Para obtener ms informacin acerca de la norma ISO19794-2 plantilla, consulte el documento estndar titulado "tecnologa de la Informacin - Datos biomtricos formatos de intercambio -- Parte 2: Dedo Datos caractersticos", nmero de documento ISO/IEC 19794-2:2005, disponible en el sitio ISO bajo Subcomit JTC 1/SC 37 (biometra): http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=38746. Una vez que el formato de la plantilla, lo que afectar a la ejecucin del mdulo JSGFPLib. Las siguientes API se ven afectados por JSGFPLib.SetTemplateFormat (): JSGFPLib.GetMaxTemplateSize () JSGFPLib.CreateTemplate () JSGFPLib.GetTemplateSize () JSGFPLib.MatchTemplate () JSGFPLib.GetMatchingScore () Las siguientes API slo funciona cuando el formato de la plantilla es TEMPLATE_FORMAT_ANSI378: JSGFPLib.GetTemplateSizeAfterMerge () JSGFPLib.MergeAnsiTemplate () JSGFPLib.GetAnsiTemplateInfo () JSGFPLib.MatchAnsiTemplate () JSGFPLib.GetAnsiMatchingScore () Las siguientes API slo funciona cuando el formato de la plantilla es TEMPLATE_FORMAT_ISO19794: JSGFPLib.GetIsoTemplateSizeAfterMerge () JSGFPLib.MergeIsoTemplate () JSGFPLib.GetIsoTemplateInfo () JSGFPLib.MatchIsoTemplate () JSGFPLib.GetIsoMatchingScore () Las siguientes API trabaja con cualquier formato de la plantilla: JSGFPLib.MatchTemplateEx () JSGFPLib.GetMatchingScoreEx ()

20

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

JSGFPLib.SetTemplateFormat TEMPLATE_FORMAT_ANSI378); (SGFDxTemplateFormat

Formato plantilla de SG400


JSGFPLib.SetTemplateFormat TEMPLATE_FORMAT_SG400); (SGFDxTemplateFormat

formato ISO19794
(SGFDxTemplateFormat

JSGFPLib.SetTemplateFormat TEMPLATE_FORMAT_ISO19794);

3.15. Manipular ANSI378 Plantillas


La norma ANSI378 formato de plantilla permite que varios dedos de las manos y dedos mltiples vistas por que se almacena en una plantilla. Para dar soporte a esta funcin, Fdx SDK Pro proporciona las siguientes APIs especiales: JSGFPLib.GetTemplateSizeAfterMerge () JSGFPLib.MergeAnsiTemplate () JSGFPLib.GetAnsiTemplateInfo () JSGFPLib.MatchAnsiTemplate () JSGFPLib.GetAnsiMatchingScore ()

Despus de crear una norma ANSI378 plantilla a partir de una imagen de la huella, ANSI378 plantillas adicionales pueden ser fusionadas en una plantilla. Para hacer esto, utilice JSGFPLib.MergeAnsiTemplate (), que toma dos ANSI378 plantillas y las combina en una plantilla. El tamao de la plantilla fusionada ser menor que la suma de los tamaos de todas las plantillas de entrada. Llamada JSGFPLib.GetTemplateSizeAfterMerge () para obtener el tamao de la plantilla de la plantilla fusionada antes de utilizar JSGFPLib.MergeAnsiTemplate ().
Err = JSGFPLib.GetMaxTemplateSize &m_MaxTemplateSize); Byte [] m_Template1 = new byte [m_MaxTemplateSize]; Byte [] m_Template2 = new byte [m_MaxTemplateSize]; (m_hFPM,

// Obtener la primera imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_Template1); // Obtener una segunda imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_Template2); // Guardar la plantilla despus de combinar dos plantillas m_Template1, m_Template2 buf_size int [] = new int [1]; Err = JSGFPLib.GetTemplateSizeAfterMerge (m_Template1, buf_size); Merged_template byte [] = new byte [buf_size [0]; Err = JSGFPLib.MergeAnsiTemplate (m_Template1, merged_template);

m_Template2,

m_Template2,

21

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

Obtener informacin sobre un ANSI378 plantilla La norma ANSI378 formato de plantilla permite que varios dedos de las manos y dedos mltiples vistas por que se almacena en una plantilla. Para que coincida con una muestra (ver) contra una muestra en otra plantilla, informacin sobre la plantilla puede ser necesaria. Para obtener informacin de la muestra sobre una plantilla, utilice JSGFPLib.GetAnsiTemplateInfo ().
Long err. Int matched_samples = 0; SGANSITemplateInfo sample_info1 = new SGANSITemplateInfo; SGANSITemplateInfo sample_info2 = new SGANSITemplateInfo; Err = JSGFPLib.GetAnsiTemplateInfo (g_EnrollData, sample_info1); Err = JSGFPLib.GetAnsiTemplateInfo (g_VrfData, sample_info2); (Int i = 0; i < sample_info1.TotalSamples; i++) { (Int j = 0; j < sample_info2.TotalSamples; j++) { Boolean [] con = new Boolean [1]; Err = JSGFPLib.MatchAnsiTemplate (g_EnrollData, i, g_VrfData, 0, sl, conciliado); Si (coincidencia [0]) Matched_samples++; } } Si (err == SGFDxErrorCode.SGFDX_ERROR_NONE) { Si (matched_samples > 0) System.out.writeln (" + matched_samples + "muestras pareadas" ); Otra cosa System.out.writeln (No se puede encontrar coincidencias muestra); } Otra cosa System.out.writeln (MatchTemplate () ha fallado. Error = " + err);

22

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

3.16. Plantillas manipular ISO19794-2


La ISO19794-2 formato de plantilla permite que varios dedos de las manos y dedos por varias vistas para ser almacenados en una plantilla. Para dar soporte a esta funcin, Fdx SDK Pro proporciona las siguientes APIs especiales: JSGFPLib.GetIsoTemplateSizeAfterMerge () JSGFPLib.MergeIsoTemplate () JSGFPLib.GetIsoTemplateInfo () JSGFPLib.MatchIsoTemplate () JSGFPLib.GetIsoMatchingScore ()

Fusionar dos plantillas ISO19794-2 Despus de crear una ISO19794-2 plantilla a partir de una imagen de la huella, ISO19794-2 plantillas adicionales pueden ser fusionadas en una plantilla. Para ello, utilice JSGFPLib.MergeIsoTemplate (), que lleva dos plantillas ISO19794-2 y las combina en una plantilla. El tamao de la plantilla fusionada ser menor que la suma de los tamaos de todas las plantillas de entrada. Llamada JSGFPLib.GetIsoTemplateSizeAfterMerge () para obtener el tamao de la plantilla de la plantilla fusionada antes de utilizar JSGFPLib.MergeIsoTemplate ().
Err = JSGFPLib.GetMaxTemplateSize &m_MaxTemplateSize); Byte [] m_Template1 = new byte [m_MaxTemplateSize]; Byte [] m_Template2 = new byte [m_MaxTemplateSize]; (m_hFPM,

// Obtener la primera imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_Template1); // Obtener una segunda imagen de la huella y crear plantilla desde la imagen err = JSGFPLib.GetImage (m_ImgBuf); Err = JSGFPLib.CreateTemplate (null, m_ImgBuf, m_Template2); // Guardar la plantilla despus de combinar dos plantillas m_Template1, m_Template2 buf_size int [] = new int [1]; Err = JSGFPLib.GetTemplateSizeAfterMerge (m_Template1, buf_size); Merged_template byte [] = new byte [buf_size [0]; Err = JSGFPLib.MergeIsoTemplate (m_Template1, merged_template);

m_Template2,

m_Template2,

Obtener informacin sobre una plantilla ISO19794-2 La ISO19794-2 formato de plantilla permite que varios dedos de las manos y dedos por varias vistas para ser almacenados en una plantilla. Para que coincida con una muestra (ver) contra una muestra en otra plantilla, informacin sobre la plantilla puede ser necesaria. Para obtener informacin de la muestra sobre una plantilla, utilice JSGFPLib.GetIsoTemplateInfo ().
DWORD err. BOOL coincidir FALSE; =

23

FDx SDK Pro Programming Manual - Java


// ISO19794-2 SGISOTemplateInfo sample_info = {0}; Err = JSGFPLib.GetIsoTemplateInfo &sample_info);

Chapter 3. Programming in Java

(m_hFPM,

m_StoredTemplate,

Coincidir = FALSE; Int found_finger = -1; (Int i = 0; i < sample_info.TotalSamples; i++) { // ISO19794-2 Err = JSGFPLib.MatchIsoTemplate (m_hFPM, m_StoredTemplate, i, m_FetBufM, 0, SL_NORMAL, &Conciliad o);

24

FDx SDK Pro Programming Manual - Java

Chapter 3. Programming in Java

Si (coincidencia) { Found_finger = sample_info.SampleInfo[i] .FingerNumber; Romper. } } Si (err == SGFDX_ERROR_NONE) { Si (found_finger > = 0) M_resultedit.Format (Los datos de la huella dactilar. Posicin de los dedos: %s", G_fingerposstr [found_finger]); Otra cosa M_resultedit.Format (No se puede encontrar con datos de huella dactilar); } Otra cosa { M_resultedit.Format (MatchIsoTemplate failed. Error = %d", err); }

3.17. Obtener informacin sobre la versin del MINEX algoritmos compatibles


Para obtener informacin de la versin MINEXalgoritmos compatibles, utilice JSGFPLib.GetMinexVersion () .Actualmente, el nmero de versin extractor es 0x 000A0035, buscador y el nmero de versin es 0x000A8035.
Extractor largo [] = new long [1]; Long [ ] matcher = new long [1]; Err = JSGFPLib.GetMinexVersion (extractor, matcher); System.out.println ((Extractor:" + extractor [0] + "Matcher:" + buscador);

25

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

El Captulo 4. Referencia de la funcin JSGFPLib


4.1. Creacin y terminacin JSGFPLib
Pblico JSGFPLib () Crea una instancia del objeto JSGFPLib. Valores de retorno SGFDX_ERROR_NONE SGFDX_ERROR_CREATION_FAILED = Sin error = Error al crear una instancia objeto

Pblico largo Open () Secugen Se abre la biblioteca nativa. Valores de retorno SGFDX_ERROR_NONE = Sin error Largo pblico Close () Cierra el Secugen biblioteca nativa. Valores de retorno SGFDX_ERROR_NONE = Sin error

4.2. Inicializacin
Mucho pblico Init (largo devName) Inicializa JSGFPLib informacin con el nombre de dispositivo. El objeto JSGFPLib carga los controladores apropiados con el nombre de dispositivo (Devname) e inicializa huellas dactilares mdulo algoritmo basado en la informacin del dispositivo. Devname Especifica el nombre de dispositivo SG_DEV_FDU03: nombre de dispositivo USB FDU03 y SDU03-based SG_DEV_FDU04 lectores: nombre de dispositivo USB de FDU04 y SDU04-segn los lectores SG_DEV_AUTO: determina automticamente el nombre de dispositivo Valores de retorno SGFDX_ERROR_NONE = Sin error SGFDX_ERROR_CREATION_FAILED = Error al crear objeto JSGFPLib SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_DRVLOAD_FAILED = No se ha podido cargar el controlador Largo InitEx pblico (largo ancho, altura larga, larga ppp) Inicializa JSGFPLib con informacin de la imagen. Utilizar cuando se ejecuta sin huellas dactilares mdulo un algoritmo Secugen lector. Parmetros 26

FDx SDK Pro Programming Manual - Java Anch o Ancho de la imagen en pxeles. Altura Altura de la imagen en pxeles.

Chapter 4.JSGFPLib Function Reference

27

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Ppp Resolucin de la imagen en PPP Valores de retorno SGFDX_ERROR_NONE = Sin error SGFDX_ERROR_CREATION_FAILED = Error al crear objeto JSGFPLib SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_DLLLOAD_FAILED = No se ha podido cargar el algoritmo DLL Mucho pblico SetTemplateFormat (formato corto) Formato de la plantilla fija. Formato predeterminado es Secugen formato propietario (TEMPLATE_FORMAT_SG400). Formato Especifica formato de plantilla TEMPLATE_FORMAT_ANSI378: ANSI INCITS 378-2004 TEMPLATE_FORMAT_ISO19794 formato: ISO/IEC 19794-2:2005 TEMPLATE_FORMAT_SG400 formato: Secugen formato propietario Valores de retorno SGFDX_ERROR_NONE = Sin error SGFDX_ERROR_CREATION_FAILED = Error al crear objeto JSGFPLib SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal formato de plantilla

4.3. Dispositivo y funciones de captura


Mucho pblico EnumerateDevice (int [] ndevs, SGDeviceList [] devList) Enumera actualmente conectado lector para el sistema. Parmetros Ndevs El nmero de lectores USB conectado Devlist Buffer que contiene ID de dispositivo y nmero de serie del dispositivo. Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_FUNCTION_FAILED = funcin General fail error SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado

OpenDevice largo pblico (largo devId) Inicializa el lector de huellas digitales. Devid Especifica el ID de dispositivo USB para los lectores. El valor puede ser de 0 a 9. El nmero mximo admitido de lectores conectados al mismo tiempo es de 10. Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_SYSLOAD_FAILED = No se ha podido cargar archivos de sistema SGFDX_ERROR_INITIALIZE_FAILED = Error al inicializar SGFDX_ERROR_DEVICE_NOT_FOUND chip = no se ha 28

FDx SDK Pro Programming Manual - Java encontrado el dispositivo

Chapter 4.JSGFPLib Function Reference

29

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Mucho pblico CloseDevice () Cierra el dispositivo. OpenDevice () debe ser llamada antes de que esta funcin se utiliza. Valores de retorno SGFDX_ERROR_NONE = Sin error Mucho pblico GetDeviceInfo (SGDeviceInfoParam Info) Obtiene informacin del dispositivo del conductor (antes de que el dispositivo inicializacin) Info Una instancia SGDeviceInfoParam objeto. Valores de retorno SGFDX_ERROR_NONE = Sin error Largo aparato pblico (int brillo) Controla el brillo del sensor de la imagen. Esta funcin slo funcionar si Smart Capture est desactivado. Brillo Se debe establecer en un valor de 0 a 100 Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado Mucho pblico SetLedOn (boolean on) Unidad ptica activa de activacin/desactivacin de LED. En Es cierto: Se enciende el LED se apaga Falso: LED Valores de retorno SGFDX_ERROR_NONE = Sin error Mucho pblico GetImage (byte [] buffer) Captura un nivel de gris 256 imgenes de la huella del lector. El tamao de la imagen puede ser recuperada por llamar GetDeviceInfo (). JSGFPLib.GetImage () no se comprueba para la calidad de la imagen. Para obtener calidad de la imagen de una imagen capturada, utilice GetImageQuality (). Bfer Una matriz de bytes que contiene una imagen de la huella. El tamao de la imagen puede ser recuperada por llamar GetDeviceInfo (). Valores de retorno SGFDX_ERROR_NONE = Sin error SGFDX_ERROR_WRONG_IMAGE = Capturar imagen no es una verdadera imagen de la huella SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_LINE_DROPPED = Imagen prdida de datos 30

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Largo GetImageQuality pblico (largo ancho, altura larga, byte [] imgBuf, int [] calidad) Obtiene la calidad de una captura (escaneado) imagen. El valor se determina por dos factores. Uno de ellos es la relacin entre la imagen de la huella de todo el rea explorada, y la otra es la cresta calidad de la imagen de la huella. Un valor de calidad de 50 o superior se recomienda para su registro. Un valor de calidad de 40 o superior se recomienda para su verificacin. Parmetros Anch o Ancho de la imagen en pxeles. Altura Altura de la imagen en pxeles. Imgbuf Datos de imgenes de huellas digitales Calida d El nico elemento matriz que contiene calidad de imagen Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado

Largo GetImageEx Pblico (byte [] buffer, largo tiempo de espera, tiempo dispWnd, largo calidad) Captura imgenes de huellas dactilares del lector hasta que la calidad de la imagen es mayor que el valor del parmetro de calidad. La huella es un nivel de gris 256 imgenes; tamao de la imagen se pueden recuperar SGFPM_GetDeviceInfo llamando a la funcin. Un valor de calidad de 50 o superior se recomienda para su registro. Un valor de calidad de 40 O superior se recomienda para su verificacin. Nota: El valor de la calidad es diferente del valor utilizado en SGFPM_GetImage (). El valor de calidad GetImageEx () slo representa la relacin entre la imagen de la huella para toda la zona explorada. Parmetros Bfer Una matriz de bytes que contiene una imagen de la huella. El tamao de la imagen puede ser recuperada por llamar GetDeviceInfo (). Tiempo de espera El valor de tiempo de espera (en milisegundos) que se usa para especificar la cantidad de tiempo en el que la funcin esperar que una huella dactilar vlida para dar entrada en el lector de huellas digitales Dispwnd Null. No se usa en Java Calidad El mnimo valor de la calidad de la imagen, que se utiliza para determinar si se acepta la imagen capturada Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_LINE_DROPPED = Imagen prdida de datos = No vlido SGFDX_ERROR_TIME_OUT huella capturada en el tiempo

31

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

4.4. Las funciones de extraccin


Mucho pblico GetMaxTemplateSize (int [] tamao) Obtiene el tamao mximo de una plantilla de huella dactilar (vista o muestra). Utilice esta funcin antes de utilizar CreateTemplate () Para obtener un adecuado tamao de bfer. Si el formato de la plantilla es SG400, devuelve longitud fija tamao 400. Nota: El tamao de la plantilla es el tamao mximo de una vista o muestra. Tamao El nico elemento matriz para contener tamao de la plantilla Valores de retorno SGFDX_ERROR_NONE = Sin error Mucho pblico CreateTemplate (SGFingerInfo fpInfo, byte [] rawImage, byte [] minTemplate) Los extractos minucias de una imagen de la huella para formar una plantilla con el formato predeterminado. Parmetros Fpinfo Informacin sobre la huella dactilar almacenada en una plantilla. Para ANSI 378 plantillas, esta informacin puede obtenerse a travs de la plantilla utilizando GetAnsiTemplateInfo () .Para ISO 19794 plantillas, esta informacin puede obtenerse a travs de la plantilla utilizando GetIsoTemplateInfo () .Para SG 400 plantillas, esta informacin no puede ser visto en la plantilla. Rawimg Una matriz de bytes que contienen 256 Gris de datos imagen de huellas dactilares Mintemplate Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_FEAT_NUMBER = nmero inadecuado de nimiedades SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = 103 = Error durante la descodificacin plantilla 1 SGFDX_ERROR_INVALID_TEMPLATE2 = 104 = Error durante la descodificacin plantilla 2

Largo GetTemplateSize pblico (byte [] minTemplate, int [] tamao) Obtiene tamao de la plantilla. Si el formato de la plantilla es SG400, se vuelve 400. Si el formato de la plantilla es ANSI378 o ISO19794, tamao de la plantilla puede variar. Mintemplate Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Tamao Una matriz de bytes que contiene tamao de la plantilla Valores de retorno SGFDX_ERROR_NONE = Sin error

32

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

4.5. Funciones de coincidencia


Largo MatchTemplate pblico (byte [] minTemplate1, byte [] minTemplate2, largo secuLevel, Boolean [] coinciden) compara dos conjuntos de puntos caractersticos los datos del mismo formato de la plantilla. El formato de la plantilla debe ser el mismo que el establecido por SetTemplateFormat () y debe incluir slo una muestra. Para que coincida con las plantillas que tienen ms de una muestra, utilice MatchTemplateEx () o MatchAnsiTemplate (). Devuelve TRUE o FALSE como resultado de coincidencia (con). Nivel de seguridad (secuLevel) afecta al resultado de coincidencia. El nivel de seguridad se puede ajustar de acuerdo a la poltica de seguridad requerida por el usuario o la organizacin. Mintemplate1 Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Mintempate2 Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Seculevel Un nivel de seguridad especificados en "SGFDxSecurityLevel" por uno de los siguientes nueve niveles de seguridad: SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SL_NORMAL, SL_ABOVE_NORMAL, SL_HIGH, SL_HIGHER y SL_HIGHEST. SL_NORMAL se recomienda en caso normal. Conciliado Una matriz de bytes que contiene resultado de coincidencia. Si pasa las plantillas las plantillas son coincidentes, se devuelve TRUE. Si no es as, se devuelve FALSE. Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2 Largo MatchTemplateEx pblico (byte [] minTemplate1 tempateType1, corto, largo sampleNum1, byte [] Mintemplate2 tempateType2, corto, largo, largo secuLevel sampleNum2, boolean [] coincidentes) Compara dos conjuntos de puntos caractersticos datos, los cuales pueden ser de diferentes formatos de plantilla (SG400 o ANSI378). Devuelve TRUE o FALSE como resultado de coincidencia ( con). Nivel de seguridad (secuLevel) afecta al resultado de coincidencia. El nivel de seguridad se puede ajustar de acuerdo a la poltica de seguridad requerida por el usuario o la organizacin.

Mintemplate1 Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Templatetype1 Especifica formato de minTemplate1. Debe ser TEMPLATE_FORMAT_SG400 o TEMPLATE_FORMAT_ANSI378. Samplenum1 Posicin de la muestra que debe coincidir en minTemplate1. Si templateType1 TEMPLATE_FORMAT_ANSI378, puede tener un valor de 0 a (nmero de muestras -1) en minTemplate1. Si templateType1 es TEMPLATE_FORMAT_SG400, este valor es ignorado. 33

FDx SDK Pro Programming Manual - Java Chapter 4.JSGFPLib Function Reference Mintemplate2 Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Templatetype2 Especifica formato de minTemplate2. Debe ser TEMPLATE_FORMAT_SG400 o TEMPLATE_FORMAT_ANSI378. Samplenum2 Posicin de la muestra que debe coincidir en minTemplate2. Si templateType2 TEMPLATE_FORMAT_ANSI378, puede tener un valor de 0 a (nmero de muestras -1) en minTemplate2. Si templateType2 es

34

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

TEMPLATE_FORMAT_SG400, este valor es ignorado. Seculevel Un nivel de seguridad especificados en "fplibnew.h" por uno de los siguientes nueve niveles de seguridad: SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SL_NORMAL, SL_ABOVE_NORMAL, SL_HIGH, SL_HIGHER y SL_HIGHEST. SL_NORMAL se recomienda en caso normal. Conciliado VERDADERO: la misma plantilla FALSO: No es la misma plantilla Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2

Mucho pblico JSGFPLib.GetMatchingScore (byte [] minTemplate1, byte [] minTemplate2, int [] puntuacin) Obtiene con puntuacin de dos conjuntos de puntos caractersticos los datos del mismo formato de la plantilla. Parmetros Mintemplate1 Un puntero al buffer que contiene puntos caractersticos los datos extrados de una imagen de la huella Mintemplate2 Un puntero al buffer que contiene puntos caractersticos los datos extrados de una imagen de la huella Puntuacin Puntuacin correspondiente. Puntuacin ha devuelto un valor de 0 a 199. Valores devueltos SGFDX_ERROR_NONE = Sin error SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2

Largo GetMatchingScoreEx pblico (byte [] minTemplate1 tempateType1, corto, largo sampleNum1, byte [] Mintemplate2 tempateType2, corto, largo sampleNum2, int [] puntuacin); Obtiene puntuacin correspondiente de los dos conjuntos de puntos caractersticos datos, los cuales pueden ser de diferentes formatos de plantilla (SG400 o ANSI378). Parmetros Mintemplate1 Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Templatetype1 Especifica formato de minTemplate1. Debe ser TEMPLATE_FORMAT_SG400 o TEMPLATE_FORMAT_ANSI378. Samplenum1 Posicin de la muestra que debe coincidir en minTemplate1. Si templateType1 TEMPLATE_FORMAT_ANSI378, puede tener un valor de 0 a (nmero de muestras -1) en minTemplate1. Si templateType1 es TEMPLATE_FORMAT_SG400, este valor es ignorado. Mintemplate2 Una matriz de bytes que contiene puntos caractersticos los datos extrados de una imagen de la huella Templatetype2 35

FDx SDK Pro Programming Manual - Java Chapter 4.JSGFPLib Function Reference Especifica formato de minTemplate2. Debe ser TEMPLATE_FORMAT_SG400 o TEMPLATE_FORMAT_ANSI378. Samplenum2 Posicin de la muestra que debe coincidir en minTemplate2. Si templateType2 TEMPLATE_FORMAT_ANSI378, puede tener un valor de 0 a (nmero de muestras -1) en minTemplate2. Si templateType2 es TEMPLATE_FORMAT_SG400, este valor es ignorado. Puntuacin

36

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Puntuacin correspondiente. Puntuacin ha devuelto un valor de 0 a 199. Valores devueltos SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Sin error = tipo de plantilla incorrecta SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2

4.6. Funciones de ANSI378 Plantillas


Largo GetTemplateSizeAfterMerge pblico (byte [] ansiTemplate1, byte [] ansiTemplate2, int [] tamao) Calcula tamao de la plantilla si dos plantillas - ansiTemplate1 y ansiTemplate2 - se combinan. Esta funcin se utiliza para determinar la causa exacta tamao de bfer antes de utilizar MergeAnsiTemplate (). Ansitemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Ansitempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Tamao Tamao de la plantilla si se combinan dos plantillas Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2 Largo MergeAnsiTemplate pblico (byte [] ansiTemplate1, byte [] ansiTemplate2, byte [] outTemplate) Combina dos ANSI378 plantillas y devuelve una nueva plantilla fusionada. La plantilla fusionada (outTemplate) tamao ser de menos de suma de los tamaos de las dos plantillas de entrada (tamao de ansiTemplate1 + tamao de ansiTemplate2). Llamada GetTemplateSizeAfterMerge () para determinar exactamente el tamao de bfer para outTemplate antes de llamar MergeAnsiTemplate (). Ansitemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Asnitempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Outtempate La matriz de bytes que contiene datos combinados. El bfer debe ser asignado por la aplicacin. Para determinar exactamente el tamao del buffer, llamada JSGFPLib.GetTemplateSizeAfterMerge (). Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2 Largo GetAnsiTemplateInfo pblico (byte [] ansiTemplate, SGANSITemplateInfo templateInfo) Obtiene informacin de un ANSI378 plantilla. Se llama a esta funcin antes MatchAnsiTemplate () para obtener informacin sobre una plantilla. Anisitemplate 37

FDx SDK Pro Programming Manual - Java ANSI378 plantilla

Chapter 4.JSGFPLib Function Reference

38

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Templateinfo El objeto que contiene informacin de la plantilla. Para obtener ms informacin, consulte SGANSITemplateInfo estructura. Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla

Largo MatchAnsiTemplate pblico (byte [] ansiTemplate1 largo sampleNum1, byte [] ansiTemplate2 sampleNum2, largo, largo secuLevel, Boolean [] coincidentes) Compara dos conjuntos de ANSI 378 plantillas. Devuelve TRUE o FALSE como resultado de coincidencia (con). Nivel de seguridad (secuLevel) afecta al resultado de coincidencia. El nivel de seguridad se puede ajustar de acuerdo a la poltica de seguridad requerida por el usuario o la organizacin. Parmetros Ansitemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum1 Posicin de la muestra coincide en ansiTemplate1 .Puede ser desde 0 a (nmero de muestras -1) Ansitemplate1 Ansitempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum2 Posicin de la muestra coincide en ansiTemplate2 .Puede ser desde 0 a (nmero de muestras -1) Ansitemplate2 Seculevel Un nivel de seguridad tal como se especifica en SGFDxSecurityLevel por uno de los siguientes nueve niveles de seguridad: SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SL_NORMAL, SL_ABOVE_NORMAL, SL_HIGH, SL_HIGHER y SL_HIGHEST. SL_NORMAL se recomienda en caso normal. Conciliado VERDADERO: la misma plantilla FALSO: No es la misma plantilla Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en ansiTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en ansiTemplate2

Largo GetAnsiMatchingScore pblico (byte [] ansiTemplate1 largo sampleNum1, byte [] ansiTemplate2 largo sampleNum2, int [] puntuacin) Obtiene puntuacin correspondiente. Parmetros Ansitemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum1 Posicin de la muestra coincide en ansiTemplate1 .Puede ser desde 0 a (nmero de muestras -1) Ansitemplate1 Ansitempate2 39

FDx SDK Pro Programming Manual - Java Chapter 4.JSGFPLib Function Reference Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum2 Posicin de la muestra coincide en ansiTemplate2 .Puede ser desde 0 a (nmero de muestras -1) Ansitemplate2 Puntuacin Puntuacin correspondiente. Puntuacin ha devuelto un valor de 0 a 199.

40

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en ansiTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en ansiTemplate2

4.7. ISO19794-2 Funciones de plantillas


Largo GetIsoTemplateSizeAfterMerge pblico (byte [] isoTemplate1, byte [] isoTemplate2, int [] tamao) Calcula tamao de la plantilla si dos plantillas - isoTemplate1 e isoTemplate2 - se combinan. Esta funcin se utiliza para determinar la causa exacta tamao de bfer antes de utilizar MergeIsoTemplate (). Isotemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Isotempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Tamao Tamao de la plantilla si se combinan dos plantillas Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2

Largo MergeIsoTemplate pblico (byte [] isoTemplate1, byte [] isoTemplate2, byte [] outTemplate) Combina dos ISO19794-2 plantillas y devuelve una nueva plantilla fusionada. La plantilla fusionada (outTemplate) tamao ser de menos de suma de los tamaos de las dos plantillas de entrada (tamao de isoTemplate1 + tamao de isoTemplate2). Llamada GetTIsoemplateSizeAfterMerge () para determinar exactamente el tamao de bfer para outTemplate antes de llamar MergeIsoTemplate (). Isotemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Isotempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Outtempate La matriz de bytes que contiene datos combinados. El bfer debe ser asignado por la aplicacin. Para determinar exactamente el tamao del buffer, llamada GetIsoTemplateSizeAfterMerge (). Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en minTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en minTemplate2

41

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Largo GetIsoTemplateInfo pblico (byte [] isoTemplate, SGISOTemplateInfo templateInfo) Obtiene informacin de un ISO19794-2 plantilla. Se llama a esta funcin antes MatchIsoTemplate () para obtener informacin sobre una plantilla. Isotemplate ISO19794-2 plantilla Templateinfo El objeto que contiene informacin de la plantilla. Para obtener ms informacin, consulte SGISOTemplateInfo estructura. Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_PARAM = parmetro no vlido utilizado SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla Largo MatchIsoTemplate pblico (byte [] isoTemplate1 largo sampleNum1, byte [] isoTemplate2 sampleNum2, largo, largo secuLevel, boolean [] coincidentes) Compara dos conjuntos de ISO19794-2 plantillas. Devuelve TRUE o FALSE como resultado de coincidencia (con). Nivel de seguridad (secuLevel) afecta al resultado de coincidencia. El nivel de seguridad se puede ajustar de acuerdo a la poltica de seguridad requerida por el usuario o la organizacin. Parmetros Isotemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum1 Posicin de la muestra coincide en isoTemplate1 .Puede ser desde 0 a (nmero de muestras -1) Isotemplate1 Isotempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum2 Posicin de la muestra coincide en isoTemplate2 .Puede ser desde 0 a (nmero de muestras -1) Isotemplate2 Seculevel Un nivel de seguridad tal como se especifica en SGFDxSecurityLevel por uno de los siguientes nueve niveles de seguridad: SL_LOWEST, SL_LOWER, SL_LOW, SL_BELOW_NORMAL, SL_NORMAL, SL_ABOVE_NORMAL, SL_HIGH, SL_HIGHER y SL_HIGHEST. SL_NORMAL se recomienda en caso normal. Conciliado VERDADERO: la misma plantilla FALSO: No es la misma plantilla Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en isoTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en isoTemplate2

42

FDx SDK Pro Programming Manual - Java

Chapter 4.JSGFPLib Function Reference

Largo GetIsoMatchingScore pblico (byte [] isoTemplate1 largo sampleNum1, byte [] isoTemplate2 largo sampleNum2, int [] puntuacin) Obtiene puntuacin correspondiente. Parmetros Isotemplate1 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum1 Posicin de la muestra coincide en isoTemplate1 .Puede ser desde 0 a (nmero de muestras -1) Isotemplate1 Isotempate2 Una matriz de bytes que contiene datos caractersticos. Una plantilla puede tener ms de una muestra. Samplenum2 Posicin de la muestra coincide en isoTemplate2 .Puede ser desde 0 a (nmero de muestras -1) Isotemplate2 Puntuacin Puntuacin correspondiente. Puntuacin ha devuelto un valor de 0 a 199. Valores de retorno = Sin error SGFDX_ERROR_NONE SGFDX_ERROR_INVALID_TEMPLATE_TYPE = Mal tipo de plantilla SGFDX_ERROR_INVALID_TEMPLATE1 = Error en isoTemplate1 SGFDX_ERROR_INVALID_TEMPLATE2 = Error en isoTemplate2

4.8. Otros
Mucho pblico GetMinexVersion (long [] extractor, largo [] matcher) Obtiene versin de MINEX compatible con los algoritmos utilizados en el presente. Parmetros Extractor Versin compatible con extractor de MINEX (generador de plantillas) Buscado r Compatible con versin de MINEX matcher (plantilla) Valores de retorno SGFDX_ERROR_NONE = Sin error

43

FDx SDK Pro Programming Manual - Java

Chapter 5. Class Reference

El Captulo 5. Referencia de la clase


5.1. Documentacin Java
Consulte el "doc" carpeta en esta versin del SDK de JavaDoc referencia de la clase completa.

44

FDx SDK Pro Programming Manual - Java

Chapter 6. Constants

El Captulo 6. Constantes
6.1. SGFDxDeviceName
Nombre del dispositivo SG_DEV_UNKNOWN SG_DEV_FDU03 SG_DEV_FDU04 SG_DEV_AUTO Valor 0 0X04 0X05 0Xff Descripcin No determinada FDU03 o SDU03-basado reader FDU04 o SDU04-basado reader Deteccin automtica

6.2. SGFDxSecurityLevel
SL_NONE SL_LOWEST SL_LOWER SL_LOW SL_BELOW_NORMAL SL_NORMAL SL_ABOVE_NORMAL SL_HIGH SL_HIGHER SL_HIGHEST Nivel de seguridad Valor 0 1 2 3 4 5 6 7 8 9 Descripcin No hay seguridad inferior ms bajo Baja Por debajo de lo normal Normal Por encima de lo normal Alta Superior Ms alta

6.3. SGFDxTemplateFormat
Formato de la plantilla TEMPLATE_FORMAT_ANSI378 TEMPLATE_FORMAT_SG400 TEMPLATE_FORMAT_ISO19794 Valor 0X0100 0X0200 0X0300 Descripcin Formato ANSI INCITS 3782004 Secugen formato de ISO/IEC 19794-2:2005 formato

6.4. SGImpressionType
Nivel de seguridad SG_IMPTYPE_LP SG_IMPTYPE_LR SG_IMPTYPE_NP SG_IMPTYPE_NR Valor 0X00 0X01 0X02 0X03 Descripcin Live-scan normal vivir-scan laminados No-scan normal No-laminados captura

45

FDx SDK Pro Programming Manual - Java

Chapter 6. Constants

6.5. SGFingerPosition
Nivel de seguridad SG_FINGPOS_UK SG_FINGPOS_RT SG_FINGPOS_RI SG_FINGPOS_RM SG_FINGPOS_RR SG_FINGPOS_RL SG_FINGPOS_LT SG_FINGPOS_LI SG_FINGPOS_LM SG_FINGPOS_LR SG_FINGPOS_LL Valor 0X00 0X01 0X02 0X03 0X04 0X05 0X06 0X07 0X08 0X09 0X0A Descripcin Dedo desconocido Pulgar derecho Dedo ndice derecho dedo medio derecho dedo anular derecho dedo derecho pequeo dedo pulgar izquierdo Dedo ndice izquierdo dedo izquierdo medio dedo anular izquierdo dedo meique izquierdo

6.6. SGFDxErrorCode
Cdigo de Error Valor Los Cdigos de Error general 0 1 2 3 4 5 6 7 No hay errores Error al crear el objeto JSGFPLib Fallo en la funcin de llamadas Parmetro no vlido utilizado No se usa funcin Error al cargar DLL Error al cargar controladores de dispositivo Error al cargar DLL algoritmo Descripcin

SGFDX_ERROR_NONE SGFDX_ERROR_CREATION_FAILED SGFDX_ERROR_FUNCTION_FAILED SGFDX_ERROR_INVALID_PARAM SGFDX_ERROR_NOT_USED SGFDX_ERROR_DLLLOAD_FAILED SGFDX_ERROR_DLLLOAD_FAILED_DRV SGFDX_ERROR_DLLLOAD_FAILED_ALGO

Cdigos de Error del controlador de dispositivo SGFDX_ERROR_SYSLOAD_FAILED 51 Puede encontrar Chip SGFDX_ERROR_INITIALIZE_FAILED controlador inicializacin archivo 52 53 SGFDX_ERROR_LINE_DROPPED sys Imagen no pierde datos 54 SGFDX_ERROR_TIME_OUT GetImageEx() no se ha 55 SGFDX_ERROR_DEVICE_NOT_FOUND encontrado el dispositivo de SGFDX_ERROR_DRVLOAD_FAILED tiempo de espera 56 57 SGFDX_ERROR_WRONG_IMAGE Archivo de controlador ha fallado la carga 58 Mala imagen SGFDX_ERROR_LACK_OF_BANDWIDTH 59 Falta de banda ancha USB SGFDX_ERROR_DEV_ALREADY_OPEN Dispositivo ya est abierto SGFDX_ERROR_GETSN_FAILED 60 61 SGFDX_ERROR_UNSUPPORTED_DEV Nmero de serie no existe Dispositivo no compatible Extracto correspondiente y los cdigos de error 101 Insuficiente nmero de puntos SGFDX_ERROR_FEAT_NUMBER 102 SGFDX_ERROR_INVALID_TEMPLATE_TYPE caractersticos 103 Tipo de plantilla incorrecta SGFDX_ERROR_INVALID_TEMPLATE1 Error de decodificacin plantilla 1 SGFDX_ERROR_INVALID_TEMPLATE2 104 105 SGFDX_ERROR_EXTRACT_FAIL Error de decodificacin plantilla 2 106 Error durante la extraccin SGFDX_ERROR_MATCH_FAIL No coincidente

6.7. SGFDxConstant
DEV_SN_LEN 15 * nmero de serie del dispositivo. 46

FDx SDK Pro Programming Manual - Java

Chapter 7. Sample Applications

El Captulo 7. Aplicaciones de ejemplo


Despus de instalar el hardware y el software, se recomienda que todos los componentes que se compruebe para comprobar que estn funcionando correctamente. Muestra que se incluyen aplicaciones se pueden utilizar para este fin

7.1. JSGD - Hardware Programa de prueba


Secugen El programa de utilidad de diagnstico del dispositivo (JSGD.class) se encuentra en el FDxSDK.jar archivo. Este programa escanea las imgenes de las huellas digitales y, adems, realiza registro de huellas dactilares y la verificacin. Si este programa no logra captar una imagen de la huella, el sistema no est configurado correctamente. 1. Abra un smbolo del sistema. 2. Cd < FDx_SDK_FOR_JAVA_INSTALL_DIR> 3. Tipo run_JSGD.bat y luego, Intro .El siguiente comando tambin se puede utilizar:
Java -cp " .AbsoluteLayout.jar; FDxSDKPro.jar" Secugen.FDxSDKPro.samples.JSGD

4.

Haga clic en Iniciar para inicializar el lector. El resultado de la inicializacin (xito o fracaso) en la barra de estado se mostrar en la parte inferior izquierda de la pantalla. Si la inicializacin falla, compruebe la conexin del dispositivo y repita los pasos anteriores.

47

FDx SDK Pro Programming Manual - Java

Chapter 7. Sample Applications

48

FDx SDK Pro Programming Manual - Java

Chapter 7. Sample Applications

Si la inicializacin se realiza correctamente, coloque su dedo en el lector de huellas digitales, y haga clic en el botn Capturar. La imagen de la huella se debe mostrar si el lector est funcionando correctamente.

7.2. Programa de prueba JFPLib


La JSGFPLibTest programa demuestra toda la funcionalidad incluida en Pro Fdx SDK para Java. 1. Abra un smbolo del sistema. 2. Cd < FDx_SDK_FOR_JAVA_INSTALL_DIR> 3. Tipo run_jsgfplibtest.bat y, a continuacin, entrar.

49

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

El Captulo 8. Subprograma Firmado y explorador Web Integracin


8.1. Instalar el Fdx SDK Pro para Java Runtime Library
Windows 7 32 bits: Copia jnifplib\win32 \jnisgfplib.dll en C: \windows\system32 Windows 7 64 bits: Copia jnifplib\win32 \jnisgfplib.dll en C: \Windows\syswow64 Copia jnifplib\x64 \jnisgfplib.dll en C: \Windows\system32

8.2. Generar un Certificado Digital y el par de claves (GENKEY.BAT)


Keytool -genkey -alias demokey -keypass demopassword -keystore demokeystore -storepass demopassword

8.3. Crear un archivo JAR firmado (BUILDSIGNEDAPPLET.BAT)


Del AppletDemo.jar Jar xvf FDxSDKPro.jar Jar xvf AbsoluteLayout.jar Javac -depreciacin applet\ * .java Jar cvf AppletDemo SecuGen\FDxSDKPro\jni\.jar * .class * .class applet\ org\netbeans\lib\awtextra\ *. * Jarsigner -keystore demokeystore -storepass demopassword -keypass demopassword AppletDemo.jar demokey

50

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

42

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

8.4. Exportar el certificado (EXPORTCERT.BAT)


Keytool -export -alias demokey -storepass demopassword -keystore demokeystore -archivo democert.csr

8.5. Importar el certificado en Java Plug-in

Lanzamiento del Java applet del Panel de Control y seleccione la ficha Seguridad.

43

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

Haga clic en el botn "Certificados" y, a continuacin, haga clic en "Import".

44

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

Vaya a la DEMOCERT.CSR certificado exportado y haga clic en "Abrir".

El certificado se ha instalado en el JRE.

45

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

8.6. Abrir el Applet Demo Archivo HTML


JSGDAppletDemo.html
<Html> <HEAD> <TITLE> Applet JSGD Demo < /Title> < /Head> < /Body> <Center> <Applet Cdigo = "applet.JSGDApplet.class". Name = " JSGDApplet" archivo = "AppletDemo.jar" width = " 550" Height = " 550" Hspace = " 0" vspace = " 0" Align = "media" > < /Applet> < /Center> < /Body> < /HTML>

46

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

8.7. Navegador Internet Explorer


IE v9.0.8112 probado en Windows 7 de 32 bits Probado IE v10.0.9200 en el Wind0ws 7 de 64 bits

47

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

8.8. Navegador Firefox


Probado FireFox v20.0.1 en Windows 7 de 32 bits Probado en Firefox v12.0 Windows 7 de 64 bits

48

FDx SDK Pro Programming Manual - Java

Chapter 8. Signed Applet and Web Browser Integration

8.9. Navegador Google Chrome


Probando Google Chrome v27.0.1453.94 m en Windows 7 de 32 bits Probando Google Chrome v27.0.1453.94 m enWindows 7 de 64 bits

49

También podría gustarte