Struttura XLATEOBJ (winddi.h)

La struttura XLATEOBJ viene usata per tradurre gli indici di colore da una tavolozza a un'altra.

Sintassi

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

Members

iUniq

Identificatore della cache che consente al driver di riconoscere una struttura XLATEOBJ precedentemente memorizzata nella cache. Se questo membro è zero, il driver non deve memorizzare nella cache la struttura XLATEOBJ.

flXlate

Flag che specificano hint sulla traduzione. Questo membro può essere una combinazione dei valori seguenti:

Valore Significato
XO_DEVICE_ICM ICM è abilitato nel dispositivo. Il driver deve tradurre il colore in base alla trasformazione del colore creata da DrvIcmCreateColorTransform. Il driver deve chiamare XLATEOBJ_hGetColorTransform per ottenere l'handle di trasformazione del colore. Questo bit si escludono a vicenda da XO_HOST_ICM.
XO_FROM_CMYK Come risultato della traduzione ICM, gli indici di origine vengono convertiti nel formato di colore CMYK a 32 bit. Quando questo bit è impostato, è necessario ignorare iSrcType, iDstType, cEntries e pulXlate.
XO_HOST_ICM ICM viene eseguito dal motore di grafica, quindi i colori di questa tabella colori vengono corretti nella superficie di destinazione. Questo bit viene impostato da GDI come informazioni per il driver: nessuna azione è necessaria dal driver. Questo bit si escludono a vicenda da XO_DEVICE_ICM.
XO_TABLE Viene fornita una tabella per tradurre gli indici di origine in indici di destinazione.
XO_TO_MONO Gli indici di origine vengono convertiti in un formato monocromatico con la proprietà speciale che tutti gli indici mappano a zero, ad eccezione di uno. Un driver può usarlo per accelerare un trasferimento a blocchi.
XO_TRIVIAL Gli indici di origine sono utilizzabili come indici di destinazione.

iSrcType

Obsoleto. Usare XLATEOBJ_cGetPalette per eseguire query sul formato di origine.

iDstType

Obsoleto. Usare XLATEOBJ_cGetPalette per eseguire query sul formato di destinazione.

cEntries

Specifica il numero di voci nella matrice a cui punta il membro pulXlate . L'indicizzazione in pulXlate con un valore maggiore di cEntries comporta una violazione dell'accesso alla memoria.

pulXlate

Puntatore a una matrice di voci di traduzione.

Commenti

La tavolozza di destinazione appartiene sempre alla superficie di destinazione di un'operazione di disegno. Il tavolozza di origine è una tavolozza selezionata dall'applicazione o una tavolozza da un'altra superficie.

La struttura XLATEOBJ viene usata per tradurre indici di colore che fanno riferimento alla tavolozza di origine agli indici per la tavolozza di destinazione. L'indice risultante identifica un colore corrispondente al colore di origine il più vicino possibile.

Requisiti

Requisito Valore
Intestazione winddi.h (include Winddi.h)

Vedi anche

DrvIcmCreateColorTransform

XLATEOBJ_cGetPalette

XLATEOBJ_hGetColorTransform

XLATEOBJ_piVector