IBitmapFrame.GetPixelDataAsync Метод

Определение

Пространство имен:

Windows.Graphics.Imaging

Перегрузки

GetPixelDataAsync()	Асинхронно запрашивает пиксельные данные для кадра. Результирующий массив данных пикселей будет использовать формат пикселей растрового изображения и альфа-режим, указанный в свойствах BitmapPixelFormat и BitmapAlphaMode . Он также будет применяться к управлению цветом и ориентации EXIF (дополнительные сведения см. в разделе Примечания).
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)	Асинхронно запрашивает пиксельные данные для кадра с помощью указанных параметров.

GetPixelDataAsync()

Асинхронно запрашивает пиксельные данные для кадра. Результирующий массив данных пикселей будет использовать формат пикселей растрового изображения и альфа-режим, указанный в свойствах BitmapPixelFormat и BitmapAlphaMode . Он также будет применяться к управлению цветом и ориентации 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)

Возвращаемое значение

IAsyncOperation<PixelDataProvider>

Объект , который управляет асинхронным получением данных в пикселях.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Комментарии

Приложение не должно предполагать, что данные в пикселях, возвращаемые этим методом, используют какой-либо определенный формат пикселей или альфа-режим (например, Rgba8 с предварительно заполненной альфа-функцией). Вместо этого он всегда должен проверка свойства BitmapPixelFormat и BitmapAlphaMode и обрабатывать данные соответствующим образом.

Для удобства этот метод выполняет управление цветом из встроенного цветового пространства кадра (если он существует) в цветовое пространство sRGB. Если внедренные данные профиля цвета отсутствуют, то управление цветом не выполняется. Этот метод также пытается прочитать флаг ориентации EXIF на кадре и, если он существует, выполнит необходимое преобразование для правильного направления данных в пикселях.

Чтобы получить правильную ширину и высоту растрового изображения, приложение должно считывать свойства OrientedPixelWidth и OrientedPixelHeight вместо свойств PixelWidth и PixelHeight .

Этот метод эквивалентен вызову метода GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) со следующими аргументами:

Аргумент

Значение

*pixelFormat*

Значение объекта См. также раздел GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) 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 Указанный альфа-режим. transform BitmapTransform Набор преобразований, применяемых к кадру. exifOrientationMode ExifOrientationMode Указывает, следует ли игнорировать или соблюдать флаг ориентации EXIF. colorManagementMode ColorManagementMode Указывает, должны ли данные о пикселях управлять цветом в цветовом пространстве sRGB. Возвращаемое значение IAsyncOperation<PixelDataProvider> Объект , который управляет асинхронным получением данных в пикселях. Атрибуты OverloadAttribute RemoteAsyncAttribute Комментарии Этот метод следует использовать вместо GetPixelDataAsync , если приложению требуется более детальное управление массивом данных пикселей. См. также раздел GetPixelDataAsync()