Compartilhar via


IBitmapFrame.GetPixelDataAsync Método

Definição

Sobrecargas

GetPixelDataAsync()

Solicita de forma assíncrona os dados de pixel para o quadro. A matriz de dados de pixel resultante usará o formato de pixel bitmap e o modo alfa especificados nas propriedades BitmapPixelFormat e BitmapAlphaMode . Ele também terá o gerenciamento de cores e a orientação EXIF aplicados (consulte a seção Comentários para obter mais informações).

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

Solicita de forma assíncrona os dados de pixel para o quadro usando os parâmetros especificados.

GetPixelDataAsync()

Solicita de forma assíncrona os dados de pixel para o quadro. A matriz de dados de pixel resultante usará o formato de pixel bitmap e o modo alfa especificados nas propriedades BitmapPixelFormat e BitmapAlphaMode . Ele também terá o gerenciamento de cores e a orientação EXIF aplicados (consulte a seção Comentários para obter mais informações).

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)

Retornos

Objeto que gerencia a recuperação assíncrona dos dados de pixel.

Atributos

Comentários

Um aplicativo não deve assumir que os dados de pixel retornados por esse método usam qualquer formato de pixel específico ou modo alfa (ou seja, Rgba8 com alfa pré-multiplicado). Em vez disso, ele deve sempre marcar as propriedades BitmapPixelFormat e BitmapAlphaMode e manipular os dados adequadamente.

Como conveniência, esse método executa o gerenciamento de cores do espaço de cor inserido do quadro (se ele existir) para o espaço de cor sRGB. Se não houver dados de perfil de cores inseridos, nenhum gerenciamento de cores será executado. Esse método também tenta ler o sinalizador de orientação EXIF no quadro e, se ele existir, executará a transformação necessária para orientar corretamente os dados de pixel.

Para recuperar a largura e a altura corretas do bitmap, o aplicativo deve ler as propriedades OrientedPixelWidth e OrientedPixelHeight , em vez das propriedades PixelWidth e PixelHeight .

Esse método é equivalente a chamar o método GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) com os seguintes argumentos:

ArgumentoValor
*Pixelformat*O valor do

Confira também

Aplica-se a

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

Solicita de forma assíncrona os dados de pixel para o quadro usando os parâmetros especificados.

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)

Parâmetros

pixelFormat
BitmapPixelFormat

O formato de pixel especificado.

alphaMode
BitmapAlphaMode

O modo alfa especificado.

transform
BitmapTransform

O conjunto de transformações a serem aplicadas ao quadro.

exifOrientationMode
ExifOrientationMode

Indica se o sinalizador de orientação EXIF deve ser ignorado ou respeitado.

colorManagementMode
ColorManagementMode

Indica se os dados de pixel devem ser gerenciados por cores para o espaço de cor sRGB.

Retornos

Objeto que gerencia a recuperação assíncrona dos dados de pixel.

Atributos

Comentários

Esse método deve ser usado em vez de GetPixelDataAsync se o aplicativo precisar de um controle mais refinado sobre a matriz de dados de pixel.

Confira também

Aplica-se a