XLATEOBJ-Struktur (winddi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | winddi.h (einschließlich Winddi.h) |