BitmapFrame.GetPixelDataAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| GetPixelDataAsync() |
Асинхронно запрашивает данные в пикселях для кадра. Результирующий массив данных пикселей будет использовать формат пикселей растрового изображения и альфа-режим, указанный в свойствах BitmapPixelFormat и BitmapAlphaMode . Он также будет иметь управление цветом и ориентацию EXIF (дополнительные сведения см. в разделе Примечания). |
| GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) |
Асинхронно запрашивает данные в пикселях для кадра, используя указанные параметры. |
GetPixelDataAsync()
Асинхронно запрашивает данные в пикселях для кадра. Результирующий массив данных пикселей будет использовать формат пикселей растрового изображения и альфа-режим, указанный в свойствах BitmapPixelFormat и BitmapAlphaMode . Он также будет иметь управление цветом и ориентацию 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 . Он также будет иметь управление цветом и ориентацию EXIF.
Для удобства этот метод выполняет управление цветом из внедренного цветового пространства кадра (если он существует) в цветовое пространство sRGB. Если внедренные данные цветового профиля отсутствуют, управление цветом не выполняется. Этот метод также пытается прочитать флаг ориентации EXIF на кадре и, если он существует, выполнит необходимое преобразование для правильного направления данных в пикселях.
Чтобы получить правильную ширину и высоту растрового изображения, приложение должно считывать свойства OrientedPixelWidth и OrientedPixelHeight вместо свойств PixelWidth и PixelHeight .
Этот метод эквивалентен вызову метода GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) со следующими аргументами:
| Аргумент | Значение |
|---|---|
| pixelFormat | Значение свойства BitmapPixelFormat . |
| alphaMode | Значение свойства BitmapAlphaMode |
| преобразование | Пустое преобразование. |
| exifOrientationMode | Значение ExifOrientationModeRespectExifOrientation. |
| colorManagementMode | Значение ColorManagementModeColorManageToSRgb. |
См. также раздел
- 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
Указанный альфа-режим.
- transform
- BitmapTransform
Набор преобразований, применяемых к кадру.
- exifOrientationMode
- ExifOrientationMode
Указывает, следует ли игнорировать или учитывать флаг ориентации EXIF.
- colorManagementMode
- ColorManagementMode
Указывает, должны ли пиксельные данные быть цветными, управляемыми в цветовом пространстве sRGB.
Возвращаемое значение
Объект , управляющий асинхронным получением пиксельных данных.
Реализации
- Атрибуты
Комментарии
Этот метод следует использовать вместо GetPixelDataAsync , если приложению требуется более детальное управление массивом данных пикселей.
Если для параметра exifOrientationMode задано значение RespectExifOrientation, полученные пиксельные данные будут иметь измерения, определенные с помощью OrientedPixelWidth и OrientedPixelHeight , а не PixelWidth и PixelHeight. Если вы также применяете преобразование, сведения о правильной обработке координатных пространств см. в разделе BitmapTransform .