BitmapFrame.GetPixelDataAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
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)
戻り値
ピクセル データの非同期取得を管理する オブジェクト。
実装
- 属性
注釈
ピクセル データ配列では、 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)
- PixelDataProvider
- イメージング
- イメージング
適用対象
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 色空間に対して色管理するかどうかを示します。
戻り値
ピクセル データの非同期取得を管理する オブジェクト。
実装
- 属性
注釈
アプリケーションでピクセル データ配列を細かく制御する必要がある場合は、 GetPixelDataAsync の代わりにこのメソッドを使用する必要があります。
exifOrientationMode パラメーターを RespectExifOrientation に設定すると、結果のピクセル データには、PixelWidth と PixelHeight ではなく、OrientedPixelWidth と OrientedPixelHeight によって定義されるディメンションが含まれます。 変換も適用する場合は、座標空間を正しく処理する方法については 、BitmapTransform を参照してください。