BitmapFrame.GetPixelDataAsync Metode

Definisi

Ruang nama:

Windows.Graphics.Imaging

Overload

GetPixelDataAsync()	Secara asinkron meminta data piksel untuk bingkai. Array data piksel yang dihasilkan akan menggunakan format piksel bitmap dan mode alfa yang ditentukan dalam properti BitmapPixelFormat dan BitmapAlphaMode . Ini juga akan memiliki manajemen warna dan orientasi EXIF yang diterapkan (lihat bagian Keterangan untuk informasi selengkapnya).
GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)	Secara asinkron meminta data piksel untuk bingkai menggunakan parameter yang ditentukan.

GetPixelDataAsync()

Secara asinkron meminta data piksel untuk bingkai. Array data piksel yang dihasilkan akan menggunakan format piksel bitmap dan mode alfa yang ditentukan dalam properti BitmapPixelFormat dan BitmapAlphaMode . Ini juga akan memiliki manajemen warna dan orientasi EXIF yang diterapkan (lihat bagian Keterangan untuk informasi selengkapnya).

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)

Mengembalikan

IAsyncOperation<PixelDataProvider>

Objek yang mengelola pengambilan asinkron data piksel.

Penerapan

GetPixelDataAsync()

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Array data piksel akan menggunakan format piksel bitmap dan mode alfa yang ditentukan dalam properti BitmapPixelFormat dan BitmapAlphaMode . Ini juga akan memiliki manajemen warna dan orientasi EXIF yang diterapkan.

Sebagai kenyamanan, metode ini melakukan manajemen warna dari ruang warna yang disematkan bingkai (jika ada) ke ruang warna sRGB. Jika tidak ada data profil warna yang disematkan, maka tidak ada manajemen warna yang dilakukan. Metode ini juga mencoba membaca bendera orientasi EXIF pada bingkai, dan jika ada, akan melakukan transformasi yang diperlukan untuk mengorientasikan data piksel dengan benar.

Untuk mengambil lebar dan tinggi piksel bitmap yang benar, aplikasi harus membaca properti OrientedPixelWidth dan OrientedPixelHeight , bukan properti PixelWidth dan PixelHeight .

Metode ini setara dengan memanggil metode GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode) dengan argumen berikut:

Argumen	Nilai
pixelFormat	Nilai properti BitmapPixelFormat .
alphaMode	Nilai properti BitmapAlphaMode
Mengubah	Transformasi kosong.
exifOrientationMode	Nilai ExifOrientationModeRespectExifOrientation.
colorManagementMode	Nilai ColorManagementModeColorManageToSRgb.

Lihat juga

• GetPixelDataAsync(BitmapPixelFormat, BitmapAlphaMode, BitmapTransform, ExifOrientationMode, ColorManagementMode)
• PixelDataProvider
• Pencitraan
• Pencitraan

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

Secara asinkron meminta data piksel untuk bingkai menggunakan parameter yang ditentukan.

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)

Parameter

pixelFormat

BitmapPixelFormat

Format piksel yang ditentukan.

alphaMode

BitmapAlphaMode

Mode alfa yang ditentukan.

transform

BitmapTransform

Kumpulan transformasi yang akan diterapkan ke bingkai.

exifOrientationMode

ExifOrientationMode

Menunjukkan apakah bendera orientasi EXIF harus diabaikan atau dihormati.

colorManagementMode

ColorManagementMode

Menunjukkan apakah data piksel harus dikelola warna ke ruang warna sRGB.

Mengembalikan

IAsyncOperation<PixelDataProvider>

Objek yang mengelola pengambilan asinkron data piksel.

Penerapan

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

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Metode ini harus digunakan alih-alih GetPixelDataAsync jika aplikasi membutuhkan kontrol yang lebih halus atas array data piksel.

Jika Anda mengatur parameter exifOrientationMode ke RespectExifOrientation, data piksel yang dihasilkan akan memiliki dimensi yang ditentukan oleh OrientedPixelWidth dan OrientedPixelHeight alih-alih PixelWidth dan PixelHeight. Jika Anda juga menerapkan transformasi, lihat BitmapTransform untuk informasi tentang penanganan ruang koordinat dengan benar.

Lihat juga

• GetPixelDataAsync()
• Pencitraan
• Pencitraan