Estructura XLATEOBJ (winddi.h)
La estructura XLATEOBJ se usa para traducir índices de color de una paleta a otra.
Sintaxis
typedef struct _XLATEOBJ {
ULONG iUniq;
FLONG flXlate;
USHORT iSrcType;
USHORT iDstType;
ULONG cEntries;
ULONG *pulXlate;
} XLATEOBJ;
Miembros
iUniq
Identificador de caché que permite al controlador reconocer una estructura XLATEOBJ que ha almacenado previamente en caché. Si este miembro es cero, el controlador no debe almacenar en caché la estructura XLATEOBJ.
flXlate
Marcas que especifican sugerencias sobre la traducción. Este miembro puede ser cualquier combinación de los siguientes valores:
| Valor | Significado |
|---|---|
| XO_DEVICE_ICM | ICM está habilitado en el dispositivo. El controlador debe traducir el color según la transformación de color creada por DrvIcmCreateColorTransform. El controlador debe llamar a XLATEOBJ_hGetColorTransform para obtener el identificador de transformación de color. Este bit es mutuamente excluyente de XO_HOST_ICM. |
| XO_FROM_CMYK | Como resultado de la traducción de ICM, los índices de origen se traducen al formato de color CMYK de 32 bits. Cuando se establece este bit, se debe omitir iSrcType, iDstType, cEntries y pulXlate . |
| XO_HOST_ICM | ICM se realiza mediante el motor de gráficos, por lo que los colores de esta tabla de colores se corrigen en la superficie de destino. El GDI establece este bit como información para el controlador: el controlador no requiere ninguna acción. Este bit es mutuamente excluyente de XO_DEVICE_ICM. |
| XO_TABLE | Se proporciona una tabla para traducir índices de origen a índices de destino. |
| XO_TO_MONO | Los índices de origen se traducen a un formato monocromático con la propiedad especial que todos los índices se asignan a cero, excepto para uno. Un controlador puede usarlo para acelerar una transferencia de bloques. |
| XO_TRIVIAL | Los índices de origen se pueden usar como índices de destino. |
iSrcType
Está obsoleto. Use XLATEOBJ_cGetPalette para consultar el formato de origen.
iDstType
Está obsoleto. Use XLATEOBJ_cGetPalette para consultar el formato de destino.
cEntries
Especifica el número de entradas de la matriz a las que apunta el miembro pulXlate . La indexación en pulXlate con un valor mayor que cEntries da como resultado una infracción de acceso a la memoria.
pulXlate
Puntero a una matriz de entradas de traducción.
Comentarios
La paleta de destino siempre pertenece a la superficie de destino de alguna operación de dibujo. La paleta de origen es una paleta seleccionada por la aplicación o una paleta de otra superficie.
La estructura XLATEOBJ se usa para traducir índices de color que hacen referencia a la paleta de origen a índices de la paleta de destino. El índice resultante identifica un color que coincide con el color de origen lo más cerca posible.
Requisitos
| Requisito | Valor |
|---|---|
| Header | winddi.h (incluya Winddi.h) |