XLATEOBJ-Struktur (winddi.h)

Artikel
03/13/2024

Die XLATEOBJ-Struktur wird verwendet, um Farbindizes von einer Palette in eine andere zu übersetzen.

Syntax

typedef struct _XLATEOBJ {
  ULONG  iUniq;
  FLONG  flXlate;
  USHORT iSrcType;
  USHORT iDstType;
  ULONG  cEntries;
  ULONG  *pulXlate;
} XLATEOBJ;

Member

iUniq

Ein Cachebezeichner, der es dem Treiber ermöglicht, eine zuvor zwischengespeicherte XLATEOBJ-Struktur zu erkennen. Wenn dieser Member 0 ist, sollte der Treiber die XLATEOBJ-Struktur nicht zwischenspeichern.

flXlate

Flags, die Hinweise zur Übersetzung angeben. Dieser Member kann eine beliebige Kombination der folgenden Werte sein:

Wert	Bedeutung
XO_DEVICE_ICM	ICM ist auf dem Gerät aktiviert. Der Treiber sollte die Farbe entsprechend der von DrvIcmCreateColorTransform erstellten Farbtransform übersetzen. Der Treiber sollte XLATEOBJ_hGetColorTransform aufrufen, um den Farbtransformationshandle abzurufen. Dieses Bit schließt sich gegenseitig von XO_HOST_ICM aus.
XO_FROM_CMYK	Als Ergebnis der ICM-Übersetzung werden Quellindizes in das 32-Bit-CMYK-Farbformat übersetzt. Wenn dieses Bit festgelegt ist, sollten iSrcType, iDstType, cEntries und pulXlate ignoriert werden.
XO_HOST_ICM	ICM wird von der Grafik-Engine ausgeführt, sodass die Farben in dieser Farbtabelle auf die Zieloberfläche korrigiert werden. Dieses Bit wird vom GDI als Informationen für den Treiber festgelegt: Vom Treiber ist keine Aktion erforderlich. Dieses Bit schließt sich gegenseitig von XO_DEVICE_ICM aus.
XO_TABLE	Eine Tabelle wird bereitgestellt, um Quellindizes in Zielindizes zu übersetzen.
XO_TO_MONO	Quellindizes werden in ein monochromes Format mit der speziellen Eigenschaft übersetzt, dass alle Indizes mit Ausnahme eines Indizes 0 zugeordnet werden. Ein Treiber kann dies verwenden, um eine Blockübertragung zu beschleunigen.
XO_TRIVIAL	Quellindizes können als Zielindizes verwendet werden.

iSrcType

Ist veraltet. Verwenden Sie XLATEOBJ_cGetPalette , um das Quellformat abzufragen.

iDstType

Ist veraltet. Verwenden Sie XLATEOBJ_cGetPalette , um das Zielformat abzufragen.

cEntries

Gibt die Anzahl der Einträge in dem Array an, auf das das pulXlate-Element verweist. Die Indizierung in pulXlate mit einem Wert größer als cEntries führt zu einer Speicherzugriffsverletzung.

pulXlate

Zeiger auf ein Array von Übersetzungseinträgen.

Hinweise

Die Zielpalette gehört immer zur Zieloberfläche eines Zeichnungsvorgangs. Die Quellpalette ist eine von der Anwendung ausgewählte Palette oder eine Palette von einer anderen Oberfläche.

Die XLATEOBJ-Struktur wird verwendet, um Farbindizes, die auf die Quellpalette verweisen, in Indizes für die Zielpalette zu übersetzen. Der resultierende Index identifiziert eine Farbe, die der Quellfarbe so gut wie möglich entspricht.