git.maemo.org Git - opencv/blob - interfaces/matlab/toolbox/opencv/cvgoodfeaturestotrack.m

   1 function varargout = cvgoodfeaturestotrack(varargin)\r
   2 %CVGOODFEATURESTOTRACK Find strong corners on the image.\r
   3 %   corners = cvGoodFeaturesToTrack(IMAGE image, corner_count,\r
   4 %     quality_level, min_distance);\r
   5 %   corners = cvGoodFeaturesToTrack(IMAGE image, corner_count,\r
   6 %     quality_level, min_distance, IMAGE mask);\r
   7 %\r
   8 %   image         - input image\r
   9 %   corner_count  - number of output corners\r
  10 %   quality_level - only those corners are selected, which minimal eigen value is\r
  11 %                   non-less than maximum of minimal eigen values on the image,\r
  12 %                   multiplied by quality_level. For example, quality_level = 0.1\r
  13 %                   means that selected corners must be at least 1/10 as good as\r
  14 %                   the best corner.\r
  15 %   min_distance  - The selected corners(after thresholding using quality_level)\r
  16 %                   are rerified such that pair-wise distance between them is\r
  17 %                   non-less than min_distance\r
  18 %   mask          - mask image\r
  19 %\r
  20 %   corners       - output corners\r
  21 \r
  22 if nargin < 4 | nargin > 5\r
  23     error 'Invalid number of parameters';\r
  24     return;\r
  25 end\r
  26 \r
  27 if nargin < 5\r
  28     varargin{5} = [];\r
  29 end;\r
  30 \r
  31 out = nargout;\r
  32 if out < 1\r
  33     out = 1;\r
  34 end\r
  35 \r
  36 if out > 1\r
  37     error 'Too many output parameters'\r
  38     return;\r
  39 end;\r
  40 \r
  41 [varargout{1:1}] = feval('cvwrap', 'GoodFeaturesToTrack', varargin{:});\r
  42 \r
  43 return;