IBitmapFrame.GetPixelDataAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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:
Argumento | Valor |
---|---|
*Pixelformat* | O valor do
Confira tambémAplica-se aGetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)Solicita de forma assíncrona os dados de pixel para o quadro usando os parâmetros especificados.
Parâmetros
O formato de pixel especificado.
O modo alfa especificado.
O conjunto de transformações a serem aplicadas ao quadro.
Indica se o sinalizador de orientação EXIF deve ser ignorado ou respeitado.
Indica se os dados de pixel devem ser gerenciados por cores para o espaço de cor sRGB. RetornosObjeto que gerencia a recuperação assíncrona dos dados de pixel.
ComentáriosEsse 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émAplica-se a |