Frame Filter Module Wizard

This chapter shows how to use a project wizard to create a frame filter module. A frame filter module can be loaded by other IC Imaging Control applications.

How to use

First of all, start Visual Studio 2003. If the "Start Page" is shown, click on the button "New Project". Otherwise, select File -> New -> Project from Visual Studio's menu.

The following dialog is shown:

Select the icon called IC Frame Filter Module. Enter a valid project name into the Name input field e.g. MyFilterModule. - this will be the name of the resulting FTF module file. Then, click the OK button. Now the project properties can be adjusted:

Input field description

The Frame Filter Module Wizards adds a Frame Filter class to the project. The input fields are nearly the same as in the Frame Filter Class Wizard

Filter name

This is the name of the filter that is specified by the user of the filter when creating it. Click here for a sample of the resulting source code.

Class name

This is the name of the class e.g. CMyFilter.

.h file

This is the name of the header file of the class. The name is generated by the class wizard. You may overwrite this name.

.cpp file

This is the name of the cpp file of the class. The name is generated by the class wizard. You may overwrite this name.

Transform filter / Update filter

These radio buttons determine, whether the newly created frame filter is a transform or an update filter. If the video format or color format of a frame is changed in the filter, a transform filter is used. It creates a new frame in memory in to which the data of the source frame is copied.

The update filter performs the changes directly in the current frame, so it is changed.

Property dialog

If this check box is checked, then the wizard will create a property dialog for the frame filter class. The property dialog is used to adjust parameters of the class.

Notify at start and stop live video

If you check this check box, the frame filter class wizard inserts the methods, that are called when startLive and stopLive are called. The methods are named notifyStart and notifyStop. Also a new boolean attribute m_bLiveVideoRunning is added to the class. The methods look like follows:

//////////////////////////////////////////////////////////////////////////
// This method is called by the framework when the live video is started.
//////////////////////////////////////////////////////////////////////////
 
void CMyFilter::notifyStart( const FrameTypeInfo& in_type, const FrameTypeInfo& out_type )
{
    m_bLiveVideoRunning = true;
}
 
//////////////////////////////////////////////////////////////////////////
// This method is called by the framework when the live video is stopped.
//////////////////////////////////////////////////////////////////////////
 
void CMyFilter::notifyStop()
{
    m_bLiveVideoRunning = false;
}

IC installation path

This text box contains the installation directory of IC Imaging Control. The classlib\*\TIS_UDSHL*.LIB libraries are included from this path. Additionally, the .ftf file that is created is saved in this directory.

Once you have followed all of the above steps, click on the Finish button. Now the wizard creates the class.

<< Project Wizards