mirror of
				https://github.com/bspeice/libcvautomation
				synced 2025-11-04 02:10:35 -05:00 
			
		
		
		
	Release version 1.1 Documentation
This commit is contained in:
		
							
								
								
									
										294
									
								
								cva-match_8c-source.html
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										294
									
								
								cva-match_8c-source.html
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,294 @@
 | 
			
		||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 | 
			
		||||
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
 | 
			
		||||
<title>libcvautomation: cva-match.c Source File</title>
 | 
			
		||||
<link href="doxygen.css" rel="stylesheet" type="text/css">
 | 
			
		||||
<link href="tabs.css" rel="stylesheet" type="text/css">
 | 
			
		||||
</head><body>
 | 
			
		||||
<!-- Generated by Doxygen 1.4.7 -->
 | 
			
		||||
<div class="tabs">
 | 
			
		||||
  <ul>
 | 
			
		||||
    <li><a href="index.html"><span>Main Page</span></a></li>
 | 
			
		||||
    <li><a href="annotated.html"><span>Classes</span></a></li>
 | 
			
		||||
    <li id="current"><a href="files.html"><span>Files</span></a></li>
 | 
			
		||||
    <li><a href="pages.html"><span>Related Pages</span></a></li>
 | 
			
		||||
    <li>
 | 
			
		||||
      <form action="search.php" method="get">
 | 
			
		||||
        <table cellspacing="0" cellpadding="0" border="0">
 | 
			
		||||
          <tr>
 | 
			
		||||
            <td><label> <u>S</u>earch for </label></td>
 | 
			
		||||
            <td><input type="text" name="query" value="" size="20" accesskey="s"/></td>
 | 
			
		||||
          </tr>
 | 
			
		||||
        </table>
 | 
			
		||||
      </form>
 | 
			
		||||
    </li>
 | 
			
		||||
  </ul></div>
 | 
			
		||||
<div class="tabs">
 | 
			
		||||
  <ul>
 | 
			
		||||
    <li><a href="files.html"><span>File List</span></a></li>
 | 
			
		||||
    <li><a href="globals.html"><span>File Members</span></a></li>
 | 
			
		||||
  </ul></div>
 | 
			
		||||
<h1>cva-match.c</h1><a href="cva-match_8c.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
 | 
			
		||||
<a name="l00002"></a>00002 <span class="comment"> * =====================================================================================</span>
 | 
			
		||||
<a name="l00003"></a>00003 <span class="comment"> *</span>
 | 
			
		||||
<a name="l00004"></a>00004 <span class="comment"> *       Filename:  cva-match.c</span>
 | 
			
		||||
<a name="l00005"></a>00005 <span class="comment"> *</span>
 | 
			
		||||
<a name="l00006"></a>00006 <span class="comment"> *    Description:  Match an image to its parent image, and return the coordinates</span>
 | 
			
		||||
<a name="l00007"></a>00007 <span class="comment"> *</span>
 | 
			
		||||
<a name="l00008"></a>00008 <span class="comment"> *        Version:  0.1</span>
 | 
			
		||||
<a name="l00009"></a>00009 <span class="comment"> *        Created:  06/20/2012</span>
 | 
			
		||||
<a name="l00010"></a>00010 <span class="comment"> *       Revision:  none</span>
 | 
			
		||||
<a name="l00011"></a>00011 <span class="comment"> *       Compiler:  gcc</span>
 | 
			
		||||
<a name="l00012"></a>00012 <span class="comment"> *</span>
 | 
			
		||||
<a name="l00013"></a>00013 <span class="comment"> *         Author:  Bradlee Speice, bspeice@uncc.edu</span>
 | 
			
		||||
<a name="l00014"></a>00014 <span class="comment"> *   Organization:  MOSAIC at University of North Carolina at Charlotte</span>
 | 
			
		||||
<a name="l00015"></a>00015 <span class="comment"> *</span>
 | 
			
		||||
<a name="l00016"></a>00016 <span class="comment"> * =====================================================================================</span>
 | 
			
		||||
<a name="l00017"></a>00017 <span class="comment"> */</span>
 | 
			
		||||
<a name="l00018"></a>00018 <span class="preprocessor">#include <stdlib.h></span>
 | 
			
		||||
<a name="l00019"></a>00019 <span class="preprocessor">#include <stdio.h></span>
 | 
			
		||||
<a name="l00020"></a>00020 <span class="preprocessor">#include <unistd.h></span>
 | 
			
		||||
<a name="l00021"></a>00021 <span class="preprocessor">#include <getopt.h></span>
 | 
			
		||||
<a name="l00022"></a>00022 <span class="preprocessor">#include <limits.h></span>
 | 
			
		||||
<a name="l00023"></a>00023 
 | 
			
		||||
<a name="l00024"></a>00024 <span class="preprocessor">#include <<a class="code" href="libcvautomation_8h.html">libcvautomation/libcvautomation.h</a>></span>
 | 
			
		||||
<a name="l00025"></a>00025 
 | 
			
		||||
<a name="l00026"></a>00026 <span class="keywordtype">void</span> <a class="code" href="cva-input_8c.html#76233dfb0e07a4db25a86e8688302693">usage</a> ();
 | 
			
		||||
<a name="l00027"></a>00027 
 | 
			
		||||
<a name="l00028"></a><a class="code" href="structlist.html">00028</a> <span class="keyword">struct </span><a class="code" href="structlist.html">list</a> {
 | 
			
		||||
<a name="l00029"></a><a class="code" href="structlist.html#ed82c7e1f3c98f1c527884c60e88ac06">00029</a>     <span class="keywordtype">char</span> *<a class="code" href="structlist.html#ed82c7e1f3c98f1c527884c60e88ac06">fileName</a>;
 | 
			
		||||
<a name="l00030"></a><a class="code" href="structlist.html#17ba8e20337279fa9dfa74ac99c21bc1">00030</a>     <span class="keyword">struct </span><a class="code" href="structlist.html">list</a> *<a class="code" href="structlist.html#17ba8e20337279fa9dfa74ac99c21bc1">next</a>;
 | 
			
		||||
<a name="l00031"></a>00031 };
 | 
			
		||||
<a name="l00032"></a>00032 
 | 
			
		||||
<a name="l00033"></a><a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">00033</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structlist.html">list</a> <a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">basic_list</a>; 
 | 
			
		||||
<a name="l00034"></a>00034 
 | 
			
		||||
<a name="l00035"></a><a class="code" href="cva-match_8c.html#24e6ce6d053864cf5fb7af941457bb0e">00035</a> <span class="keywordtype">int</span> <a class="code" href="cva-input_8c.html#24e6ce6d053864cf5fb7af941457bb0e">main</a>( <span class="keywordtype">int</span> argc, <span class="keywordtype">char</span>** argv )
 | 
			
		||||
<a name="l00036"></a>00036 {
 | 
			
		||||
<a name="l00037"></a>00037     CvPoint result_point;
 | 
			
		||||
<a name="l00038"></a>00038     result_point.x = result_point.y = 0;
 | 
			
		||||
<a name="l00039"></a>00039 
 | 
			
		||||
<a name="l00040"></a>00040     <span class="comment">/* Set up everything for getopt */</span>
 | 
			
		||||
<a name="l00041"></a>00041     <span class="keywordtype">char</span> *separator = <span class="stringliteral">","</span>;
 | 
			
		||||
<a name="l00042"></a>00042     <span class="keywordtype">char</span> *root_location = <span class="stringliteral">"root.png"</span>;
 | 
			
		||||
<a name="l00043"></a>00043     <span class="keywordtype">char</span> *sub_location = <span class="stringliteral">"sub.png"</span>;
 | 
			
		||||
<a name="l00044"></a>00044     <span class="keywordtype">int</span> tolerance = INT_MAX;
 | 
			
		||||
<a name="l00045"></a>00045     <span class="keywordtype">int</span> search_method = CV_TM_SQDIFF;
 | 
			
		||||
<a name="l00046"></a>00046     <span class="keywordtype">int</span> useX = 0; <span class="comment">/* bool useX = false; */</span>
 | 
			
		||||
<a name="l00047"></a>00047     <span class="keywordtype">int</span> useCenter = 0;
 | 
			
		||||
<a name="l00048"></a>00048     <span class="keywordtype">char</span> *xDisplayLocation;
 | 
			
		||||
<a name="l00049"></a>00049     Display *display;
 | 
			
		||||
<a name="l00050"></a>00050     <span class="comment">/* This line to suppress a compiler warning */</span>
 | 
			
		||||
<a name="l00051"></a>00051     display = NULL;
 | 
			
		||||
<a name="l00052"></a>00052 
 | 
			
		||||
<a name="l00053"></a>00053     <span class="comment">/* Set the default display */</span>
 | 
			
		||||
<a name="l00054"></a>00054     xDisplayLocation = <span class="stringliteral">""</span>;
 | 
			
		||||
<a name="l00055"></a>00055 
 | 
			
		||||
<a name="l00056"></a>00056     <span class="comment">/* Set up the linked list for slave images */</span>
 | 
			
		||||
<a name="l00057"></a>00057     <a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">basic_list</a> *list_head = NULL, *list_curr = NULL, *list_prev = NULL;
 | 
			
		||||
<a name="l00058"></a>00058 
 | 
			
		||||
<a name="l00059"></a>00059     <span class="comment">/* Start getopt */</span>
 | 
			
		||||
<a name="l00060"></a>00060     <span class="keywordflow">while</span> (1)
 | 
			
		||||
<a name="l00061"></a>00061     {
 | 
			
		||||
<a name="l00062"></a>00062         <span class="keyword">static</span> <span class="keyword">struct </span>option long_options[] =
 | 
			
		||||
<a name="l00063"></a>00063         {
 | 
			
		||||
<a name="l00064"></a>00064                 {<span class="stringliteral">"help"</span>,        no_argument,        0,  <span class="charliteral">'h'</span>},
 | 
			
		||||
<a name="l00065"></a>00065                 {<span class="stringliteral">"usage"</span>,       no_argument,        0,  <span class="charliteral">'u'</span>},
 | 
			
		||||
<a name="l00066"></a>00066                 {<span class="stringliteral">"version"</span>,     no_argument,        0,  <span class="charliteral">'v'</span>},
 | 
			
		||||
<a name="l00067"></a>00067                 {<span class="stringliteral">"root-image"</span>,  required_argument,  0,  <span class="charliteral">'r'</span>},
 | 
			
		||||
<a name="l00068"></a>00068                 {<span class="stringliteral">"sub-image"</span>,   required_argument,  0,  <span class="charliteral">'s'</span>},
 | 
			
		||||
<a name="l00069"></a>00069                 {<span class="stringliteral">"separator"</span>,   required_argument,  0,  <span class="charliteral">'p'</span>},
 | 
			
		||||
<a name="l00070"></a>00070                 {<span class="stringliteral">"search-method"</span>,required_argument, 0,  <span class="charliteral">'m'</span>},
 | 
			
		||||
<a name="l00071"></a>00071                 {<span class="stringliteral">"tolerance"</span>,   required_argument,  0,  <span class="charliteral">'t'</span>},
 | 
			
		||||
<a name="l00072"></a>00072                 {<span class="stringliteral">"x-root"</span>,      optional_argument,  0,  <span class="charliteral">'x'</span>},
 | 
			
		||||
<a name="l00073"></a>00073                 {<span class="stringliteral">"center"</span>,      no_argument,        0,  <span class="charliteral">'c'</span>},
 | 
			
		||||
<a name="l00074"></a>00074                 {<span class="stringliteral">"sane-tolerance"</span>, required_argument, 0, <span class="charliteral">'o'</span>},
 | 
			
		||||
<a name="l00075"></a>00075                 {0, 0, 0, 0}
 | 
			
		||||
<a name="l00076"></a>00076         };
 | 
			
		||||
<a name="l00077"></a>00077 
 | 
			
		||||
<a name="l00078"></a>00078         <span class="keywordtype">int</span> option_index = 0;
 | 
			
		||||
<a name="l00079"></a>00079         opterr = 0;
 | 
			
		||||
<a name="l00080"></a>00080 
 | 
			
		||||
<a name="l00081"></a>00081         <span class="keywordtype">int</span> c = getopt_long (argc, argv, <span class="stringliteral">"hur:s:p:m:t:x::c"</span>,
 | 
			
		||||
<a name="l00082"></a>00082                             long_options, &option_index);
 | 
			
		||||
<a name="l00083"></a>00083 
 | 
			
		||||
<a name="l00084"></a>00084         <span class="comment">/* We're done with parsing options */</span>
 | 
			
		||||
<a name="l00085"></a>00085         <span class="keywordflow">if</span> (c == -1)
 | 
			
		||||
<a name="l00086"></a>00086             <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00087"></a>00087 
 | 
			
		||||
<a name="l00088"></a>00088         <span class="keywordflow">switch</span> (c)
 | 
			
		||||
<a name="l00089"></a>00089         {
 | 
			
		||||
<a name="l00090"></a>00090             <span class="keywordflow">case</span> 0:
 | 
			
		||||
<a name="l00091"></a>00091                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00092"></a>00092 
 | 
			
		||||
<a name="l00093"></a>00093             <span class="keywordflow">case</span> <span class="charliteral">'h'</span>:
 | 
			
		||||
<a name="l00094"></a>00094                 <a class="code" href="cva-input_8c.html#76233dfb0e07a4db25a86e8688302693">usage</a>();
 | 
			
		||||
<a name="l00095"></a>00095                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00096"></a>00096 
 | 
			
		||||
<a name="l00097"></a>00097             <span class="keywordflow">case</span> <span class="charliteral">'u'</span>:
 | 
			
		||||
<a name="l00098"></a>00098                 <a class="code" href="cva-input_8c.html#76233dfb0e07a4db25a86e8688302693">usage</a>();
 | 
			
		||||
<a name="l00099"></a>00099                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00100"></a>00100 
 | 
			
		||||
<a name="l00101"></a>00101             <span class="keywordflow">case</span> <span class="charliteral">'v'</span>:
 | 
			
		||||
<a name="l00102"></a>00102                 <a class="code" href="cva-input_8c.html#76233dfb0e07a4db25a86e8688302693">usage</a>();
 | 
			
		||||
<a name="l00103"></a>00103                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00104"></a>00104 
 | 
			
		||||
<a name="l00105"></a>00105             <span class="keywordflow">case</span> <span class="charliteral">'r'</span>:
 | 
			
		||||
<a name="l00106"></a>00106                 root_location = optarg;
 | 
			
		||||
<a name="l00107"></a>00107                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00108"></a>00108 
 | 
			
		||||
<a name="l00109"></a>00109             <span class="keywordflow">case</span> <span class="charliteral">'s'</span>:
 | 
			
		||||
<a name="l00110"></a>00110                 <span class="keywordflow">if</span> ( list_head == NULL )
 | 
			
		||||
<a name="l00111"></a>00111                 {
 | 
			
		||||
<a name="l00112"></a>00112                     list_head = (<a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">basic_list</a> *) malloc (<span class="keyword">sizeof</span>(<a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">basic_list</a>));
 | 
			
		||||
<a name="l00113"></a>00113                     list_curr = list_head;
 | 
			
		||||
<a name="l00114"></a>00114                 }
 | 
			
		||||
<a name="l00115"></a>00115                 list_curr-><a class="code" href="structlist.html#ed82c7e1f3c98f1c527884c60e88ac06">fileName</a> = optarg;
 | 
			
		||||
<a name="l00116"></a>00116                 list_curr->next = (<a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">basic_list</a> *) malloc (<span class="keyword">sizeof</span>(<a class="code" href="cva-match_8c.html#13f238c775b8e32baf4b94d638a11d6f">basic_list</a>));
 | 
			
		||||
<a name="l00117"></a>00117                 list_curr = list_curr->next;
 | 
			
		||||
<a name="l00118"></a>00118                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00119"></a>00119 
 | 
			
		||||
<a name="l00120"></a>00120             <span class="keywordflow">case</span> <span class="charliteral">'p'</span>:
 | 
			
		||||
<a name="l00121"></a>00121                 separator = optarg;
 | 
			
		||||
<a name="l00122"></a>00122                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00123"></a>00123 
 | 
			
		||||
<a name="l00124"></a>00124             <span class="keywordflow">case</span> <span class="charliteral">'m'</span>:
 | 
			
		||||
<a name="l00125"></a>00125                 search_method = atoi(optarg);
 | 
			
		||||
<a name="l00126"></a>00126                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00127"></a>00127 
 | 
			
		||||
<a name="l00128"></a>00128             <span class="keywordflow">case</span> <span class="charliteral">'t'</span>:
 | 
			
		||||
<a name="l00129"></a>00129                 tolerance = atoi(optarg);
 | 
			
		||||
<a name="l00130"></a>00130                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00131"></a>00131 
 | 
			
		||||
<a name="l00132"></a>00132             <span class="keywordflow">case</span> <span class="charliteral">'x'</span>:
 | 
			
		||||
<a name="l00133"></a>00133                 <span class="keywordflow">if</span> ( optarg != NULL ) {
 | 
			
		||||
<a name="l00134"></a>00134                     useX = 1;
 | 
			
		||||
<a name="l00135"></a>00135                     xDisplayLocation = optarg;
 | 
			
		||||
<a name="l00136"></a>00136                     display = XOpenDisplay(xDisplayLocation);
 | 
			
		||||
<a name="l00137"></a>00137                 } <span class="keywordflow">else</span> {
 | 
			
		||||
<a name="l00138"></a>00138                     useX = 1;
 | 
			
		||||
<a name="l00139"></a>00139                     xDisplayLocation = <span class="stringliteral">""</span>;
 | 
			
		||||
<a name="l00140"></a>00140                     display = XOpenDisplay(xDisplayLocation);
 | 
			
		||||
<a name="l00141"></a>00141                 }
 | 
			
		||||
<a name="l00142"></a>00142                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00143"></a>00143 
 | 
			
		||||
<a name="l00144"></a>00144             <span class="keywordflow">case</span> <span class="charliteral">'c'</span>:
 | 
			
		||||
<a name="l00145"></a>00145                 useCenter = 1;
 | 
			
		||||
<a name="l00146"></a>00146 
 | 
			
		||||
<a name="l00147"></a>00147             <span class="keywordflow">case</span> <span class="charliteral">'o'</span>:
 | 
			
		||||
<a name="l00148"></a>00148                 tolerance = atoi(optarg);
 | 
			
		||||
<a name="l00149"></a>00149                 <span class="comment">/* Provide a more sane way to configure tolerance:</span>
 | 
			
		||||
<a name="l00150"></a>00150 <span class="comment">                 * --sane-tolerance=100 ~= INT_MAX */</span>
 | 
			
		||||
<a name="l00151"></a>00151                 tolerance = pow(1.2397076, tolerance);
 | 
			
		||||
<a name="l00152"></a>00152                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00153"></a>00153 
 | 
			
		||||
<a name="l00154"></a>00154             <span class="keywordflow">case</span> <span class="charliteral">'?'</span>:
 | 
			
		||||
<a name="l00155"></a>00155                 <span class="comment">/* Error routine */</span>
 | 
			
		||||
<a name="l00156"></a>00156                 <span class="keywordflow">break</span>;
 | 
			
		||||
<a name="l00157"></a>00157 
 | 
			
		||||
<a name="l00158"></a>00158             <span class="keywordflow">default</span>:
 | 
			
		||||
<a name="l00159"></a>00159                 fprintf( stderr, <span class="stringliteral">"Unknown option..."</span> );
 | 
			
		||||
<a name="l00160"></a>00160                 exit(0);
 | 
			
		||||
<a name="l00161"></a>00161         };
 | 
			
		||||
<a name="l00162"></a>00162     }
 | 
			
		||||
<a name="l00163"></a>00163 
 | 
			
		||||
<a name="l00164"></a>00164     <span class="comment">/* Make sure we have a linked list, </span>
 | 
			
		||||
<a name="l00165"></a>00165 <span class="comment">     * and reset the linked list to go back through from the top */</span>
 | 
			
		||||
<a name="l00166"></a>00166     <span class="keywordflow">if</span> ( list_head == NULL )
 | 
			
		||||
<a name="l00167"></a>00167         <span class="keywordflow">return</span> 1;
 | 
			
		||||
<a name="l00168"></a>00168     <span class="keywordflow">else</span>
 | 
			
		||||
<a name="l00169"></a>00169         list_curr = list_head;
 | 
			
		||||
<a name="l00170"></a>00170 
 | 
			
		||||
<a name="l00171"></a>00171     <span class="keywordflow">do</span>
 | 
			
		||||
<a name="l00172"></a>00172     {
 | 
			
		||||
<a name="l00173"></a>00173         sub_location = list_curr-><a class="code" href="structlist.html#ed82c7e1f3c98f1c527884c60e88ac06">fileName</a>;
 | 
			
		||||
<a name="l00174"></a>00174 
 | 
			
		||||
<a name="l00175"></a>00175         <span class="keywordflow">if</span> (useX && useCenter)
 | 
			
		||||
<a name="l00176"></a>00176             result_point = <a class="code" href="libcvautomation-xlib_8h.html#b441627acd22889f404d89c9cc4809f5">matchSubImage_X11_location_center</a>( display, sub_location, search_method, tolerance );
 | 
			
		||||
<a name="l00177"></a>00177         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (useX && !useCenter)
 | 
			
		||||
<a name="l00178"></a>00178             result_point = <a class="code" href="libcvautomation-xlib_8h.html#d238842448af81c09f56d1d54253c1b5">matchSubImage_X11_location</a>( display, sub_location, search_method, tolerance );
 | 
			
		||||
<a name="l00179"></a>00179         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!useX && useCenter)
 | 
			
		||||
<a name="l00180"></a>00180             result_point = <a class="code" href="libcvautomation-opencv_8h.html#bed7c891adb272993912d973c0e08c27">matchSubImage_location_center</a>( root_location, sub_location, search_method, tolerance );
 | 
			
		||||
<a name="l00181"></a>00181         <span class="keywordflow">else</span> <span class="comment">/* if (!useX && !useCenter) */</span>
 | 
			
		||||
<a name="l00182"></a>00182             result_point = <a class="code" href="libcvautomation-opencv_8h.html#c0d3066da6b2d42251c876d12a7158c7">matchSubImage_location</a>( root_location, sub_location, search_method, tolerance );
 | 
			
		||||
<a name="l00183"></a>00183 
 | 
			
		||||
<a name="l00184"></a>00184         <span class="keywordflow">if</span> ( result_point.x != -1 && result_point.y != -1 )
 | 
			
		||||
<a name="l00185"></a>00185             <span class="comment">/* Output the match location */</span>
 | 
			
		||||
<a name="l00186"></a>00186             printf (<span class="stringliteral">"%s%s%i%s%i\n"</span>, list_curr->fileName, separator,
 | 
			
		||||
<a name="l00187"></a>00187                     result_point.x, separator, result_point.y );
 | 
			
		||||
<a name="l00188"></a>00188 
 | 
			
		||||
<a name="l00189"></a>00189         <span class="comment">/* With the way we allocate the list, we ensure that we always</span>
 | 
			
		||||
<a name="l00190"></a>00190 <span class="comment">         * have at least one element past the end of the list.</span>
 | 
			
		||||
<a name="l00191"></a>00191 <span class="comment">         * Also, deconstruct the list as we go. */</span>
 | 
			
		||||
<a name="l00192"></a>00192         list_prev = list_curr;
 | 
			
		||||
<a name="l00193"></a>00193         list_curr = list_curr->next;
 | 
			
		||||
<a name="l00194"></a>00194         free(list_prev);
 | 
			
		||||
<a name="l00195"></a>00195 
 | 
			
		||||
<a name="l00196"></a>00196     } <span class="keywordflow">while</span> ( list_curr->fileName != NULL );
 | 
			
		||||
<a name="l00197"></a>00197 
 | 
			
		||||
<a name="l00198"></a>00198     <span class="comment">/* And free the final element */</span>
 | 
			
		||||
<a name="l00199"></a>00199     free(list_curr);
 | 
			
		||||
<a name="l00200"></a>00200 
 | 
			
		||||
<a name="l00201"></a>00201     <span class="comment">/* Clean up X */</span>
 | 
			
		||||
<a name="l00202"></a>00202     <span class="keywordflow">if</span> (useX)
 | 
			
		||||
<a name="l00203"></a>00203         XCloseDisplay(display);
 | 
			
		||||
<a name="l00204"></a>00204 
 | 
			
		||||
<a name="l00205"></a>00205     <span class="keywordflow">return</span> 0;
 | 
			
		||||
<a name="l00206"></a>00206 }
 | 
			
		||||
<a name="l00207"></a>00207 
 | 
			
		||||
<a name="l00208"></a>00208 <span class="comment">/* </span>
 | 
			
		||||
<a name="l00209"></a>00209 <span class="comment"> * ===  FUNCTION  ======================================================================</span>
 | 
			
		||||
<a name="l00210"></a>00210 <span class="comment"> *         Name:  usage</span>
 | 
			
		||||
<a name="l00211"></a>00211 <span class="comment"> *  Description:  I really shouldn't need to write this</span>
 | 
			
		||||
<a name="l00212"></a>00212 <span class="comment"> * =====================================================================================</span>
 | 
			
		||||
<a name="l00213"></a>00213 <span class="comment"> */</span>
 | 
			
		||||
<a name="l00214"></a>00214 <span class="keywordtype">void</span> <a class="code" href="cva-input_8c.html#76233dfb0e07a4db25a86e8688302693">usage</a> ( )
 | 
			
		||||
<a name="l00215"></a>00215 {
 | 
			
		||||
<a name="l00216"></a>00216     fprintf( stderr, <span class="stringliteral">"\</span>
 | 
			
		||||
<a name="l00217"></a>00217 <span class="stringliteral">Libcvautomation version: %s\n\</span>
 | 
			
		||||
<a name="l00218"></a>00218 <span class="stringliteral">cva-match -r <root_image> -s <sub_image> \n\</span>
 | 
			
		||||
<a name="l00219"></a>00219 <span class="stringliteral">cva-match -s <sub_image> -x \n\</span>
 | 
			
		||||
<a name="l00220"></a>00220 <span class="stringliteral">\n\</span>
 | 
			
		||||
<a name="l00221"></a>00221 <span class="stringliteral">This program uses OpenCV in order to recognize an image within an image.\n\</span>
 | 
			
		||||
<a name="l00222"></a>00222 <span class="stringliteral">The return code is how many matches were found - return 0 for no matches,\n\</span>
 | 
			
		||||
<a name="l00223"></a>00223 <span class="stringliteral">1 for one match, etc.\n\</span>
 | 
			
		||||
<a name="l00224"></a>00224 <span class="stringliteral">\n\</span>
 | 
			
		||||
<a name="l00225"></a>00225 <span class="stringliteral">Usage: \n\</span>
 | 
			
		||||
<a name="l00226"></a>00226 <span class="stringliteral">\n\</span>
 | 
			
		||||
<a name="l00227"></a>00227 <span class="stringliteral">\t-h, --help:\t\tDisplay this usage message.\n\</span>
 | 
			
		||||
<a name="l00228"></a>00228 <span class="stringliteral">\t-u, --usage:\t\tDisplay this usage message.\n\</span>
 | 
			
		||||
<a name="l00229"></a>00229 <span class="stringliteral">\t-r, --root-image:\tLocation of the root image to compare against.\n\</span>
 | 
			
		||||
<a name="l00230"></a>00230 <span class="stringliteral">\t-s, --sub-image:\tLocation of the sub-image to find in root.\n\</span>
 | 
			
		||||
<a name="l00231"></a>00231 <span class="stringliteral">\t-p, --separator:\tSeparator of the X and Y coordinates.\n\</span>
 | 
			
		||||
<a name="l00232"></a>00232 <span class="stringliteral">\t-t, --tolerance:\tSet how strict the match is - 100 is recommended lowest value.\n\</span>
 | 
			
		||||
<a name="l00233"></a>00233 <span class="stringliteral">\t\t\t\tNote: When using CCORR or CCOEFF tolerance works in opposite direction,\n\</span>
 | 
			
		||||
<a name="l00234"></a>00234 <span class="stringliteral">\t\t\t\tso -50 is recommended highest value.\n\</span>
 | 
			
		||||
<a name="l00235"></a>00235 <span class="stringliteral">\t-m, --search-method:\tSet which method is used to search for sub-images.\n\</span>
 | 
			
		||||
<a name="l00236"></a>00236 <span class="stringliteral">\t\t\t\tMethods:\n\</span>
 | 
			
		||||
<a name="l00237"></a>00237 <span class="stringliteral">\t\t\t\t\tCV_TM_SQDIFF = 0\n\</span>
 | 
			
		||||
<a name="l00238"></a>00238 <span class="stringliteral">\t\t\t\t\tCV_TM_SQDIFF_NORMED = 1\n\</span>
 | 
			
		||||
<a name="l00239"></a>00239 <span class="stringliteral">\t\t\t\t\tCV_TM_CCORR = 2\n\</span>
 | 
			
		||||
<a name="l00240"></a>00240 <span class="stringliteral">\t\t\t\t\tCV_TM_CCORR_NORMED = 3\n\</span>
 | 
			
		||||
<a name="l00241"></a>00241 <span class="stringliteral">\t\t\t\t\tCV_TM_CCOEFF = 4\n\</span>
 | 
			
		||||
<a name="l00242"></a>00242 <span class="stringliteral">\t\t\t\t\tCV_TM_COEFF_NORMED = 5\n\</span>
 | 
			
		||||
<a name="l00243"></a>00243 <span class="stringliteral">\t-x, --x-root[=DISPLAY]:\tSet the root image to come from X11\n\</span>
 | 
			
		||||
<a name="l00244"></a>00244 <span class="stringliteral">\t\t\t\tThe DISPLAY variable is optional, not specifying it will cause X\n\</span>
 | 
			
		||||
<a name="l00245"></a>00245 <span class="stringliteral">\t\t\t\tto use the default display (not specifically :0.0)\n\</span>
 | 
			
		||||
<a name="l00246"></a>00246 <span class="stringliteral">\t\t\t\tPlease note also that the '-x' must come at the end\n\</span>
 | 
			
		||||
<a name="l00247"></a>00247 <span class="stringliteral">\t\t\t\tsince it is an optional argument.\n\</span>
 | 
			
		||||
<a name="l00248"></a>00248 <span class="stringliteral">\t-c, --center:\t\tThe output points should be centered on the sub-image, rather\n\</span>
 | 
			
		||||
<a name="l00249"></a>00249 <span class="stringliteral">\t\t\t\tthan the top-left corner.\n\</span>
 | 
			
		||||
<a name="l00250"></a>00250 <span class="stringliteral">\t-o, --sane-tolerance:\tSet the tolerance using a scale of 1-100,\n\</span>
 | 
			
		||||
<a name="l00251"></a>00251 <span class="stringliteral">\t\t\t\trather than INT_MIN to INT_MAX (100 ~= INT_MAX)\n\</span>
 | 
			
		||||
<a name="l00252"></a>00252 <span class="stringliteral">\n\</span>
 | 
			
		||||
<a name="l00253"></a>00253 <span class="stringliteral">If you have any questions, comments, concerns, email <%s>\n"</span>, <a class="code" href="libcvautomation_8h.html#6b6ab32b9a55421b91988946b2180bd0">LIBCVAUTOMATION_VERSION</a>, <a class="code" href="libcvautomation_8h.html#064f2ecb9f4013fd636368d0dd59e453">LIBCVAUTOMATION_BUGREPORT</a> );
 | 
			
		||||
<a name="l00254"></a>00254 
 | 
			
		||||
<a name="l00255"></a>00255     exit (0);
 | 
			
		||||
<a name="l00256"></a>00256 
 | 
			
		||||
<a name="l00257"></a>00257 }       <span class="comment">/* -----  end of function usage  ----- */</span>
 | 
			
		||||
<a name="l00258"></a>00258 
 | 
			
		||||
<a name="l00259"></a>00259 <span class="comment">/* Doxygen Information */</span>
 | 
			
		||||
<a name="l00266"></a>00266 <span class="comment">/* The biggest purpose of documenting this code is to trick doxygen into making a man page for it. */</span>
 | 
			
		||||
</pre></div><hr size="1"><address style="align: right;"><small>Generated on Tue Jul 17 12:19:00 2012 for libcvautomation by 
 | 
			
		||||
<a href="http://www.doxygen.org/index.html">
 | 
			
		||||
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
 | 
			
		||||
</body>
 | 
			
		||||
</html>
 | 
			
		||||
		Reference in New Issue
	
	Block a user