イメージバッファにアクセスする - RGB24 -

RGB24は24bit 、カラーのフォーマットです。 すべてのピクセルが3バイトで表されますが、1バイトがそれぞれ1色の値に対応します。'RGB' は それぞれRed (赤)、Green (緑)、Blue (青) を意味し、 3つのバイトがそれぞれRed, Green, Blueの値を表しているということになります。
RGBという呼び方は誤解を招く可能性があるかもしれません。というのもピクセルの最初のバイトが必ずしもRedの値を表すということではないためです。Windows© 環境においては、RGB データは大抵BGRの順に並んでいます。つまり最初のバイトがBlue,次にGreen, Redとなっているということです。IC Imaging Control はBGR 順になっており、イメージバッファのピクセルは左から右へ、下から上へと組織されます。

ピクセルデータの読み込み、書き込みの方法

ここでその動作を示すため、まずは画像取り込みデバイス、ビデオフォーマット、 FrameSnapSinkクラスライブラリリファレンス＞クラス＞FrameSnapSinkを 準備します。まず最初に、イメージバッファ内には何もありませんので、画像をキャプチャしなければなりません。そのためにライブ表示を開始し、FrameSnapSink.SnapImageクラスライブラリリファレンス＞クラス＞FrameSnapSink＞FrameSnapSink.SnapSingel Methodを呼び出し、GrabImageメソッドによってこれを行います。

バッファにアクセスする

イメージバッファのデータにアクセスするために、BufferAccessHelperのインスタンスを作成します。 そうすることで、buf[column,line]として個別のデータにアクセスできます。
今回の例では、画像中の最初の(一段左上から)2ピクセル分の読み出しをします。 次のステップでは最初の3ピクセルを扱います。RGB画像は下から上に保存されるため、最初のラインのインデックスはilines-1となります。
ピクセルデータのX座標を計算するため、1ピクセルあたりに必要なバイト数(3)に取得される縦のピクセルを掛けます。その後、ピクセルのRedかGreen,もしくはBlueコンポーネントにアクセスするためのオフセットが加えられます。

[C#]
// RGB24 はボトム アップなので最初のラインのインデックスはlines-1となります。
int y = frame.FrameType.Height - 1;

txtOutput.Text = "Image buffer pixel format is RGB24\r\n";
txtOutput.Text += "Pixel 1: ";
txtOutput.Text += "R=" + buf[0 * 3 + 2, y] + ", ";
txtOutput.Text += "G=" + buf[0 * 3 + 1, y] + ", ";
txtOutput.Text += "B=" + buf[0 * 3 + 0, y] + "\r\n";
txtOutput.Text += "Pixel 2: ";
txtOutput.Text += "R=" + buf[1 * 3 + 2, y] + ", ";
txtOutput.Text += "G=" + buf[1 * 3 + 1, y] + ", ";
txtOutput.Text += "B=" + buf[1 * 3 + 0, y];

画像データを操作する

ピクセルデータは読むだけではなく、操作することも可能です。次のコードは左上のピクセルをRedに、それに続くピクセルをそれぞれGreen,Blueに設定します。この変更を加えた後、画像はBMPファイルとして保存されます。

[C#]
// 最初のピクセル を red (255 0 0)に
buf[0 * 3 + 2, y] = 255;
buf[0 * 3 + 1, y] = 0;
buf[0 * 3 + 0, y] = 0;
// 2番目のピクセルを green  (0 255 0)に
buf[1 * 3 + 2, y] = 0;
buf[1 * 3 + 1, y] = 255;
buf[1 * 3 + 0, y] = 0;
// 3番目のピクセルを Blue  (0 0 255)に
buf[2 * 3 + 2, y] = 0;
buf[2 * 3 + 1, y] = 0;
buf[2 * 3 + 0, y] = 255;

TIS.Imaging.FrameExtensions.SaveAsBitmap(frame, "RGB24.bmp");

結果をチェックするために保存された画像を開き、左上のピクセルを見てください。次のように表示されるかと思います。