BitmapFrame.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:
 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)

Retornos

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

Implementações

Atributos

Comentários

A matriz de dados de pixel 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.

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 da propriedade BitmapPixelFormat .
alphaMode O valor da propriedade BitmapAlphaMode
transform Uma transformação vazia.
exifOrientationMode O valor ExifOrientationModeRespectExifOrientation.
colorManagementMode O valor ColorManagementModeColorManageToSRgb.

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:
 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)

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.

Implementações

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.

Se você definir o parâmetro exifOrientationMode como RespectExifOrientation, os dados de pixel resultantes terão dimensões definidas por OrientedPixelWidth e OrientedPixelHeight em vez de PixelWidth e PixelHeight. Se você também estiver aplicando uma transformação, consulte BitmapTransform para obter informações sobre como lidar corretamente com espaços de coordenadas.

Confira também

Aplica-se a