PhotoConfirmationCapturedEventArgs.Frame プロパティ

定義

名前空間:

Windows.Media.Capture

キャプチャされたフレームを取得します。

public:
 property CapturedFrame ^ Frame { CapturedFrame ^ get(); };

CapturedFrame Frame();

public CapturedFrame Frame { get; }

var capturedFrame = photoConfirmationCapturedEventArgs.frame;

Public ReadOnly Property Frame As CapturedFrame

プロパティ値

CapturedFrame

キャプチャされたフレーム。

注釈

Frame プロパティで返されるデータは、生ピクセル データです。 つまり、イメージ ファイル形式ヘッダーは含まれません。 このため、キャプチャしたフレームのストリームをビットマップの SetSourceAsync メソッドに直接渡すことはできません。 代わりに、ピクセル データをビットマップのピクセル バッファーに手動でコピーする必要があります。 次のコード スニペットは、画像データをコピーし、操作を実行するヘルパー クラスを提供する方法を示しています。

まず、写真の確認を有効にし、 PhotoConfirmationCaptured イベントをフックする必要があります。

private void EnablePhotoConfirmation()
{
    _mediaCapture.VideoDeviceController.PhotoConfirmationControl.Enabled = true;
    _mediaCapture.PhotoConfirmationCaptured += PhotoConfirmationCaptured;
}

void PhotoConfirmationCaptured(MediaCapture sender, PhotoConfirmationCapturedEventArgs args)
{
    using (ManualResetEventSlim evt = new ManualResetEventSlim(false))
    {
        CoreApplication.MainView.CoreWindow.Dispatcher.RunAsync(CoreDispatcherPriority.Normal, async () =>
        {
            try
            {
                WriteableBitmap bmp = new WriteableBitmap(unchecked((int)args.Frame.Width), unchecked((int)args.Frame.Height));
                using (var istream = args.Frame.AsStream())
                using (var ostream = bmp.PixelBuffer.AsStream())
                {
                    await istream.CopyStreamToAsync(ostream);
                }
            }
            finally
            {
                evt.Set();
            }

        });

        evt.Wait();
    }

}

次のコード スニペットは、キャプチャしたフレーム データを書き込み可能なビットマップのピクセル データ ストリームにコピーするための拡張メソッドを定義するヘルパー クラスを示しています。 クラスには、コピー バッファー サイズを指定したり、既定のサイズを使用したりできる同期メソッドと非同期メソッドとオーバーロードが用意されています。

public static class StreamEx
{
    public static void CopyStreamTo(this Stream inputStream, Stream outputStream)
    {
        inputStream.CopyStreamTo(outputStream, 4096);
    }

    public static void CopyStreamTo(this Stream inputStream, Stream outputStream, int bufferSize)
    {
        if (inputStream == null)
        {
            throw new ArgumentNullException("inputStream");
        }

        if (!inputStream.CanSeek)
        {
            throw new ArgumentException("Cannot seek in the input stream.", "inputStream");
        }

        if (!inputStream.CanRead)
        {
            throw new ArgumentException("Input stream is not readable.", "inputStream");
        }

        if (outputStream == null)
        {
            throw new ArgumentNullException("outputStream");
        }

        if (!outputStream.CanSeek)
        {
            throw new ArgumentException("Cannot seek in the output stream.", "outputStream");
        }

        if (!outputStream.CanWrite)
        {
            throw new ArgumentException("Output stream is not writeable.", "outputStream");
        }

        if (bufferSize <= 0)
        {
            throw new ArgumentOutOfRangeException("bufferSize", "Buffer size is equal to zero or negative.");
        }

        inputStream.Seek(0, SeekOrigin.Begin);
        outputStream.Seek(0, SeekOrigin.Begin);

        byte[] buffer = new byte[bufferSize];
        while (inputStream.Position < inputStream.Length)
        {
            int bytesRead = inputStream.Read(buffer, 0, buffer.Length);
            outputStream.Write(buffer, 0, bytesRead);
        }
    }

    public static Task CopyStreamToAsync(this Stream inputStream, Stream outputStream)
    {
        return Task.Run(() => CopyStreamTo(inputStream, outputStream));
    }

    public static Task CopyStreamToAsync(this Stream inputStream, Stream outputStream, int bufferSize)
    {
        return Task.Run(() => CopyStreamTo(inputStream, outputStream, bufferSize));
    }
}