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

RGB8 は8bit、モノクロのフォーマットです。すべてのピクセルが1バイトで表されます。イメージバッファのピクセルは左から右へ、下から上へと組織されます。 つまり、イメージバッファの1バイトめが映像における1番下のラインの最初のピクセルに対応しているということです。

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

画像取り込みデバイス、ビデオフォーマット、 FrameHandlerSinkクラスライブラリリファレンス＞クラス＞FrameHandlerSink と ImageBuffersクラスライブラリリファレンス＞クラス＞FrameHandlerSink＞FrameHandlerSink.ImageBuffers Property コレクション, これら画像データのカラーフォーマットを定義するためのものが全てセットアップされてなければなりません。以下のコードはRGB8ピクセルデータにどようにアクセスし、調整するのかを順番に説明しています。
まず最初に、イメージバッファ内には何もありませんので、画像をキャプチャしなければなりません。そのためにライブ表示を開始し、FrameHandlerSink.SnapImageクラスライブラリリファレンス＞クラス＞FrameHandlerSink＞FrameHandlerSink.SnapImage Method を呼び出します。

バッファにアクセスする

イメージバッファのデータにアクセスするために、C# なら buf[column,line]、VB.NETであれば buf(column,line)を記述します。
今回の例では、画像中の最初の(一段左上から)2ピクセル分の読み出しをします。 次のステップでは最初の3ピクセルを扱います。RGB 画像は下から上に保存されるため、最初のラインのインデックスはilines-1となります。

[VB.NET]
' RGB8はボトムアップのため、最初のラインのインデックスはlines-1となります。
Dim y As Integer = buf.Lines - 1

txtOutput.Text = "Image buffer pixel format is RGB8" & vbCrLf
txtOutput.Text &= "Pixel 1: " & buf(0, y) & vbCrLf
txtOutput.Text &= "Pixel 2: " & buf(1, y)
[C#]
// RGB8はボトムアップのため、最初のラインのインデックスはlines-1となります。
int y = buf.Lines - 1;

txtOutput.Text = "Image buffer pixel format is RGB8\r\n";
txtOutput.Text += "Pixel 1: " + buf[0, y] + "\r\n";
txtOutput.Text += "Pixel 2: " + buf[1, y];

画像データを調整する

ピクセルデータの読み込みを行うだけでなく、データを調整するという事も可能です。次のコードは左上にあるピクセルを黒に、それに続くピクセルをそれぞれグレー、白に設定します。この変更を加えた後、画像はBMPファイルとして保存されます。

[VB.NET]
' 最初のピクセルを 　0 (black)に
buf(0, y) = 0
' 2番目のピクセルを  128 (gray)に
buf(1, y) = 128
' 3番目のピクセルを 255 (white)に
buf(2, y) = 255

  buf.SaveAsBitmap("RGB8.bmp"))
[C#]
// 最初のピクセルを 　0 (black)に
buf[0, y] = 0;
// 2番目のピクセルを  128 (gray)に
buf[1, y] = 128;
// 3番目のピクセルを 255 (white)に
buf[2, y] = 255;

buf.SaveAsBitmap("RGB8.bmp");

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