RenderTargetBitmap.GetPixelsAsync メソッド

定義

名前空間:

Windows.UI.Xaml.Media.Imaging

前にレンダリングされた RenderTargetBitmap イメージを、事前に乗算されたアルファ形式の 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)

戻り値

IAsyncOperation<IBuffer>

正常に完了すると、バイトを含む IBuffer ストリームを取得できる非同期操作オブジェクト。 これはイメージのバイナリ データであり、 BGRA8 形式のバイト配列に変換できます

属性

RemoteAsyncAttribute

注釈

IBuffer の戻り値を使用すると、WriteableBitmap とその PixelBuffer に結果を渡すことが可能になります。 もう 1 つの方法は、バッファーを BitmapEncoder に渡すことです。 バイト配列が必要な場合は、 DataReader と FromBuffer メソッドを使用して変換を支援します。

このメソッドは、 IAsyncOperation 中間値を使用して、 RenderAsync の最新の呼び出しによって生成されたイメージ ソースのピクセルを返します。

GetPixelsAsync を呼び出す前に、必ず RenderAsync を呼び出してください。 GetPixelsAsync を呼び出し、その RenderTargetBitmap インスタンスで RenderAsync を以前に呼び出したことがない場合、GetPixelsAsync は空のバッファー ストリームを返し、エラーは発生しません (非同期状態は完了であるため、インジケーターとして使用することはできません)。

こちらもご覧ください

• BitmapEncoder
• DataTransferManager
• Windows.Graphics.Imaging
• XAML をビットマップにレンダリングするサンプル