GdipSetImageAttributesColorKeys()

Resultat.i = GdipSetImageAttributesColorKeys(*imageattr, type.i, enableFlag.l, colorLow.l, colorHigh.l)

*imageattr

[in] Pointeur sur un objet ImageAttributes.

type.i

[in] Elément de l'énumération ColorAdjustType qui indique la catégorie pour laquelle le seuil (plage de transparence) est appliqué.

enableFlag.i

[in] Valeur booléenne. Si enableFlag vaut #True, la clé des couleurs est appliquée, sinon elle ne l'est pas.

colorLow.i

[in] Couleur qui indique la valeur basse de la clé de couleur.

colorHigh.i

[in] Couleur qui indique la valeur haute de la clé de couleur.

Cette fonction permet de définir la clé des couleurs (plage de transparence) pour la catégorie indiquée.

Cette fonction définit les valeurs hautes et basses de la clé des couleurs. Toute couleur dont la valeur de chacune de ses trois composantes (rouge, vert, bleu) se situe entre les valeurs hautes et basses de la clé, est rendue transparente.

colorLow et colorHigh sont des couleurs 24 bit ayant les 3 composantes. Pour constituer facilement la couleur finale en fixant les seuils pour les 3 composantes, la commande PureBasic RGB correspond parfaitement.

L'exemple fixe le seuil bas ainsi : composante rouge à 50, verte à 95 et bleue à 30, ce qui donne la couleur finale basse : RGB(50, 95, 30)
et le seuil haut ainsi : composante rouge à 250, verte à 245 et bleue à 250, ce qui donne la couleur finale haute : RGB(250, 245, 250)

Un objet ImageAttributes conserve les paramètres de réglage des couleurs et des nuances de gris pour cinq catégories de réglages : par défaut, bitmap, brush, pen et text.

Les paramètres de réglage des couleurs et des nuances de gris par défaut s'appliquent à toutes les catégories qui n'ont pas de paramètres de réglage propres. Par exemple, si vous ne spécifiez jamais de paramètres de réglage pour la catégorie pen, les paramètres par défaut s'appliquent à cette catégorie. Dès que vous spécifiez un paramètre de réglage des couleurs ou des nuances de gris pour une catégorie donnée, les paramètres de réglage par défaut ne s'appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez un ensemble de paramètres de réglage pour la catégorie par défaut. Si vous définissez le seuil (plage de transparence) de la catégorie pen en passant #ColorAdjustTypePen à la fonction GdipSetImageAttributesThreshold(), aucun des paramètres de réglage par défaut ne s'appliquera aux pen.
Vous pouvez rétablir les réglages par défaut pour cette catégorie en utilisant la fonction GdipResetImageAttributes().

L'exemple charge une image PNG (une mosaïque de couleurs), l'affiche à gauche. L'image de gauche ne sera pas modifié par le code.
Les seuils bas et haut sont fixé comme ceci : RGB(50, 95, 30) et RGB(250, 245, 250). Toutes les couleurs qui auront les 3 composantes situées respectivement entre le seuil haut et bas seront transparentes. Avant d'appliquer la clé des couleurs, l'image Purebasic crée est colorée avec la même couleur que le fond de la fenêtre car son fond d'origine est noir. Ensuite l'image corrigé est affichée à droite et certaines zone sont transparentes.