Share via

SHGetInverseCMAP-Funktion (shlwapi.h)

  • Artikel

[Diese Funktion ist über Windows XP und Windows Server 2003 verfügbar. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar.]

Ruft die umgekehrte Farbtabellenzuordnung für die Halbtonpalette ab.

Syntax

LWSTDAPI SHGetInverseCMAP(
  [out] BYTE  *pbMap,
  [in]  ULONG cbMap
);

Parameter

[out] pbMap

Typ: BYTE*

Ein Zeiger auf ein Array von BYTE-Werten, das die inverse Farbtabellenzuordnung empfängt, oder ein Zeiger auf ein LPBYTE, der abhängig vom Wert des cbMap-Parameters einen Zeiger auf eine zwischengespeicherte Kopie der inversen Farbtabellenzuordnung empfängt.

[in] cbMap

Typ: ULONG

Die Größe des Puffers, auf den pbMap verweist, der auch den Inhalt definiert. Zwei Werte werden erkannt.

(sizeof(BYTE*))

Der Puffer, auf den pbMap verweist, empfängt einen Zeiger auf eine zwischengespeicherte Kopie der umgekehrten Farbzuordnungstabelle.

(32768)

Der Puffer, auf den pbMap verweist, empfängt eine Kopie der umgekehrten Farbzuordnungstabelle. Der Puffer muss genau 32.768 Bytes groß sein.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die inverse Farbzuordnungstabelle ist eine Tabelle mit 32.768 Bytes. Sie enthält die Farbindizes in der Halbtonpalette. Jeder Index wird an einer Position im Puffer gespeichert, die einem bestimmten RGB-Wert entspricht, der im Format 555 ausgedrückt wird. Diese Kopplungen ermöglichen es Ihnen, eine Farbe in der Halbtonpalette zu finden, die eine enge Näherung der ursprünglichen Farbe ist.

Beispielsweise lautet die Methode zum Bestimmen einer Farbe in der Halbtonpalette, die eine enge Näherung für die Farbe #306040 darstellt, wie folgt:

  1. Zerlegen Sie die Farbe in ihre roten, grünen und blauen Komponenten. In diesem Fall wird die rote Komponente 0x30, die grüne Komponente 0x60 und die blaue Komponente 0x40.
  2. Passen Sie die Farbe im Format 555 erneut an. Die Formel zum Reduzieren einer 24-Bit-RGB-Farbe in das 555-Format wird hier gezeigt. 
    ((red / 8) << 10) + ((blue / 8) << 5) + (green / 8)

    In diesem Beispiel ist der Wert im Format 555 ((0x30 / 8) << 10) + ((0x60 / 8) << 5) + (0x40 / 8) = 6536.

  3. Der Indexwert, der an Position 6536 in der Tabelle der umgekehrten Farbzuordnung gespeichert ist, ist der Index der Farbe in der Halbtonpalette, der eine vernünftige Näherung an die Farbe #306040 darstellt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

CreateHalftonePalette

GetNearestColor