RenderTargetBitmap.GetPixelsAsync Method

Recupera la imagen RenderTargetBitmap previamente presentada como una secuencia almacenada en búfer de bytes en el formato BGRA8.

Sintaxis


public IAsyncOperation<IBuffer> GetPixelsAsync()

Parámetros

Este Método no tiene parámetros.

Valor devuelto

Tipo: IAsyncOperation<IBuffer>

Cuando este método vuelve, una secuencia IBuffer que contiene bytes. Son los datos binarios de la imagen y se pueden convertir en una matriz de bytes en formato BGRA8

Comentarios

El valor devuelto en IBuffer permite pasar el resultado a un objeto WriteableBitmap y a su propiedad PixelBuffer. Otra alternativa es pasar el búfer a la clase BitmapEncoder. Si desea una matriz de bytes, utilice un objeto DataReader y el método FromBuffer para facilitar la conversión.

Con el valor intermedio de IAsyncOperation, este método devuelve los píxeles de origen de la imagen generada por la llamada más reciente a RenderAsync.

Llame siempre al método RenderAsync antes de llamar al método GetPixelsAsync. Si llama a GetPixelsAsync y nunca ha llamado a RenderAsync anteriormente en esa instancia de RenderTargetBitmap, GetPixelsAsync devolverá una secuencia del búfer vacía y no se producirá ningún error (Status asincrónico es Completed, por lo que no puede usarlo como indicador).

Requisitos

Cliente mínimo admitido

Windows 8.1

Servidor mínimo admitido

Windows Server 2012 R2

Espacio de nombres

Windows.UI.Xaml.Media.Imaging
Windows::UI::Xaml::Media::Imaging [C++]

Metadatos

Windows.winmd

Vea también

RenderTargetBitmap
BitmapEncoder
DataTransferManager
Windows.Graphics.Imaging namespace
Ejemplo de representación XAML en mapa de bits

 

 

Mostrar:
© 2014 Microsoft