org.bytedeco.opencv.opencv_xfeatures2d

Class SURF

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.opencv.opencv_core.Algorithm

org.bytedeco.opencv.opencv_features2d.Feature2D

org.bytedeco.opencv.opencv_xfeatures2d.SURF

All Implemented Interfaces:

AutoCloseable

@Namespace(value="cv::xfeatures2d")
 @Properties(inherit=opencv_xfeatures2d.class)
public class SURF
extends Feature2D

\brief Class for extracting Speeded Up Robust Features from an image \cite Bay06 .

The algorithm parameters: - member int extended - 0 means that the basic descriptors (64 elements each) shall be computed - 1 means that the extended descriptors (128 elements each) shall be computed - member int upright - 0 means that detector computes orientation of each feature. - 1 means that the orientation is not computed (which is much, much faster). For example, if you match images from a stereo pair, or do image stitching, the matched features likely have very similar angles, and you can speed up feature extraction by setting upright=1. - member double hessianThreshold Threshold for the keypoint detector. Only features, whose hessian is larger than hessianThreshold are retained by the detector. Therefore, the larger the value, the less keypoints you will get. A good default value could be from 300 to 500, depending from the image contrast. - member int nOctaves The number of a gaussian pyramid octaves that the detector uses. It is set to 4 by default. If you want to get very large features, use the larger value. If you want just small features, decrease it. - member int nOctaveLayers The number of images within each octave of a gaussian pyramid. It is set to 2 by default. \note - An example using the SURF feature detector can be found at opencv_source_code/samples/cpp/generic_descriptor_match.cpp - Another example using the SURF feature detector, extractor and matcher can be found at opencv_source_code/samples/cpp/matcher_simple.cpp

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
SURF(Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
static SURF	create()
static SURF	create(double hessianThreshold, int nOctaves, int nOctaveLayers, boolean extended, boolean upright)
boolean	getExtended()
double	getHessianThreshold()
int	getNOctaveLayers()
int	getNOctaves()
boolean	getUpright()
void	setExtended(boolean extended)
void	setHessianThreshold(double hessianThreshold)
void	setNOctaveLayers(int nOctaveLayers)
void	setNOctaves(int nOctaves)
void	setUpright(boolean upright)

Methods inherited from class org.bytedeco.opencv.opencv_features2d.Feature2D

compute, compute, compute, compute, compute, compute, defaultNorm, descriptorSize, descriptorType, detect, detect, detect, detect, detect, detect, detect, detect, detect, detect, detect, detect, detectAndCompute, detectAndCompute, detectAndCompute, detectAndCompute, detectAndCompute, detectAndCompute, empty, getDefaultName, position, read, read, read, write, write, write, write, write

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

clear, save, save

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

SURF

public SURF(Pointer p)

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

Method Detail

create

@opencv_core.Ptr
public static SURF create(double hessianThreshold,
                                           int nOctaves,
                                           int nOctaveLayers,
                                           @Cast(value="bool")
                                           boolean extended,
                                           @Cast(value="bool")
                                           boolean upright)

Parameters:

hessianThreshold - Threshold for hessian keypoint detector used in SURF.

nOctaves - Number of pyramid octaves the keypoint detector will use.

nOctaveLayers - Number of octave layers within each octave.

extended - Extended descriptor flag (true - use extended 128-element descriptors; false - use 64-element descriptors).

upright - Up-right or rotated features flag (true - do not compute orientation of features; false - compute orientation).

create

@opencv_core.Ptr
public static SURF create()

setHessianThreshold

public void setHessianThreshold(double hessianThreshold)

getHessianThreshold

public double getHessianThreshold()

setNOctaves

public void setNOctaves(int nOctaves)

getNOctaves

public int getNOctaves()

setNOctaveLayers

public void setNOctaveLayers(int nOctaveLayers)

getNOctaveLayers

public int getNOctaveLayers()

setExtended

public void setExtended(@Cast(value="bool")
                        boolean extended)

getExtended

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

setUpright

public void setUpright(@Cast(value="bool")
                       boolean upright)

getUpright

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