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.

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

lcsIntent

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

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.

Anforderungen

Weitere Informationen

BITMAPV4HEADER

BITMAPV5HEADER

CMYK

RGB