BitmapDecoder.GetPixelDataAsync Metode

Definisi

Ruang nama:

Windows.Graphics.Imaging

Overload

GetPixelDataAsync()	Secara asinkron meminta data piksel untuk bingkai.
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.

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.

Aplikasi tidak boleh mengasumsikan bahwa data piksel yang dikembalikan oleh metode ini menggunakan format piksel atau mode alfa tertentu (seperti Rgba8 dengan alfa yang telah ditentukan sebelumnya). Sebaliknya, harus selalu memeriksa properti BitmapPixelFormat dan BitmapAlphaMode dan menangani data yang sesuai.

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	BitmapTransform baru.
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

Set transformasi yang akan diterapkan ke bingkai.

exifOrientationMode

ExifOrientationMode

Menunjukkan apakah bendera orientasi EXIF harus diabaikan atau dihormati.

colorManagementMode

ColorManagementMode

Menunjukkan apakah data piksel harus berwarna dikelola 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.

Lihat juga

• GetPixelDataAsync()
• Pencitraan
• Pencitraan