BitmapFrame.GetPixelDataAsync 方法

定义

重载

GetPixelDataAsync()

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

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

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

GetPixelDataAsync()

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

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)

返回

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

实现

属性

注解

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

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

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

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

参数
pixelFormat BitmapPixelFormat 属性的值。
alphaMode BitmapAlphaMode 属性的值
transform 空转换。
exifOrientationMode ExifOrientationModeRespectExifOrientation
colorManagementMode ColorManagementModeColorManageToSRgb

另请参阅

适用于

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 颜色空间。

返回

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

实现

属性

注解

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

如果将 exifOrientationMode 参数设置为 RespectExifOrientation,则生成的像素数据将具有由 OrientedPixelWidthOrientedPixelHeight 而不是 PixelWidthPixelHeight 定义的维度。 如果还要应用转换,请参阅 BitmapTransform ,了解有关正确处理坐标空间的信息。

另请参阅

适用于