BitmapDecoder.GetPixelDataAsync Methode

Definition

Namespace:

Windows.Graphics.Imaging

Überlädt

GetPixelDataAsync()	Fordert asynchron die Pixeldaten für den Frame an.
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)	Fordert die Pixeldaten für den Frame mithilfe der angegebenen Parameter asynchron an.

GetPixelDataAsync()

Fordert asynchron die Pixeldaten für den Frame an.

public:
 virtual IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync() = 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.

Implementiert

GetPixelDataAsync()

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Das Pixeldatenarray verwendet das Bitmap-Pixelformat und den Alphamodus, die in den Eigenschaften BitmapPixelFormat und BitmapAlphaMode angegeben sind. Außerdem werden Farbverwaltung und EXIF-Ausrichtung angewendet.

Eine Anwendung sollte nicht davon ausgehen, dass von dieser Methode zurückgegebene Pixeldaten ein bestimmtes Pixelformat oder einen bestimmten Alphamodus verwenden (z. B. Rgba8 mit vormultipliziertem Alpha). Stattdessen sollten sie immer die Eigenschaften BitmapPixelFormat und BitmapAlphaMode überprüfen und die Daten entsprechend behandeln.

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 auszurichten.

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

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

Argument	Wert
Pixelformat	Der Wert der BitmapPixelFormat-Eigenschaft .
alphaMode	Der Wert der BitmapAlphaMode-Eigenschaft
Verwandeln	Eine neue BitmapTransform.
exifOrientationMode	Der ExifOrientationMode-WertRespectExifOrientation.
colorManagementMode	Der ColorManagementMode-WertColorManageToSRgb.

Weitere Informationen

• GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)
• PixelDataProvider
• Bildverarbeitung
• Bildverarbeitung

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Fordert die Pixeldaten für den Frame mithilfe der angegebenen Parameter asynchron an.

public:
 virtual IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode) = GetPixelDataAsync;

/// [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 respektiert werden soll.

colorManagementMode

ColorManagementMode

Gibt an, ob die Pixeldaten farblich in den sRGB-Farbraum verwaltet werden sollen.

Gibt zurück

IAsyncOperation<PixelDataProvider>

Objekt, das den asynchronen Abruf der Pixeldaten verwaltet.

Implementiert

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Diese Methode sollte anstelle von GetPixelDataAsync verwendet werden, wenn die Anwendung eine differenziertere Steuerung des Pixeldatenarrays benötigt.

Weitere Informationen

• GetPixelDataAsync()
• Bildverarbeitung
• Bildverarbeitung