UpsPct.IImage.EquilibrerSaturationEtLuminosite

Fonction EquilibrerSaturationEtLuminosite(DeltaSaturation : Entier, DeltaLuminosite : Entier, BalanceDemandee : BalanceCouleurs, C : Booleen=Faux, M : Nul Ou MasqueDessin=Nul) Retourner Nul Ou IImage;

Description

La méthode EquilibrerSaturationEtLuminosite permet d'équilibrer les couleurs de l'image courante en modifiant la saturation et la luminosité avec respectivement les valeurs des paramètres DeltaSaturation et DeltaLuminosite selon la balance BalanceDemandee.

Pour plus de précisions sur la balance chromatique, merci de se référer à la fiche BalanceChromatique.

Pour une image en noir et blanc, cet appel n'est pas possible. Pour une image en 16, 256 ou 65536 couleurs, cet appel s'effectue au niveau de la table des couleurs de l'image. Pour une image en couleurs vraies, cet appel s'effectue au niveau des pixels de l'image.

Si le paramètre C a pour valeur Vrai, alors l'image courante est copiée avant l'opération. Ainsi l'image courante est inchangée.

Pour une image en couleurs vraies, si le paramètre M est non Nul, alors seuls les pixels decalqués au travers de ce masque sont impactés par cet appel.

Le résultat est l'image une fois la saturation et la luminosité équilibrées totalement ou partiellement.

En cas d'erreur, l'exception OperationImageImpossible est envoyée.

Exemple

Principal
/*******/
Variable
/******/

Debut
...
I=I.EquilibrerSaturationEtLuminosite(0, 10);
/* Renforce la luminosité de l'image. */
...
Fin Principal

Voir aussi

InverserSaturationEtLuminosite pour inverser la saturation et la luminosité de l'image. TronquerSaturationEtLuminosite pour tronquer la saturation et la luminosité de l'image.

Traduction

---------