BitmapFrame.GetPixelDataAsync メソッド

  • リファレンス

定義

名前空間:
Windows.Graphics.Imaging

オーバーロード

GetPixelDataAsync()

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

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

GetPixelDataAsync()

編集

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

public:
 virtual IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync() = 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>

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

実装

GetPixelDataAsync()
属性
OverloadAttribute RemoteAsyncAttribute

注釈

ピクセル データ配列では、 BitmapPixelFormat プロパティと BitmapAlphaMode プロパティで指定されたビットマップ ピクセル形式とアルファ モードが使用されます。 また、色管理と EXIF の向きも適用されます。

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

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

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

引数 値
pixelFormat BitmapPixelFormat プロパティの値。
alphaMode BitmapAlphaMode プロパティの値
transform 空の変換。
exifOrientationMode ExifOrientationMode 値 RespectExifOrientation。
colorManagementMode ColorManagementMode 値 ColorManageToSRgb。

こちらもご覧ください

適用対象

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

編集

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

public:
 virtual IAsyncOperation<PixelDataProvider ^> ^ GetPixelDataAsync(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, BitmapTransform ^ transform, ExifOrientationMode exifOrientationMode, ColorManagementMode colorManagementMode) = GetPixelDataAsync;
/// [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 色空間に対して色管理するかどうかを示します。

戻り値

IAsyncOperation<PixelDataProvider>

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

実装

GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)
属性
OverloadAttribute RemoteAsyncAttribute

注釈

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

exifOrientationMode パラメーターを RespectExifOrientation に設定すると、結果のピクセル データには、PixelWidth と PixelHeight ではなく、OrientedPixelWidth と OrientedPixelHeight によって定義されるディメンションが含まれます。 変換も適用する場合は、座標空間を正しく処理する方法については 、BitmapTransform を参照してください。

こちらもご覧ください

適用対象