PhotoConfirmationCapturedEventArgs.Frame Eigenschaft

Definition

Namespace:

Windows.Media.Capture

Ruft den erfassten Frame ab.

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

CapturedFrame Frame();

public CapturedFrame Frame { get; }

var capturedFrame = photoConfirmationCapturedEventArgs.frame;

Public ReadOnly Property Frame As CapturedFrame

Eigenschaftswert

CapturedFrame

Der erfasste Frame.

Hinweise

Die in der Frame-Eigenschaft zurückgegebenen Daten sind unformatierte Pixeldaten. Mit anderen Worten, es enthält keinen Header im Bilddateiformat. Daher können Sie den Stream des erfassten Frames nicht direkt an die SetSourceAsync-Methode der Bitmap übergeben. Stattdessen müssen Sie die Pixeldaten manuell in den Pixelpuffer der Bitmap kopieren. Die folgenden Codeausschnitte zeigen, wie Sie die Bilddaten kopieren und eine Hilfsklasse bereitstellen, die den Vorgang ausführt.

Zunächst müssen Sie die Fotobestätigung aktivieren und das PhotoConfirmationCaptured-Ereignis einbinden.

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();
    }

}

Der folgende Codeausschnitt zeigt die Hilfsklasse, die die Erweiterungsmethoden für das Kopieren der erfassten Framedaten in den Pixeldatenstrom der beschreibbaren Bitmap definiert. Die -Klasse stellt synchrone und asynchrone Methoden und Überladungen bereit, mit denen Sie eine Kopierpuffergröße angeben oder eine Standardgröße verwenden können.

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));
    }
}