GdipSetImageAttributesThreshold()

Resultat.i = GdipSetImageAttributesThreshold(*imageattr, type.i, enableFlag.i, threshold.f)

*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, le seuil est appliqué, sinon il ne l'est pas.

threshold.f

[in] Nombre flottant qui définit le seuil. La valeur doit être comprise en 0.0 et 1.0.

Cette fonction permet de définir le seuil (plage de transparence) pour la catégorie spécifiée.
Le seuil (threshold.f) est une valeur comprise entre 0.0 et 1.0 qui spécifie un point de troncature pour chaque composante de la couleur. Par exemple, supposons que le seuil a la valeur 0,7 et que vous utilisez une couleur dont les composantes rouge, verte et bleue sont respectivement 230, 50 et 220. La composante rouge (230) étant supérieure à 0,7x255, elle passe à 255 (intensité complète). La composante verte (50) étant inférieure à 0,7x255, elle passe à 0. La composante bleue (220) étant supérieur à 0,7x255, elle passe à 255.

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 et à droire. L'image de gauche ne sera pas modifié par le code. A l'aide d'un curseur, on peut faire varie le seuil entre 0 et 1 et appliquer ce nouveau seuil à l'image de gauche.