<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libfprint: fprint.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<script type="text/javascript">
function hasClass(ele,cls) {
return ele.className.match(new RegExp('(\\s|^)'+cls+'(\\s|$)'));
}
function addClass(ele,cls) {
if (!this.hasClass(ele,cls)) ele.className += " "+cls;
}
function removeClass(ele,cls) {
if (hasClass(ele,cls)) {
var reg = new RegExp('(\\s|^)'+cls+'(\\s|$)');
ele.className=ele.className.replace(reg,' ');
}
}
function toggleVisibility(linkObj) {
var base = linkObj.getAttribute('id');
var summary = document.getElementById(base + '-summary');
var content = document.getElementById(base + '-content');
var trigger = document.getElementById(base + '-trigger');
if ( hasClass(linkObj,'closed') ) {
summary.style.display = 'none';
content.style.display = 'block';
trigger.src = 'open.png';
removeClass(linkObj,'closed');
addClass(linkObj,'opened');
} else if ( hasClass(linkObj,'opened') ) {
summary.style.display = 'block';
content.style.display = 'none';
trigger.src = 'closed.png';
removeClass(linkObj,'opened');
addClass(linkObj,'closed');
}
return false;
}
</script>
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
</ul>
</div>
<div class="header">
<div class="headertitle">
<h1>fprint.h</h1> </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> * Main definitions for libfprint</span>
<a name="l00003"></a>00003 <span class="comment"> * Copyright (C) 2007 Daniel Drake <dsd@gentoo.org></span>
<a name="l00004"></a>00004 <span class="comment"> *</span>
<a name="l00005"></a>00005 <span class="comment"> * This library is free software; you can redistribute it and/or</span>
<a name="l00006"></a>00006 <span class="comment"> * modify it under the terms of the GNU Lesser General Public</span>
<a name="l00007"></a>00007 <span class="comment"> * License as published by the Free Software Foundation; either</span>
<a name="l00008"></a>00008 <span class="comment"> * version 2.1 of the License, or (at your option) any later version.</span>
<a name="l00009"></a>00009 <span class="comment"> *</span>
<a name="l00010"></a>00010 <span class="comment"> * This library is distributed in the hope that it will be useful,</span>
<a name="l00011"></a>00011 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00012"></a>00012 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00013"></a>00013 <span class="comment"> * Lesser General Public License for more details.</span>
<a name="l00014"></a>00014 <span class="comment"> *</span>
<a name="l00015"></a>00015 <span class="comment"> * You should have received a copy of the GNU Lesser General Public</span>
<a name="l00016"></a>00016 <span class="comment"> * License along with this library; if not, write to the Free Software</span>
<a name="l00017"></a>00017 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span>
<a name="l00018"></a>00018 <span class="comment"> */</span>
<a name="l00019"></a>00019
<a name="l00020"></a>00020 <span class="preprocessor">#ifndef __FPRINT_H__</span>
<a name="l00021"></a>00021 <span class="preprocessor"></span><span class="preprocessor">#define __FPRINT_H__</span>
<a name="l00022"></a>00022 <span class="preprocessor"></span>
<a name="l00023"></a>00023 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00024"></a>00024 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
<a name="l00025"></a>00025 <span class="preprocessor">#endif</span>
<a name="l00026"></a>00026 <span class="preprocessor"></span>
<a name="l00027"></a>00027 <span class="preprocessor">#include <stdint.h></span>
<a name="l00028"></a>00028 <span class="preprocessor">#include <sys/time.h></span>
<a name="l00029"></a>00029
<a name="l00030"></a>00030 <span class="comment">/* structs that applications are not allowed to peek into */</span>
<a name="l00031"></a>00031 <span class="keyword">struct </span>fp_dscv_dev;
<a name="l00032"></a>00032 <span class="keyword">struct </span>fp_dscv_print;
<a name="l00033"></a>00033 <span class="keyword">struct </span>fp_dev;
<a name="l00034"></a>00034 <span class="keyword">struct </span>fp_driver;
<a name="l00035"></a>00035 <span class="keyword">struct </span>fp_print_data;
<a name="l00036"></a>00036 <span class="keyword">struct </span>fp_img;
<a name="l00037"></a>00037
<a name="l00038"></a>00038 <span class="comment">/* misc/general stuff */</span>
<a name="l00039"></a>00039
<a name="l00045"></a><a class="code" href="group__print__data.html#ga5c6d4e10ca53fd0b61eaa4716f3985d5">00045</a> <span class="keyword">enum</span> <a class="code" href="group__print__data.html#ga5c6d4e10ca53fd0b61eaa4716f3985d5" title="Numeric codes used to refer to fingers (and thumbs) of a human.">fp_finger</a> {
<a name="l00046"></a>00046 LEFT_THUMB = 1,
<a name="l00047"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5a8e451ff5c90ff6cf44d266af59d3bcc7">00047</a> LEFT_INDEX,
<a name="l00048"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5a0d98404411ee5451af67ff3fa419bc56">00048</a> LEFT_MIDDLE,
<a name="l00049"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5aeca4b184f4328b2dfdb5530efe124091">00049</a> LEFT_RING,
<a name="l00050"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5a929a14ed753c249a9ceabc76defc6ef0">00050</a> LEFT_LITTLE,
<a name="l00051"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5a7f13e23fab6f5ade33ec9c8491a3bf25">00051</a> RIGHT_THUMB,
<a name="l00052"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5ada22d9991d3f5cb22d59ae92496af023">00052</a> RIGHT_INDEX,
<a name="l00053"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5a63368eff7313a8e9441fa71d49fa9f71">00053</a> RIGHT_MIDDLE,
<a name="l00054"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5aa062124fa518709ad3b4a26085cc6d23">00054</a> RIGHT_RING,
<a name="l00055"></a><a class="code" href="group__print__data.html#gga5c6d4e10ca53fd0b61eaa4716f3985d5a3aac8fd26588f140348ac03416e5e3c9">00055</a> RIGHT_LITTLE,
<a name="l00056"></a>00056 };
<a name="l00057"></a>00057
<a name="l00063"></a><a class="code" href="group__dev.html#ga522218ddb7c587d2bb472ea399588ffa">00063</a> <span class="keyword">enum</span> <a class="code" href="group__dev.html#ga522218ddb7c587d2bb472ea399588ffa" title="Numeric codes used to refer to the scan type of the device.">fp_scan_type</a> {
<a name="l00064"></a>00064 FP_SCAN_TYPE_PRESS = 0,
<a name="l00065"></a><a class="code" href="group__dev.html#gga522218ddb7c587d2bb472ea399588ffaaf8c87c55dc15177a1ebdbe80d03a8bc6">00065</a> FP_SCAN_TYPE_SWIPE,
<a name="l00066"></a>00066 };
<a name="l00067"></a>00067
<a name="l00068"></a>00068 <span class="comment">/* Drivers */</span>
<a name="l00069"></a>00069 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="group__drv.html#ga9e7f611a3530260ad66410c10b83aacb" title="Retrieves the name of the driver.">fp_driver_get_name</a>(<span class="keyword">struct</span> fp_driver *drv);
<a name="l00070"></a>00070 <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="group__drv.html#gabf70568ddd186185d81433910f1a1c87" title="Retrieves a descriptive name of the driver.">fp_driver_get_full_name</a>(<span class="keyword">struct</span> fp_driver *drv);
<a name="l00071"></a>00071 uint16_t <a class="code" href="group__drv.html#ga74c62e3603d6f046239604c124baa741" title="Retrieves the driver ID code for a driver.">fp_driver_get_driver_id</a>(<span class="keyword">struct</span> fp_driver *drv);
<a name="l00072"></a>00072 <span class="keyword">enum</span> <a class="code" href="group__dev.html#ga522218ddb7c587d2bb472ea399588ffa" title="Numeric codes used to refer to the scan type of the device.">fp_scan_type</a> <a class="code" href="group__drv.html#gabbb0d6cca3a0e0c0c9f0aec437ce6c2e" title="Retrieves the scan type for the devices associated with the driver.">fp_driver_get_scan_type</a>(<span class="keyword">struct</span> fp_driver *drv);
<a name="l00073"></a>00073
<a name="l00074"></a>00074 <span class="comment">/* Device discovery */</span>
<a name="l00075"></a>00075 <span class="keyword">struct </span>fp_dscv_dev **<a class="code" href="group__dscv__dev.html#gacb1b399085676739d4e1d9868638f3d6" title="Scans the system and returns a list of discovered devices.">fp_discover_devs</a>(<span class="keywordtype">void</span>);
<a name="l00076"></a>00076 <span class="keywordtype">void</span> <a class="code" href="group__dscv__dev.html#ga225dc69e61bd49af648897a2e6156a24" title="Free a list of discovered devices.">fp_dscv_devs_free</a>(<span class="keyword">struct</span> fp_dscv_dev **devs);
<a name="l00077"></a>00077 <span class="keyword">struct </span>fp_driver *<a class="code" href="group__dscv__dev.html#ga630d5f065f553e831f6e6b1b0064d061" title="Gets the driver for a discovered device.">fp_dscv_dev_get_driver</a>(<span class="keyword">struct</span> fp_dscv_dev *dev);
<a name="l00078"></a>00078 uint32_t <a class="code" href="group__dscv__dev.html#gaa2f2b76b8cb8368ed4a453ea9699412f" title="Gets the devtype for a discovered device.">fp_dscv_dev_get_devtype</a>(<span class="keyword">struct</span> fp_dscv_dev *dev);
<a name="l00079"></a>00079 <span class="keywordtype">int</span> <a class="code" href="group__dscv__dev.html#ga89cffce735038e47a28f19a41c37b37b" title="Determines if a specific stored print appears to be compatible with a discovered device.">fp_dscv_dev_supports_print_data</a>(<span class="keyword">struct</span> fp_dscv_dev *dev,
<a name="l00080"></a>00080 <span class="keyword">struct</span> fp_print_data *print);
<a name="l00081"></a>00081 <span class="keywordtype">int</span> <a class="code" href="group__dscv__dev.html#gafb427e5a0fa78f3aee41b63f0da093ac" title="Determines if a specific discovered print appears to be compatible with a discovered device...">fp_dscv_dev_supports_dscv_print</a>(<span class="keyword">struct</span> fp_dscv_dev *dev,
<a name="l00082"></a>00082 <span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00083"></a>00083 <span class="keyword">struct </span>fp_dscv_dev *<a class="code" href="group__dscv__dev.html#ga979e47e55effbba8d38fb95236413c2a" title="Searches a list of discovered devices for a device that appears to be compatible with a stored print...">fp_dscv_dev_for_print_data</a>(<span class="keyword">struct</span> fp_dscv_dev **devs,
<a name="l00084"></a>00084 <span class="keyword">struct</span> fp_print_data *print);
<a name="l00085"></a>00085 <span class="keyword">struct </span>fp_dscv_dev *<a class="code" href="group__dscv__dev.html#gae1fa4cad50e81d877ed0c13bb01dd08f" title="Searches a list of discovered devices for a device that appears to be compatible with a discovered pr...">fp_dscv_dev_for_dscv_print</a>(<span class="keyword">struct</span> fp_dscv_dev **devs,
<a name="l00086"></a>00086 <span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00087"></a>00087
<a name="l00088"></a>00088 <span class="keyword">static</span> <span class="keyword">inline</span> uint16_t fp_dscv_dev_get_driver_id(<span class="keyword">struct</span> fp_dscv_dev *dev)
<a name="l00089"></a>00089 {
<a name="l00090"></a>00090 <span class="keywordflow">return</span> <a class="code" href="group__drv.html#ga74c62e3603d6f046239604c124baa741" title="Retrieves the driver ID code for a driver.">fp_driver_get_driver_id</a>(<a class="code" href="group__dscv__dev.html#ga630d5f065f553e831f6e6b1b0064d061" title="Gets the driver for a discovered device.">fp_dscv_dev_get_driver</a>(dev));
<a name="l00091"></a>00091 }
<a name="l00092"></a>00092
<a name="l00093"></a>00093 <span class="comment">/* Print discovery */</span>
<a name="l00094"></a>00094 <span class="keyword">struct </span>fp_dscv_print **<a class="code" href="group__dscv__print.html#ga9e637d14e657f4cee01d69487eba4f68" title="Scans the users home directory and returns a list of prints that were previously saved using fp_print...">fp_discover_prints</a>(<span class="keywordtype">void</span>);
<a name="l00095"></a>00095 <span class="keywordtype">void</span> <a class="code" href="group__dscv__print.html#ga48f429113859b69f71a1c06483ed9266" title="Frees a list of discovered prints.">fp_dscv_prints_free</a>(<span class="keyword">struct</span> fp_dscv_print **prints);
<a name="l00096"></a>00096 uint16_t <a class="code" href="group__dscv__print.html#ga5a254f3503f660f38468a32c3c9a8e45" title="Gets the driver ID for a discovered print.">fp_dscv_print_get_driver_id</a>(<span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00097"></a>00097 uint32_t <a class="code" href="group__dscv__print.html#gae5598e7e31c829bd5b9800bf7b748cb7" title="Gets the devtype for a discovered print.">fp_dscv_print_get_devtype</a>(<span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00098"></a>00098 <span class="keyword">enum</span> <a class="code" href="group__print__data.html#ga5c6d4e10ca53fd0b61eaa4716f3985d5" title="Numeric codes used to refer to fingers (and thumbs) of a human.">fp_finger</a> <a class="code" href="group__dscv__print.html#gabf0b6e730a8bd0cbcbe55d836d7afa5d" title="Gets the finger code for a discovered print.">fp_dscv_print_get_finger</a>(<span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00099"></a>00099 <span class="keywordtype">int</span> <a class="code" href="group__dscv__print.html#ga0e502ba429790e93dbbe8a61419469ec" title="Removes a discovered print from disk.">fp_dscv_print_delete</a>(<span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00100"></a>00100
<a name="l00101"></a>00101 <span class="comment">/* Device handling */</span>
<a name="l00102"></a>00102 <span class="keyword">struct </span>fp_dev *<a class="code" href="group__dev.html#gaadd81517ba2e3f1279525a326d0e6ee4" title="Opens and initialises a device.">fp_dev_open</a>(<span class="keyword">struct</span> fp_dscv_dev *ddev);
<a name="l00103"></a>00103 <span class="keywordtype">void</span> <a class="code" href="group__dev.html#gaa073e271cfbbea1fecc3e4fc6abb7299" title="Close a device.">fp_dev_close</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00104"></a>00104 <span class="keyword">struct </span>fp_driver *<a class="code" href="group__dev.html#ga2c59ac8e66e76587265dd44676db006b" title="Get the driver for a fingerprint device.">fp_dev_get_driver</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00105"></a>00105 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#ga709ece32f96f734ce7f1c85dd80cbc6d" title="Gets the number of enroll stages required to enroll a fingerprint with the device.">fp_dev_get_nr_enroll_stages</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00106"></a>00106 uint32_t <a class="code" href="group__dev.html#ga0395d9befefc0ddd4416035b5dc54fd3" title="Gets the devtype for a device.">fp_dev_get_devtype</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00107"></a>00107 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gae5a402c86979779b98e22a26a3d4bd7b" title="Determines if a stored print is compatible with a certain device.">fp_dev_supports_print_data</a>(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">struct</span> fp_print_data *data);
<a name="l00108"></a>00108 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gafc4dbf5ef42f4506d4c1d717ed2a4cd5" title="Determines if a discovered print appears to be compatible with a certain device.">fp_dev_supports_dscv_print</a>(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">struct</span> fp_dscv_print *print);
<a name="l00109"></a>00109
<a name="l00110"></a>00110 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#ga520edf22e305280cc3a51aa0c38922de" title="Determines if a device has imaging capabilities.">fp_dev_supports_imaging</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00111"></a>00111 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gaa7a7f70b12f0276df4749d23caf2cecd" title="Captures an image from a device.">fp_dev_img_capture</a>(<span class="keyword">struct</span> fp_dev *dev, <span class="keywordtype">int</span> unconditional,
<a name="l00112"></a>00112 <span class="keyword">struct</span> fp_img **image);
<a name="l00113"></a>00113 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gaa80c290c0b05f2a9621b1c51a22278bd" title="Gets the expected width of images that will be captured from the device.">fp_dev_get_img_width</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00114"></a>00114 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gaa79b477e4cac642056c64c458af88a28" title="Gets the expected height of images that will be captured from the device.">fp_dev_get_img_height</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00115"></a>00115
<a name="l00124"></a><a class="code" href="group__dev.html#ga29155cb920a7e294b2962616d8ad64fb">00124</a> <span class="keyword">enum</span> <a class="code" href="group__dev.html#ga29155cb920a7e294b2962616d8ad64fb" title="Enrollment result codes returned from fp_enroll_finger().">fp_enroll_result</a> {
<a name="l00127"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba9a699d6f712901a9e5faa90b66c1e7a9">00127</a> <a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba9a699d6f712901a9e5faa90b66c1e7a9" title="Enrollment completed successfully, the enrollment data has been returned to the caller.">FP_ENROLL_COMPLETE</a> = 1,
<a name="l00130"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba58d4c3752f6421d571f7867745700272">00130</a> FP_ENROLL_FAIL,
<a name="l00132"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba176d4d91638eacffc98bbc9e07c1ae03">00132</a> FP_ENROLL_PASS,
<a name="l00135"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba348a9db89e08b72c21e2b06c0dd9c76a">00135</a> <a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba348a9db89e08b72c21e2b06c0dd9c76a" title="The enrollment scan did not succeed due to poor scan quality or other general user scanning problem...">FP_ENROLL_RETRY</a> = 100,
<a name="l00138"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba24b3f9177f5057c10b4efc195da9ac75">00138</a> FP_ENROLL_RETRY_TOO_SHORT,
<a name="l00141"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba046767ecf132502a212aa1a69bb042e6">00141</a> FP_ENROLL_RETRY_CENTER_FINGER,
<a name="l00145"></a><a class="code" href="group__dev.html#gga29155cb920a7e294b2962616d8ad64fba65353ad4e9480b035fcf50281d9917c4">00145</a> FP_ENROLL_RETRY_REMOVE_FINGER,
<a name="l00146"></a>00146 };
<a name="l00147"></a>00147
<a name="l00148"></a>00148 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gae8f36a456208018fe2aa53fa44979e3f" title="Performs an enroll stage.">fp_enroll_finger_img</a>(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">struct</span> fp_print_data **print_data,
<a name="l00149"></a>00149 <span class="keyword">struct</span> fp_img **img);
<a name="l00150"></a>00150
<a name="l00162"></a><a class="code" href="group__dev.html#ga6fbb9f101f718f06c19f4ccabd112e17">00162</a> <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="group__dev.html#ga6fbb9f101f718f06c19f4ccabd112e17" title="Performs an enroll stage.">fp_enroll_finger</a>(<span class="keyword">struct</span> fp_dev *dev,
<a name="l00163"></a>00163 <span class="keyword">struct</span> fp_print_data **print_data)
<a name="l00164"></a>00164 {
<a name="l00165"></a>00165 <span class="keywordflow">return</span> <a class="code" href="group__dev.html#gae8f36a456208018fe2aa53fa44979e3f" title="Performs an enroll stage.">fp_enroll_finger_img</a>(dev, print_data, NULL);
<a name="l00166"></a>00166 }
<a name="l00167"></a>00167
<a name="l00175"></a><a class="code" href="group__dev.html#ga6945ffc512c323a40720b859445fd898">00175</a> <span class="keyword">enum</span> <a class="code" href="group__dev.html#ga6945ffc512c323a40720b859445fd898" title="Verification result codes returned from fp_verify_finger().">fp_verify_result</a> {
<a name="l00180"></a><a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a65da9e8c0d65ccafd126512d595b0974">00180</a> <a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a65da9e8c0d65ccafd126512d595b0974" title="The scan completed successfully, but the newly scanned fingerprint does not match the fingerprint bei...">FP_VERIFY_NO_MATCH</a> = 0,
<a name="l00184"></a><a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a5f86198b93e1ac93f26753f99a1acff4">00184</a> <a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a5f86198b93e1ac93f26753f99a1acff4" title="The scan completed successfully and the newly scanned fingerprint does match the fingerprint being ve...">FP_VERIFY_MATCH</a> = 1,
<a name="l00187"></a><a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a0acf6b5809cb4cc4e85f07bee1971293">00187</a> <a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a0acf6b5809cb4cc4e85f07bee1971293" title="The scan did not succeed due to poor scan quality or other general user scanning problem.">FP_VERIFY_RETRY</a> = FP_ENROLL_RETRY,
<a name="l00189"></a><a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898ad0aab2c3337e78ef7b400723108d4f30">00189</a> <a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898ad0aab2c3337e78ef7b400723108d4f30" title="The scan did not succeed because the finger swipe was too short.">FP_VERIFY_RETRY_TOO_SHORT</a> = FP_ENROLL_RETRY_TOO_SHORT,
<a name="l00192"></a><a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898ac1f395f79ec278d0014a6ae52d501e47">00192</a> <a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898ac1f395f79ec278d0014a6ae52d501e47" title="The scan did not succeed because the finger was not centered on the scanner.">FP_VERIFY_RETRY_CENTER_FINGER</a> = FP_ENROLL_RETRY_CENTER_FINGER,
<a name="l00195"></a><a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a12bae160415e9c059c52ea716586c01d">00195</a> <a class="code" href="group__dev.html#gga6945ffc512c323a40720b859445fd898a12bae160415e9c059c52ea716586c01d" title="The scan did not succeed due to quality or pressure problems; the user should remove their finger fro...">FP_VERIFY_RETRY_REMOVE_FINGER</a> = FP_ENROLL_RETRY_REMOVE_FINGER,
<a name="l00196"></a>00196 };
<a name="l00197"></a>00197
<a name="l00198"></a>00198 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#ga267c6b214779a7d1bfbc722b6094ef20" title="Performs a new scan and verify it against a previously enrolled print.">fp_verify_finger_img</a>(<span class="keyword">struct</span> fp_dev *dev,
<a name="l00199"></a>00199 <span class="keyword">struct</span> fp_print_data *enrolled_print, <span class="keyword">struct</span> fp_img **img);
<a name="l00200"></a>00200
<a name="l00211"></a><a class="code" href="group__dev.html#ga33a22bb0cd9460c911dd301dcdf4c929">00211</a> <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="group__dev.html#ga33a22bb0cd9460c911dd301dcdf4c929" title="Performs a new scan and verify it against a previously enrolled print.">fp_verify_finger</a>(<span class="keyword">struct</span> fp_dev *dev,
<a name="l00212"></a>00212 <span class="keyword">struct</span> fp_print_data *enrolled_print)
<a name="l00213"></a>00213 {
<a name="l00214"></a>00214 <span class="keywordflow">return</span> <a class="code" href="group__dev.html#ga267c6b214779a7d1bfbc722b6094ef20" title="Performs a new scan and verify it against a previously enrolled print.">fp_verify_finger_img</a>(dev, enrolled_print, NULL);
<a name="l00215"></a>00215 }
<a name="l00216"></a>00216
<a name="l00217"></a>00217 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gafe6fec65d8ff4c48eea11055c80f6785" title="Determines if a device is capable of identification through fp_identify_finger() and similar...">fp_dev_supports_identification</a>(<span class="keyword">struct</span> fp_dev *dev);
<a name="l00218"></a>00218 <span class="keywordtype">int</span> <a class="code" href="group__dev.html#ga65d5a34cf824ef2225f93a5742d2c2f6" title="Performs a new scan and attempts to identify the scanned finger against a collection of previously en...">fp_identify_finger_img</a>(<span class="keyword">struct</span> fp_dev *dev,
<a name="l00219"></a>00219 <span class="keyword">struct</span> fp_print_data **print_gallery, <span class="keywordtype">size_t</span> *match_offset,
<a name="l00220"></a>00220 <span class="keyword">struct</span> fp_img **img);
<a name="l00221"></a>00221
<a name="l00237"></a><a class="code" href="group__dev.html#gaca931eb81012e612b4546c63082a712b">00237</a> <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="group__dev.html#gaca931eb81012e612b4546c63082a712b" title="Performs a new scan and attempts to identify the scanned finger against a collection of previously en...">fp_identify_finger</a>(<span class="keyword">struct</span> fp_dev *dev,
<a name="l00238"></a>00238 <span class="keyword">struct</span> fp_print_data **print_gallery, <span class="keywordtype">size_t</span> *match_offset)
<a name="l00239"></a>00239 {
<a name="l00240"></a>00240 <span class="keywordflow">return</span> <a class="code" href="group__dev.html#ga65d5a34cf824ef2225f93a5742d2c2f6" title="Performs a new scan and attempts to identify the scanned finger against a collection of previously en...">fp_identify_finger_img</a>(dev, print_gallery, match_offset, NULL);
<a name="l00241"></a>00241 }
<a name="l00242"></a>00242
<a name="l00243"></a>00243 <span class="comment">/* Data handling */</span>
<a name="l00244"></a>00244 <span class="keywordtype">int</span> <a class="code" href="group__print__data.html#ga55244830b6ad7e4a04d184d95bc7e865" title="Loads a previously stored print from disk.">fp_print_data_load</a>(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">enum</span> <a class="code" href="group__print__data.html#ga5c6d4e10ca53fd0b61eaa4716f3985d5" title="Numeric codes used to refer to fingers (and thumbs) of a human.">fp_finger</a> finger,
<a name="l00245"></a>00245 <span class="keyword">struct</span> fp_print_data **data);
<a name="l00246"></a>00246 <span class="keywordtype">int</span> <a class="code" href="group__print__data.html#gab7d990f770aa6139ac84a688ae202382" title="Attempts to load a stored print based on a discovered print record.">fp_print_data_from_dscv_print</a>(<span class="keyword">struct</span> fp_dscv_print *print,
<a name="l00247"></a>00247 <span class="keyword">struct</span> fp_print_data **data);
<a name="l00248"></a>00248 <span class="keywordtype">int</span> <a class="code" href="group__print__data.html#ga98b1ba5a31560e8e9831cbe914268cc0" title="Saves a stored print to disk, assigned to a specific finger.">fp_print_data_save</a>(<span class="keyword">struct</span> fp_print_data *data, <span class="keyword">enum</span> <a class="code" href="group__print__data.html#ga5c6d4e10ca53fd0b61eaa4716f3985d5" title="Numeric codes used to refer to fingers (and thumbs) of a human.">fp_finger</a> finger);
<a name="l00249"></a>00249 <span class="keywordtype">int</span> <a class="code" href="group__print__data.html#gae7fd437d8bcd9026f7b3fa72068f6353" title="Removes a stored print from disk previously saved with fp_print_data_save().">fp_print_data_delete</a>(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">enum</span> <a class="code" href="group__print__data.html#ga5c6d4e10ca53fd0b61eaa4716f3985d5" title="Numeric codes used to refer to fingers (and thumbs) of a human.">fp_finger</a> finger);
<a name="l00250"></a>00250 <span class="keywordtype">void</span> <a class="code" href="group__print__data.html#ga196516e2967ba5f6244299a179fdb1b7" title="Frees a stored print.">fp_print_data_free</a>(<span class="keyword">struct</span> fp_print_data *data);
<a name="l00251"></a>00251 <span class="keywordtype">size_t</span> <a class="code" href="group__print__data.html#ga3e3d0244d35990e2019a70dd2dc24de0" title="Convert a stored print into a unified representation inside a data buffer.">fp_print_data_get_data</a>(<span class="keyword">struct</span> fp_print_data *data, <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> **ret);
<a name="l00252"></a>00252 <span class="keyword">struct </span>fp_print_data *<a class="code" href="group__print__data.html#gab5032f4f0d5e3e386ed7452c08c27562" title="Load a stored print from a data buffer.">fp_print_data_from_data</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *buf,
<a name="l00253"></a>00253 <span class="keywordtype">size_t</span> buflen);
<a name="l00254"></a>00254 uint16_t <a class="code" href="group__print__data.html#ga6160a7a0a909f7d263a22a0777550383" title="Gets the driver ID for a stored print.">fp_print_data_get_driver_id</a>(<span class="keyword">struct</span> fp_print_data *data);
<a name="l00255"></a>00255 uint32_t <a class="code" href="group__print__data.html#ga7aae2b0091ddb586a5e5bec9031a4969" title="Gets the devtype for a stored print.">fp_print_data_get_devtype</a>(<span class="keyword">struct</span> fp_print_data *data);
<a name="l00256"></a>00256
<a name="l00257"></a>00257 <span class="comment">/* Image handling */</span>
<a name="l00258"></a>00258
<a name="l00260"></a><a class="code" href="structfp__minutia.html">00260</a> <span class="keyword">struct </span><a class="code" href="structfp__minutia.html">fp_minutia</a> {
<a name="l00261"></a>00261 <span class="keywordtype">int</span> x;
<a name="l00262"></a>00262 <span class="keywordtype">int</span> y;
<a name="l00263"></a>00263 <span class="keywordtype">int</span> ex;
<a name="l00264"></a>00264 <span class="keywordtype">int</span> ey;
<a name="l00265"></a>00265 <span class="keywordtype">int</span> direction;
<a name="l00266"></a>00266 <span class="keywordtype">double</span> reliability;
<a name="l00267"></a>00267 <span class="keywordtype">int</span> type;
<a name="l00268"></a>00268 <span class="keywordtype">int</span> appearing;
<a name="l00269"></a>00269 <span class="keywordtype">int</span> feature_id;
<a name="l00270"></a>00270 <span class="keywordtype">int</span> *nbrs;
<a name="l00271"></a>00271 <span class="keywordtype">int</span> *ridge_counts;
<a name="l00272"></a>00272 <span class="keywordtype">int</span> num_nbrs;
<a name="l00273"></a>00273 };
<a name="l00274"></a>00274
<a name="l00275"></a>00275 <span class="keywordtype">int</span> <a class="code" href="group__img.html#ga243dd89512cf44189fd5a9a63da53153" title="Gets the pixel height of an image.">fp_img_get_height</a>(<span class="keyword">struct</span> fp_img *img);
<a name="l00276"></a>00276 <span class="keywordtype">int</span> <a class="code" href="group__img.html#ga8481ce980f6cd9ed3c22e407f342a039" title="Gets the pixel width of an image.">fp_img_get_width</a>(<span class="keyword">struct</span> fp_img *img);
<a name="l00277"></a>00277 <span class="keywordtype">unsigned</span> <span class="keywordtype">char</span> *<a class="code" href="group__img.html#ga29904671177c5860af01a98dda91c8d6" title="Gets the greyscale data for an image.">fp_img_get_data</a>(<span class="keyword">struct</span> fp_img *img);
<a name="l00278"></a>00278 <span class="keywordtype">int</span> <a class="code" href="group__img.html#ga42878cabc584c56a5f225d5340319dfa" title="A quick convenience function to save an image to a file in PGM format.">fp_img_save_to_file</a>(<span class="keyword">struct</span> fp_img *img, <span class="keywordtype">char</span> *path);
<a name="l00279"></a>00279 <span class="keywordtype">void</span> <a class="code" href="group__img.html#ga4b3b9e9043c3534b31622723f9e32a85" title="Standardizes an image by normalizing its orientation, colors, etc.">fp_img_standardize</a>(<span class="keyword">struct</span> fp_img *img);
<a name="l00280"></a>00280 <span class="keyword">struct </span>fp_img *<a class="code" href="group__img.html#ga4c4515b326b9893b9c3dc87c6c4e30d8" title="Get a binarized form of a standardized scanned image.">fp_img_binarize</a>(<span class="keyword">struct</span> fp_img *img);
<a name="l00281"></a>00281 <span class="keyword">struct </span><a class="code" href="structfp__minutia.html">fp_minutia</a> **<a class="code" href="group__img.html#gab45fcd7736793a56a8be9d78a6267796" title="Get a list of minutiae detected in an image.">fp_img_get_minutiae</a>(<span class="keyword">struct</span> fp_img *img, <span class="keywordtype">int</span> *nr_minutiae);
<a name="l00282"></a>00282 <span class="keywordtype">void</span> <a class="code" href="group__img.html#ga18dcdd8c27abc8980e4fb9775e84da35" title="Frees an image.">fp_img_free</a>(<span class="keyword">struct</span> fp_img *img);
<a name="l00283"></a>00283
<a name="l00284"></a>00284 <span class="comment">/* Polling and timing */</span>
<a name="l00285"></a>00285
<a name="l00286"></a><a class="code" href="structfp__pollfd.html">00286</a> <span class="keyword">struct </span><a class="code" href="structfp__pollfd.html">fp_pollfd</a> {
<a name="l00287"></a>00287 <span class="keywordtype">int</span> fd;
<a name="l00288"></a>00288 <span class="keywordtype">short</span> events;
<a name="l00289"></a>00289 };
<a name="l00290"></a>00290
<a name="l00291"></a>00291 <span class="keywordtype">int</span> <a class="code" href="group__poll.html#ga1bcfb2aa35f80831c8f83cbf37c16c59" title="Handle any pending events.">fp_handle_events_timeout</a>(<span class="keyword">struct</span> timeval *timeout);
<a name="l00292"></a>00292 <span class="keywordtype">int</span> <a class="code" href="group__poll.html#gac90ddc168b563df89954f0cabf9f298e" title="Convenience function for calling fp_handle_events_timeout() with a sensible default timeout value of ...">fp_handle_events</a>(<span class="keywordtype">void</span>);
<a name="l00293"></a>00293 <span class="keywordtype">size_t</span> <a class="code" href="group__poll.html#gac7aa1c4d7dc0b3bc6704c76202823d1f" title="Retrieve a list of file descriptors that should be polled for events interesting to libfprint...">fp_get_pollfds</a>(<span class="keyword">struct</span> <a class="code" href="structfp__pollfd.html">fp_pollfd</a> **pollfds);
<a name="l00294"></a>00294 <span class="keywordtype">int</span> fp_get_next_timeout(<span class="keyword">struct</span> timeval *tv);
<a name="l00295"></a>00295
<a name="l00296"></a>00296 <span class="keyword">typedef</span> void (*fp_pollfd_added_cb)(<span class="keywordtype">int</span> fd, <span class="keywordtype">short</span> events);
<a name="l00297"></a>00297 <span class="keyword">typedef</span> void (*fp_pollfd_removed_cb)(<span class="keywordtype">int</span> fd);
<a name="l00298"></a>00298 <span class="keywordtype">void</span> fp_set_pollfd_notifiers(fp_pollfd_added_cb added_cb,
<a name="l00299"></a>00299 fp_pollfd_removed_cb removed_cb);
<a name="l00300"></a>00300
<a name="l00301"></a>00301 <span class="comment">/* Library */</span>
<a name="l00302"></a>00302 <span class="keywordtype">int</span> <a class="code" href="group__core.html#ga5772cdd0a4354e2b53b18a02ce523ddc" title="Initialise libfprint.">fp_init</a>(<span class="keywordtype">void</span>);
<a name="l00303"></a>00303 <span class="keywordtype">void</span> <a class="code" href="group__core.html#ga47011a58c8a38aa51b329640765815b1" title="Deinitialise libfprint.">fp_exit</a>(<span class="keywordtype">void</span>);
<a name="l00304"></a>00304 <span class="keywordtype">void</span> <a class="code" href="group__core.html#ga6ca82e6e91d1b8ff4806f1955006842a" title="Set message verbosity.">fp_set_debug</a>(<span class="keywordtype">int</span> level);
<a name="l00305"></a>00305
<a name="l00306"></a>00306 <span class="comment">/* Asynchronous I/O */</span>
<a name="l00307"></a>00307
<a name="l00308"></a>00308 <span class="keyword">typedef</span> void (*fp_dev_open_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">int</span> status, <span class="keywordtype">void</span> *user_data);
<a name="l00309"></a>00309 <span class="keywordtype">int</span> fp_async_dev_open(<span class="keyword">struct</span> fp_dscv_dev *ddev, fp_dev_open_cb callback,
<a name="l00310"></a>00310 <span class="keywordtype">void</span> *user_data);
<a name="l00311"></a>00311
<a name="l00312"></a>00312 <span class="keyword">typedef</span> void (*fp_dev_close_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">void</span> *user_data);
<a name="l00313"></a>00313 <span class="keywordtype">void</span> fp_async_dev_close(<span class="keyword">struct</span> fp_dev *dev, fp_dev_close_cb callback,
<a name="l00314"></a>00314 <span class="keywordtype">void</span> *user_data);
<a name="l00315"></a>00315
<a name="l00316"></a>00316 <span class="keyword">typedef</span> void (*fp_enroll_stage_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">int</span> result,
<a name="l00317"></a>00317 <span class="keyword">struct </span>fp_print_data *print, <span class="keyword">struct </span>fp_img *img, <span class="keywordtype">void</span> *user_data);
<a name="l00318"></a>00318 <span class="keywordtype">int</span> fp_async_enroll_start(<span class="keyword">struct</span> fp_dev *dev, fp_enroll_stage_cb callback,
<a name="l00319"></a>00319 <span class="keywordtype">void</span> *user_data);
<a name="l00320"></a>00320
<a name="l00321"></a>00321 <span class="keyword">typedef</span> void (*fp_enroll_stop_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">void</span> *user_data);
<a name="l00322"></a>00322 <span class="keywordtype">int</span> fp_async_enroll_stop(<span class="keyword">struct</span> fp_dev *dev, fp_enroll_stop_cb callback,
<a name="l00323"></a>00323 <span class="keywordtype">void</span> *user_data);
<a name="l00324"></a>00324
<a name="l00325"></a>00325 <span class="keyword">typedef</span> void (*fp_verify_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">int</span> result,
<a name="l00326"></a>00326 <span class="keyword">struct </span>fp_img *img, <span class="keywordtype">void</span> *user_data);
<a name="l00327"></a>00327 <span class="keywordtype">int</span> fp_async_verify_start(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">struct</span> fp_print_data *data,
<a name="l00328"></a>00328 fp_verify_cb callback, <span class="keywordtype">void</span> *user_data);
<a name="l00329"></a>00329
<a name="l00330"></a>00330 <span class="keyword">typedef</span> void (*fp_verify_stop_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">void</span> *user_data);
<a name="l00331"></a>00331 <span class="keywordtype">int</span> fp_async_verify_stop(<span class="keyword">struct</span> fp_dev *dev, fp_verify_stop_cb callback,
<a name="l00332"></a>00332 <span class="keywordtype">void</span> *user_data);
<a name="l00333"></a>00333
<a name="l00334"></a>00334 <span class="keyword">typedef</span> void (*fp_identify_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">int</span> result,
<a name="l00335"></a>00335 <span class="keywordtype">size_t</span> match_offset, <span class="keyword">struct </span>fp_img *img, <span class="keywordtype">void</span> *user_data);
<a name="l00336"></a>00336 <span class="keywordtype">int</span> fp_async_identify_start(<span class="keyword">struct</span> fp_dev *dev, <span class="keyword">struct</span> fp_print_data **gallery,
<a name="l00337"></a>00337 fp_identify_cb callback, <span class="keywordtype">void</span> *user_data);
<a name="l00338"></a>00338
<a name="l00339"></a>00339 <span class="keyword">typedef</span> void (*fp_identify_stop_cb)(<span class="keyword">struct </span>fp_dev *dev, <span class="keywordtype">void</span> *user_data);
<a name="l00340"></a>00340 <span class="keywordtype">int</span> fp_async_identify_stop(<span class="keyword">struct</span> fp_dev *dev, fp_identify_stop_cb callback,
<a name="l00341"></a>00341 <span class="keywordtype">void</span> *user_data);
<a name="l00342"></a>00342
<a name="l00343"></a>00343 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00344"></a>00344 <span class="preprocessor"></span>}
<a name="l00345"></a>00345 <span class="preprocessor">#endif</span>
<a name="l00346"></a>00346 <span class="preprocessor"></span>
<a name="l00347"></a>00347 <span class="preprocessor">#endif</span>
<a name="l00348"></a>00348 <span class="preprocessor"></span>
</pre></div></div>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Wed Sep 8 2010 for libfprint by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
36c3913465aa447b7a02f02786061291
>
files
>
16
