Fungsi GetPS2ColorSpaceArray (icm.h)

Artikel
03/09/2023

Mengambil array ruang warna PostScript Level 2 dari profil warna ICC.

Sintaks

BOOL GetPS2ColorSpaceArray(
  HPROFILE hProfile,
  DWORD    dwIntent,
  DWORD    dwCSAType,
  PBYTE    pPS2ColorSpaceArray,
  PDWORD   pcbPS2ColorSpaceArray,
  PBOOL    pbBinary
);

Parameter

hProfile

Menentukan handel ke profil ICC untuk mengambil array ruang warna PostScript Level 2.

dwIntent

Menentukan niat penyajian yang diinginkan untuk array ruang warna. Bidang ini mungkin mengambil salah satu nilai berikut:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Untuk informasi selengkapnya, lihat Niat Rendering.

dwCSAType

Menentukan jenis array ruang warna. Lihat Pengidentifikasi Tipe Ruang Warna.

pPS2ColorSpaceArray

Penunjuk ke buffer tempat array ruang warna akan ditempatkan. Jika penunjuk pBuffer diatur ke NULL, fungsi mengembalikan ukuran buffer yang diperlukan di lokasi memori yang ditunjukkan oleh pcbSize.

pcbPS2ColorSpaceArray

Penunjuk ke variabel yang berisi ukuran buffer dalam byte. Saat dikembalikan, berisi jumlah byte yang disalin ke dalam buffer.

pbBinary

Penunjuk ke variabel Boolean. Jika diatur ke TRUE, data yang disalin bisa berupa biner. Jika diatur ke FALSE, data harus dikodekan sebagai ASCII85. Saat kembali, lokasi memori yang ditunjukkan oleh pbBinary menunjukkan apakah data yang dikembalikan benar-benar biner (TRUE) atau ASCII85 (FALSE).

Menampilkan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE. Ini juga mengembalikan TRUE jika parameter pBufferADALAH NULL dan ukuran yang diperlukan untuk buffer disalin ke dalam pcbSize.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jika array ruang warna tidak tersedia di profil, fungsi GetPS2ColorSpaceArray membangun array ruang warna PostScript Level 2 menggunakan konten profil. Array ini kemudian dapat digunakan sebagai operand untuk operator setcolorspace PostScript Level2.

Metode ini tidak mendukung profil WCS.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	icm.h
Pustaka	Mscms.lib
DLL	Mscms.dll

Bagikan melalui