Layer [yuy2][rgb32]

Layer (base_clip, overlay_clip, string "op", int "level", int "x", int "y", int "threshold", bool "use_chroma")

Ce filtre peut mélanger deux clips de taille différente (mais ayant le même format de couleur) en utilisant différentes techniques.
Pour gérer les informations de transparence au niveau des pixels, le quatrième canal de couleur du format de couleur RGB32 (appelé A ou canal alpha) est utilisé en tant que masque.

Base_clip: c'est le clip sur lequel se reposent les autres. C'est lui qui détermine la taille et les propriétés video et audio des autres clip et du clip de sortie.
Overlay_clip: c'est le clip qui est mélangé au premier clip. Ce clip peut contenir un canal alpha.
op: définit le type de l'opération de mélange. Il peut être: "add"(ajouter), "subtract"(soustraire), "brighten"(éclaircir), "darken"(assombrir), "fast"(rapide), "mul"(multiplier)
level: 0-255, définit la force de l'opération de mélange. 0: le clip de base est renvoyé sans aucun changement, 255: la force maximale est utilisée.
x, y: décalage de position du clip à mélanger.
threshold: implémenté seulement pour les opérations "lighten" et "darken".
use_chroma: utilise la chrominance du clip à mélanger (overlay_clip), par défaut=true(vrai). Quand ce paramètre est false(faux), la luminance seulement est utilisée.

Il y a quelques différences dans le comportement et les paramètres autorisés en fonction du format de couleur et de l'opération de mélange. voici quelques détails:

Ces opérateurs se comportent de manière identique en RGB32 et en YUY2:

"fast": use_chroma doit être TRUE(vrai), level et threshold ne sont pas utilisés.
Le résultat est simplement la moyenne entre base_clip et overlay_clip.

"add": threshold n'est pas utilisé. La différence entre base_clip et overlay_clip est multiplié avec la valeur de alpha et ajouté à base_clip.
alpha=0 -> seulement base_clip est visible,
alpha=128 -> base et overlay sont mélangés avec un poids égal,
alpha=255 -> seulement overlay est visible.

"subtract": fonctionne de la même manière que add, sauf que overlay_clip est inversé au départ.

Ces opérateurs ne semblent fonctionner que dans le format YUY2:

"mul": threshold n'est pas utilisé. base_clip est coloré en fonction de overlay_clip, donc use_chroma doit être TRUE(vrai).
alpha=0 -> seulement base_clip est visible, alpha=255 -> à peu près la même luminance que base_clip
mais avec les couleurs de overlay_clip

"lighten": use_chroma doit être TRUE(vrai). Effectue la même opération que "add", mais seulement quand le résultat
 est plus lumineux que le clip de base.
Avec un grand threshold, lighten est encore plus proche de la fonction "add",
Avec threshold=255, lighten est identique à "add",
Avec threshold=0, base_clip est transmis pratiquement sans changements, en fonction des différences entre base_clip et overlay_clip.

"darken": même fonction que "lighten", mais elle n'est effectuée que quand les résultats est moins lumineux que base_clip.


Voir également ici pour plus d'informations sur les propriétés des clips résultants.

 

Mask [rgb32]

Mask (clip, mask_clip)

Applique un masque alpha défini sur clip, à utiliser avec Layer. Ce filtre procède en convertissant mask_clipen niveaux de gris et en l'utilisant en tant que masque (le canal alpha) du format RGB32. Sur ce canal en niveaux de gris, le noir signifie complètement transparent, et blanc signifie complètement opaque).

 

ResetMask [rgb32]

ResetMask (clip)

Applique un masque alpha totalement opaque à clip, à utiliser avec Layer.

Le canal alpha d'un clip RGB32 n'est pas toujours bien défini (en fonction de la source),
ce filtre est une manière rapide d'appliquer un masque totalement blanc:

clip=ResetMask(clip)

 

ColorKeyMask [rgb32]

ColorKeyMask (clip, int "color", int "tolerance")

Définit un canal alpha (de manière similaire à  ce que Mask fait) mais il le génère en comparant l'argument color (par défaut black(noir)). Chaque pixel avec une différence de couleur dans la plage définie par l'argument tolerance (par défaut 10) est défini comme transparent, sinon, il reste inchangé ( et il n'est pas définit comme opaque). Voir Overlay pour quelques exemples.

$English date: 2005/01/26 22:08:35 $
French translation date: 2006/02/04 JasonFly macpaille@users.sourceforge.net