BitmapFrame.GetPixelDataAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| GetPixelDataAsync() |
Fordert asynchron die Pixeldaten für den Frame an. Das resultierende Pixeldatenarray verwendet das Bitmappixelformat und den Alphamodus, die in den Eigenschaften BitmapPixelFormat und BitmapAlphaMode angegeben sind. 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 mithilfe der angegebenen Parameter asynchron an. |
GetPixelDataAsync()
Fordert asynchron die Pixeldaten für den Frame an. Das resultierende Pixeldatenarray verwendet das Bitmappixelformat und den Alphamodus, die in den Eigenschaften BitmapPixelFormat und BitmapAlphaMode angegeben sind. Außerdem werden Farbverwaltung und EXIF-Ausrichtung angewendet (weitere Informationen finden Sie im Abschnitt Hinweise).
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
Objekt, das den asynchronen Abruf der Pixeldaten verwaltet.
Implementiert
- Attribute
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.
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 leere Transformation. |
| exifOrientationMode | Der ExifOrientationMode-WertRespectExifOrientation. |
| colorManagementMode | Der ColorManagementMode-WertColorManageToSRgb. |
Weitere Informationen
- GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)
- PixelDataProvider
- Bildverarbeitung
- Bildverarbeitung
Gilt für:
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
Objekt, das den asynchronen Abruf der Pixeldaten verwaltet.
Implementiert
- Attribute
Hinweise
Diese Methode sollte anstelle von GetPixelDataAsync verwendet werden, wenn die Anwendung eine differenziertere Steuerung des Pixeldatenarrays benötigt.
Wenn Sie den exifOrientationMode-Parameter auf RespectExifOrientation festlegen, verfügen die resultierenden Pixeldaten über Dimensionen, die von OrientedPixelWidth und OrientedPixelHeight anstelle von PixelWidth und PixelHeight definiert werden. Wenn Sie auch eine Transformation anwenden, finden Sie unter BitmapTransform Informationen zur ordnungsgemäßen Behandlung von Koordinatenräumen.