Estrutura XLATEOBJ (winddi.h)

Artigo
03/04/2024

A estrutura XLATEOBJ é usada para traduzir índices de cores de uma paleta para outra.

Sintaxe

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

Membros

iUniq

Um identificador de cache que permite que o driver reconheça uma estrutura XLATEOBJ armazenada em cache anteriormente. Se esse membro for zero, o driver não deverá armazenar em cache a estrutura XLATEOBJ.

flXlate

Sinalizadores especificando dicas sobre a tradução. Esse membro pode ser qualquer combinação dos seguintes valores:

Valor	Significado
XO_DEVICE_ICM	O ICM está habilitado no dispositivo. O driver deve traduzir a cor de acordo com a transformação de cor criada por DrvIcmCreateColorTransform. O driver deve chamar XLATEOBJ_hGetColorTransform para obter o identificador de transformação de cor. Esse bit é mutuamente exclusivo de XO_HOST_ICM.
XO_FROM_CMYK	Como resultado da tradução do ICM, os índices de origem são traduzidos para o formato de cor CMYK de 32 bits. Quando esse bit é definido, iSrcType, iDstType, cEntries e pulXlate devem ser ignorados.
XO_HOST_ICM	O ICM é executado pelo mecanismo gráfico, portanto, as cores nesta tabela de cores são corrigidas para a superfície de destino. Esse bit é definido pelo GDI como informações para o driver: nenhuma ação é necessária para o driver. Esse bit é mutuamente exclusivo de XO_DEVICE_ICM.
XO_TABLE	Uma tabela é fornecida para traduzir índices de origem para índices de destino.
XO_TO_MONO	Os índices de origem são convertidos em um formato monocromático com a propriedade especial que todos os índices mapeiam para zero, exceto para um. Um driver pode usar isso para acelerar uma transferência de bloco.
XO_TRIVIAL	Os índices de origem são utilizáveis como índices de destino.

iSrcType

Está obsoleto. Use XLATEOBJ_cGetPalette para consultar o formato de origem.

iDstType

Está obsoleto. Use XLATEOBJ_cGetPalette para consultar o formato de destino.

cEntries

Especifica o número de entradas na matriz apontada pelo membro pulXlate . A indexação em pulXlate com um valor maior que cEntries resulta em uma violação de acesso à memória.

pulXlate

Ponteiro para uma matriz de entradas de tradução.

Comentários

A paleta de destino sempre pertence à superfície de destino de alguma operação de desenho. A paleta de origem é uma paleta selecionada pelo aplicativo ou uma paleta de outra superfície.

A estrutura XLATEOBJ é usada para traduzir índices de cores que se referem à paleta de origem para índices para a paleta de destino. O índice resultante identifica uma cor que corresponde à cor de origem o mais próxima possível.