RenderTargetBitmap.GetPixelsAsync Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml.Media.Imaging

Récupère l’image RenderTargetBitmap précédemment rendue sous la forme d’un flux d’octets mis en mémoire tampon au format BGRA8 .

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)

Retours

IAsyncOperation<IBuffer>

Objet d’opération asynchrone à partir duquel, en cas de réussite de l’exécution, vous pouvez récupérer un flux IBuffer contenant des octets. Il s’agit des données binaires de l’image et peut être convertie en tableau d’octets au format BGRA8

Attributs

RemoteAsyncAttribute

Remarques

La valeur de retour IBuffer permet de transmettre le résultat à un WriteableBitmap et à son PixelBuffer. Une autre alternative consiste à passer la mémoire tampon à un BitmapEncoder. Si vous souhaitez un tableau d’octets, utilisez un DataReader et la méthode FromBuffer pour faciliter la conversion.

Par le biais de la valeur intermédiaire IAsyncOperation , cette méthode retourne les pixels de la source d’image qui a été produite par l’appel le plus récent à RenderAsync.

Appelez toujours RenderAsync avant d’appeler GetPixelsAsync. Si vous appelez GetPixelsAsync et que vous n’avez jamais appelé RenderAsync précédemment sur cette instance RenderTargetBitmap, GetPixelsAsync retourne un flux de mémoire tampon vide et aucune erreur ne se produit (l’état asynchrone est terminé, vous ne pouvez donc pas l’utiliser comme indicateur).

Voir aussi

• BitmapEncoder
• DataTransferManager
• Espace de noms Windows.Graphics.Imaging
• Exemple de rendu XAML en bitmap