OpenCVForUnity.Features2dModule.MSER Class Reference

Maximally stable extremal region extractor. More...

Public Member Functions
void	detectRegions (Mat image, List< MatOfPoint > msers, MatOfRect bboxes)
	Detect MSER regions.
double	getAreaThreshold ()
override string	getDefaultName ()
int	getDelta ()
int	getEdgeBlurSize ()
int	getMaxArea ()
int	getMaxEvolution ()
double	getMaxVariation ()
int	getMinArea ()
double	getMinDiversity ()
double	getMinMargin ()
bool	getPass2Only ()
void	setAreaThreshold (double areaThreshold)
void	setDelta (int delta)
void	setEdgeBlurSize (int edge_blur_size)
void	setMaxArea (int maxArea)
void	setMaxEvolution (int maxEvolution)
void	setMaxVariation (double maxVariation)
void	setMinArea (int minArea)
void	setMinDiversity (double minDiversity)
void	setMinMargin (double min_margin)
void	setPass2Only (bool f)
Public Member Functions inherited from OpenCVForUnity.Features2dModule.Feature2D
void	compute (List< Mat > images, List< MatOfKeyPoint > keypoints, List< Mat > descriptors)
void	compute (Mat image, MatOfKeyPoint keypoints, Mat descriptors)
	Computes the descriptors for a set of keypoints detected in an image (first variant) or image set (second variant).
int	defaultNorm ()
int	descriptorSize ()
int	descriptorType ()
void	detect (List< Mat > images, List< MatOfKeyPoint > keypoints)
void	detect (List< Mat > images, List< MatOfKeyPoint > keypoints, List< Mat > masks)
void	detect (Mat image, MatOfKeyPoint keypoints)
	Detects keypoints in an image (first variant) or image set (second variant).
void	detect (Mat image, MatOfKeyPoint keypoints, Mat mask)
	Detects keypoints in an image (first variant) or image set (second variant).
void	detectAndCompute (Mat image, Mat mask, MatOfKeyPoint keypoints, Mat descriptors)
void	detectAndCompute (Mat image, Mat mask, MatOfKeyPoint keypoints, Mat descriptors, bool useProvidedKeypoints)
override bool	empty ()
	Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read.
void	read (string fileName)
void	write (string fileName)
Public Member Functions inherited from OpenCVForUnity.CoreModule.Algorithm
virtual void	clear ()
	Clears the algorithm state.
IntPtr	getNativeObjAddr ()
void	save (string filename)
Public Member Functions inherited from OpenCVForUnity.DisposableObject
void	Dispose ()
void	ThrowIfDisposed ()

Static Public Member Functions
static new MSER	__fromPtr__ (IntPtr addr)
static MSER	create ()
	Full constructor for MSER detector.
static MSER	create (int delta)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area, double max_variation)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area, double max_variation, double min_diversity)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution, double area_threshold)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution, double area_threshold, double min_margin)
	Full constructor for MSER detector.
static MSER	create (int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution, double area_threshold, double min_margin, int edge_blur_size)
	Full constructor for MSER detector.
Static Public Member Functions inherited from OpenCVForUnity.Features2dModule.Feature2D
static new Feature2D	__fromPtr__ (IntPtr addr)
Static Public Member Functions inherited from OpenCVForUnity.CoreModule.Algorithm
static Algorithm	__fromPtr__ (IntPtr addr)
Static Public Member Functions inherited from OpenCVForUnity.DisposableObject
static IntPtr	ThrowIfNullIntPtr (IntPtr ptr)

Protected Member Functions
override void	Dispose (bool disposing)
Protected Member Functions inherited from OpenCVForUnity.Features2dModule.Feature2D
Protected Member Functions inherited from OpenCVForUnity.CoreModule.Algorithm
Protected Member Functions inherited from OpenCVForUnity.DisposableOpenCVObject
	DisposableOpenCVObject ()
	DisposableOpenCVObject (bool isEnabledDispose)
	DisposableOpenCVObject (IntPtr ptr)
	DisposableOpenCVObject (IntPtr ptr, bool isEnabledDispose)
Protected Member Functions inherited from OpenCVForUnity.DisposableObject
	DisposableObject ()
	DisposableObject (bool isEnabledDispose)

Additional Inherited Members
Package Functions inherited from OpenCVForUnity.Features2dModule.Feature2D
Package Functions inherited from OpenCVForUnity.CoreModule.Algorithm
Package Attributes inherited from OpenCVForUnity.DisposableOpenCVObject
Properties inherited from OpenCVForUnity.DisposableObject
bool	IsDisposed [get, protected set]
bool	IsEnabledDispose [get, set]

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

__fromPtr__()

static new MSER OpenCVForUnity.Features2dModule.MSER.__fromPtr__ ( IntPtr addr )

static

create() [1/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( )

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

create() [2/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta )

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

create() [3/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area )

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

create() [4/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area )

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

create() [5/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area, double max_variation )

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

create() [6/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area, double max_variation, double min_diversity )

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

create() [7/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution )

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

create() [8/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution, double area_threshold )

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

create() [9/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution, double area_threshold, double min_margin )

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

create() [10/10]

static MSER OpenCVForUnity.Features2dModule.MSER.create ( int delta, int min_area, int max_area, double max_variation, double min_diversity, int max_evolution, double area_threshold, double min_margin, int edge_blur_size )

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

void OpenCVForUnity.Features2dModule.MSER.detectRegions	(	Mat	image,
		List< MatOfPoint >	msers,
		MatOfRect	bboxes )

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

Dispose()

override void OpenCVForUnity.Features2dModule.MSER.Dispose ( bool disposing )

protectedvirtual

Reimplemented from OpenCVForUnity.Features2dModule.Feature2D.

getAreaThreshold()

double OpenCVForUnity.Features2dModule.MSER.getAreaThreshold

(

)

getDefaultName()

override string OpenCVForUnity.Features2dModule.MSER.getDefaultName ( )

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 OpenCVForUnity.Features2dModule.Feature2D.

getDelta()

int OpenCVForUnity.Features2dModule.MSER.getDelta

(

)

getEdgeBlurSize()

int OpenCVForUnity.Features2dModule.MSER.getEdgeBlurSize

(

)

getMaxArea()

int OpenCVForUnity.Features2dModule.MSER.getMaxArea

(

)

getMaxEvolution()

int OpenCVForUnity.Features2dModule.MSER.getMaxEvolution

(

)

getMaxVariation()

double OpenCVForUnity.Features2dModule.MSER.getMaxVariation

(

)

getMinArea()

int OpenCVForUnity.Features2dModule.MSER.getMinArea

(

)

getMinDiversity()

double OpenCVForUnity.Features2dModule.MSER.getMinDiversity

(

)

getMinMargin()

double OpenCVForUnity.Features2dModule.MSER.getMinMargin

(

)

getPass2Only()

bool OpenCVForUnity.Features2dModule.MSER.getPass2Only

(

)

setAreaThreshold()

void OpenCVForUnity.Features2dModule.MSER.setAreaThreshold

(

double

areaThreshold

)

setDelta()

void OpenCVForUnity.Features2dModule.MSER.setDelta

(

int

delta

)

setEdgeBlurSize()

void OpenCVForUnity.Features2dModule.MSER.setEdgeBlurSize

(

int

edge_blur_size

)

setMaxArea()

void OpenCVForUnity.Features2dModule.MSER.setMaxArea

(

int

maxArea

)

setMaxEvolution()

void OpenCVForUnity.Features2dModule.MSER.setMaxEvolution

(

int

maxEvolution

)

setMaxVariation()

void OpenCVForUnity.Features2dModule.MSER.setMaxVariation

(

double

maxVariation

)

setMinArea()

void OpenCVForUnity.Features2dModule.MSER.setMinArea

(

int

minArea

)

setMinDiversity()

void OpenCVForUnity.Features2dModule.MSER.setMinDiversity

(

double

minDiversity

)

setMinMargin()

void OpenCVForUnity.Features2dModule.MSER.setMinMargin

(

double

min_margin

)

setPass2Only()

void OpenCVForUnity.Features2dModule.MSER.setPass2Only

(

bool

f

)

---

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

• OpenCVForUnity/Assets/OpenCVForUnity/org/opencv/features2d/MSER.cs