boofcv.factory.feature.describe

Class FactoryDescribeRegionPoint

java.lang.Object

boofcv.factory.feature.describe.FactoryDescribeRegionPoint

public class FactoryDescribeRegionPoint
extends Object

Factory for creating implementations of DescribeRegionPoint.

Author:

Peter Abeles

Constructor Summary

Constructors

Constructor and Description
FactoryDescribeRegionPoint()

Method Summary

Methods

Modifier and Type	Method and Description
static <T extends ImageSingleBand> DescribeRegionPoint<T,TupleDesc_B>	brief(ConfigBrief config, Class<T> imageType) Creates a BRIEF descriptor.
static <T extends ImageSingleBand,D extends TupleDesc> DescribeRegionPoint<T,D>	pixel(int regionWidth, int regionHeight, Class<T> imageType) Creates a region descriptor based on pixel intensity values alone.
static <T extends ImageSingleBand> DescribeRegionPoint<T,NccFeature>	pixelNCC(int regionWidth, int regionHeight, Class<T> imageType) Creates a region descriptor based on normalized pixel intensity values alone.
static DescribeRegionPoint<ImageFloat32,SurfFeature>	sift(ConfigSiftScaleSpace configSS, ConfigSiftDescribe configDescribe) Creates a standard SIFT region descriptor.
static <T extends ImageMultiBand,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature>	surfColorFast(ConfigSurfDescribe.Speed config, ImageType<T> imageType) Color variant of the SURF descriptor which has been designed for speed and sacrifices some stability.
static <T extends ImageBase,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature>	surfColorStable(ConfigSurfDescribe.Stablility config, ImageType<T> imageType) Color variant of the SURF descriptor which has been designed for stability.
static <T extends ImageSingleBand,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature>	surfFast(ConfigSurfDescribe.Speed config, Class<T> bandType) Creates a SURF descriptor.
static <T extends ImageSingleBand,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature>	surfStable(ConfigSurfDescribe.Stablility config, 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

FactoryDescribeRegionPoint

public FactoryDescribeRegionPoint()

Method Detail

surfFast

public static <T extends ImageSingleBand,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature> surfFast(ConfigSurfDescribe.Speed config,
                                                                                                 Class<T> bandType)

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

Parameters:

config - SURF configuration. Pass in null for default options.

bandType - Type of input image.

Returns:

SURF description extractor

See Also:

DescribePointSurf

surfColorFast

public static <T extends ImageMultiBand,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature> surfColorFast(ConfigSurfDescribe.Speed config,
                                                                                                     ImageType<T> imageType)

Color variant of the SURF descriptor which has been designed for speed and sacrifices some stability.

Parameters:

config - SURF configuration. Pass in null for default options.

imageType - Type of input image.

Returns:

SURF color description extractor

See Also:

DescribePointSurfMultiSpectral

surfStable

public static <T extends ImageSingleBand,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature> surfStable(ConfigSurfDescribe.Stablility config,
                                                                                                   Class<T> imageType)

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

Parameters:

config - SURF configuration. Pass in null for default options.

imageType - Type of input image.

Returns:

SURF description extractor

See Also:

DescribePointSurf

surfColorStable

public static <T extends ImageBase,II extends ImageSingleBand> DescribeRegionPoint<T,SurfFeature> surfColorStable(ConfigSurfDescribe.Stablility config,
                                                                                                  ImageType<T> imageType)

Color variant of the SURF descriptor which has been designed for stability.

Parameters:

config - SURF configuration. Pass in null for default options.

imageType - Type of input image.

Returns:

SURF color description extractor

See Also:

DescribePointSurfMultiSpectral

sift

public static DescribeRegionPoint<ImageFloat32,SurfFeature> sift(ConfigSiftScaleSpace configSS,
                                                 ConfigSiftDescribe configDescribe)

Creates a standard SIFT region descriptor.

NOTE: If detecting and describing SIFT features then it is more efficient to use FactoryDetectDescribe.sift(boofcv.abst.feature.describe.ConfigSiftScaleSpace, boofcv.abst.feature.detect.interest.ConfigSiftDetector, boofcv.abst.feature.orientation.ConfigSiftOrientation, boofcv.abst.feature.describe.ConfigSiftDescribe) instead

Parameters:

configSS - SIFT scale-space configuration. Pass in null for default options.

configDescribe - SIFT descriptor configuration. Pass in null for default options.

Returns:

SIFT descriptor

brief

public static <T extends ImageSingleBand> DescribeRegionPoint<T,TupleDesc_B> brief(ConfigBrief config,
                                                                   Class<T> imageType)

Creates a BRIEF descriptor.

Parameters:

config - Configuration for BRIEF descriptor. If null then default is used.

imageType - Type of gray scale image it processes.

Returns:

BRIEF descriptor

See Also:

DescribePointBrief, DescribePointBriefSO

pixel

public static <T extends ImageSingleBand,D extends TupleDesc> DescribeRegionPoint<T,D> pixel(int regionWidth,
                                                                             int regionHeight,
                                                                             Class<T> imageType)

Creates a region descriptor based on pixel intensity values alone. A classic and fast to compute descriptor, but much less stable than more modern ones.

Parameters:

regionWidth - How wide the pixel region is.

regionHeight - How tall the pixel region is.

imageType - Type of image it will process.

Returns:

Pixel region descriptor

See Also:

DescribePointPixelRegion

pixelNCC

public static <T extends ImageSingleBand> DescribeRegionPoint<T,NccFeature> pixelNCC(int regionWidth,
                                                                     int regionHeight,
                                                                     Class<T> imageType)

Creates a region descriptor based on normalized pixel intensity values alone. This descriptor is designed to be light invariance, but is still less stable than more modern ones.

Parameters:

regionWidth - How wide the pixel region is.

regionHeight - How tall the pixel region is.

imageType - Type of image it will process.

Returns:

Pixel region descriptor

See Also:

DescribePointPixelRegionNCC