IC Imaging Control C++

Frame Filter Module Wizard

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:

image

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:

image

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

Get in touch with us


About The Imaging Source

Established in 1990, The Imaging Source is one of the leading manufacturers of industrial cameras, frame grabbers and video converters for production automation, quality assurance, logistics, medicine, science and security.

Our comprehensive range of cameras with USB 3.1, USB 3.0, USB 2.0, GigE interfaces and other innovative machine vision products are renowned for their high quality and ability to meet the performance requirements of demanding applications.

Automated Imaging Association ISO 9001:2015 certified

Contact us