BitmapDecoder.GetPixelDataAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| GetPixelDataAsync() |
フレームのピクセル データを非同期的に要求します。 |
| GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) |
指定したパラメーターを使用して、フレームのピクセル データを非同期的に要求します。 |
GetPixelDataAsync()
フレームのピクセル データを非同期的に要求します。
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 の向きも適用されます。
アプリケーションでは、このメソッドによって返されるピクセル データが特定のピクセル形式またはアルファ モード (事前乗算アルファを持つ Rgba8 など) を使用することを想定しないでください。 代わりに、BitmapPixelFormat プロパティと BitmapAlphaMode プロパティを常にチェックし、それに応じてデータを処理する必要があります。
便宜上、このメソッドは、フレームの埋め込み色空間 (存在する場合) から sRGB 色空間への色管理を実行します。 埋め込みカラー プロファイル データがない場合、カラー管理は実行されません。 このメソッドでは、フレーム上の EXIF 方向フラグの読み取りも試行され、存在する場合は、ピクセル データの方向を正しく設定するために必要な変換が実行されます。
正しいビットマップ ピクセルの幅と高さを取得するには、アプリケーションで、PixelWidth プロパティと PixelHeight プロパティではなく、OrientedPixelWidth プロパティと OrientedPixelHeight プロパティを読み取る必要があります。
このメソッドは、 GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) メソッドを次の引数で呼び出すことと同じです。
| 引数 | 値 |
|---|---|
| pixelFormat | BitmapPixelFormat プロパティの値。 |
| alphaMode | BitmapAlphaMode プロパティの値 |
| transform | 新しい BitmapTransform。 |
| 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 の代わりにこのメソッドを使用する必要があります。