Freigeben über

GetPS2ColorRenderingDictionary-Funktion (icm.h)

  • Artikel

Ruft das PostScript Level 2-Farbrenderungswörterbuch aus dem angegebenen ICC-Farbprofil ab.

Syntax

BOOL GetPS2ColorRenderingDictionary(
  HPROFILE hProfile,
  DWORD    dwIntent,
  PBYTE    pPS2ColorRenderingDictionary,
  PDWORD   pcbPS2ColorRenderingDictionary,
  PBOOL    pbBinary
);

Parameter

hProfile

Gibt ein Handle für das betreffende ICC-Farbprofil an.

dwIntent

Gibt die gewünschte Renderingabsicht für das Farbrenderingwörterbuch an. Gültige Werte sind:

  • INTENT_PERCEPTUAL
  • INTENT_SATURATION
  • INTENT_RELATIVE_COLORIMETRIC
  • INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderabsichten.

pPS2ColorRenderingDictionary

Zeiger auf einen Puffer, in dem das Farbrenderingwörterbuch platziert werden soll. Wenn der pBuffer-Zeiger auf NULL festgelegt ist, wird die erforderliche Puffergröße in *pcbSize zurückgegeben.

pcbPS2ColorRenderingDictionary

Zeiger auf eine Variable, die die Größe des Puffers in Bytes enthält. Bei der Rückgabe enthält die Variable die Anzahl der tatsächlich kopierten Bytes.

pbBinary

Zeiger auf eine boolesche Variable. Wenn TRUE, könnte das Farbrenderingwörterbuch in binärer Form kopiert werden. Bei FALSE wird das Wörterbuch in ASCII85 Form codiert. Bei der Rückgabe gibt diese boolesche Variable an, ob das Wörterbuch tatsächlich binär (TRUE) oder ASCII85 (FALSE) war.

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.

Hinweise

Wenn das Wörterbuch im Profil nicht verfügbar ist, erstellt die GetPS2ColorRenderingDictionary-Funktion ein Wörterbuch mithilfe des Profilinhalts. Dieses Wörterbuch kann dann als Operand für den PostScript Level 2-Operator setcolorrendering verwendet werden.

Diese Methode unterstützt keine WCS-Profile.

Anforderungen

Anforderung Wert
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