boofcv.factory.feature.detdesc

Class FactoryDetectDescribe

java.lang.Object

boofcv.factory.feature.detdesc.FactoryDetectDescribe

public class FactoryDetectDescribe
extends java.lang.Object

Creates instances of DetectDescribePoint for different feature detectors/describers.

Constructor Summary

Constructors

Constructor and Description
FactoryDetectDescribe()

Method Summary

Methods

Modifier and Type	Method and Description
static <T extends boofcv.struct.image.ImageSingleBand,D extends TupleDesc> DetectDescribePoint<T,D>	fuseTogether(InterestPointDetector<T> detector, OrientationImage<T> orientation, DescribeRegionPoint<T,D> describe) Given independent algorithms for feature detection, orientation, and describing, create a new DetectDescribePoint.
static DetectDescribePoint<boofcv.struct.image.ImageFloat32,SurfFeature>	sift(ConfigSiftScaleSpace configSS, ConfigSiftDetector configDetector, ConfigSiftOrientation configOri, ConfigSiftDescribe configDesc) Creates a new SIFT feature detector and describer.
static <T extends boofcv.struct.image.ImageSingleBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfColorFast(ConfigFastHessian configDetector, ConfigSurfDescribe.Speed configDesc, ConfigAverageIntegral configOrientation, boofcv.struct.image.ImageType<T> imageType) Color version of SURF stable.
static <T extends boofcv.struct.image.ImageMultiBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfColorStable(ConfigFastHessian configDetector, ConfigSurfDescribe.Stability configDescribe, ConfigSlidingIntegral configOrientation, boofcv.struct.image.ImageType<T> imageType) Color version of SURF stable feature.
static <T extends boofcv.struct.image.ImageSingleBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfFast(ConfigFastHessian configDetector, ConfigSurfDescribe.Speed configDesc, ConfigAverageIntegral configOrientation, java.lang.Class<T> imageType) Creates a SURF descriptor.
static <T extends boofcv.struct.image.ImageSingleBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfStable(ConfigFastHessian configDetector, ConfigSurfDescribe.Stability configDescribe, ConfigSlidingIntegral configOrientation, java.lang.Class<T> imageType) Creates a SURF descriptor.

Methods inherited from class java.lang.Object

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

Constructor Detail

FactoryDetectDescribe

public FactoryDetectDescribe()

Method Detail

sift

public static DetectDescribePoint<boofcv.struct.image.ImageFloat32,SurfFeature> sift(ConfigSiftScaleSpace configSS,
                                                                     ConfigSiftDetector configDetector,
                                                                     ConfigSiftOrientation configOri,
                                                                     ConfigSiftDescribe configDesc)

Creates a new SIFT feature detector and describer.

Parameters:

configSS - Configuration for scale-space. Pass in null for default options.

configDetector - Configuration for detector. Pass in null for default options.

configOri - Configuration for region orientation. Pass in null for default options.

configDesc - Configuration for descriptor. Pass in null for default options.

Returns:

SIFT

surfFast

public static <T extends boofcv.struct.image.ImageSingleBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfFast(ConfigFastHessian configDetector,
                                                                                                                                         ConfigSurfDescribe.Speed configDesc,
                                                                                                                                         ConfigAverageIntegral configOrientation,
                                                                                                                                         java.lang.Class<T> imageType)

Creates a SURF descriptor. SURF descriptors are invariant to illumination, orientation, and scale. BoofCV provides two variants. Creates a variant which is designed for speed at the cost of some stability. Different descriptors are created for color and gray-scale images.

[1] Add tech report when its finished. See SURF performance web page for now.

Parameters:

configDetector - Configuration for SURF detector

configDesc - Configuration for SURF descriptor

configOrientation - Configuration for orientation

Returns:

SURF detector and descriptor

See Also:

FastHessianFeatureDetector, DescribePointSurf, DescribePointSurfMultiSpectral

surfColorFast

public static <T extends boofcv.struct.image.ImageSingleBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfColorFast(ConfigFastHessian configDetector,
                                                                                                                                              ConfigSurfDescribe.Speed configDesc,
                                                                                                                                              ConfigAverageIntegral configOrientation,
                                                                                                                                              boofcv.struct.image.ImageType<T> imageType)

Color version of SURF stable. Features are detected in a gray scale image, but the descriptors are computed using a color image. Each band in the page adds to the descriptor length. See DetectDescribeSurfMultiSpectral for details.

Parameters:

configDetector - Configuration for SURF detector

configDesc - Configuration for SURF descriptor

configOrientation - Configuration for orientation

Returns:

SURF detector and descriptor

See Also:

FastHessianFeatureDetector, DescribePointSurf, DescribePointSurfMultiSpectral

surfStable

public static <T extends boofcv.struct.image.ImageSingleBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfStable(ConfigFastHessian configDetector,
                                                                                                                                           ConfigSurfDescribe.Stability configDescribe,
                                                                                                                                           ConfigSlidingIntegral configOrientation,
                                                                                                                                           java.lang.Class<T> imageType)

Creates a SURF descriptor. SURF descriptors are invariant to illumination, orientation, and scale. BoofCV provides two variants. Creates a variant which is designed for stability. Different descriptors are created for color and gray-scale images.

[1] Add tech report when its finished. See SURF performance web page for now.

Parameters:

configDetector - Configuration for SURF detector. Null for default.

configDescribe - Configuration for SURF descriptor. Null for default.

configOrientation - Configuration for region orientation. Null for default.

imageType - Specify type of input image.

Returns:

SURF detector and descriptor

See Also:

DescribePointSurfMultiSpectral, FastHessianFeatureDetector, DescribePointSurfMod

surfColorStable

public static <T extends boofcv.struct.image.ImageMultiBand,II extends boofcv.struct.image.ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfColorStable(ConfigFastHessian configDetector,
                                                                                                                                               ConfigSurfDescribe.Stability configDescribe,
                                                                                                                                               ConfigSlidingIntegral configOrientation,
                                                                                                                                               boofcv.struct.image.ImageType<T> imageType)

Color version of SURF stable feature. Features are detected in a gray scale image, but the descriptors are computed using a color image. Each band in the page adds to the descriptor length. See DetectDescribeSurfMultiSpectral for details.

Parameters:

configDetector - Configuration for SURF detector. Null for default.

configDescribe - Configuration for SURF descriptor. Null for default.

configOrientation - Configuration for region orientation. Null for default.

imageType - Specify type of color input image.

Returns:

SURF detector and descriptor

See Also:

DescribePointSurfMultiSpectral, FastHessianFeatureDetector, DescribePointSurfMod

fuseTogether

public static <T extends boofcv.struct.image.ImageSingleBand,D extends TupleDesc> DetectDescribePoint<T,D> fuseTogether(InterestPointDetector<T> detector,
                                                                                                        OrientationImage<T> orientation,
                                                                                                        DescribeRegionPoint<T,D> describe)

Given independent algorithms for feature detection, orientation, and describing, create a new DetectDescribePoint.

Parameters:

detector - Feature detector

orientation - Orientation estimation. Optionally, can be null.

describe - Feature descriptor

Returns:

DetectDescribePoint.