LOGCOLORSPACEA-Struktur (wingdi.h)

Artikel
03/04/2024

Die LOGCOLORSPACE-Struktur enthält Informationen, die einen logischen Farbraum definieren.

Syntax

typedef struct tagLOGCOLORSPACEA {
  DWORD         lcsSignature;
  DWORD         lcsVersion;
  DWORD         lcsSize;
  LCSCSTYPE     lcsCSType;
  LCSGAMUTMATCH lcsIntent;
  CIEXYZTRIPLE  lcsEndpoints;
  DWORD         lcsGammaRed;
  DWORD         lcsGammaGreen;
  DWORD         lcsGammaBlue;
  CHAR          lcsFilename[MAX_PATH];
} LOGCOLORSPACEA, *LPLOGCOLORSPACEA;

Member

lcsSignature

Farbraumsignatur. Derzeit sollte dieser Member immer auf LCS_SIGNATURE festgelegt werden.

lcsVersion

Versionsnummer; muss 0x400 werden.

lcsSize

Größe dieser Struktur in Bytes.

lcsCSType

Farbraumtyp. Das Element kann einer der folgenden Werte sein.

Wert	Bedeutung
LCS_CALIBRATED_RGB	Farbwerte sind kalibrierte RGB-Werte. Die Werte werden mit den Endpunkten übersetzt, die vom lcsEndpoints-Member angegeben werden, bevor sie an das Gerät übergeben werden.
LCS_sRGB	Farbwerte sind sRGB-Werte.
LCS_WINDOWS_COLOR_SPACE	Farbwerte sind Windows-Standardfarbraumfarbwerte.

Wenn LCS_CALIBRATED_RGB nicht angegeben wird, wird das lcsEndpoints-Element ignoriert.

lcsIntent

Die Gamut-Zuordnungsmethode. Dieser Member kann einer der folgenden Werte sein.

Wert	Intent	ICC-Name	Bedeutung
LCS_GM_ABS_ FARBMETRISCH	Match	Absolute Farbmetrik	Behalten Sie den Weißpunkt bei. Passen Sie die Farben der nächstgelegenen Farbe im Zielraum an.
LCS_GM_ BUSINESS	Graphic	Sättigung	Sättigung beibehalten. Wird für Geschäftsdiagramme und andere Situationen verwendet, in denen nicht versehene Farben erforderlich sind.
LCS_GM_ GRAPHICS	Proof	Relative Farbmetrik	Behalten Sie die farbmetrische Übereinstimmung bei. Wird für Grafikdesigns und benannte Farben verwendet.
LCS_GM_ IMAGES	Picture	Wahrnehmungs	Kontrast beibehalten. Wird für Fotografien und natürliche Bilder verwendet.

lcsEndpoints

Rote, grüne, blaue Endpunkte.

lcsGammaRed

Skala der roten Koordinate.

lcsGammaGreen

Skala der grünen Koordinate.

lcsGammaBlue

Skala der blauen Koordinate.

lcsFilename[MAX_PATH]

Eine NULL-Zeichenfolge, die eine Farbprofildatei benennt. Dieser Member ist in der Regel auf 0 festgelegt, kann jedoch verwendet werden, um den Farbraum genau so festzulegen, wie im Farbprofil angegeben. Dies ist nützlich für Geräte, die Farbwerte für einen bestimmten Drucker eingeben, oder bei Verwendung eines installierbaren Bildfarbabgleichs. Wenn ein Farbprofil angegeben wird, sollten alle anderen Elemente dieser Struktur auf vernünftige Werte festgelegt werden, auch wenn die Werte nicht vollständig genau sind.

Hinweise

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

Wenn das lcsCSType-Element auf LCS_sRGB oder LCS_WINDOWS_COLOR_SPACE festgelegt ist, werden die anderen Elemente dieser Struktur ignoriert, und WCS verwendet den sRGB-Farbraum. Die Elemente lcsEndpoints,lcsGammaRed, lcsGammaGreen und lcsGammaBlue werden verwendet, um den logischen Farbraum zu beschreiben. Das lcsEndpoints-Element ist ein CIEXYZTRIPLE , das die x-, y- und z-Werte des RGB-Endpunkts des Farbraums enthält.

Das erforderliche DWORD-Bitformat für lcsGammaRed, lcsGammaGreen und lcsGammaBlue ist eine ganzzahlige 8,8-Fixpunkt-Ganzzahl mit Linksverschiebung um 8 Bit. Dies bedeutet, dass 8 ganzzahlige Bits von 8 Bruchbits gefolgt werden. Unter Berücksichtigung der Bitverschiebung ist das erforderliche Format des 32-Bit-DWORD:

0000000000nnffffffffff0000000000

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

Die Beziehung zwischen den Dreistimulanzwerten X,Y,Z und chromatischen Werten x,y,z ist 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 Member dieser Struktur ignoriert, und ICM verwendet den sRGB-Farbraum. Anwendungen sollten weiterhin den Rest der Struktur initialisieren, da CreateProfileFromLogColorSpace lcsCSType-Member ignoriert und lcsEndpoints, lcsGammaRed, lcsGammaGreen, lcsGammaBlue-Member verwendet, um ein Profil zu erstellen, das bei LCS_sRGB oder LCS_WINDOWS_COLOR_SPACE Farbräumen möglicherweise nicht initialisiert wird.

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wingdi.h

Weitere Informationen