Maximally stable extremal region extractor. More...

#include <features2d.hpp>

Inheritance diagram for cv::MSER:

Public Member Functions
virtual CV_WRAP void	detectRegions (InputArray image, CV_OUT std::vector< std::vector< Point > > &msers, CV_OUT std::vector< Rect > &bboxes)=0
	Detect MSER regions. More...

virtual CV_WRAP void	setDelta (int delta)=0

virtual CV_WRAP int	getDelta () const =0

virtual CV_WRAP void	setMinArea (int minArea)=0

virtual CV_WRAP int	getMinArea () const =0

virtual CV_WRAP void	setMaxArea (int maxArea)=0

virtual CV_WRAP int	getMaxArea () const =0

virtual CV_WRAP void	setMaxVariation (double maxVariation)=0

virtual CV_WRAP double	getMaxVariation () const =0

virtual CV_WRAP void	setMinDiversity (double minDiversity)=0

virtual CV_WRAP double	getMinDiversity () const =0

virtual CV_WRAP void	setMaxEvolution (int maxEvolution)=0

virtual CV_WRAP int	getMaxEvolution () const =0

virtual CV_WRAP void	setAreaThreshold (double areaThreshold)=0

virtual CV_WRAP double	getAreaThreshold () const =0

virtual CV_WRAP void	setMinMargin (double min_margin)=0

virtual CV_WRAP double	getMinMargin () const =0

virtual CV_WRAP void	setEdgeBlurSize (int edge_blur_size)=0

virtual CV_WRAP int	getEdgeBlurSize () const =0

virtual CV_WRAP void	setPass2Only (bool f)=0

virtual CV_WRAP bool	getPass2Only () const =0

virtual CV_WRAP String	getDefaultName () const CV_OVERRIDE

Public Member Functions inherited from cv::Feature2D
virtual	~Feature2D ()

virtual CV_WRAP void	detect (InputArray image, CV_OUT std::vector< KeyPoint > &keypoints, InputArray mask=noArray())
	Detects keypoints in an image (first variant) or image set (second variant). More...

virtual CV_WRAP void	detect (InputArrayOfArrays images, CV_OUT std::vector< std::vector< KeyPoint > > &keypoints, InputArrayOfArrays masks=noArray())

virtual CV_WRAP void	compute (InputArray image, CV_OUT CV_IN_OUT std::vector< KeyPoint > &keypoints, OutputArray descriptors)
	Computes the descriptors for a set of keypoints detected in an image (first variant) or image set (second variant). More...

virtual CV_WRAP void	compute (InputArrayOfArrays images, CV_OUT CV_IN_OUT std::vector< std::vector< KeyPoint > > &keypoints, OutputArrayOfArrays descriptors)

virtual CV_WRAP void	detectAndCompute (InputArray image, InputArray mask, CV_OUT std::vector< KeyPoint > &keypoints, OutputArray descriptors, bool useProvidedKeypoints=false)

virtual CV_WRAP int	descriptorSize () const

virtual CV_WRAP int	descriptorType () const

virtual CV_WRAP int	defaultNorm () const

CV_WRAP void	write (const String &fileName) const

CV_WRAP void	read (const String &fileName)

virtual void	write (FileStorage &) const CV_OVERRIDE
	Stores algorithm parameters in a file storage. More...

virtual CV_WRAP void	read (const FileNode &) CV_OVERRIDE
	Reads algorithm parameters from a file storage. More...

virtual CV_WRAP bool	empty () const CV_OVERRIDE
	Return true if detector object is empty. More...

CV_WRAP void	write (FileStorage &fs, const String &name) const

void	write (const Ptr< FileStorage > &fs, const String &name) const

Public Member Functions inherited from cv::Algorithm
	Algorithm ()

virtual	~Algorithm ()

virtual CV_WRAP void	clear ()
	Clears the algorithm state. More...

CV_WRAP void	write (FileStorage &fs, const String &name) const

void	write (const Ptr< FileStorage > &fs, const String &name=String()) const

virtual CV_WRAP void	save (const String &filename) const

Static Public Member Functions
static CV_WRAP Ptr< MSER >	create (int delta=5, int min_area=60, int max_area=14400, double max_variation=0.25, double min_diversity=.2, int max_evolution=200, double area_threshold=1.01, double min_margin=0.003, int edge_blur_size=5)
	Full constructor for MSER detector. More...

Static Public Member Functions inherited from cv::Algorithm
template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	Reads algorithm from the file node. More...

template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	Loads algorithm from the file. More...

template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	Loads algorithm from a String. More...

Additional Inherited Members
Protected Member Functions inherited from cv::Algorithm
void	writeFormat (FileStorage &fs) const

Detailed Description

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

Member Function Documentation

◆ create()

static CV_WRAP Ptr<MSER> cv::MSER::create	(	int	delta = `5`,
		int	min_area = `60`,
		int	max_area = `14400`,
		double	max_variation = `0.25`,
		double	min_diversity = `.2`,
		int	max_evolution = `200`,
		double	area_threshold = `1.01`,
		double	min_margin = `0.003`,
		int	edge_blur_size = `5`
	)

static

Full constructor for MSER detector.

Parameters

delta	it compares $(size_{i}-size_{i-delta})/size_{i-delta}$
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

◆ detectRegions()

virtual CV_WRAP void cv::MSER::detectRegions	(	InputArray	image,
		CV_OUT std::vector< std::vector< Point > > &	msers,
		CV_OUT std::vector< Rect > &	bboxes
	)

pure virtual

Detect MSER regions.

Parameters

image	input image (8UC1, 8UC3 or 8UC4, must be greater or equal than 3x3)
msers	resulting list of point sets
bboxes	resulting bounding boxes

◆ getAreaThreshold()

virtual CV_WRAP double cv::MSER::getAreaThreshold ( ) const

pure virtual

◆ getDefaultName()

virtual CV_WRAP String cv::MSER::getDefaultName ( ) const

virtual

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.

Reimplemented from cv::Feature2D.

◆ getDelta()

virtual CV_WRAP int cv::MSER::getDelta ( ) const

pure virtual

◆ getEdgeBlurSize()

virtual CV_WRAP int cv::MSER::getEdgeBlurSize ( ) const

pure virtual

◆ getMaxArea()

virtual CV_WRAP int cv::MSER::getMaxArea ( ) const

pure virtual

◆ getMaxEvolution()

virtual CV_WRAP int cv::MSER::getMaxEvolution ( ) const

pure virtual

◆ getMaxVariation()

virtual CV_WRAP double cv::MSER::getMaxVariation ( ) const

pure virtual

◆ getMinArea()

virtual CV_WRAP int cv::MSER::getMinArea ( ) const

pure virtual

◆ getMinDiversity()

virtual CV_WRAP double cv::MSER::getMinDiversity ( ) const

pure virtual

◆ getMinMargin()

virtual CV_WRAP double cv::MSER::getMinMargin ( ) const

pure virtual

◆ getPass2Only()

virtual CV_WRAP bool cv::MSER::getPass2Only ( ) const

pure virtual

◆ setAreaThreshold()

virtual CV_WRAP void cv::MSER::setAreaThreshold ( double areaThreshold )

pure virtual

◆ setDelta()

virtual CV_WRAP void cv::MSER::setDelta ( int delta )

pure virtual

◆ setEdgeBlurSize()

virtual CV_WRAP void cv::MSER::setEdgeBlurSize ( int edge_blur_size )

pure virtual

◆ setMaxArea()

virtual CV_WRAP void cv::MSER::setMaxArea ( int maxArea )

pure virtual

◆ setMaxEvolution()

virtual CV_WRAP void cv::MSER::setMaxEvolution ( int maxEvolution )

pure virtual

◆ setMaxVariation()

virtual CV_WRAP void cv::MSER::setMaxVariation ( double maxVariation )

pure virtual

◆ setMinArea()

virtual CV_WRAP void cv::MSER::setMinArea ( int minArea )

pure virtual

◆ setMinDiversity()

virtual CV_WRAP void cv::MSER::setMinDiversity ( double minDiversity )

pure virtual

◆ setMinMargin()

virtual CV_WRAP void cv::MSER::setMinMargin ( double min_margin )

pure virtual

◆ setPass2Only()

virtual CV_WRAP void cv::MSER::setPass2Only ( bool f )

pure virtual

The documentation for this class was generated from the following file:

build/release/_deps/opencv-src/include/opencv4/opencv2/features2d.hpp

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ create()

◆ detectRegions()

◆ getAreaThreshold()

◆ getDefaultName()

◆ getDelta()

◆ getEdgeBlurSize()

◆ getMaxArea()

◆ getMaxEvolution()

◆ getMaxVariation()

◆ getMinArea()

◆ getMinDiversity()

◆ getMinMargin()

◆ getPass2Only()

◆ setAreaThreshold()

◆ setDelta()

◆ setEdgeBlurSize()

◆ setMaxArea()

◆ setMaxEvolution()

◆ setMaxVariation()

◆ setMinArea()

◆ setMinDiversity()

◆ setMinMargin()

◆ setPass2Only()