Estrutura XLATEOBJ (winddi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | winddi.h (inclua Winddi.h) |