UpsPct.IImage.EquilibrerCouleursTSL


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

Description

La méthode EquilibrerCouleursTSL permet d'équilibrer les couleurs de l'image courante en modifiant les composantes teinte et saturation avec respectivement les valeurs des paramètres DeltaTeinte et DeltaSaturation selon la balance BalanceDemandee dans l'espace colorimétrique TSL.

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 les couleurs équilibrées totalement ou partiellement.

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

Exemple


Principal

/*******/

Variable

/******/


	I : Nul Ou IImage;



Debut

...

I=I.EquilibrerCouleursTSL(0, 10);

/* Renforce la saturation de l'image. */

...

Fin Principal

Voir aussi

FiltrerCouleursTSL pour filtrer les couleurs de l'image en TSL. InverserCouleursTSL pour inverser les couleurs de l'image en TSL. TronquerCouleursTSL pour tronquer les couleurs de l'image en TSL.

Traduction


-	-	-	-	-	-	-	-	-