UpsPct.IImage.EquilibrerCouleursYCbCr

Fonction EquilibrerCouleursYCbCr(DeltaCb : Entier, DeltaCr : Entier, BalanceDemandee : BalanceCouleurs, C : Booleen=Faux, M : Nul Ou MasqueDessin=Nul) Retourner Nul Ou IImage;

Description

La méthode EquilibrerCouleursYCbCr permet d'équilibrer les couleurs de l'image courante en modifiant les composantes chrominance bleue et rouge avec respectivement les valeurs des paramètres DeltaCb et DeltaCr selon la balance BalanceDemandee dans l'espace colorimétrique YCbCr.

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.EquilibrerCouleursYCbCr(0, 10);
/* Renforce la chrominance rouge de l'image. */
...
Fin Principal

Voir aussi

FiltrerCouleursYCbCr pour filtrer les couleurs de l'image en YCbCr. InverserCouleursYCbCr pour inverser les couleurs de l'image en YCbCr. TronquerCouleursYCbCr pour tronquer les couleurs de l'image en YCbCr.

Traduction

---------