boofcv.alg.shapes.polygon

Class RefinePolygonCornersToImage<T extends boofcv.struct.image.ImageGray>

java.lang.Object

boofcv.alg.shapes.polygon.RefinePolygonCornersToImage<T>

All Implemented Interfaces:

RefineBinaryPolygon<T>

public class RefinePolygonCornersToImage<T extends boofcv.struct.image.ImageGray>
extends java.lang.Object
implements RefineBinaryPolygon<T>

Given a contour and the index of corner points it will fit the corners individually to sub-pixel precision by locally fitting line segments near by each corner. The length of each line segment is specified by the number of pixels away it will traverse the contour. It makes sure that the end point does not go past the next corner.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<georegression.struct.point.Point2D_I32>	contour
protected georegression.struct.point.Point2D_F64	cornerPt
protected georegression.struct.point.Point2D_F64	leftPt
protected RefineCornerLinesToImage<T>	refineCorner
protected georegression.struct.point.Point2D_F64	rightPt
protected org.ddogleg.struct.GrowQueue_I32	splits

Constructor Summary

Constructors

Constructor and Description
RefinePolygonCornersToImage(java.lang.Class<T> imageType) Provides reasonable default values for all parameters that it can
RefinePolygonCornersToImage(int endPointDistance, double cornerOffset, int maxLineSamples, int sampleRadius, int maxIterations, double convergeTolPixels, double maxCornerChangePixels, java.lang.Class<T> imageType) Configures all parameters of the detector

Method Summary

Modifier and Type	Method and Description
void	clearLensDistortion() Clears the previously set lens distortion
int	getPixelsAway()
SnapToLineEdge<T>	getSnapToEdge()
protected int	pickEndIndex(int cornerS, int dir) Selects the index to use as the end point.
boolean	refine(georegression.struct.shapes.Polygon2D_F64 input, java.util.List<georegression.struct.point.Point2D_I32> contour, org.ddogleg.struct.GrowQueue_I32 splits, georegression.struct.shapes.Polygon2D_F64 refined) Refines the corner estimates in the contour.
void	setImage(T input) Sets the input image
void	setLensDistortion(int width, int height, boofcv.struct.distort.PixelTransform2_F32 distToUndist, boofcv.struct.distort.PixelTransform2_F32 undistToDist) Specifies lens distortion
void	setPixelsAway(int pixelsAway)

Methods inherited from class java.lang.Object

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

Field Detail

refineCorner

protected RefineCornerLinesToImage<T extends boofcv.struct.image.ImageGray> refineCorner

cornerPt

protected georegression.struct.point.Point2D_F64 cornerPt

leftPt

protected georegression.struct.point.Point2D_F64 leftPt

rightPt

protected georegression.struct.point.Point2D_F64 rightPt

contour

protected java.util.List<georegression.struct.point.Point2D_I32> contour

splits

protected org.ddogleg.struct.GrowQueue_I32 splits

Constructor Detail

RefinePolygonCornersToImage

public RefinePolygonCornersToImage(int endPointDistance,
                                   double cornerOffset,
                                   int maxLineSamples,
                                   int sampleRadius,
                                   int maxIterations,
                                   double convergeTolPixels,
                                   double maxCornerChangePixels,
                                   java.lang.Class<T> imageType)

Configures all parameters of the detector

Parameters:

endPointDistance - How many indexes away in the contour list should end points be.

cornerOffset - pixels this close to the corner will be ignored. Try 2

maxLineSamples - Number of points along the line which will be sampled. try 10

sampleRadius - How far away from the line will it sample pixels. ≥ 1

maxIterations - Maximum number of iterations it will perform. Try 10

convergeTolPixels - When the corner changes less than this amount it will stop iterating. Try 1e-5

maxCornerChangePixels - maximum change in corner location allowed from previous iteration in pixels. Try 2.0

imageType - Type of input image.

RefinePolygonCornersToImage

public RefinePolygonCornersToImage(java.lang.Class<T> imageType)

Provides reasonable default values for all parameters that it can

Parameters:

imageType - Type of input image.

Method Detail

setImage

public void setImage(T input)

Sets the input image

Specified by:

setImage in interface RefineBinaryPolygon<T extends boofcv.struct.image.ImageGray>

Parameters:

input - Input image-

setLensDistortion

public void setLensDistortion(int width,
                              int height,
                              boofcv.struct.distort.PixelTransform2_F32 distToUndist,
                              boofcv.struct.distort.PixelTransform2_F32 undistToDist)

Description copied from interface: RefineBinaryPolygon

Specifies lens distortion

Specified by:

setLensDistortion in interface RefineBinaryPolygon<T extends boofcv.struct.image.ImageGray>

clearLensDistortion

public void clearLensDistortion()

Description copied from interface: RefineBinaryPolygon

Clears the previously set lens distortion

Specified by:

clearLensDistortion in interface RefineBinaryPolygon<T extends boofcv.struct.image.ImageGray>

refine

public boolean refine(georegression.struct.shapes.Polygon2D_F64 input,
                      java.util.List<georegression.struct.point.Point2D_I32> contour,
                      org.ddogleg.struct.GrowQueue_I32 splits,
                      georegression.struct.shapes.Polygon2D_F64 refined)

Refines the corner estimates in the contour.

Specified by:

refine in interface RefineBinaryPolygon<T extends boofcv.struct.image.ImageGray>

Parameters:

contour - (Input) Shape's contour

splits - (Input) index of corners in the contour

refined - (Output) Refined polygon with sub-pixel accurate corners

input - 2D polygon version of contour polygon

Returns:

Number of corners it successfully optimized.

pickEndIndex

protected int pickEndIndex(int cornerS,
                           int dir)

Selects the index to use as the end point. Makes sure that the index does not go past the next corner.

Parameters:

cornerS - index of corner in split list

dir - Specifies which corner is next. can be -1 or 1.

getPixelsAway

public int getPixelsAway()

setPixelsAway

public void setPixelsAway(int pixelsAway)

getSnapToEdge

public SnapToLineEdge<T> getSnapToEdge()