Structure XLATEOBJ (winddi.h)

Article
08/27/2023

La structure XLATEOBJ est utilisée pour traduire des index de couleur d’une palette à l’autre.

Syntaxe

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

Membres

iUniq

Identificateur de cache qui permet au pilote de reconnaître une structure XLATEOBJ qu’il a précédemment mise en cache. Si ce membre est égal à zéro, le pilote ne doit pas mettre en cache la structure XLATEOBJ.

flXlate

Indicateurs spécifiant des indicateurs sur la traduction. Ce membre peut être n’importe quelle combinaison des valeurs suivantes :

Valeur	Signification
XO_DEVICE_ICM	ICM est activé sur l’appareil. Le pilote doit traduire la couleur en fonction de la transformation de couleur créée par DrvIcmCreateColorTransform. Le pilote doit appeler XLATEOBJ_hGetColorTransform pour obtenir le handle de transformation de couleur. Ce bit s’exclut mutuellement de XO_HOST_ICM.
XO_FROM_CMYK	À la suite de la traduction ICM, les index sources sont traduits au format de couleur CMJN 32 bits. Lorsque ce bit est défini, iSrcType, iDstType, cEntries et pulXlate doivent être ignorés.
XO_HOST_ICM	ICM étant effectué par le moteur graphique, les couleurs de cette table de couleurs sont corrigées sur la surface cible. Ce bit est défini par le GDI en tant qu’informations pour le pilote : aucune action n’est requise par le pilote. Ce bit s’exclut mutuellement de XO_DEVICE_ICM.
XO_TABLE	Une table est fournie pour traduire les index sources en index cibles.
XO_TO_MONO	Les index sources sont traduits dans un format monochrome avec la propriété spéciale que tous les index sont mappés à zéro, à l’exception d’un seul. Un pilote peut l’utiliser pour accélérer un transfert de bloc.
XO_TRIVIAL	Les index sources sont utilisables en tant qu’index cibles.

iSrcType

Est obsolète. Utilisez XLATEOBJ_cGetPalette pour interroger le format source.

iDstType

Est obsolète. Utilisez XLATEOBJ_cGetPalette pour interroger le format de destination.

cEntries

Spécifie le nombre d’entrées dans le tableau pointé vers le membre pulXlate . L’indexation dans pulXlate avec une valeur supérieure à cEntries entraîne une violation de l’accès à la mémoire.

pulXlate

Pointeur vers un tableau d’entrées de traduction.

Remarques

La palette de destination appartient toujours à la surface de destination d’une opération de dessin. La palette source est une palette sélectionnée par l’application ou une palette d’une autre surface.

La structure XLATEOBJ est utilisée pour traduire les index de couleur qui font référence à la palette source en index pour la palette de destination. L’index résultant identifie une couleur qui correspond à la couleur source aussi étroitement que possible.