boofcv.abst.feature.detdesc

Class WrapDetectDescribeSurf<T extends ImageSingleBand,II extends ImageSingleBand>

java.lang.Object

boofcv.abst.feature.detdesc.WrapDetectDescribeSurf<T,II>

Type Parameters:

T - Input image type

II - Integral image type

All Implemented Interfaces:

DescriptorInfo<SurfFeature>, DetectDescribePoint<T,SurfFeature>, FoundPointSO, InterestPointDetector<T>

public class WrapDetectDescribeSurf<T extends ImageSingleBand,II extends ImageSingleBand>
extends Object
implements DetectDescribePoint<T,SurfFeature>

Wrapper around SURF algorithms for DetectDescribePoint.

Author:

Peter Abeles

Constructor Summary

Constructors

Constructor and Description
WrapDetectDescribeSurf(FastHessianFeatureDetector<II> detector, OrientationIntegral<II> orientation, DescribePointSurf<II> describe)

Method Summary

Methods

Modifier and Type	Method and Description
SurfFeature	createDescription() Creates new description instance which can be processed by this class
void	detect(T input) Detects interest points inside the provided image.
SurfFeature	getDescription(int index) Returns the feature descriptor at the specified index.
Class<SurfFeature>	getDescriptionType() The type of region descriptor generated
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

WrapDetectDescribeSurf

public WrapDetectDescribeSurf(FastHessianFeatureDetector<II> detector,
                      OrientationIntegral<II> orientation,
                      DescribePointSurf<II> describe)

Method Detail

createDescription

public SurfFeature createDescription()

Description copied from interface: DescriptorInfo

Creates new description instance which can be processed by this class

Specified by:

createDescription in interface DescriptorInfo<SurfFeature>

Returns:

New descriptor

getDescription

public SurfFeature getDescription(int index)

Description copied from interface: DetectDescribePoint

Returns the feature descriptor at the specified index.

WARNING: The returned data structure is recycled each time InterestPointDetector.detect(boofcv.struct.image.ImageBase) is called. Create a copy if this is a problem.

Specified by:

getDescription in interface DetectDescribePoint<T extends ImageSingleBand,SurfFeature>

Parameters:

index - Which feature

Returns:

Feature descriptor

getDescriptionType

public Class<SurfFeature> getDescriptionType()

Description copied from interface: DescriptorInfo

The type of region descriptor generated

Specified by:

getDescriptionType in interface DescriptorInfo<SurfFeature>

Returns:

Returns the descriptor type.

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 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 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 ImageSingleBand>

Returns:

true if it estimates the orientation