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

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

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

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

バッファにアクセスする

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

[VB.NET]
' Y800はトップダウンなので、最初のラインのインデックスは0となる
Dim y As Integer = 0

txtOutput.Text = "Image buffer pixel format is Y800" & vbCrLf
txtOutput.Text &= "Pixel 1: " & buf(0, y) & vbCrLf
txtOutput.Text &= "Pixel 2: " & buf(1, y)
[C#]
// Y800はトップダウンなので、最初のラインのインデックスは0となる
int y = 0;

txtOutput.Text = "Image buffer pixel format is Y800\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("Y800.bmp")
[C#]
// 最初のピクセルを 　0 (black)に
buf[0, y] = 0;
// 2番目のピクセルを  128 (gray)に
buf[1, y] = 128;
// 3番目のピクセルを 255 (white)に
buf[2, y] = 255;

buf.SaveAsBitmap("Y800.bmp");

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