## ColorYUV

`ColorYUV` (clip, float "gain_y", float "off_y", float "gamma_y", float "cont_y", float "gain_u", float "off_u", float "gamma_u", float "cont_u",
float "gain_v", float "off_v", float "gamma_v", float "cont_v", string "levels", string "opt",
boolean "showyuv", boolean "analyze", boolean "autowhite", boolean "autogain")

`ColorYUV` permet de changer la couleur et la luminance de vos images de beaucoup de manières différentes. `ColorYUV` est présent dans AviSynth v2.5.Tout les arguments de ce filtre sont optionnels. Toutes les valeurs sont par défaut à "0".

Gain, off(set), gamma et cont(rast) peuvent être paramétrés différemment pour chaque canal.

Gain sert à multiplier une valeur. Cela veut dire que si le gain est défini à 0, le filtre préserve les valeurs telles qu'elles sont. Quand le gain est fixé à 256, toutes les valeurs sont multipliées par 2 (deux fois plus de lumière). Si le gain est fixé à 512, toutes les valeurs sont multipliées par 3.

Off (offset -> décalage en français) ajoute une valeur à la luminance ou à la chrominance. Un décalage de 16 ajoutera 16 aux valeurs de chaque pixel. Un décalage de -32 enlèvera 32 aux valeurs de chaque pixels.

Gamma ajuste le gamma du canal spécifié. Une valeur de 0 correspond à une valeur de gamma de 1.0. Quand gamma est fixé à 256, cela correspond à gamma 2.0. Gamma reste valide jusqu'à -256, cela correspond à gamma 0.0.

Cont ajuste le contraste du canal spécifié. L'utilisation est la même que celle du paramètre gamma.

Levels peut être fixé à "TV->PC" ou à "PC->TV". Cela effectue une conversion de plage. Normalement, les valeurs YUV ne sont pas construites en utilisant des valeurs allant de 0 à 255 (plage d'un PC) mais une plage plus limité (la plage TV, 16-235). Cet argument effectue une conversion entre ces deux formats. Si rien n'est spécifié en paramètre, aucune conversion n'est effectuée (opération par défaut).

Opt peut être soit fixé à "coring" ou à "" (rien, paramètre par défaut). En spécifiant "coring", vous allez rééchelonner les valeurs YUV pour obtenir une video dans la plage TV. Sinon "invalid results" (résultats non valides) seront acceptés.

ShowYUV peut être true (vrai) ou false (faux). Cela remplace l'image initiale par une image montrant les valeurs de chrominance sur les deux axes. Cela peut être utile si vous souhaitez ajuster la couleur de votre image, mais vous devez comprendre comment les couleurs sont construites. En haut à gauche, les valeurs de chrominance sont à '16'. A droite de l'image, U est maximum. En bas de l'image, V est maximum. Au milieu, les deux canaux de chrominance sont à la valeur 128 (qui correspond au gris).

Analyze peut être true (vrai) ou false (faux). Cela rajoute les caractéristiques de couleurs sur l'image. On trouve notamment les valeurs maximales et minimales pour chaque canaux. On trouve également une moyenne pour tout les canaux et des valeurs 'limite maximum" et "limite minimum". Ces valeurs "limites" sont construites pour filtrer les parties bruitées très claires ou très sombres en créant un minimum / maximum haut ou bas.

Autowhite peut être true (vrai) ou false (faux). Cet argument utilise les valeurs de l'argument Analyze, et essaie d'équilibrer les décalages de couleurs. Si vous avez une source de type capture TV ou VHS et qu'une couleur à bavé sur une autre lors de la capture, ce filtre peut être utile. Mais soyez prudent car il n'est pas très intelligent. Si votre source contient un ciel bleu clair, autowhite le transformera en gris! Si vous précisez les paramètres "off_u" ou "off_v", ils ne seront pas utilisés.

Autogain peut être true (vrai) ou false (faux). Cet argument utilise les informations du filtre Analyze, et essaie de créer un contraste aussi bon que possible. Cela veut dire qu'il modifie les valeurs de luminance (y) pour qu'elles s'étalent sur une plage de valeurs maximum. Il agit en fait de la même manière que la fonction "autogain" des camescopes, en amplifiant les scènes sombreset en ne touchant pas aux scènes avec un bon contraste. On peut quelquefois le retrouver sous le nom de "autolevels".

Les valeurs caractéristiques que sont la saturation, le contraste et la luminosité (que l'on retrouve dans `Tweak` par exemple) sont liées aux valeurs de ce filtre par les équations suivantes:

cont_u = cont_v = - (1 - saturation) * 256
cont_y = - (1-contraste) * 256
off_y = luminosité

Une saturation de 0.8 donne par exemple: cont_u = cont_v = - 0.2 * 256 = 51.2.

    #  Cela ajuste le gamma de tout les canaux (moins sur y que sur les autres), en augmentant 'y'.
    colorYUV(gamma_y=128, gamma_u=256, gamma_v=256, off_y=-16)

    #  Montre toutes les couleurs. La luminance de l'image 0 est 16, celle de l'image 1 est 17 etc...
    colorYUV(showyuv=true)

    #  Améliore la visibilité sur des mauvais enregistrements.
    colorYUV(autogain=true, autowhite=true)

`$English date: 2005/06/01 18:28:01 $
French translation date: 2005/11/01 JasonFly macpaille@users.sourceforge.net`