Package boofcv.abst.feature.describe

Class DescribeSift_RadiusAngle<T extends ImageGray<T>>

java.lang.Object

boofcv.abst.feature.describe.DescribeSift_RadiusAngle<T>

All Implemented Interfaces:

DescribePointRadiusAngle<T,TupleDesc_F64>, DescriptorInfo<TupleDesc_F64>

public class DescribeSift_RadiusAngle<T extends ImageGray<T>>
extends Object
implements DescribePointRadiusAngle<T,TupleDesc_F64>

Allows you to use SIFT features independent of the SIFT detector. A SIFT scale-space is computed with all octaves and most of the scales saved. When a few feature is requested it looks up the closest scale image and uses that as the input image.

Constructor Summary

Constructors

Constructor	Description
DescribeSift_RadiusAngle(SiftScaleSpace scaleSpace, DescribePointSift<GrayF32> describe, Class<T> imageType)

Method Summary

Modifier and Type	Method	Description
TupleDesc_F64	createDescription()	Creates new description instance which can be processed by this class
double	getCanonicalWidth()	Returns the width of the square (or approximation of) sample region at a scale of one.
Class<TupleDesc_F64>	getDescriptionType()	The type of region descriptor generated
ImageType<T>	getImageType()	Description of the type of image it can process
boolean	isOriented()	True if the descriptor uses orientation information.
boolean	isScalable()	If size information is used when computing the descriptor.
boolean	process(double x, double y, double orientation, double radius, TupleDesc_F64 description)	Extract a description of the local image at the given point, scale, and orientation.
void	setImage(T image)	Specified the image which is to be processed.

Methods inherited from class java.lang.Object

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

Constructor Details

DescribeSift_RadiusAngle

public DescribeSift_RadiusAngle(SiftScaleSpace scaleSpace,
 DescribePointSift<GrayF32> describe,
 Class<T> imageType)

Method Details

setImage

public void setImage(T image)

Description copied from interface: DescribePointRadiusAngle

Specified the image which is to be processed.

Specified by:

setImage in interface DescribePointRadiusAngle<T extends ImageGray<T>,TupleDesc_F64>

Parameters:

image - The image which contains the features.

process

public boolean process(double x,
 double y,
 double orientation,
 double radius,
 TupleDesc_F64 description)

Description copied from interface: DescribePointRadiusAngle

Extract a description of the local image at the given point, scale, and orientation.

WARNING: Check the returned value to make sure a description was actually computed. Some implementations might now allow features to extend outside the image border and will return false.

Specified by:

process in interface DescribePointRadiusAngle<T extends ImageGray<T>,TupleDesc_F64>

Parameters:

x - Coordinate of the point.

y - Coordinate of the point.

orientation - Direction the feature is pointing at in radians. 0 = x-axis PI/2 = y-axis

radius - Radius of the detected object in pixels.

description - (output) Storage for extracted feature. Use DescriptorInfo.createDescription() to create descriptor.

Returns:

true if a descriptor can be computed or false if not.

isScalable

public boolean isScalable()

Description copied from interface: DescribePointRadiusAngle

If size information is used when computing the descriptor.

Specified by:

isScalable in interface DescribePointRadiusAngle<T extends ImageGray<T>,TupleDesc_F64>

Returns:

true is the radius is used when computing the descriptor or false if not

isOriented

public boolean isOriented()

Description copied from interface: DescribePointRadiusAngle

True if the descriptor uses orientation information.

Specified by:

isOriented in interface DescribePointRadiusAngle<T extends ImageGray<T>,TupleDesc_F64>

Returns:

if orientation needs to be provided or not

getImageType

public ImageType<T> getImageType()

Description copied from interface: DescribePointRadiusAngle

Description of the type of image it can process

Specified by:

getImageType in interface DescribePointRadiusAngle<T extends ImageGray<T>,TupleDesc_F64>

Returns:

ImageDataType

getCanonicalWidth

public double getCanonicalWidth()

Description copied from interface: DescribePointRadiusAngle

Returns the width of the square (or approximation of) sample region at a scale of one. When multiplied by the scale, pixels outside of the square region should not influence the descriptor's value.

Specified by:

getCanonicalWidth in interface DescribePointRadiusAngle<T extends ImageGray<T>,TupleDesc_F64>

Returns:

width of descriptor at a scale of one

createDescription

public TupleDesc_F64 createDescription()

Description copied from interface: DescriptorInfo

Creates new description instance which can be processed by this class

Specified by:

createDescription in interface DescriptorInfo<T extends ImageGray<T>>

Returns:

New descriptor

getDescriptionType

public Class<TupleDesc_F64> getDescriptionType()

Description copied from interface: DescriptorInfo

The type of region descriptor generated

Specified by:

getDescriptionType in interface DescriptorInfo<T extends ImageGray<T>>

Returns:

Returns the descriptor type.