RenderTargetBitmap.GetPixelsAsync Método

Definição

Namespace:

Windows.UI.Xaml.Media.Imaging

Recupera a imagem RenderTargetBitmap renderizada anteriormente como um fluxo em buffer de bytes no formato alfa BGRA8, pré-multiplicado.

public:
 virtual IAsyncOperation<IBuffer ^> ^ GetPixelsAsync() = GetPixelsAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IBuffer> GetPixelsAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IBuffer> GetPixelsAsync();

function getPixelsAsync()

Public Function GetPixelsAsync () As IAsyncOperation(Of IBuffer)

Retornos

IAsyncOperation<IBuffer>

Um objeto de operação assíncrono do qual, após a conclusão bem-sucedida, você pode recuperar um fluxo IBuffer que contém bytes. Esses são os dados binários da imagem e podem ser convertidos em uma matriz de bytes no formato BGRA8

Atributos

RemoteAsyncAttribute

Comentários

O valor retornado do IBuffer permite passar o resultado para um WriteableBitmap e seu PixelBuffer. Outra alternativa é passar o buffer para um BitmapEncoder. Se você quiser uma matriz de bytes, use um DataReader e o método FromBuffer para ajudar na conversão.

Por meio do valor intermediário IAsyncOperation , esse método retorna os pixels da fonte de imagem que foi produzida pela chamada mais recente para RenderAsync.

Sempre chame RenderAsync antes de chamar GetPixelsAsync. Se você chamar GetPixelsAsync e nunca tiver chamado RenderAsync anteriormente naquela instância do RenderTargetBitmap , GetPixelsAsync retornará um fluxo de buffer vazio e nenhum erro ocorrerá (o Status assíncrono é Concluído, portanto, você não pode usá-lo como um indicador).

Confira também

• BitmapEncoder
• DataTransferManager
• Windows.Graphics.Imaging
• Exemplo de renderização XAML para bitmap