IBitmapFrame.GetPixelDataAsync メソッド

リファレンス

定義

名前空間:: Windows.Graphics.Imaging

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

フレームのピクセルデータを非同期的に要求します。結果のピクセルデータ配列では、 BitmapPixelFormat プロパティと BitmapAlphaMode プロパティで指定されたビットマップピクセル形式とアルファモードが使用されます。また、色管理と EXIF の向きも適用されます (詳細については、「解説」セクションを参照してください)。

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

指定したパラメーターを使用して、フレームのピクセルデータを非同期的に要求します。

GetPixelDataAsync()

編集

public:
 IAsyncOperation<PixelDataProvider ^> ^ 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)

戻り値

IAsyncOperation<PixelDataProvider>

ピクセルデータの非同期取得を管理するオブジェクト。

属性: OverloadAttribute RemoteAsyncAttribute

注釈

アプリケーションでは、このメソッドによって返されるピクセルデータが特定のピクセル形式またはアルファモード (つまり、事前乗算アルファを持つ Rgba8) を使用することを想定しないでください。代わりに、BitmapPixelFormat プロパティと BitmapAlphaMode プロパティを常にチェックし、それに応じてデータを処理する必要があります。

便宜上、このメソッドは、フレームの埋め込み色空間 (存在する場合) から sRGB 色空間への色管理を実行します。埋め込みカラープロファイルデータがない場合、カラー管理は実行されません。このメソッドでは、フレーム上の EXIF 方向フラグの読み取りも試行され、存在する場合は、ピクセルデータの方向を正しく設定するために必要な変換が実行されます。

正しいビットマップピクセルの幅と高さを取得するには、アプリケーションで、PixelWidth プロパティと PixelHeight プロパティではなく、OrientedPixelWidth プロパティと OrientedPixelHeight プロパティを読み取る必要があります。

このメソッドは、 GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) メソッドを次の引数で呼び出すことと同じです。

引数値

*pixelFormat*

の値

こちらもご覧ください

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

適用対象

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)

編集

指定したパラメーターを使用して、フレームのピクセルデータを非同期的に要求します。

public:
 IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode);

/// [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)