BitmapFrame.GetPixelDataAsync 方法

  • 參考

定義

命名空間:
Windows.Graphics.Imaging

多載

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)

傳回

IAsyncOperation<PixelDataProvider>

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

實作

GetPixelDataAsync()
屬性
OverloadAttribute RemoteAsyncAttribute

備註

圖元資料陣列會使用 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)

編輯

使用指定的參數，以非同步方式要求畫面的圖元資料。

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 。

如果您將 exifOrientationMode 參數設定為 RespectExifOrientation，產生的圖元資料會有 由 OrientedPixelWidth 和 OrientedPixelHeight 所定義的維度，而不是 PixelWidth 和 PixelHeight。 如果您也套用轉換，請參閱 BitmapTransform 以取得正確處理座標空間的相關資訊。

另請參閱

適用於