Bagikan melalui

Metode IWICBitmapFrameEncode::SetColorContexts (wincodec.h)

  • Artikel

Mengatur profil IWICColorContext angka tertentu ke bingkai.

Sintaks

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

Parameter

[in] cCount

Jenis: UINT

Jumlah profil IWICColorContext yang akan diatur.

[in] ppIColorContext

Jenis: IWICColorContext**

Penunjuk ke penunjuk IWICColorContext yang berisi profil konteks warna untuk diatur ke bingkai.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

  • BMPPengaturan konteks warna tidak didukung. Fungsi ini akan mengembalikan WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • PNGPengaturan paling banyak satu konteks warna didukung, dan konteks warna tambahan akan diabaikan. Konteks ini harus berupa WICColorContextProfile, dan digunakan untuk mengodekan gugus iCCP, gAMA, dan cHRM dalam file PNG.
  • JPEG, TIFF, JPEG-XRMenyiapkan ke satu WICColorContextProfile dan satu WICColorContextExifColorSpace didukung. Pengguna tidak boleh memberikan lebih dari satu dari setiap jenis konteks warna, karena semua kecuali konteks terakhir dari setiap jenis akan diabaikan. Dalam JPEG, WICColorContextProfile dikodekan ke blok metadata JPEG APP2 ICC.

    Di TIFF dan JPEG-XR, WICColorContextProfile dikodekan ke blok metadata profil IFD ICC (tag IFD 0x8773). Dalam ketiga format, WICColorContextExifColorSpace dikodekan ke blok metadata ruang warna EXIF (tag EXIF 0xA001).

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP dengan SP2, Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header wincodec.h
Pustaka Windowscodecs.lib