LOGCOLORSPACEW-Struktur (wingdi.h)

Artikel
11/20/2024

Die LOGCOLORSPACE Struktur enthält Informationen, die einen logischen Farbraumdefinieren.

Syntax

typedef struct tagLOGCOLORSPACEW {
  DWORD         lcsSignature;
  DWORD         lcsVersion;
  DWORD         lcsSize;
  LCSCSTYPE     lcsCSType;
  LCSGAMUTMATCH lcsIntent;
  CIEXYZTRIPLE  lcsEndpoints;
  DWORD         lcsGammaRed;
  DWORD         lcsGammaGreen;
  DWORD         lcsGammaBlue;
  WCHAR         lcsFilename[MAX_PATH];
} LOGCOLORSPACEW, *LPLOGCOLORSPACEW;

Angehörige

lcsSignature

Farbraumsignatur. Derzeit sollte dieses Mitglied immer auf LCS_SIGNATURE festgelegt werden.

lcsVersion

Versionsnummer; muss 0x400 sein.

lcsSize

Größe dieser Struktur in Byte.

lcsCSType

Farbraumtyp. Das Element kann einer der folgenden Werte sein:

Wert	Bedeutung
LCS_CALIBRATED_RGB	Farbwerte werden RGB-Werte kalibriert. Die Werte werden mithilfe der von den lcsEndpoints Member angegebenen Endpunkte übersetzt, bevor sie an das Gerät übergeben werden.
LCS_sRGB	Farbwerte sind Werte, die sRGB-Werte sind.
LCS_WINDOWS_COLOR_SPACE	Farbwerte sind Windows-Standardfarbraumfarbwerte.

Wenn LCS_CALIBRATED_RGB nicht angegeben ist, wird das "lcsEndpoints" Element ignoriert.

lcsIntent

Die Gamut-Zuordnungsmethode. Dieses Element kann einer der folgenden Werte sein:

Wert	Absicht	ICC-Name	Bedeutung
LCS_GM_ABS_ FARBMETRISCH	Streichholz	Absolute Farbmetrik	Behalten Sie den weißen Punkt bei. Stimmen Sie die Farben mit ihrer nächstgelegenen Farbe im Zielumfang überein.
LCS_GM_ GESCHÄFT	Grafik	Sättigung	Sättigung beibehalten. Wird für Geschäftsdiagramme und andere Situationen verwendet, in denen nicht zurückgegebene Farben erforderlich sind.
LCS_GM_ GRAPHIK	Beweis	Relative Farbmetrik	Aufrechterhalten der farbmetrischen Übereinstimmung. Wird für Grafikdesigns und benannte Farben verwendet.
LCS_GM_ BILDER	Bild	Wahrnehmungs	Kontrast beibehalten. Wird für Fotografien und natürliche Bilder verwendet.

lcsEndpoints

Rote, grüne, blaue Endpunkte.

lcsGammaRed

Skalierung der roten Koordinate.

lcsGammaGreen

Skalierung der grünen Koordinate.

lcsGammaBlue

Skala der blauen Koordinate.

lcsFilename[MAX_PATH]

Eine mit Null beendete Zeichenfolge, die eine Farbprofildatei benennt. Dieses Element ist in der Regel auf Null festgelegt, kann jedoch verwendet werden, um den Farbraum genau wie durch das Farbprofil angegeben festzulegen. Dies ist nützlich für Geräte, die Farbwerte für einen bestimmten Drucker oder bei Verwendung eines installierbaren Bildfarbabgleichs eingeben. Wenn ein Farbprofil angegeben wird, sollten alle anderen Elemente dieser Struktur auf angemessene Werte festgelegt werden, auch wenn die Werte nicht vollständig korrekt sind.

Bemerkungen

Wie Paletten, aber im Gegensatz zu Stiften und Pinsel muss ein Zeiger beim Erstellen eines LogColorSpace übergeben werden.

Wenn das lcsCSType Member auf LCS_sRGB oder LCS_WINDOWS_COLOR_SPACE festgelegt ist, werden die anderen Elemente dieser Struktur ignoriert, und WCS verwendet den sRGB-Farbraum. Die lcsEndpoints,lcsGammaRed, lcsGammaGreen, und lcsGammaBlue Member werden verwendet, um den logischen Farbraum zu beschreiben. Der lcsEndpoints Member ist eine CIEXYZTRIPLE-, die die X-, Y- und Z-Werte des RGB-Endpunkts des Farbraums enthält.

Das erforderliche DWORD-Bitformat für die lcsGammaRed, lcsGammaGreenund lcsGammaBlue ist eine 8,8 Feste Punkt ganzzahl links verschoben um 8 Bit. Dies bedeutet, dass 8 ganzzahlige Bits gefolgt von 8 Bruchbits sind. Unter Berücksichtigung der Bitverschiebung lautet das erforderliche Format des 32-Bit-DWORD:

000000000nnnffffff00000000000

Wenn der lcsFilename Member einen Dateinamen enthält und das lcsCSType Member auf LCS_CALIBRATED_RGB festgelegt ist, ignoriert WCS die anderen Elemente dieser Struktur. Es verwendet den Farbraum in der Datei als Farbraum, auf den sich diese LOGCOLORSPACE Struktur bezieht.

Die Beziehung zwischen den Dreireizwerten X,Y, Z und Farbigkeitswerten x,y,z lautet wie folgt:

x = X/(X+Y+Z)

y = Y/(X+Y+Z)

z = Z/(X+Y+Z)

Wenn das lcsCSType-Element auf LCS_sRGB oder LCS_WINDOWS_COLOR_SPACE festgelegt ist, werden die anderen Elemente dieser Struktur ignoriert, und ICM verwendet den sRGB-Farbraum. Anwendungen sollten den Rest der Struktur weiterhin initialisieren, da CreateProfileFromLogColorSpace lcsCSType-Member ignoriert und lcsEndpoints, lcsGammaRed, lcsGammaGreen, lcsGammaBlue-Member verwendet, um ein Profil zu erstellen, das im Falle von LCS_sRGB oder LCS_WINDOWS_COLOR_SPACE Farbräumen nicht initialisiert werden kann.

Anmerkung

Der wingdi.h-Header definiert LOGCOLORSPACE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	wingdi.h

Siehe auch

Freigeben über