MontiVision DirectShow SDK Documentation

The IMVNonLinFilter 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_NonLinFilterMode	Returns the operation mode of the nonlinear filter.
put_NonLinFilterMode	Sets the operation mode of the nonlinear filter.
get_XAperture	Returns the horizontal aperture of the filter kernel.
put_XAperture	Sets the horizontal aperture of the filter kernel.
get_YAperture	Returns the vertical aperture of the filter kernel.
put_YAperture	Sets the vertical aperture of the filter kernel.
get_XAnchor	Returns the horizontal anchor of the filter kernel.
put_XAnchor	Sets the horizontal anchor of the filter kernel.
get_YAnchor	Returns the vertical anchor of the filter kernel.
put_YAnchor	Sets the vertical anchor of the filter kernel.

Header file: iMVNonLinFilter.h
Interface definition language file: iMVNonLinFilter.idl
Typelib: MVNonLinFilter
Interface ID: IID_IMVNonLinFilter

HRESULT get_NonLinFilterMode( [out, retval] int *piMode );

Returns the operation mode of the nonlinear filter.

Parameter:

piMode

A pointer to an integer value that receives the operation mode as MV_NONLINFILTER_TYPE .

HRESULT put_NonLinFilterMode( [in ] int iMode );

Sets the operation mode of the nonlinear filter.

Parameter:

iMode

The operation mode as MV_NONLINFILTER_TYPE .

HRESULT get_XAperture( [out, retval] int *piXAperture );

Returns the horizontal aperture of the filter kernel.

Parameter:

piXAperture

A pointer to an integer value that receives the number of filter kernel columns. (horizontal aperture)

HRESULT put_XAperture( [in ] int iXAperture );

Sets the horizontal aperture of the filter kernel.

Parameter:

iXAperture

The number of filter kernel columns. (horizontal aperture)

HRESULT get_YAperture( [out, retval] int *piYAperture );

Returns the vertical aperture of the filter kernel.

Parameter:

piYAperture

A pointer to an integer value that receives the number of filter kernel rows. (vertical aperture)

HRESULT put_YAperture( [in ] int iYAperture );

Sets the vertical aperture of the filter kernel.

Parameter:

iYAperture

The number of filter kernel rows. (vertical aperture)

HRESULT get_XAnchor( [out, retval] int *piXAnchor );

Returns the horizontal anchor of the filter kernel.

Parameter:

piXAnchor

A pointer to an integer value that receives the horizontal anchor.

HRESULT put_XAnchor( [in ] int iXAnchor );

Sets the horizontal anchor of the filter kernel.

Parameter:

iXAnchor

The horizontal anchor.

HRESULT get_YAnchor( [out, retval] int *piYAnchor );

Returns the vertical anchor of the filter kernel.

Parameter:

piYAnchor

A pointer to an integer value that receives the vertical anchor.

HRESULT put_YAnchor( [in ] int iYAnchor );

Sets the vertical anchor of the filter kernel.

Parameter:

iYAnchor

The vertical anchor.

Filter specific structures and enumerators

typedef enum _MV_NONLINFILTER_TYPE
{
    MV_NONLINFILTER_MEDIAN = 0,
    MV_NONLINFILTER_MIN,
    MV_NONLINFILTER_MAX,
    MV_NONLINFILTER_MEDIAN_C
} MV_NONLINFILTER_TYPE;

Remarks

The following sequence is used to .

IMVNonLinFilter *pIMVNonLinFilter;

...

// We want to use the median operator with a 3x3 kernel
pIMVNonLinFilter->put_NonLinFilterMode( MV_NONLINFILTER_MEDIAN );
pIMVNonLinFilter->put_XAperture( 3 );
pIMVNonLinFilter->put_YAperture( 3 );
pIMVNonLinFilter->put_XAnchor( 1 );
pIMVNonLinFilter->put_YAnchor( 1 );