Estructura XLATEOBJ (winddi.h)

Artículo
03/04/2024

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.