BitmapDecoder.GetPixelDataAsync 方法

定义

命名空间:

Windows.Graphics.Imaging

重载

GetPixelDataAsync()	异步请求帧的像素数据。
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)	使用指定的参数异步请求帧的像素数据。

GetPixelDataAsync()

异步请求帧的像素数据。

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)

返回

IAsyncOperation<PixelDataProvider>

管理像素数据的异步检索的对象。

实现

GetPixelDataAsync()

属性

OverloadAttribute RemoteAsyncAttribute

注解

像素数据数组将使用 BitmapPixelFormat 和 BitmapAlphaMode 属性中指定的位图像素格式和 alpha 模式。 它还将应用颜色管理和 EXIF 方向。

应用程序不应假定此方法返回的像素数据使用任何特定的像素格式或 alpha 模式 (，例如具有预乘 alpha) 的 Rgba8。 相反，它应始终检查 BitmapPixelFormat 和 BitmapAlphaMode 属性并相应地处理数据。

为方便起见，此方法从帧的嵌入颜色空间执行颜色管理， (如果它存在于 sRGB 颜色空间) 。 如果没有嵌入的颜色配置文件数据，则不执行颜色管理。 此方法还会尝试读取帧上的 EXIF 方向标志，如果存在，将执行必要的转换来正确定位像素数据。

为了检索正确的位图像素宽度和高度，应用程序应读取 OrientedPixelWidth 和 OrientedPixelHeight 属性，而不是 PixelWidth 和 PixelHeight 属性。

此方法等效于使用以下参数调用 GetPixelDataAsync (BitmapPixelFormat、BitmapAlphaMode、BitmapTransform、ExifOrientationMode、ColorManagementMode) 方法：

参数	值
pixelFormat	BitmapPixelFormat 属性的值。
alphaMode	BitmapAlphaMode 属性的值
transform	新的 BitmapTransform。
exifOrientationMode	ExifOrientationMode 值 RespectExifOrientation。
colorManagementMode	ColorManagementMode 值 ColorManageToSRgb。

另请参阅

• GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)
• PixelDataProvider
• 映像
• 映像

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

使用指定的参数异步请求帧的像素数据。

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)

参数

pixelFormat

BitmapPixelFormat

指定的像素格式。

alphaMode

BitmapAlphaMode

指定的 alpha 模式。

transform

BitmapTransform

要应用于帧的转换集。

exifOrientationMode

ExifOrientationMode

指示是应忽略还是应遵循 EXIF 方向标志。

colorManagementMode

ColorManagementMode

指示是否应将像素数据的颜色管理为 sRGB 颜色空间。

返回

IAsyncOperation<PixelDataProvider>

管理像素数据的异步检索的对象。

实现

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

属性

OverloadAttribute RemoteAsyncAttribute

注解

如果应用程序需要对像素数据数组进行精细控制，则应使用此方法而不是 GetPixelDataAsync 。

另请参阅

• GetPixelDataAsync()
• 映像
• 映像