boofcv.abst.feature.detect.interest

Class InterestPointDetectorOverride<T extends boofcv.struct.image.ImageSingleBand>

java.lang.Object

boofcv.abst.feature.detect.interest.InterestPointDetectorOverride<T>

All Implemented Interfaces:

FoundPointSO, InterestPointDetector<T>

public class InterestPointDetectorOverride<T extends boofcv.struct.image.ImageSingleBand>
extends java.lang.Object
implements InterestPointDetector<T>

Provides the capability to tack on a different algorithm for the feature's location, scale, and orientation.

Constructor Summary

Constructors

Constructor and Description
InterestPointDetectorOverride(InterestPointDetector<T> detector, OrientationImage<T> orientation) Specifies which algorithms are to be used.

Method Summary

Methods

Modifier and Type	Method and Description
void	detect(T input) Detects interest points inside the provided image.
georegression.struct.point.Point2D_F64	getLocation(int featureIndex) The center location of the feature inside the image.
int	getNumberOfFeatures() Returns the number of interest points found.
double	getOrientation(int featureIndex) Returns the features found orientation.
double	getScale(int featureIndex) Scale of the detected feature in scale space.
boolean	hasOrientation() If the interest point detector estimates the feature's orientation
boolean	hasScale() Does the interest point detector have scale information

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InterestPointDetectorOverride

public InterestPointDetectorOverride(InterestPointDetector<T> detector,
                             OrientationImage<T> orientation)

Specifies which algorithms are to be used. If orientation is specified then it will override the orientation provided by 'detector'

Parameters:

detector - Interest point detector and default scale and orientation.

orientation - If not null then this will be used to estimate the feature's orientation.

Method Detail

detect

public void detect(T input)

Description copied from interface: InterestPointDetector

Detects interest points inside the provided image.

Specified by:

detect in interface InterestPointDetector<T extends boofcv.struct.image.ImageSingleBand>

Parameters:

input - Input features are detected inside of.

getNumberOfFeatures

public int getNumberOfFeatures()

Description copied from interface: FoundPointSO

Returns the number of interest points found.

Specified by:

getNumberOfFeatures in interface FoundPointSO

Returns:

Number of interest points.

getLocation

public georegression.struct.point.Point2D_F64 getLocation(int featureIndex)

Description copied from interface: FoundPointSO

The center location of the feature inside the image.

WARNING: Do not save the returned reference, copy instead. The returned point can be recycled each time this function is called.

Specified by:

getLocation in interface FoundPointSO

Parameters:

featureIndex - The feature's index.

Returns:

Location of the feature in image pixels.

getScale

public double getScale(int featureIndex)

Description copied from interface: FoundPointSO

Scale of the detected feature in scale space. This is the standard deviation of the Gaussian blur applied to the image when the feature was detected. While the object's size is not exactly defined, multiplying this number by 2.5 or 3 is typically considered the object's radius.

NOTE: In the future this might be changed to getRadius() to remove any ambiguity over the detected object's size.

Specified by:

getScale in interface FoundPointSO

Parameters:

featureIndex - Feature whose scale is being requested.

Returns:

Size of the interest point relative to canonical size.

getOrientation

public double getOrientation(int featureIndex)

Description copied from interface: FoundPointSO

Returns the features found orientation.

Specified by:

getOrientation in interface FoundPointSO

Parameters:

featureIndex - Feature whose

Returns:

Orientation in radians.

hasScale

public boolean hasScale()

Description copied from interface: InterestPointDetector

Does the interest point detector have scale information

Specified by:

hasScale in interface InterestPointDetector<T extends boofcv.struct.image.ImageSingleBand>

Returns:

true if it has scale information and false otherwise

hasOrientation

public boolean hasOrientation()

Description copied from interface: InterestPointDetector

If the interest point detector estimates the feature's orientation

Specified by:

hasOrientation in interface InterestPointDetector<T extends boofcv.struct.image.ImageSingleBand>

Returns:

true if it estimates the orientation