UpsPct.IImage.FiltrerCouleursRGB


Fonction FiltrerCouleursRGB(FiltrerRouge : Booleen, FiltrerVert : Booleen, FiltrerBleu : Booleen, C : Booleen=Faux, M : Nul Ou MasqueDessin=Nul) 
   Retourner Nul Ou IImage;

Description

La méthode FiltrerCouleursRGB permet de filtrer les couleurs de l'image courante pour les composantes rouges, vertes et bleues du repère colorimétrique RGB si respectivement les paramètres FiltreRouge, FiltreVert et FiltreBleu ont pour valeur Vrai.

Quand une couleur est filtrée, son intensité sur la composante est remplacée par son niveau de gris avant filtrage. Sinon, la composante est annulée. Ainsi :

Filtrer la composante rouge revient à supprimer le vert et le bleu de l'image i.e appliquer un filtre rouge comme en photographie.
Filtrer toutes les composantes revient à griser l'image.

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 filtrées totalement ou partiellement.

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

Exemple


Principal

/*******/

Variable

/******/


	I : Nul Ou IImage;



Debut

...

I=I.FiltrerCouleursRGB(Vrai, Faux, Faux);

/* Filtre la couleur rouge de l'image. */

...

I=I.FiltrerCouleursRGB(Vrai, Vrai, Vrai);

/* Grise l'image. */

...

Fin Principal

Voir aussi

EquilibrerCouleursRGB pour équilibrer les couleurs de l'image en RGB. InverserCouleursRGB pour inverser les couleurs de l'image en RGB. TronquerCouleursRGB pour tronquer les couleurs de l'image en RGB.

Traduction


-	-	-	-	-	-	-	-	-