共用方式為


IBitmapFrame.GetPixelDataAsync 方法

定義

多載

GetPixelDataAsync()

以非同步方式要求框架的圖元資料。 產生的圖元資料陣列會使用 BitmapPixelFormatBitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。 它也會套用色彩管理和 EXIF 方向 (如需詳細資訊,請參閱一節以取得詳細資訊) 。

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

使用指定的參數,以非同步方式要求框架的圖元資料。

GetPixelDataAsync()

以非同步方式要求框架的圖元資料。 產生的圖元資料陣列會使用 BitmapPixelFormatBitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。 它也會套用色彩管理和 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)

傳回

管理圖元資料非同步擷取的物件。

屬性

備註

應用程式不應該假設此方法所傳回的圖元資料會使用任何特定的像素格式或 Alpha 模式 (,也就是使用預先乘法 Alpha) 的 Rgba8。 相反地,它應該一律檢查 BitmapPixelFormatBitmapAlphaMode 屬性,並據以處理資料。

為了方便起見,此方法會從畫面格的內嵌色彩空間 (執行色彩管理,如果色彩空間存在) 至 sRGB 色彩空間,則會執行色彩管理。 如果沒有內嵌色彩設定檔資料,則不會執行色彩管理。 此方法也會嘗試讀取畫面上的 EXIF 方向旗標,如果存在,則會執行必要的轉換,以正確設定圖元資料的方向。

為了擷取正確的點陣圖圖元寬度和高度,應用程式應該讀取 OrientedPixelWidthOrientedPixelHeight 屬性,而不是 PixelWidthPixelHeight 屬性。

這個方法相當於使用下列引數呼叫 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

指定的 Alpha 模式。

transform
BitmapTransform

要套用至框架的轉換集。

exifOrientationMode
ExifOrientationMode

指出是否應該忽略或遵守 EXIF 方向旗標。

colorManagementMode
ColorManagementMode

指出圖元資料是否應以色彩管理為 sRGB 色彩空間。

傳回

管理圖元資料非同步擷取的物件。

屬性

備註

如果應用程式需要更精細的控制圖元資料陣列,則應該使用這個方法,而不是 GetPixelDataAsync

另請參閱

適用於