次の方法で共有


IBitmapFrame.GetPixelDataAsync メソッド

定義

オーバーロード

GetPixelDataAsync()

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

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

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

GetPixelDataAsync()

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

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)

戻り値

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

属性

注釈

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

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

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

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

引数
*pixelFormat* の値

こちらもご覧ください

適用対象

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)

パラメーター

pixelFormat
BitmapPixelFormat

指定したピクセル形式。

alphaMode
BitmapAlphaMode

指定したアルファ モード。

transform
BitmapTransform

フレームに適用する変換のセット。

exifOrientationMode
ExifOrientationMode

EXIF 方向フラグを無視するか、優先するかを示します。

colorManagementMode
ColorManagementMode

ピクセル データを sRGB 色空間に対して色管理する必要があるかどうかを示します。

戻り値

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

属性

注釈

アプリケーションでピクセル データ配列をきめ細かく制御する必要がある場合は、 GetPixelDataAsync の代わりにこのメソッドを使用する必要があります。

こちらもご覧ください

適用対象