MontiVision DirectShow SDK Documentation

The IMVBinary interface is used to control the filter's image processing algorithm. Read the filter description to see how the filter is used. Read the remarks for implementation details.

get_BinaryMethod	Returns the segmentation method.
put_BinaryMethod	Sets the segmentation method.
get_Threshold	Returns the currently used threshold.
put_Threshold	Sets the manual threshold.
get_PixelPercent	Returns the percentage of pixel for the Weszka algorithm.
put_PixelPercent	Sets the the percentage of pixel for the Weszka algorithm.
get_SelectedChannel	Returns the color channel that is used for segmentation.
put_SelectedChannel	Selects the color channel that is used for segmentation.

Header file: iMVBinary.h
Interface definition language file: iMVBinary.idl
Typelib: MVBinary
Interface ID: IID_IMVBinary

HRESULT get_BinaryMethod( [out, retval] int *piMethod );

Returns the currently used segmentation method as MV_BINARY_METHOD.

Parameter:

piMethod

A pointer to an integer value that receives the segmentation method as MV_BINARY_METHOD.

HRESULT put_BinaryMethod( [in ] int iMethod );

Sets the desired segmentation method as MV_BINARY_METHOD.

Parameter:

iMethod

The segmentation method as MV_BINARY_METHOD.

HRESULT get_Threshold( [out, retval] byte *pbyThreshold );

Returns the current threshold as byte.

Parameter:

pbyThreshold

A pointer to an integer value that receives the currently used threshold as a byte.

HRESULT put_Threshold( [in ] byte byThreshold );

Sets the manual threshold.

Parameter:

byThreshold

The threshold as a byte.

HRESULT get_PixelPercent( [out, retval] int *piPercent );

Returns the threshold for the laplacian array of the Weszka algorithm in percent.

Parameter:

piPercent

A pointer to an integer value that receives the laplacian array threshold for theWeska algorithm in percent. (0-100)

HRESULT put_PixelPercent( [in ] int iPercent );

Sets the threshold for the laplacian array of the Weszka algorithm in percent.

Parameter:

iPercent

The laplacian array threshold for theWeska algorithm in percent. (0-100)

HRESULT get_SelectedChannel( [out, retval] int *piChannel );

Returns the currently selected color channel that is used for the segmentation.

Parameter:

piChannel

A pointer to an integer value that receives the currently selected color channel that is used for segmentation as MV_COLOR_CHANNEL .

HRESULT put_SelectedChannel( [in ] int iChannel );

Sets the desired color channel that is used for the segmentation.

Parameter:

iChannel

The desired color channel to be used for segmentation as MV_COLOR_CHANNEL .

Filter specific structures and enumerators

typedef enum _MV_BINARY_METHOD
{
    MV_BINARY_MANUALLY= 0,
    MV_BINARY_JOHANNSEN,
    MV_BINARY_LAPLACE,
    MV_BINARY_TWOPEAKS
} MV_BINARY_METHOD;

Remarks

The following sequence is used to set a manual, all channel threshold.

IMVBinary *pIMVBinary;

...

// Manual thresholding
pIMVBinary->put_BinaryMethod( MV_BINARY_MANUALLY );
// Use all color channels
pIMVBinary->put_SelectedChannel( MV_CHANNEL_ALL );
// Set threshold to 128
pIMVBinary->put_Threshold( 128 );