BitmapFrame.GetPixelDataAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Objek yang mengelola pengambilan asinkron data piksel.
Penerapan
- Atribut
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
Berlaku untuk
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
Objek yang mengelola pengambilan asinkron data piksel.
Penerapan
- Atribut
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.