boofcv.alg.feature.orientation

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

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.ImageSingleBand>
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 int	radius
protected int	radiusScale
protected boofcv.struct.ImageRectangle	rect
protected boofcv.struct.convolve.Kernel2D_F32	weights
protected double	windowSize

Constructor Summary

Constructors

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

Method Summary

Methods

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.
int	getRadius()
boofcv.struct.convolve.Kernel2D_F32	getWeights()
void	setImage(D derivX, D derivY) Specifies input image data for estimating orientation.
void	setRadius(int radius) Specify the size of the region that is considered.
void	setScale(double scale) Specifies scale at which the orientation is estimated.

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

radius

protected int radius

radiusScale

protected int radiusScale

derivX

protected D extends boofcv.struct.image.ImageSingleBand derivX

derivY

protected D extends boofcv.struct.image.ImageSingleBand 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(int numAngles,
                        double windowSize,
                        boolean isWeighted)

Configures orientation estimating algorithm.

Parameters:

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

getRadius

public int getRadius()

setRadius

public void setRadius(int radius)

Specify the size of the region that is considered.

Parameters:

radius -

getWeights

public boofcv.struct.convolve.Kernel2D_F32 getWeights()

setScale

public void setScale(double scale)

Description copied from interface: RegionOrientation

Specifies scale at which the orientation is estimated.

Specified by:

setScale in interface RegionOrientation

Parameters:

scale - Scale of the orientation region.

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

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.