GetPS2ColorRenderingIntent-Funktion (icm.h)

Artikel
08/24/2023

Ruft die PostScript Level 2-Farbrenderingabsicht aus einem ICC-Farbprofil ab.

Syntax

BOOL GetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD    dwIntent,
  PBYTE    pBuffer,
  PDWORD   pcbPS2ColorRenderingIntent
);

Parameter

hProfile

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

dwIntent

Gibt die gewünschte Renderingabsicht an, die abgerufen werden soll. Gültige Werte sind:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderabsichten.

pBuffer

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

pcbPS2ColorRenderingIntent

Zeigt auf eine Variable, die die Puffergröße in Bytes enthält. Bei der Rückgabe enthält diese Variable die Anzahl der tatsächlich kopierten Bytes.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE. 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

Die von GetPS2ColorRenderingIntent zurückgegebene Renderingabsicht kann als Operand für den PostScript Level 2 findcolorrendering-Operator 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

Freigeben über