KeyPointDetector.h

Go to the documentation of this file.

/*
* Copyright (C) 2007-2008 Anael Orlinski
*
* This file is part of Panomatic.
*
* Panomatic is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* Panomatic is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with Panomatic; if not, write to the Free Software
* <http://www.gnu.org/licenses/>.
*/
 
#ifndef __lfeat_keypointdetector_h
#define __lfeat_keypointdetector_h
 
#include "Image.h"
#include "KeyPoint.h"
 
namespace lfeat
{
 
class KeyPointInsertor
{
public:
    virtual void operator()(const KeyPoint& k) = 0;
};
 
class LFIMPEX KeyPointDetector
{
public:
    // default constructor
    KeyPointDetector();
 
    // setters for various parameters
    inline void setMaxScales(unsigned int iMaxScales)
    {
        _maxScales = iMaxScales;
    }
    inline void setMaxOctaves(unsigned int iMaxOctaves)
    {
        _maxOctaves = iMaxOctaves;
    }
    inline void setScoreThreshold(double iThreshold)
    {
        _scoreThreshold = iThreshold;
    }
 
    // detect keypoints and put them in the insertor
    void detectKeypoints(Image& iImage, KeyPointInsertor& iInsertor);
 
private:
 
    // internal values of the keypoint detector
 
    // number of scales
    unsigned int                                        _maxScales;
 
    // number of octaves
    unsigned int                                        _maxOctaves;
 
    // detection score threshold
    double                                                      _scoreThreshold;
 
    // initial box filter size
    unsigned int                                        _initialBoxFilterSize;
 
    // scale overlapping : how many filter sizes to overlap
    // with default value 3 : [3,5,7,9,11][7,11,15,19,23][...
    unsigned int                                        _scaleOverlap;
 
    // some default values.
    const static double kBaseSigma;
 
    bool fineTuneExtrema(double** * iSH, unsigned int iX, unsigned int iY, unsigned int iS,
                         double& oX, double& oY, double& oS, double& oScore,
                         unsigned int iOctaveWidth, unsigned int iOctaveHeight, unsigned int iBorder);
 
    bool calcTrace(Image& iImage, double iX, double iY, double iScale, int& oTrace);
 
    unsigned int                getFilterSize(unsigned int iOctave, unsigned int iScale);
    unsigned int                getBorderSize(unsigned int iOctave, unsigned int iScale);
 
};
 
}
 
#endif //__lfeat_keypointdetector_h