IC Imaging Controlのフレームフィルタは、他のDirectShowライブラリと違ってDirectShowフィルタを使用するわけではありません。しかしそれらは画像ストリームを処理するDirectShowスレッドのコンテキスト内で実行されます。これによってプログラマーはDirectShowフィルタモジュールを作成して登録したり、パラメータ用にインターフェースを定義するする手間から解放されます。フレームフィルタはFrameFilterImplクラスライブラリリファレンス＞クラス＞FrameFilterImplやFrameUpdateFilterImplクラスライブラリリファレンス＞クラス＞FrameUpdateFilterImplクラスから派生することで実装され、IFrameFilterクラスライブラリリファレンス＞クラス＞IFrameFilterクラスがそのパラメータへのアクセスを容易にします。フレームフィルタはフィルタモジュールの一部として実装することができますが、クラスがわかっていればアプリケーションで直接作成することも可能です。フレームフィルタクラスやフレームフィルタモジュールの作成を簡単に行えるようにVisual Studio .NET用のプロジェクトウィザードC++用のウィザードを使用したセットアップについてが用意されています。これらを使って少しのマウス操作でフィルタを作成することができます。フレームフィルタは基本的に画像処理という点においてDirectShowフィルタと同様のパフォーマンスを提供しながらも、はるかに容易に実装することができます。

フレームフィルタの機能によって、新しいIC Imaging Controlベースで多種多様なアプリケーションの作成が可能となりました。この新しい機能をつかってどういったことができるかを紹介するために、フレームフィルタと共に実装可能なタスクのカテゴリーについて説明します。それらのうちいくつかはIC Imaging Controlに標準で備わっています。

次にフレームフィルタの2つの基本タイプについて説明します。どちらも同様のパラメータへのアクセスを提供し、フレームに反映されます。

先ほど説明したように、フレームフィルタはアプリケーション内に直接作成したり、フィルタモジュールよりロードすることが可能です。 IC Imaging Controlはstdfilters.ftfモジュールに数種類かのフィルタを備えています。現在利用可能な全フィルタモジュールにあるフレームフィルタの一覧を見たい場合はFilterLoader::getAvailableFrameFiltersクラスライブラリリファレンス＞クラス＞FilterLoader＞FilterLoader::getAvailableFrameFilters Methodメソッドをコールしてください。FilterLoader::setLoadPathクラスライブラリリファレンス＞クラス＞FilterLoader＞FilterLoader::setLoadPath Methodメソッドで追加のフィルタモジュール用パスを指定することも可能です。FilterLoader::createFilterクラスライブラリリファレンス＞クラス＞FilterLoader＞FilterLoader::createFilter Methodへのコールで一覧リストから選択されたフィルタのインスタンスを作成します。フィルタフレームインスタンスを取得できましたので、これを画像ストリーム上にある以下の3カ所に挿入することができます。

• デバイスの後ろ: Grabber::setDeviceFrameFiltersクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::setDeviceFrameFilters Method
• ディスプレイの前: Grabber::setDisplayFrameFiltersクラスライブラリリファレンス＞クラス＞Grabber＞Grabber::setDisplayFrameFilters Method
• シンクの前: MediaStreamSink::createクラスライブラリリファレンス＞クラス＞MediaStreamSink＞MediaStreamSink::create Method, FrameHandlerSink::createクラスライブラリリファレンス＞クラス＞FrameHandlerSink＞FrameHandlerSink::create Method

同じフレームフィルタのインスタンスを画像ストリーム上の複数箇所で使用しないでください。内部不整合を引き起こす可能性があります。特にFrameFilterImpl::notifyStartクラスライブラリリファレンス＞クラス＞FrameFilterImpl＞FrameFilterImpl::notifyStart Method や FrameFilterImpl::notifyStopクラスライブラリリファレンス＞クラス＞FrameFilterImpl＞FrameFilterImpl::notifyStop Methodが使われている場合にはこの恐れがあります。もし同じフィルタを複数個所に挿入する必要がある場合、別のインスタンスを使うようにしてください。

フレームフィルタの内部データにはパラメータインターフェースからアクセスすることができます。

IFrameFilter::getParameterクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::setParameter Method やIFrameFilter::setParameterクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::setParameter Methodメソッドを使うことで bool, int, long float,std::stringといった基本的なデータ型のフィルタからの読み取り、またはそこへの書き込みが可能となります。 バイナリデータのブロックは IFrameFilter::getDataクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::getData Method や IFrameFilter::setDataクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::setParameter Methodといったメソッドを使うことでフレームフィルタと交換することができます。フィルタのtransformメソッドはDirectShow スレッドの中で実行されるため、フィルタデータへの外部アクセスと内部アクセスを同期させることがとても重要になります。よってまず先にIFrameFilter::beginParamTransferクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::beginParamTransfer Methodへのコールがあり、その後に上記で述べた4つのメソッドへのコール、続いてIFrameFilter::endParamTransferクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::endParamTransfer Methodへのコールという順番にならなければいけません。

pFrameFilter->beginParamTransfer();

// setParameter と getParameterへのコールは全てここに

pFrameFilter->endParamTransfer();

フレームフィルタをFilter Inspectorプログラマーズガイド＞フィルタインスペクタのような包括的アプリケーションで使用する場合、パラメータが双方向的に変更されるようダイアログを実装されることが望まれます。フレームフィルタはIFrameFilter::hasDialogクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::hasDialog Methodメソッドにおいてtrue を返すことでパラメータダイアログの提供を示唆します。IFrameFilter::callDialogクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::callDialog Method メソッドがコールされるとダイアログが表示されるはずです。

全てのフレームフィルタはIFrameFilter::getSettingsクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::getSettings MethodやIFrameFilter::setSettingsクラスライブラリリファレンス＞クラス＞IFrameFilter＞IFrameFilter::setSettings Methodメソッドを実装し内部データをシリアライズ化ができるようにしなければいけません。そしてデータの表示形式は文字列に対応する必要があります。

Visual Studio .NET では、ウィザードを使うことによって簡単なマウス操作だけでフレームフィルタ/フィルタモジュールの作成が可能です。詳細はプロジェクトウィザードC++用のウィザードを使用したセットアップについてをご参照ください。ウィザードがどういったものかを理解したいというのであれば、フレームフィルタを記述する: 2値化プログラマーズガイド＞フレームフィルタの記述: 二値化処理、フィルタモジュールの作成プログラマーズガイド＞フィルタモジュールの作成において詳しく説明しております。