画像処理ボードVP910を使ったアプリケーション作成方法

環境　：　ＶＣ＋＋６．０　＋　ＶＰ９１０ＳＤＫ(標準インストール)

コンパイル準備

ＶＣ＋＋６．０で、新しいプロジェクトを作成後、

�@　「ビルド」−「設定」を選択
�A　「Ｃ／Ｃ＋＋」タブの「プロジェクトオプション」に追加
　　/I  "C:\vp910sdk\pcdrv\include"
�B　「リンク」タブの「オブジェクト／ライブラリオプション」に追加
　　vp900cmd.lib
　　　「プロジェクトオプション」に追加
　　/libpath:"C:\vp910sdk\pcdrv\lib"

ＶＰ９１０関数呼び出し順序

ＶＰ９１０では、ボードの初期化を行う関数、ライブラリの初期化・設定を行う関数、実際の処理関数、終了処理関数の順番を守る必要があります。
ＭＦＣでは、関数実行順序がわかりにくくなっていますが、初期化関連はviewクラスのコンストラクタに、終了処理関連は同じくviewクラスのデストラクタに記述しておけば、間違いないでしょう。

初期化関連の記述　サンプル

ＶＰ９１０の初期化では、ボードの認識→ＩＰシステムの初期化→カメラ選択→カメラ解像度設定→（ついでに）ＶＰ９１０内画像バッファの取得を行います。

ボード認識

ボードの認識は、OpenIPDev関数で行います。複数枚ＶＰ９１０がインストールされていても対応できます。戻り値は認識したボードのＩＤ番号で、以後の関数呼び出しでは、第１引数として渡す重要な情報です。

ＩＰシステム初期化

画像処理ボード内画像処理システムの初期化を行います。ResetIPSys関数、LoadIPSys関数、BootIPSys関数、InitIP関数によって、システムのリセット→ファームウェアの読み込み→起動→初期化を行っています。

カメラ選択

SelectCamera関数によって、画像入力を行うカメラの端子とカメラ属性を設定します。

カメラ解像度設定

カメラ選択後に、SetVideoFrame関数で取り込み解像度の設定を行います。

画像バッファ取得

ＶＰ９１０内部の画像バッファを設定、ハンドルを取得します。
カメラから取り込む画像はＹＵＶなので、ＹＵＶ用画像バッファをAllocYUVImg関数で設定します。ＹＵＶのＵＶ成分をアクセスするためのハンドルもGetUVImgID関数で取得します。
またＰＣ側表示用にＹＵＶ画像をＲＧＢ画像へ変換しますが、これにもＲＧＢ画像を記憶するためのバッファが必要です。AllocRGBImg関数によってバッファを設定し、GetGImgID関数とGetBImgID関数でＧ成分とＢ成分をアクセスするためのハンドルを取得します。

ウィンドウサイズ設定

SetAllWindow関数で、クリッピング領域の設定をします。この設定は、全ての画像処理で必要ですので、同じクリッピング領域なら最初にまとめて設定しておきます。

終了処理関連の記述　サンプル

ＶＰ９１０の利用を終了するには、CloseIPDev()関数を呼びます。

実際の処理について

ここでは、画像処理に必要なバッファ（画像ボード側）の取得、カメラでのキャプチャ、ＹＵＶ→ＲＧＢ変換、ＰＣへのＲＧＢデータ読み出し、という実際の処理手順に沿って、ＶＰ９１０プログラミングの解説を行います。

画像バッファの確保

ＶＰ９１０では、ボード内部の画像バッファを指定して、何らかの処理を行います。従って、最初にすることは、処理に必要な大きさを持ったバッファを確保することです。バッファが正常に確保できるとイメージＩＤが発行され、以後画像バッファの指定にはこのイメージＩＤを使います。
そのアプリケーションで使用する画像バッファは、たぶん変化しないと思いますので、イメージＩＤ用変数をグローバル変数にして、初期化処理中でイメージＩＤを取得しておくと便利です。

例　１−１：ＹＵＶ用画像バッファ（サイズ６４０×５１２）を取得する

int   ImgYUV;
ImgYUV = AllocYUVImg(devID, IMG_FS_640H_512V);

例　１−２：ＲＧＢ用画像バッファ（サイズ６４０×５１２）を取得する

int   ImgRGB;
ImgRGB = AllocRGBImg(devID, IMG_FS_640H_512V);

例　１−３：ＲＧＢ画像でＧとＢも見たいとき、ImgRGB（実はＲ）からＧとＢの画像バッファを調べる

int   ImgG, ImgB;
ImgG = GetGImgID(devID, ImgRGB);
ImgB = GetRImgID(devID, ImgRGB);

カメラから画像をキャプチャする

ＶＰ９１０のネイティブ画像フォーマットはＹＵＶです。キャプチャコマンドもＹＵＶしかありません。キャプチャ後、ＹＵＶからＲＧＢへ変換します。

ＹＵＶイメージをＲＧＢイメージに変換する

ＶＰ９１０のネイティブ画像フォーマットはＹＵＶです。キャプチャコマンドもＹＵＶしかありません。キャプチャ後、ＹＵＶからＲＧＢへ変換します。

ＰＣにＲＧＢ画像を読み出す方法

ＰＣにＲＧＢ画像データを読み出すには、Ｒ・Ｇ・Ｂそれぞれの画像バッファからデータを読み出します。ＰＣ側のＲＧＢ画像データが、

struct RGB
{
     unsigned char    R, G, B;
} ;

の２次元配列となっている事が多いですが、ＶＰの関数はプレーン毎にアクセスする仕様ですので、ＲとＧとＢ別々の２次元配列になっている方が、効率よくデータを転送できます。

例　４−１：画像ウィンドウの設定(できるだけ隅々まで扱う設定)

SetWindow(devID, SYS_WIN, 0, 0, 639, 511);

例　４−２：画像データのリード（rbuf,gbuf,bbufは適当な大きさのあるＰＣ側バッファ）

ReadImg(devID, ImgRGB, rbuf, 640 * 512);
ReadImg(devID, ImgG, gbuf, 640 * 512);
ReadImg(devID, ImgB, bbuf, 640 * 512);

例　４−３：画像データのライト（rbuf,gbuf,bbufは適当な大きさのあるＰＣ側バッファ）

WriteImg(devID, ImgRGB, rbuf, 640 * 512);
WriteImg(devID, ImgG, gbuf, 640 * 512);
WriteImg(devID, ImgB, bbuf, 640 * 512);

以下、手順箇条書き

補足： ＩＰ５０００（ＶＰ９１０より前のシリーズ）では、ＰＣと画像処理ボードの間で画像データをやりとりするときには、画像バッファのオープン・クローズ処理が必要でした（ＶＰ９１０では不要）。オープンとクローズで、リードやライト処理を挟む形になります。互換性のために、ＶＰ９１０でも記述しておくと良いでしょう。

例　補−１：バッファオープン（要するに画像処理を中断する関数だと思います）

OpenImg(devID, WAIT_FOREVER);

例　補−２：バッファクローズ

CloseImg(devID);