org.bytedeco.javacpp

Class opencv_features2d.BOWImgDescriptorExtractor

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.javacpp.opencv_features2d.BOWImgDescriptorExtractor

All Implemented Interfaces:

AutoCloseable

Enclosing class:

opencv_features2d

@Namespace(value="cv")
 @NoOffset
public static class opencv_features2d.BOWImgDescriptorExtractor
extends org.bytedeco.javacpp.Pointer

\brief Class to compute an image descriptor using the *bag of visual words*.

Such a computation consists of the following steps:

1. Compute descriptors for a given image and its keypoints set. 2. Find the nearest visual words from the vocabulary for each keypoint descriptor. 3. Compute the bag-of-words image descriptor as is a normalized histogram of vocabulary words encountered in the image. The i-th bin of the histogram is a frequency of i-th word of the vocabulary in the given image.

Nested Class Summary

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

org.bytedeco.javacpp.Pointer.CustomDeallocator, org.bytedeco.javacpp.Pointer.Deallocator, org.bytedeco.javacpp.Pointer.NativeDeallocator

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
BOWImgDescriptorExtractor(opencv_features2d.DescriptorMatcher dmatcher) \overload
BOWImgDescriptorExtractor(opencv_features2d.Feature2D dextractor, opencv_features2d.DescriptorMatcher dmatcher) \brief The constructor.
BOWImgDescriptorExtractor(org.bytedeco.javacpp.Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
void	compute(opencv_core.GpuMat keypointDescriptors, opencv_core.GpuMat imgDescriptor)
void	compute(opencv_core.GpuMat keypointDescriptors, opencv_core.GpuMat imgDescriptor, opencv_core.IntVectorVector pointIdxsOfClusters)
void	compute(opencv_core.GpuMat image, opencv_core.KeyPointVector keypoints, opencv_core.GpuMat imgDescriptor)
void	compute(opencv_core.GpuMat image, opencv_core.KeyPointVector keypoints, opencv_core.GpuMat imgDescriptor, opencv_core.IntVectorVector pointIdxsOfClusters, opencv_core.Mat descriptors)
void	compute(opencv_core.Mat image, opencv_core.KeyPointVector keypoints, opencv_core.Mat imgDescriptor)
void	compute(opencv_core.Mat image, opencv_core.KeyPointVector keypoints, opencv_core.Mat imgDescriptor, opencv_core.IntVectorVector pointIdxsOfClusters, opencv_core.Mat descriptors) \brief Computes an image descriptor using the set visual vocabulary.
void	compute(opencv_core.Mat keypointDescriptors, opencv_core.Mat imgDescriptor)
void	compute(opencv_core.Mat keypointDescriptors, opencv_core.Mat imgDescriptor, opencv_core.IntVectorVector pointIdxsOfClusters) \overload
void	compute(opencv_core.UMat image, opencv_core.KeyPointVector keypoints, opencv_core.UMat imgDescriptor)
void	compute(opencv_core.UMat image, opencv_core.KeyPointVector keypoints, opencv_core.UMat imgDescriptor, opencv_core.IntVectorVector pointIdxsOfClusters, opencv_core.Mat descriptors)
void	compute(opencv_core.UMat keypointDescriptors, opencv_core.UMat imgDescriptor)
void	compute(opencv_core.UMat keypointDescriptors, opencv_core.UMat imgDescriptor, opencv_core.IntVectorVector pointIdxsOfClusters)
int	descriptorSize() \brief Returns an image descriptor size if the vocabulary is set.
int	descriptorType() \brief Returns an image descriptor type.
opencv_core.Mat	getVocabulary() \brief Returns the set vocabulary.
void	setVocabulary(opencv_core.Mat vocabulary) \brief Sets a visual vocabulary.

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, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetof, parseBytes, physicalBytes, position, position, put, realloc, setNull, sizeof, toString, totalBytes, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

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

Constructor Detail

BOWImgDescriptorExtractor

public BOWImgDescriptorExtractor(org.bytedeco.javacpp.Pointer p)

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

BOWImgDescriptorExtractor

public BOWImgDescriptorExtractor(@Cast(value="cv::DescriptorExtractor*") @opencv_core.Ptr
                                 opencv_features2d.Feature2D dextractor,
                                 @opencv_core.Ptr
                                 opencv_features2d.DescriptorMatcher dmatcher)

\brief The constructor.

Parameters:

dextractor - Descriptor extractor that is used to compute descriptors for an input image and its keypoints.

dmatcher - Descriptor matcher that is used to find the nearest word of the trained vocabulary for each keypoint descriptor of the image.

BOWImgDescriptorExtractor

public BOWImgDescriptorExtractor(@opencv_core.Ptr
                                 opencv_features2d.DescriptorMatcher dmatcher)

\overload

Method Detail

setVocabulary

public void setVocabulary(@Const @ByRef
                          opencv_core.Mat vocabulary)

\brief Sets a visual vocabulary.

Parameters:

vocabulary - Vocabulary (can be trained using the inheritor of BOWTrainer ). Each row of the vocabulary is a visual word (cluster center).

getVocabulary

@Const
 @ByRef
public opencv_core.Mat getVocabulary()

\brief Returns the set vocabulary.

compute

public void compute(@ByVal
                    opencv_core.Mat image,
                    @ByRef
                    opencv_core.KeyPointVector keypoints,
                    @ByVal
                    opencv_core.Mat imgDescriptor,
                    opencv_core.IntVectorVector pointIdxsOfClusters,
                    opencv_core.Mat descriptors)

\brief Computes an image descriptor using the set visual vocabulary.

Parameters:

image - Image, for which the descriptor is computed.

keypoints - Keypoints detected in the input image.

imgDescriptor - Computed output image descriptor.

pointIdxsOfClusters - Indices of keypoints that belong to the cluster. This means that pointIdxsOfClusters[i] are keypoint indices that belong to the i -th cluster (word of vocabulary) returned if it is non-zero.

descriptors - Descriptors of the image keypoints that are returned if they are non-zero.

compute

public void compute(@ByVal
                    opencv_core.Mat image,
                    @ByRef
                    opencv_core.KeyPointVector keypoints,
                    @ByVal
                    opencv_core.Mat imgDescriptor)

compute

public void compute(@ByVal
                    opencv_core.UMat image,
                    @ByRef
                    opencv_core.KeyPointVector keypoints,
                    @ByVal
                    opencv_core.UMat imgDescriptor,
                    opencv_core.IntVectorVector pointIdxsOfClusters,
                    opencv_core.Mat descriptors)

compute

public void compute(@ByVal
                    opencv_core.UMat image,
                    @ByRef
                    opencv_core.KeyPointVector keypoints,
                    @ByVal
                    opencv_core.UMat imgDescriptor)

compute

public void compute(@ByVal
                    opencv_core.GpuMat image,
                    @ByRef
                    opencv_core.KeyPointVector keypoints,
                    @ByVal
                    opencv_core.GpuMat imgDescriptor,
                    opencv_core.IntVectorVector pointIdxsOfClusters,
                    opencv_core.Mat descriptors)

compute

public void compute(@ByVal
                    opencv_core.GpuMat image,
                    @ByRef
                    opencv_core.KeyPointVector keypoints,
                    @ByVal
                    opencv_core.GpuMat imgDescriptor)

compute

public void compute(@ByVal
                    opencv_core.Mat keypointDescriptors,
                    @ByVal
                    opencv_core.Mat imgDescriptor,
                    opencv_core.IntVectorVector pointIdxsOfClusters)

\overload

Parameters:

keypointDescriptors - Computed descriptors to match with vocabulary.

imgDescriptor - Computed output image descriptor.

pointIdxsOfClusters - Indices of keypoints that belong to the cluster. This means that pointIdxsOfClusters[i] are keypoint indices that belong to the i -th cluster (word of vocabulary) returned if it is non-zero.

compute

public void compute(@ByVal
                    opencv_core.Mat keypointDescriptors,
                    @ByVal
                    opencv_core.Mat imgDescriptor)

compute

public void compute(@ByVal
                    opencv_core.UMat keypointDescriptors,
                    @ByVal
                    opencv_core.UMat imgDescriptor,
                    opencv_core.IntVectorVector pointIdxsOfClusters)

compute

public void compute(@ByVal
                    opencv_core.UMat keypointDescriptors,
                    @ByVal
                    opencv_core.UMat imgDescriptor)

compute

public void compute(@ByVal
                    opencv_core.GpuMat keypointDescriptors,
                    @ByVal
                    opencv_core.GpuMat imgDescriptor,
                    opencv_core.IntVectorVector pointIdxsOfClusters)

compute

public void compute(@ByVal
                    opencv_core.GpuMat keypointDescriptors,
                    @ByVal
                    opencv_core.GpuMat imgDescriptor)

descriptorSize

public int descriptorSize()

\brief Returns an image descriptor size if the vocabulary is set. Otherwise, it returns 0.

descriptorType

public int descriptorType()

\brief Returns an image descriptor type.