IBitmapFrame.GetPixelDataAsync 方法

定义

重载

GetPixelDataAsync()

异步请求帧的像素数据。 生成的像素数据数组将使用 BitmapPixelFormatBitmapAlphaMode 属性中指定的位图 像素格式和 alpha 模式。 它还将应用颜色管理和 EXIF 方向 (有关详细信息) 请参阅“备注”部分。

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

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

GetPixelDataAsync()

异步请求帧的像素数据。 生成的像素数据数组将使用 BitmapPixelFormatBitmapAlphaMode 属性中指定的位图 像素格式和 alpha 模式。 它还将应用颜色管理和 EXIF 方向 (有关详细信息) 请参阅“备注”部分。

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)

返回

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

属性

注解

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

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

为了检索正确的位图像素宽度和高度,应用程序应读取 OrientedPixelWidthOrientedPixelHeight 属性,而不是 PixelWidthPixelHeight 属性。

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

参数
*pixelFormat* 的值

另请参阅

适用于

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

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

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)

参数

pixelFormat
BitmapPixelFormat

指定的像素格式。

alphaMode
BitmapAlphaMode

指定的 alpha 模式。

transform
BitmapTransform

要应用于帧的转换集。

exifOrientationMode
ExifOrientationMode

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

colorManagementMode
ColorManagementMode

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

返回

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

属性

注解

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

另请参阅

适用于