GdipSetImageAttributesGamma()



Syntaxe
Resultat.i = GdipSetImageAttributesGamma(*imageattr, type.i, enableFlag.i, gamma.f)

Paramètres

*imageattr

[in] Pointeur sur un objet ImageAttributes.

type.i

[in] Elément de l'énumération ColorAdjustType qui indique la catégorie pour laquelle la correction gamma est appliquée.

enableFlag.i

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

gamma.f

[in] Nombre flottant qui spécifie la valeur gamma.

Description

Cette fonction permet d'appliquer la correction gamma avec la valeur désirée
Les valeurs classiques pour le paramètre gamma sont comprises entre 1,0 et 2,2.
La valeur 1,0 n'apporte pas de modification par rapport à l'amage d'origine.
Les valeurs gamma situées en dehors de la plage habituelle peuvent être utiles pour les moniteurs CRT anciens ou pour les écrans situés dans conditions d'éclairage exceptionnelles, telles que les environnements industriels ou les étalages de vitrine.
Voir aussi la correction gamma :
http://fr.selfhtml.org/graphisme/techniques.htm
http://fr.wikipedia.org/wiki/Correction_gamma
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 à droite. L'image de gauche ne sera pas modifié par le code. A l'aide d'un curseur, on peut faire varie la correction gamma entre 0 et 5 et modifier l'image de droite en conséquence. Le curseur a le réglage d'origine à 1,0 car au début les images sont identiques.

Résultat de la fonction

Si la fonction réussit, elle retourne #Ok qui est une constante de l'énumération status.
Si la fonction échoue, elle retourne une des autres valeurs de l'énumération status.

PB - OS

PureBasic v4.30 bêta 4 (Windows - x86)
Testé avec Windows Vista édition familiale Premium