Struct MSER

pub struct MSER { /* private fields */ }

Maximally stable extremal region extractor

The class encapsulates all the parameters of the %MSER extraction algorithm (see wiki article).

• there are two different implementation of %MSER: one for grey image, one for color image

• the grey image algorithm is taken from: nister2008linear ; the paper claims to be faster than union-find method; it actually get 1.5~2m/s on my centrino L7200 1.2GHz laptop.

• the color image algorithm is taken from: forssen2007maximally ; it should be much slower than grey image method ( 3~4 times )

• (Python) A complete example showing the use of the %MSER detector can be found at samples/python/mser.py

Implementations

impl MSER

pub fn create( delta: i32, min_area: i32, max_area: i32, max_variation: f64, min_diversity: f64, max_evolution: i32, area_threshold: f64, min_margin: f64, edge_blur_size: i32, ) -> Result<Ptr<MSER>>

Full constructor for %MSER detector

Parameters

• delta: it compares
• min_area: prune the area which smaller than minArea
• max_area: prune the area which bigger than maxArea
• max_variation: prune the area have similar size to its children
• min_diversity: for color image, trace back to cut off mser with diversity less than min_diversity
• max_evolution: for color image, the evolution steps
• area_threshold: for color image, the area threshold to cause re-initialize
• min_margin: for color image, ignore too small margin
• edge_blur_size: for color image, the aperture size for edge blur

C++ default parameters

• delta: 5
• min_area: 60
• max_area: 14400
• max_variation: 0.25
• min_diversity: .2
• max_evolution: 200
• area_threshold: 1.01
• min_margin: 0.003
• edge_blur_size: 5

pub fn create_def() -> Result<Ptr<MSER>>

Full constructor for %MSER detector

Parameters

• delta: it compares
• min_area: prune the area which smaller than minArea
• max_area: prune the area which bigger than maxArea
• max_variation: prune the area have similar size to its children
• min_diversity: for color image, trace back to cut off mser with diversity less than min_diversity
• max_evolution: for color image, the evolution steps
• area_threshold: for color image, the area threshold to cause re-initialize
• min_margin: for color image, ignore too small margin
• edge_blur_size: for color image, the aperture size for edge blur

Note

This alternative version of MSER::create function uses the following default values for its arguments:

• delta: 5
• min_area: 60
• max_area: 14400
• max_variation: 0.25
• min_diversity: .2
• max_evolution: 200
• area_threshold: 1.01
• min_margin: 0.003
• edge_blur_size: 5

Trait Implementations

impl AlgorithmTrait for MSER

fn as_raw_mut_Algorithm(&mut self) -> *mut c_void

fn clear(&mut self) -> Result<()>

Clears the algorithm state

fn read(&mut self, fn_: &impl FileNodeTraitConst) -> Result<()>

Reads algorithm parameters from a file storage

impl AlgorithmTraitConst for MSER

fn as_raw_Algorithm(&self) -> *const c_void

fn write(&self, fs: &mut impl FileStorageTrait) -> Result<()>

Stores algorithm parameters in a file storage

fn write_1(&self, fs: &mut impl FileStorageTrait, name: &str) -> Result<()>

Stores algorithm parameters in a file storage

fn write_with_name(&self, fs: &Ptr<FileStorage>, name: &str) -> Result<()>

@deprecated

fn write_with_name_def(&self, fs: &Ptr<FileStorage>) -> Result<()>

👎Deprecated:

Note

Deprecated: ## Note This alternative version of AlgorithmTraitConst::write_with_name function uses the following default values for its arguments:

fn empty(&self) -> Result<bool>

Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read

fn save(&self, filename: &str) -> Result<()>

Saves the algorithm to a file. In order to make this method work, the derived class must implement Algorithm::write(FileStorage& fs).

fn get_default_name(&self) -> Result<String>

Returns the algorithm string identifier. This string is used as top level xml/yml node tag when the object is saved to a file or string.

impl Boxed for MSER

unsafe fn from_raw(ptr: <MSER as OpenCVFromExtern>::ExternReceive) -> Self

Wrap the specified raw pointer

fn into_raw(self) -> <MSER as OpenCVTypeExternContainer>::ExternSendMut

Return the underlying raw pointer while consuming this wrapper.

fn as_raw(&self) -> <MSER as OpenCVTypeExternContainer>::ExternSend

Return the underlying raw pointer.

fn as_raw_mut(&mut self) -> <MSER as OpenCVTypeExternContainer>::ExternSendMut

Return the underlying mutable raw pointer

impl Debug for MSER

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for MSER

fn drop(&mut self)

Executes the destructor for this type.

impl Feature2DTrait for MSER

fn as_raw_mut_Feature2D(&mut self) -> *mut c_void

fn detect( &mut self, image: &impl ToInputArray, keypoints: &mut Vector<KeyPoint>, mask: &impl ToInputArray, ) -> Result<()>

Detects keypoints in an image (first variant) or image set (second variant).

fn detect_def( &mut self, image: &impl ToInputArray, keypoints: &mut Vector<KeyPoint>, ) -> Result<()>

Detects keypoints in an image (first variant) or image set (second variant).

fn detect_multiple( &mut self, images: &impl ToInputArray, keypoints: &mut Vector<Vector<KeyPoint>>, masks: &impl ToInputArray, ) -> Result<()>

Detects keypoints in an image (first variant) or image set (second variant).

fn detect_multiple_def( &mut self, images: &impl ToInputArray, keypoints: &mut Vector<Vector<KeyPoint>>, ) -> Result<()>

@overload

fn compute( &mut self, image: &impl ToInputArray, keypoints: &mut Vector<KeyPoint>, descriptors: &mut impl ToOutputArray, ) -> Result<()>

Computes the descriptors for a set of keypoints detected in an image (first variant) or image set (second variant).

fn compute_multiple( &mut self, images: &impl ToInputArray, keypoints: &mut Vector<Vector<KeyPoint>>, descriptors: &mut impl ToOutputArray, ) -> Result<()>

Computes the descriptors for a set of keypoints detected in an image (first variant) or image set (second variant).

fn detect_and_compute( &mut self, image: &impl ToInputArray, mask: &impl ToInputArray, keypoints: &mut Vector<KeyPoint>, descriptors: &mut impl ToOutputArray, use_provided_keypoints: bool, ) -> Result<()>

Detects keypoints and computes the descriptors

fn detect_and_compute_def( &mut self, image: &impl ToInputArray, mask: &impl ToInputArray, keypoints: &mut Vector<KeyPoint>, descriptors: &mut impl ToOutputArray, ) -> Result<()>

Detects keypoints and computes the descriptors

fn read(&mut self, file_name: &str) -> Result<()>

fn read_from_node(&mut self, unnamed: &impl FileNodeTraitConst) -> Result<()>

impl Feature2DTraitConst for MSER

fn as_raw_Feature2D(&self) -> *const c_void

fn descriptor_size(&self) -> Result<i32>

fn descriptor_type(&self) -> Result<i32>

fn default_norm(&self) -> Result<i32>

fn write(&self, file_name: &str) -> Result<()>

fn write_to_storage(&self, unnamed: &mut impl FileStorageTrait) -> Result<()>

fn empty(&self) -> Result<bool>

Return true if detector object is empty

fn get_default_name(&self) -> Result<String>

fn write_to_storage_with_name( &self, fs: &mut impl FileStorageTrait, name: &str, ) -> Result<()>

fn write_to_storage_ptr_with_name( &self, fs: &Ptr<FileStorage>, name: &str, ) -> Result<()>

impl From<MSER> for Algorithm

fn from(s: MSER) -> Self

Converts to this type from the input type.

impl From<MSER> for Feature2D

fn from(s: MSER) -> Self

Converts to this type from the input type.

impl MSERTrait for MSER

fn as_raw_mut_MSER(&mut self) -> *mut c_void

fn detect_regions( &mut self, image: &impl ToInputArray, msers: &mut Vector<Vector<Point>>, bboxes: &mut Vector<Rect>, ) -> Result<()>

Detect %MSER regions

fn set_delta(&mut self, delta: i32) -> Result<()>

fn set_min_area(&mut self, min_area: i32) -> Result<()>

fn set_max_area(&mut self, max_area: i32) -> Result<()>

fn set_max_variation(&mut self, max_variation: f64) -> Result<()>

fn set_min_diversity(&mut self, min_diversity: f64) -> Result<()>

fn set_max_evolution(&mut self, max_evolution: i32) -> Result<()>

fn set_area_threshold(&mut self, area_threshold: f64) -> Result<()>

fn set_min_margin(&mut self, min_margin: f64) -> Result<()>

fn set_edge_blur_size(&mut self, edge_blur_size: i32) -> Result<()>

fn set_pass2_only(&mut self, f: bool) -> Result<()>

impl MSERTraitConst for MSER

fn as_raw_MSER(&self) -> *const c_void

fn get_delta(&self) -> Result<i32>

fn get_min_area(&self) -> Result<i32>

fn get_max_area(&self) -> Result<i32>

fn get_max_variation(&self) -> Result<f64>

fn get_min_diversity(&self) -> Result<f64>

fn get_max_evolution(&self) -> Result<i32>

fn get_area_threshold(&self) -> Result<f64>

fn get_min_margin(&self) -> Result<f64>

fn get_edge_blur_size(&self) -> Result<i32>

fn get_pass2_only(&self) -> Result<bool>

fn get_default_name(&self) -> Result<String>

impl TryFrom<Feature2D> for MSER

type Error = Error

The type returned in the event of a conversion error.

fn try_from(s: Feature2D) -> Result<Self>

Performs the conversion.

impl Send for MSER