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)

Асинхронно запрашивает данные в пикселях для кадра, используя указанные параметры.

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 .

См. также раздел

Применяется к