UpsPct.IImage.EquilibrerCouleursCMJN

Fonction EquilibrerCouleursCMJN(DeltaCyan : Entier, DeltaMagenta : Entier, DeltaJaune : Entier, BalanceDemandee : BalanceCouleurs, C : Booleen=Faux, M : Nul Ou MasqueDessin=Nul) Retourner Nul Ou IImage;

Description

La méthode EquilibrerCouleursCMJN permet d'équilibrer les couleurs de l'image courante en modifiant les composantes cyan, magenta et jaune avec respectivement les valeurs des paramètres DeltaCyan, DeltaMagenta et DeltaJaune selon la balance BalanceDemandee dans l'espace colorimétrique CMJN.

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
/******/

Debut
...
I=I.EquilibrerCouleursCMJN(10, 0, 0);
/* Renforce le cyan de l'image. */
...
Fin Principal

Voir aussi

FiltrerCouleursCMJN pour filtrer les couleurs de l'image en CMJN. InverserCouleursCMJN pour inverser les couleurs de l'image en CMJN. TronquerCouleursCMJN pour tronquer les couleurs de l'image en CMJN.

Traduction

---------