Execution

Functions
cvbres_t	BlobBinariseImage (IMG Src, TDRect *Rect, cvbdim_t lPlane, cvbval_t lLow, cvbval_t lHigh, IMG Dst)
	This function binarizes an image.
cvbres_t	BlobExec (PBLOB BlobHandle)
	This function executes blob analysis.
cvbres_t	BlobGetExecTime (PBLOB BlobHandle, double &dValue)
	This function returns the execution time of the last blob analysis.
cvbres_t	BlobLSEnd (PBLOB BlobHandle)
	Finalize the current analysis. NoAdditional data is processed.
cvbres_t	BlobLSNext (PBLOB BlobHandle)
	Process the current frame. Before the first call to BlobLSNext the function BlobLSStart must be called.
cvbres_t	BlobLSStart (PBLOB BlobHandle)
	This function initializes a blob analysis across multiple frames. The current frame is NOT processed. A call to BlobSetImage will terminate and reset the ongoing processing.
cvbres_t	BlobSort (PBLOB BlobHandle)
	This function sorts the objects by certain criteria (see BlobSetSortMode).

Detailed Description

Function Documentation

BlobBinariseImage()

cvbres_t BlobBinariseImage	(	IMG	Src,
		TDRect *	Rect,
		cvbdim_t	lPlane,
		cvbval_t	lLow,
		cvbval_t	lHigh,
		IMG	Dst )

This function binarizes an image.

Parameters

[in]	Src	Handle to the source image.
[in]	Rect	Area of interest in which the image will be binarized.
[in]	lPlane	Plane index in the source image to be processed.
[in]	lLow	Lower limit used for binarization.
[in]	lHigh	Upper limit used for binarization.
[out]	Dst	Handle to the destination image.

Returns

>= 0 on success,
< 0 if an error occurs.

Supported platforms:

Win32
Win64

Examples:

Visual Basic - VB Blob Detection Example
Visual C++ - VC Blob Example

BlobExec()

cvbres_t BlobExec

(

PBLOB

BlobHandle

)

This function executes blob analysis.

Parameters

[in]

BlobHandle

Handle to the Blob object.

Returns

CVC_E_OK on success, otherwise if an error occurs this function returns either CVC_E_PARAMETER or CVC_BLOB_E_TOO_MANY_OBJECTS.

Supported platforms:

Win32
Win64

Examples:

Delphi - Delphi Blob Detection Example
Visual Basic - VB Blob Detection Example
Visual C++ - VC Blob Example

BlobGetExecTime()

cvbres_t BlobGetExecTime	(	PBLOB	BlobHandle,
		double &	dValue )

This function returns the execution time of the last blob analysis.

Parameters

[in]	BlobHandle	Handle to the Blob object.
[out]	dValue	Execution time in milliseconds.

Returns

CVC_E_OK on success, otherwise CVC_E_PARAMETER for invalid function parameters.

Supported platforms:

Win32
Win64

Examples:

Visual C++ - VC Blob Example

BlobLSEnd()

cvbres_t BlobLSEnd

(

PBLOB

BlobHandle

)

Finalize the current analysis. NoAdditional data is processed.

Parameters

[in]

BlobHandle

Handle to the Blob object.

Returns

CVC_E_OK on success, otherwise if an error occurs this function returns either CVC_E_PARAMETER or CVC_BLOB_E_TOO_MANY_OBJECTS.

BlobLSNext()

cvbres_t BlobLSNext

(

PBLOB

BlobHandle

)

Process the current frame. Before the first call to BlobLSNext the function BlobLSStart must be called.

Parameters

[in]

BlobHandle

Handle to the Blob object.

Returns

CVC_E_OK on success, otherwise if an error occurs this function returns either CVC_E_PARAMETER or CVC_BLOB_E_TOO_MANY_OBJECTS.

BlobLSStart()

cvbres_t BlobLSStart

(

PBLOB

BlobHandle

)

This function initializes a blob analysis across multiple frames. The current frame is NOT processed. A call to BlobSetImage will terminate and reset the ongoing processing.

Parameters

[in]

BlobHandle

Handle to the Blob object.

Returns

CVC_E_OK on success, otherwise if an error occurs this function returns either CVC_E_PARAMETER or CVC_BLOB_E_TOO_MANY_OBJECTS.

BlobSort()

cvbres_t BlobSort

(

PBLOB

BlobHandle

)

This function sorts the objects by certain criteria (see BlobSetSortMode).

Parameters

[in]

BlobHandle

Handle to the Blob object.

Returns

CVC_E_OK on success, otherwise if an error occurs this function returns either CVC_E_PARAMETER or CVC_BLOB_E_INVALID_DATA.

Supported platforms:

Win32
Win64

Examples:

Delphi - Delphi Blob Detection Example
Visual Basic - VB Blob Detection Example