org.bytedeco.opencv.opencv_shape

Class ShapeContextDistanceExtractor

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.opencv.opencv_core.Algorithm

org.bytedeco.opencv.opencv_shape.ShapeDistanceExtractor

org.bytedeco.opencv.opencv_shape.ShapeContextDistanceExtractor

All Implemented Interfaces:

AutoCloseable

@Namespace(value="cv")
 @Properties(inherit=opencv_shape.class)
public class ShapeContextDistanceExtractor
extends ShapeDistanceExtractor

\brief Implementation of the Shape Context descriptor and matching algorithm

proposed by Belongie et al. in "Shape Matching and Object Recognition Using Shape Contexts" (PAMI 2002). This implementation is packaged in a generic scheme, in order to allow you the implementation of the common variations of the original pipeline.

Nested Class Summary

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

Pointer.CustomDeallocator, Pointer.Deallocator, Pointer.NativeDeallocator, Pointer.ReferenceCounter

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
ShapeContextDistanceExtractor(Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
int	getAngularBins()
float	getBendingEnergyWeight()
HistogramCostExtractor	getCostExtractor()
float	getImageAppearanceWeight()
void	getImages(GpuMat image1, GpuMat image2)
void	getImages(Mat image1, Mat image2)
void	getImages(UMat image1, UMat image2)
float	getInnerRadius()
int	getIterations()
float	getOuterRadius()
int	getRadialBins()
boolean	getRotationInvariant()
float	getShapeContextWeight()
float	getStdDev()
ShapeTransformer	getTransformAlgorithm()
void	setAngularBins(int nAngularBins) \brief Establish the number of angular bins for the Shape Context Descriptor used in the shape matching pipeline.
void	setBendingEnergyWeight(float bendingEnergyWeight) \brief Set the weight of the Bending Energy in the final value of the shape distance.
void	setCostExtractor(HistogramCostExtractor comparer) \brief Set the algorithm used for building the shape context descriptor cost matrix.
void	setImageAppearanceWeight(float imageAppearanceWeight) \brief Set the weight of the Image Appearance cost in the final value of the shape distance.
void	setImages(GpuMat image1, GpuMat image2)
void	setImages(Mat image1, Mat image2) \brief Set the images that correspond to each shape.
void	setImages(UMat image1, UMat image2)
void	setInnerRadius(float innerRadius) \brief Set the inner radius of the shape context descriptor.
void	setIterations(int iterations)
void	setOuterRadius(float outerRadius) \brief Set the outer radius of the shape context descriptor.
void	setRadialBins(int nRadialBins) \brief Establish the number of radial bins for the Shape Context Descriptor used in the shape matching pipeline.
void	setRotationInvariant(boolean rotationInvariant)
void	setShapeContextWeight(float shapeContextWeight) \brief Set the weight of the shape context distance in the final value of the shape distance.
void	setStdDev(float sigma) \brief Set the value of the standard deviation for the Gaussian window for the image appearance cost.
void	setTransformAlgorithm(ShapeTransformer transformer) \brief Set the algorithm used for aligning the shapes.

Methods inherited from class org.bytedeco.opencv.opencv_shape.ShapeDistanceExtractor

computeDistance, computeDistance, computeDistance

Methods inherited from class org.bytedeco.opencv.opencv_core.Algorithm

clear, empty, getDefaultName, position, read, save, save, write, write, write

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, hashCode, isNull, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetof, parseBytes, physicalBytes, position, put, realloc, referenceCount, releaseReference, retainReference, setNull, sizeof, toString, totalBytes, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ShapeContextDistanceExtractor

public ShapeContextDistanceExtractor(Pointer p)

Pointer cast constructor. Invokes Pointer.Pointer(Pointer).

Method Detail

setAngularBins

public void setAngularBins(int nAngularBins)

\brief Establish the number of angular bins for the Shape Context Descriptor used in the shape matching pipeline.

Parameters:

nAngularBins - The number of angular bins in the shape context descriptor.

getAngularBins

public int getAngularBins()

setRadialBins

public void setRadialBins(int nRadialBins)

\brief Establish the number of radial bins for the Shape Context Descriptor used in the shape matching pipeline.

Parameters:

nRadialBins - The number of radial bins in the shape context descriptor.

getRadialBins

public int getRadialBins()

setInnerRadius

public void setInnerRadius(float innerRadius)

\brief Set the inner radius of the shape context descriptor.

Parameters:

innerRadius - The value of the inner radius.

getInnerRadius

public float getInnerRadius()

setOuterRadius

public void setOuterRadius(float outerRadius)

\brief Set the outer radius of the shape context descriptor.

Parameters:

outerRadius - The value of the outer radius.

getOuterRadius

public float getOuterRadius()

setRotationInvariant

public void setRotationInvariant(@Cast(value="bool")
                                 boolean rotationInvariant)

getRotationInvariant

@Cast(value="bool")
public boolean getRotationInvariant()

setShapeContextWeight

public void setShapeContextWeight(float shapeContextWeight)

\brief Set the weight of the shape context distance in the final value of the shape distance. The shape context distance between two shapes is defined as the symmetric sum of shape context matching costs over best matching points. The final value of the shape distance is a user-defined linear combination of the shape context distance, an image appearance distance, and a bending energy.

Parameters:

shapeContextWeight - The weight of the shape context distance in the final distance value.

getShapeContextWeight

public float getShapeContextWeight()

setImageAppearanceWeight

public void setImageAppearanceWeight(float imageAppearanceWeight)

\brief Set the weight of the Image Appearance cost in the final value of the shape distance. The image appearance cost is defined as the sum of squared brightness differences in Gaussian windows around corresponding image points. The final value of the shape distance is a user-defined linear combination of the shape context distance, an image appearance distance, and a bending energy. If this value is set to a number different from 0, is mandatory to set the images that correspond to each shape.

Parameters:

imageAppearanceWeight - The weight of the appearance cost in the final distance value.

getImageAppearanceWeight

public float getImageAppearanceWeight()

setBendingEnergyWeight

public void setBendingEnergyWeight(float bendingEnergyWeight)

\brief Set the weight of the Bending Energy in the final value of the shape distance. The bending energy definition depends on what transformation is being used to align the shapes. The final value of the shape distance is a user-defined linear combination of the shape context distance, an image appearance distance, and a bending energy.

Parameters:

bendingEnergyWeight - The weight of the Bending Energy in the final distance value.

getBendingEnergyWeight

public float getBendingEnergyWeight()

setImages

public void setImages(@ByVal
                      Mat image1,
                      @ByVal
                      Mat image2)

\brief Set the images that correspond to each shape. This images are used in the calculation of the Image Appearance cost.

Parameters:

image1 - Image corresponding to the shape defined by contours1.

image2 - Image corresponding to the shape defined by contours2.

setImages

public void setImages(@ByVal
                      UMat image1,
                      @ByVal
                      UMat image2)

setImages

public void setImages(@ByVal
                      GpuMat image1,
                      @ByVal
                      GpuMat image2)

getImages

public void getImages(@ByVal
                      Mat image1,
                      @ByVal
                      Mat image2)

getImages

public void getImages(@ByVal
                      UMat image1,
                      @ByVal
                      UMat image2)

getImages

public void getImages(@ByVal
                      GpuMat image1,
                      @ByVal
                      GpuMat image2)

setIterations

public void setIterations(int iterations)

getIterations

public int getIterations()

setCostExtractor

public void setCostExtractor(@opencv_core.Ptr
                             HistogramCostExtractor comparer)

\brief Set the algorithm used for building the shape context descriptor cost matrix.

Parameters:

comparer - Smart pointer to a HistogramCostExtractor, an algorithm that defines the cost matrix between descriptors.

getCostExtractor

@opencv_core.Ptr
public HistogramCostExtractor getCostExtractor()

setStdDev

public void setStdDev(float sigma)

\brief Set the value of the standard deviation for the Gaussian window for the image appearance cost.

Parameters:

sigma - Standard Deviation.

getStdDev

public float getStdDev()

setTransformAlgorithm

public void setTransformAlgorithm(@opencv_core.Ptr
                                  ShapeTransformer transformer)

\brief Set the algorithm used for aligning the shapes.

Parameters:

transformer - Smart pointer to a ShapeTransformer, an algorithm that defines the aligning transformation.

getTransformAlgorithm

@opencv_core.Ptr
public ShapeTransformer getTransformAlgorithm()