Freigeben über

CMGetPS2ColorRenderingIntent-Funktion (icm.h)

  • Artikel

Ruft die Farbrenderingabsicht PostScript Level 2 aus einem Profil ab.

Syntax

BOOL CMGetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD    dwIntent,
  LPBYTE   lpBuffer,
  LPDWORD  lpcbSize
);

Parameter

hProfile

Gibt das zu verwendende Profil an.

dwIntent

Gibt die abzurufende Renderingabsicht an. Folgenden Werte sind möglich:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Weitere Informationen finden Sie unter Renderingabsichten.

lpBuffer

Verweist auf einen Puffer, in dem die Farbrenderingabsicht platziert werden soll. Wenn der Zeiger NULL ist, gibt die Funktion die für diesen Puffer erforderliche Größe in *lpcbSize zurück.

lpcbSize

Verweist auf eine Variable, die die Größe des Puffers angibt. Bei der Rückgabe hat die Variable contains die Anzahl der Bytes, die tatsächlich in den Puffer kopiert wurden.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE. Es gibt auch TRUE zurück, wenn er aufgerufen wird, wobei lpBuffer auf NULL festgelegt ist und die Größe des erforderlichen Puffers in lpcbSize kopiert wird.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE. In diesem Fall sollte der CMM SetLastError aufrufen, um den letzten Fehler auf einen gültigen Fehlerwert festzulegen, der in Winerror.h definiert ist.

Hinweise

Diese Funktion ist für alle CMMs optional.

Wenn ein CMM diese Funktion nicht unterstützt, verwendet Windows den Standard-CMM, um die Farbrenderingabsicht zu erhalten.

Wenn das Tag nicht in dem profil vorhanden ist, das durch hProfile angegeben ist, wird es vom CMM erstellt. Die resultierende Renderingabsicht kann als Operand für den Findcolorrendering-Operator für PostScript Level 2 verwendet werden.

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

Weitere Informationen