Freigeben über

GetPS2ColorSpaceArray-Funktion (icm.h)

  • Artikel

Ruft das PostScript Level 2-Farbraumarray aus einem ICC-Farbprofil ab.

Syntax

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

Parameter

hProfile

Gibt ein Handle für das ICC-Profil an, aus dem das PostScript Level 2-Farbraumarray abgerufen werden soll.

dwIntent

Gibt die gewünschte Renderingabsicht für das Farbraumarray an. Dieses Feld kann einen der folgenden Werte annehmen:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderingabsichten.

dwCSAType

Gibt den Typ des Farbraumarrays an. Weitere Informationen finden Sie unter Farbraumtypbezeichner.

pPS2ColorSpaceArray

Zeiger auf einen Puffer, in dem das Farbraumarray platziert werden soll. Wenn der pBuffer-Zeiger auf NULL festgelegt ist, gibt die Funktion die erforderliche Größe des Puffers in der Speicherposition zurück, auf die von pcbSize verwiesen wird.

pcbPS2ColorSpaceArray

Zeiger auf eine Variable, die die Größe des Puffers in Bytes enthält. Bei der Rückgabe enthält es die Anzahl der Bytes, die in den Puffer kopiert wurden.

pbBinary

Zeiger auf eine boolesche Variable. Wenn dieser Wert auf TRUE festgelegt ist, können die kopierten Daten binär sein. Wenn dieser Wert auf FALSE festgelegt ist, sollten Daten als ASCII85 codiert werden. Bei der Rückgabe gibt der Speicherspeicherort, auf den pbBinary verweist, an, ob die zurückgegebenen Daten tatsächlich binär (TRUE) oder ASCII85 (FALSE) sind.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE. Außerdem wird TRUE zurückgegeben, wenn der pBuffer-ParameterNULL ist und die für den Puffer erforderliche Größe in pcbSize kopiert wird.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Wenn das Farbraumarray im Profil nicht verfügbar ist, erstellt die GetPS2ColorSpaceArray-Funktion ein PostScript Level 2-Farbraumarray unter Verwendung des Profilinhalts. Dieses Array kann dann als Operand für den PostScript Level2-Operator setcolorspace verwendet werden.

Diese Methode unterstützt keine WCS-Profile.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile icm.h
Bibliothek Mscms.lib
DLL Mscms.dll

Weitere Informationen