Freigeben über


LOGCOLORSPACEA-Struktur (wingdi.h)

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

BITMAPV4HEADER

BITMAPV5HEADER

CMYK

RGB