BitmapDecoder.GetPixelDataAsync 方法

定義

命名空間:

Windows.Graphics.Imaging

多載

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)

傳回

IAsyncOperation<PixelDataProvider>

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

實作

GetPixelDataAsync()

屬性

OverloadAttribute RemoteAsyncAttribute

備註

圖元資料陣列會使用 BitmapPixelFormat 和 BitmapAlphaMode 屬性中指定的點陣圖像素格式和 Alpha 模式。 它也會套用色彩管理和 EXIF 方向。

應用程式不應該假設此方法傳回的圖元資料會使用任何特定的像素格式或 Alpha 模式 (，例如 Rgba8 搭配預先乘法的 Alpha) 。 相反地，它應該一律檢查 BitmapPixelFormat 和 BitmapAlphaMode 屬性，並據以處理資料。

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

為了擷取正確的點陣圖圖元寬度和高度，應用程式應該讀取 OrientedPixelWidth 和 OrientedPixelHeight 屬性，而不是 PixelWidth 和 PixelHeight 屬性。

這個方法相當於使用下列引數呼叫 GetPixelDataAsync (BitmapPixelFormat、BitmapAlphaMode、BitmapTransform、ExifOrientationMode、ColorManagementMode) 方法：

引數	值
pixelFormat	BitmapPixelFormat屬性的值。
AlphaMode	BitmapAlphaMode屬性的值
變換	新的 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

指定的 Alpha 模式。

transform

BitmapTransform

要套用至框架的轉換集。

exifOrientationMode

ExifOrientationMode

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

colorManagementMode

ColorManagementMode

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

傳回

IAsyncOperation<PixelDataProvider>

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

實作

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

屬性

OverloadAttribute RemoteAsyncAttribute

備註

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

另請參閱

• GetPixelDataAsync()
• 建立映像
• 建立映像