Trait opencv::xfeatures2d::SURF

pub trait SURF: Feature2DTrait {
    pub fn as_raw_SURF(&self) -> *const c_void;
    pub fn as_raw_mut_SURF(&mut self) -> *mut c_void;

    pub fn set_hessian_threshold(
        &mut self, 
        hessian_threshold: f64
    ) -> Result<()> { ... }
    pub fn get_hessian_threshold(&self) -> Result<f64> { ... }
    pub fn set_n_octaves(&mut self, n_octaves: i32) -> Result<()> { ... }
    pub fn get_n_octaves(&self) -> Result<i32> { ... }
    pub fn set_n_octave_layers(&mut self, n_octave_layers: i32) -> Result<()> { ... }
    pub fn get_n_octave_layers(&self) -> Result<i32> { ... }
    pub fn set_extended(&mut self, extended: bool) -> Result<()> { ... }
    pub fn get_extended(&self) -> Result<bool> { ... }
    pub fn set_upright(&mut self, upright: bool) -> Result<()> { ... }
    pub fn get_upright(&self) -> Result<bool> { ... }
}

Class for extracting Speeded Up Robust Features from an image 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

Required methods

pub fn as_raw_SURF(&self) -> *const c_void

pub fn as_raw_mut_SURF(&mut self) -> *mut c_void

Loading content...

Provided methods

pub fn set_hessian_threshold(&mut self, hessian_threshold: f64) -> Result<()>

pub fn get_hessian_threshold(&self) -> Result<f64>

pub fn set_n_octaves(&mut self, n_octaves: i32) -> Result<()>

pub fn get_n_octaves(&self) -> Result<i32>

pub fn set_n_octave_layers(&mut self, n_octave_layers: i32) -> Result<()>

pub fn get_n_octave_layers(&self) -> Result<i32>

pub fn set_extended(&mut self, extended: bool) -> Result<()>

pub fn get_extended(&self) -> Result<bool>

pub fn set_upright(&mut self, upright: bool) -> Result<()>

pub fn get_upright(&self) -> Result<bool>

Loading content...

Implementations

impl<'_> dyn SURF + '_

pub fn create(
    hessian_threshold: f64,
    n_octaves: i32,
    n_octave_layers: i32,
    extended: bool,
    upright: bool
) -> Result<Ptr<dyn SURF>>

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

C++ default parameters

• hessian_threshold: 100
• n_octaves: 4
• n_octave_layers: 3
• extended: false
• upright: false

Implementors

impl SURF for PtrOfSURF

pub fn as_raw_SURF(&self) -> *const c_void

pub fn as_raw_mut_SURF(&mut self) -> *mut c_void

Loading content...