IBitmapFrame.GetPixelDataAsync Methode

Definition

Namespace:

Windows.Graphics.Imaging

Überlädt

GetPixelDataAsync()	Fordert die Pixeldaten für den Frame asynchron an. Das resultierende Pixeldatenarray verwendet das Bitmappixelformat und den Alphamodus, der in den Eigenschaften BitmapPixelFormat und BitmapAlphaMode angegeben ist. Außerdem werden Farbverwaltung und EXIF-Ausrichtung angewendet (weitere Informationen finden Sie im Abschnitt Hinweise).
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)	Fordert die Pixeldaten für den Frame mit den angegebenen Parametern asynchron an.

GetPixelDataAsync()

Fordert die Pixeldaten für den Frame asynchron an. Das resultierende Pixeldatenarray verwendet das Bitmappixelformat und den Alphamodus, der in den Eigenschaften BitmapPixelFormat und BitmapAlphaMode angegeben ist. Außerdem werden Farbverwaltung und EXIF-Ausrichtung angewendet (weitere Informationen finden Sie im Abschnitt Hinweise).

public:
 IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync();

/// [Windows.Foundation.Metadata.Overload("GetPixelDataAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<PixelDataProvider> GetPixelDataAsync();

[Windows.Foundation.Metadata.Overload("GetPixelDataAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<PixelDataProvider> GetPixelDataAsync();

function getPixelDataAsync()

Public Function GetPixelDataAsync () As IAsyncOperation(Of PixelDataProvider)

Gibt zurück

IAsyncOperation<PixelDataProvider>

Objekt, das den asynchronen Abruf der Pixeldaten verwaltet.

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Eine Anwendung sollte nicht davon ausgehen, dass von dieser Methode zurückgegebene Pixeldaten ein bestimmtes Pixelformat oder alphan-Modus (d. h. Rgba8 mit prämultipliziertem Alpha) verwenden. Stattdessen sollte immer die Eigenschaften BitmapPixelFormat und BitmapAlphaMode überprüft und die Daten entsprechend behandelt werden.

Zur Vereinfachung führt diese Methode die Farbverwaltung vom eingebetteten Farbraum des Frames (sofern vorhanden) bis zum sRGB-Farbraum durch. Wenn keine eingebetteten Farbprofildaten vorhanden sind, wird keine Farbverwaltung durchgeführt. Diese Methode versucht auch, das EXIF-Ausrichtungsflag auf dem Frame zu lesen, und wenn es vorhanden ist, führt die erforderliche Transformation aus, um die Pixeldaten richtig zu orientieren.

Um die richtige Pixelbreite und -höhe der Bitmap abzurufen, sollte die Anwendung die Eigenschaften OrientedPixelWidth und OrientedPixelHeight anstelle der Eigenschaften PixelWidth und PixelHeight lesen.

Diese Methode entspricht dem Aufrufen der GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)- Methode mit den folgenden Argumenten:

Argument

Wert

*Pixelformat*

Der Wert des Weitere Informationen GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) Fordert die Pixeldaten für den Frame mit den angegebenen Parametern asynchron an. public: IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode); /// [Windows.Foundation.Metadata.Overload("GetPixelDataTransformedAsync")] /// [Windows.Foundation.Metadata.RemoteAsync] IAsyncOperation<PixelDataProvider> GetPixelDataAsync(BitmapPixelFormat const& pixelFormat, BitmapAlphaMode const& alphaMode, BitmapTransform const& transform, ExifOrientationMode const& exifOrientationMode, ColorManagementMode const& colorManagementMode); [Windows.Foundation.Metadata.Overload("GetPixelDataTransformedAsync")] [Windows.Foundation.Metadata.RemoteAsync] public IAsyncOperation<PixelDataProvider> GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode); function getPixelDataAsync(pixelFormat, alphaMode, transform, exifOrientationMode, colorManagementMode) Public Function GetPixelDataAsync (pixelFormat As BitmapPixelFormat, alphaMode As BitmapAlphaMode, transform As BitmapTransform, exifOrientationMode As ExifOrientationMode, colorManagementMode As ColorManagementMode) As IAsyncOperation(Of PixelDataProvider) Parameter pixelFormat BitmapPixelFormat Das angegebene Pixelformat. alphaMode BitmapAlphaMode Der angegebene Alphamodus. transform BitmapTransform Der Satz von Transformationen, die auf den Frame angewendet werden sollen. exifOrientationMode ExifOrientationMode Gibt an, ob das EXIF-Ausrichtungsflag ignoriert oder beachtet werden soll. colorManagementMode ColorManagementMode Gibt an, ob die Pixeldaten farbseitig für den sRGB-Farbraum verwaltet werden sollen. Gibt zurück IAsyncOperation<PixelDataProvider> Objekt, das den asynchronen Abruf der Pixeldaten verwaltet. Attribute OverloadAttribute RemoteAsyncAttribute Hinweise Diese Methode sollte anstelle von GetPixelDataAsync verwendet werden, wenn die Anwendung eine präzisere Steuerung des Pixeldatenarrays benötigt. Weitere Informationen GetPixelDataAsync()