boofcv.alg.feature.orientation

Class OrientationSlidingWindow<D extends boofcv.struct.image.ImageGray>

java.lang.Object

boofcv.alg.feature.orientation.OrientationSlidingWindow<D>

All Implemented Interfaces:

OrientationGradient<D>, RegionOrientation

Direct Known Subclasses:

ImplOrientationSlidingWindow_F32, ImplOrientationSlidingWindow_S16, ImplOrientationSlidingWindow_S32

public abstract class OrientationSlidingWindow<D extends boofcv.struct.image.ImageGray>
extends java.lang.Object
implements OrientationGradient<D>

Estimates the orientation by sliding window across all angles. All pixels which are pointing at an angle inside of this window have their gradient summed. The window with the largest normal is selected as the best window. The angle is then computed from the best window using atan2() and the summed gradient.

NOTE: There are probably additional performance enhancements that could be done.

Field Summary

Fields

Modifier and Type	Field and Description
protected double[]	angles
protected D	derivX
protected D	derivY
protected boolean	isWeighted
protected int	numAngles
protected double	objectRadiusToScale
protected int	pixelRadius
protected boofcv.struct.ImageRectangle	rect
protected boofcv.struct.convolve.Kernel2D_F32	weights
protected double	windowSize

Constructor Summary

Constructors

Constructor and Description
OrientationSlidingWindow(double objectRadiusToScale, int numAngles, double windowSize, boolean isWeighted) Configures orientation estimating algorithm.

Method Summary

Modifier and Type	Method and Description
double	compute(double X, double Y) Computes the orientation of a region about its center.
protected abstract double	computeOrientation() Compute the angle without using the optional weights
protected abstract double	computeWeightedOrientation(int c_x, int c_y) Compute the angle using the weighting kernel.
boofcv.struct.convolve.Kernel2D_F32	getWeights()
void	setImage(D derivX, D derivY) Specifies input image data for estimating orientation.
void	setObjectRadius(double objRadius) Specifies the circle's radius that the orientation should be

Methods inherited from class java.lang.Object

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

Methods inherited from interface boofcv.abst.feature.orientation.OrientationGradient

getImageType

Field Detail

pixelRadius

protected int pixelRadius

objectRadiusToScale

protected double objectRadiusToScale

derivX

protected D extends boofcv.struct.image.ImageGray derivX

derivY

protected D extends boofcv.struct.image.ImageGray derivY

rect

protected boofcv.struct.ImageRectangle rect

numAngles

protected int numAngles

windowSize

protected double windowSize

angles

protected double[] angles

isWeighted

protected boolean isWeighted

weights

protected boofcv.struct.convolve.Kernel2D_F32 weights

Constructor Detail

OrientationSlidingWindow

public OrientationSlidingWindow(double objectRadiusToScale,
                                int numAngles,
                                double windowSize,
                                boolean isWeighted)

Configures orientation estimating algorithm.

Parameters:

objectRadiusToScale - Convert object radius into scale factor

numAngles - Number of discrete points in which the sliding window will be centered around.

windowSize - Number of radians in the window being considered.

isWeighted - Should points be weighted using a Gaussian kernel.

Method Detail

getWeights

public boofcv.struct.convolve.Kernel2D_F32 getWeights()

setObjectRadius

public void setObjectRadius(double objRadius)

Description copied from interface: RegionOrientation

Specifies the circle's radius that the orientation should be

Specified by:

setObjectRadius in interface RegionOrientation

Parameters:

objRadius - Object's radius.

setImage

public void setImage(D derivX,
                     D derivY)

Description copied from interface: OrientationGradient

Specifies input image data for estimating orientation.

Specified by:

setImage in interface OrientationGradient<D extends boofcv.struct.image.ImageGray>

Parameters:

derivX - Image derivative along x-axis.

derivY - Image derivative along y-axis.

compute

public double compute(double X,
                      double Y)

Description copied from interface: RegionOrientation

Computes the orientation of a region about its center.

Specified by:

compute in interface RegionOrientation

Parameters:

X - Center of the region in image pixels.

Y - Center of the region in image pixels.

Returns:

Orientation in radians. Angle zero points along x-axis and pi/2 along y-axis.

computeOrientation

protected abstract double computeOrientation()

Compute the angle without using the optional weights

computeWeightedOrientation

protected abstract double computeWeightedOrientation(int c_x,
                                                     int c_y)

Compute the angle using the weighting kernel.