BitmapFrame.GetPixelDataAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| GetPixelDataAsync() |
以非同步方式要求框架的圖元資料。 產生的圖元資料陣列會使用 BitmapPixelFormat 和 BitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。 它也 (套用色彩管理和 EXIF 方向，請參閱一節以取得詳細資訊) 。 |
| GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) |
使用指定的參數，以非同步方式要求畫面的圖元資料。 |
GetPixelDataAsync()
以非同步方式要求框架的圖元資料。 產生的圖元資料陣列會使用 BitmapPixelFormat 和 BitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。 它也 (套用色彩管理和 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 屬性中指定的點陣圖像素格式和 Alpha 模式。 它也會套用色彩管理和 EXIF 方向。
為了方便起見，此方法會從框架的內嵌色彩空間執行色彩管理， (如果) 到 sRGB 色彩空間。 如果沒有內嵌色彩設定檔資料，則不會執行任何色彩管理。 此方法也會嘗試讀取框架上的 EXIF 方向旗標，如果存在，則會執行必要的轉換，以正確設定圖元資料的方向。
為了擷取正確的點陣圖圖元寬度和高度，應用程式應該讀取 OrientedPixelWidth 和 OrientedPixelHeight 屬性，而不是 PixelWidth 和 PixelHeight 屬性。
這個方法相當於使用下列引數呼叫 GetPixelDataAsync (BitmapPixelFormat、BitmapAlphaMode、BitmapTransform、ExifOrientationMode、ColorManagementMode) 方法：
| 引數 | 值 |
|---|---|
| pixelFormat | BitmapPixelFormat屬性的值。 |
| AlphaMode | BitmapAlphaMode屬性的值 |
| 變換 | 空的轉換。 |
| 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
指定的 Alpha 模式。
- transform
- BitmapTransform
要套用至框架的一組轉換。
- exifOrientationMode
- ExifOrientationMode
指出是否應該忽略或遵守 EXIF 方向旗標。
- colorManagementMode
- ColorManagementMode
指出圖元資料是否應以色彩管理為 sRGB 色彩空間。
傳回
物件，管理圖元資料的非同步擷取。
實作
- 屬性
備註
如果應用程式需要更精細的控制圖元資料陣列，則應該使用這個方法，而不是 GetPixelDataAsync 。
如果您將 exifOrientationMode 參數設定為 RespectExifOrientation，產生的圖元資料會有 由 OrientedPixelWidth 和 OrientedPixelHeight 所定義的維度，而不是 PixelWidth 和 PixelHeight。 如果您也套用轉換，請參閱 BitmapTransform 以取得正確處理座標空間的相關資訊。