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) |