BitmapFrame.GetPixelDataAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| GetPixelDataAsync() |
异步请求帧的像素数据。 生成的像素数据数组将使用 BitmapPixelFormat 和 BitmapAlphaMode 属性中指定的位图 像素格式和 alpha 模式。 它还将应用颜色管理和 EXIF 方向 (有关详细信息) 请参阅“备注”部分。 |
| GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) |
使用指定的参数异步请求帧的像素数据。 |
GetPixelDataAsync()
异步请求帧的像素数据。 生成的像素数据数组将使用 BitmapPixelFormat 和 BitmapAlphaMode 属性中指定的位图 像素格式和 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)返回
管理像素数据的异步检索的对象。
实现
- 属性
注解
像素数据数组将使用 BitmapPixelFormat 和 BitmapAlphaMode 属性中指定的位图像素格式和 alpha 模式。 它还将应用颜色管理和 EXIF 方向。
为方便起见，此方法从帧的嵌入颜色空间执行颜色管理， (如果它存在于 sRGB 颜色空间) 。 如果没有嵌入的颜色配置文件数据，则不执行颜色管理。 此方法还会尝试读取帧上的 EXIF 方向标志，如果存在，将执行必要的转换来正确定位像素数据。
为了检索正确的位图像素宽度和高度，应用程序应读取 OrientedPixelWidth 和 OrientedPixelHeight 属性，而不是 PixelWidth 和 PixelHeight 属性。
此方法等效于使用以下参数调用 GetPixelDataAsync (BitmapPixelFormat、BitmapAlphaMode、BitmapTransform、ExifOrientationMode、ColorManagementMode) 方法：
| 参数 | 值 |
|---|---|
| pixelFormat | BitmapPixelFormat 属性的值。 |
| alphaMode | BitmapAlphaMode 属性的值 |
| transform | 空转换。 |
| 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 颜色空间。
返回
管理像素数据的异步检索的对象。
实现
- 属性
注解
如果应用程序需要对像素数据数组进行精细控制，则应使用此方法而不是 GetPixelDataAsync 。
如果将 exifOrientationMode 参数设置为 RespectExifOrientation，则生成的像素数据将具有由 OrientedPixelWidth 和 OrientedPixelHeight 而不是 PixelWidth 和 PixelHeight 定义的维度。 如果还要应用转换，请参阅 BitmapTransform ，了解有关正确处理坐标空间的信息。