ColorMatchToTarget-Funktion (wingdi.h)

  • Artikel

Mit der ColorMatchToTarget-Funktion können Sie Farben so anzeigen, wie sie auf dem Zielgerät angezeigt werden.

Syntax

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

Parameter

hdc

Gibt den Gerätekontext für die Vorschau an, in der Regel der Bildschirm.

hdcTarget

Gibt den Kontext des Zielgeräts an, in der Regel ein Drucker.

action

Eine Konstante, die einen der folgenden Werte haben kann.

 

Wert Bedeutung
CS_ENABLE
 Ordnen Sie die Farben der Farbskala des Zielgeräts zu. Dies ermöglicht die Farbprüfung. Alle nachfolgenden Zeichenbefehle für den DC rendern Farben so, wie sie auf dem Zielgerät angezeigt werden.
CS_DISABLE
 Deaktivieren Sie die Farbprüfung.
CS_DELETE_TRANSFORM
 Wenn die Farbverwaltung für das Zielprofil aktiviert ist, deaktivieren Sie es, und löschen Sie die verkettete Transformation.

Rückgabewert

Wenn diese Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn diese Funktion fehlschlägt, ist der Rückgabewert FALSE.

Hinweise

ColorMatchToTarget kann verwendet werden, um die Farben eines Farbausgabegeräts auf einem anderen Farbausgabegerät zu überprüfen. Wenn Sie den uiAction-Parameter auf CS_ENABLE festlegen, werden bei allen nachfolgenden Zeichnungsbefehlen im DC Farben gerendert, wie sie auf dem Zielgerät angezeigt werden. Wenn uiAction auf CS_DISABLE festgelegt ist, wird die Korrekturprüfung deaktiviert. Die aktuelle Farbtransformation wird jedoch nicht aus dem DC gelöscht. Es ist einfach inaktiv.

Wenn ColorMatchToTarget aufgerufen wird, wird zuerst die Farbtransformation für das Zielgerät ausgeführt, und dann wird die Transformation auf das Vorschaugerät auf die Ergebnisse der ersten Transformation angewendet. Dies wird in erster Linie zum Überprüfen von Gamutzuordnungsbedingungen verwendet. Bevor Sie diese Funktion verwenden, müssen Sie WCS für beide Gerätekontexte aktivieren.

Diese Funktion kann nicht kaskadiert werden. Während die Farbzuordnung zum Ziel durch Festlegen von uiAction auf CS_ENABLE aktiviert wird, werden Änderungen der Anwendung am Farbraum oder der Gamutzuordnungsmethode ignoriert. Diese Änderungen werden dann wirksam, wenn die Farbzuordnung zum Ziel deaktiviert ist.

Hinweis Ein Speicherverlust tritt nicht auf, wenn eine Anwendung eine Transformation nicht mithilfe von CS_DELETE_TRANSFORM löscht. Die Transformation wird gelöscht, wenn entweder der Gerätekontext (Device Context, DC) geschlossen wird oder wenn der Farbraum der Anwendung gelöscht wird. Wenn die Transformation jedoch nicht erneut verwendet wird oder die Anwendung keine weiteren Farbabgleiche auf dem DC durchführt, sollte sie die Transformation explizit löschen, um den belegten Arbeitsspeicher freizugeben.
 
Der uiAction-Parameter sollte nur auf CS_DELETE_TRANSFORM festgelegt werden, wenn die Farbverwaltung aktiviert ist, bevor die ColorMatchToTarget-Funktion aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wingdi.h
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen