IMVFilterInfo

The IMVFilterInfo interface offers several methods to get general information about a MontiVision image processing filter. Read the remarks for ímplementation details.

GetNumOfInPins Returns the number of the filter's video input pins.
get_NumOfOutPins Returns the number of the filter's video output pins.
get_SelectedInfoPin Returns the currently selected info pin.
put_SelectedInfoPin Selects the current info pin.
get_InfoPinDirection Returns the current pin direction (input/output).
put_InfoPinDirection Sets the current pin direction (input/output).
GetImageInfo Returns the image dimensions of the selected pin.
GetImageWidth Returns the image width of the selected pin.
GetImageHeight Returns the image height of the selected pin.
GetNumOfChannels Returns the number of color channels of the image of the selected pin.
GetSymbol16 Returns the 16*16 pixel icon of the filter.
GetSymbol32 Returns the 32*32 pixel icon of the filter.

Header file: iMVFilterCommon.h
Interface definition language file: iMVFilterCommon.idl
Interface ID:IID_IMVFilterInfo

 

HRESULT GetNumOfInPins( [out, retval] int *piInputPins );

Returns the number of the filter's video input pins.

Parameter:

piInputPins A pointer to an integer value that receives the number of input pins.

 

HRESULT GetNumOfOutPins( [out, retval] int *piOutputPins );

Returns the number of the filter's video output pins.

Parameter:

piOutputPins A pointer to an integer value that receives the number of output pins.

 

HRESULT get_SelectedInfoPin( [out, retval] int *piActualPin );

Returns the currently selected info pin.

Parameter:

piActualPin A pointer to an integer value that receives the currently selected info pin.

 

HRESULT put_SelectedInfoPin( [in ] int iActualPin );

Selects the current info pin.

Parameter:

iActualPin The selected info pin number..

 

HRESULT get_InfoPinDirection( [out, retval] int *piPinDirection );

Returns the direction of the selected info pin.

Value Description
0 Output pin.
1 Input Pin

Parameter:

piPinDirection A pointer to an integer value that receives the number of input pins.

 

HRESULT put_InfoPinDirection( [in ] int iPinDirection );

Sets the direction of the selected info pin.

Value Description
0 Output pin.
1 Input Pin

Parameter:

iPinDirection The pin direction.

 

HRESULT GetImageInfo( [out] int *piWidth, [out] int *piHeight, [out] int *piChannel );

Returns the dimensions of the image of the selected info pin.

Parameter:

piWidth A pointer to an integer value that receives the image width.
piHeight A pointer to an integer value that receives the image height.
piChannel A pointer to an integer value that receives the number of color channels as MV_COLOR_CHANNEL.

 

HRESULT GetImageWidth( [out, retval] int *piWidth );

Returns the width of the image on the selected info pin.

Parameter:

piWidth A pointer to an integer value that receives the image width.

 

HRESULT GetImageHeight( [out, retval] int *piHeight );

Returns the height of the image on the selected info pin..

Parameter:

piHeight A pointer to an integer value that receives the image height.

 

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

Returns the number of color channels of the image of the selected info pin.

Parameter:

piChannel A pointer to an integer value that receives the number of color channels as MV_COLOR_CHANNEL.

 

HRESULT GetSymbol16( [out, retval] byte **ppbySymbol );

Returns the 16*16 picel icon of the filter.

Parameter:

ppbySymbol A pointer to a pointer that receives the filter icon as Windows BITMAP structure.

 

HRESULT GetSymbol32( [out, retval] byte **ppbySymbol );

Returns the 32*32 pixel icon of the filter.

Parameter:

ppbySymbol A pointer to a pointer that receives the filter icon as Windows BITMAP structure.

 

 

Remarks

The following sequence is used to receive information about the image dimension of a pin.

int iNumOfInPins, iWidth, iHeight, iChannel;
IMVFilterInfo *pIMVFilterInfo;

pIMVFilterInfo->GetNumOfInPins( &iInputPins );
if( iNumOfInPins > 0 )
{
   pIMVFilterInfo->put_InfoPinDirection( 1 );
   pIMVFilterInfo->put_SelectedInfoPin ( 0 );
   pIMVFilterInfo->GetImageInfo( &iWidth, &iHeight, &iChannel );
}