## Layer [yuy2][rgb32]

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

Este filtro pode sobrepor dois clipes de tamanhos diferentes (mas com o mesmo formato de cor) usando modos de operação diferentes.
Para informação de transparência modo píxel o 4º canal de cor de RGB32 (A - ou canal alfa) é usado como máscara.

Base_clip: o clipe base que determina o tamanho e todas as outras propriedades do resultado do vídeo e áudio.
Overlay_clip: o clipe que é fundido em outro. Este clipe pode conter uma camada alfa.
op: as operação fundidas executadas, que podem ser:"add", "subtract", "brighten", "darken", "fast", "mul"
level: 0-255, a força da operação executada. 0: o base_clip é devolvido inalterado, 255: a força máxima é usada.
x, y: posição compensada do overlay_clip
threshold: só implementado para "lighten" e "darken"
use_chroma: usa croma do overlay_clip, default=true. Quando false só luma é usado.

Há algumas diferenças no parâmetro de comportamento e do permitido que dependem do formato de cor e a operação; aqui os detalhes:

- Não há nenhuma máscara (canal alfa) em YUY2, assim é assumido que o canal alfa é opaco em todos os lugares.
- em RGB32 o canal alfa do overlay_clip é multiplicado com level, assim o alfa resultante = (alpha_mask * level) / 256. Isto significa que para a força completa de operação alfa e level têm que ser 255.

Estes operadores se comportam igualmente para RGB32 ou YUY2:

    "fast": use_chroma deve ser TRUE, level e threshold não são usados.
            O resultado é simplesmente a média de base_clip e overlay_clip.

    "add":  threshold não é usado. A diferença entre base_clip e overlay_clip é
            multiplicado com alfa e acrescentado ao base_clip.
            alpha=0 - > só base_clip visível,
            alpha=128 - > base e camada igualmente misturadas,
            alpha=255 - > só camada visível.

    "subtract": igual a "add", mas o overlay_clip é invertido antes.

Estes operadores parecem trabalhar corretamente só em YUY2:

    "mul": threshold não é usado. O base_clip fica colorido como overlay_clip, assim use_chroma deve ser TRUE.
           alpha=0 - > só base_clip visível, alpha=255 - > aproximadamente a mesma Luminância como Base
           mas com as cores de Overlay

    "lighten": use_chroma deve ser TRUE. Executa a mesma operação de "add", mas só quando
               o resultado é mais LUMINOSO que a base dos novos valores usados.
               Com um threshold mais alto a operação é mais provável,
               assim, com threshold=255 é o mesmo que "add",
               com threshold=0 o base_clip é mais provável ser passado inalterado,
               dependendo da diferença entre base_clip e overlay_clip.

    "darken":  igual a "lighten", mas só é executado quando o resultado for mais ESCURO que a base.

Veja também aqui as propriedades resultantes do clipe.

## Mask [rgb32]

`Mask` (clip, mask_clip)

Aplica uma máscara alfa definida para clip, para uso com `Layer`, convertendo mask_clip em cinza e usando-a para a máscara (o canal alfa) RGB32. Neste canal "preto" significa completamente transparente e branco completamente opaco).

## ResetMask [rgb32]

`ResetMask` (clip)

Aplica uma máscara alfa "all-opaque" completamente opaco para clip,, para uso com `Layer`.

    O canal alfa de um clipe RGB32 nem sempre é bem definido (depende da fonte),
    este filtro é o modo mais rápido para aplicar uma máscara toda branca:

    clip=ResetMask(clip)

## ColorKeyMask [rgb32]

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

Fixa o canal alfa (semelhante ao que Mask faz) mas gera-o comparando a cor (padrão preto). Cada píxel com uma cor que difere menos que tolerance (padrão 10) é fixado em transparente, caso contrário é inalterado (não é fixado para opaco). Veja Overlay para exemplos.

`$Date: 2006/03/26 18:11:19 $ Portuguese translation by RoLon`