-api-id | -api-type |
---|---|
M:Windows.Graphics.Imaging.BitmapDecoder.GetPixelDataAsync |
winrt method |
Asynchronously requests the pixel data for the frame.
Object that manages the asynchronous retrieval of the pixel data.
The pixel data array will use the bitmap pixel format and alpha mode specified in the BitmapPixelFormat and BitmapAlphaMode properties. It will also have color management and EXIF orientation applied.
An application should not assume that pixel data returned by this method uses any particular pixel format or alpha mode (like Rgba8 with premultiplied alpha). Instead, it should always check the BitmapPixelFormat and BitmapAlphaMode properties and handle the data accordingly.
As a convenience, this method performs color management from the frame's embedded color space (if it exists) to the sRGB color space. If there is no embedded color profile data, then no color management is performed. This method also attempts to read the EXIF orientation flag on the frame, and if it exists, will perform the necessary transformation to correctly orient the pixel data.
In order to retrieve the correct bitmap pixel width and height, the application should read the OrientedPixelWidth and OrientedPixelHeight properties, instead of the PixelWidth and PixelHeight properties.
This method is equivalent to calling the GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) method with the following arguments:
Argument | Value |
---|---|
pixelFormat | The value of the BitmapPixelFormat property. |
alphaMode | The value of the BitmapAlphaMode property |
transform | A new BitmapTransform. |
exifOrientationMode | The ExifOrientationMode value RespectExifOrientation. |
colorManagementMode | The ColorManagementMode value ColorManageToSRgb. |
Imaging, Imaging, GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode), PixelDataProvider