## Subtitle

`Subtitle` (clip, string text, int "x", int "y", int "first_frame", int "last_frame", string "font", int "size", int "text_color", int "halo_color", int "align", int "spc")
`Subtitle` (clip, string text)

O filtro Subtitle acrescenta uma única linha de texto anti-aliased a uma série de quadro s. Se você quer mais de um subtítulo, ou um subtítulo que tenha mais de uma linha, tem que encadear vários filtros Subtitle juntos. Este filtro é obviamente inadequado para qualquer coisa a mais que o uso ocasional. Eu o uso ocasionalmente. Todos os parâmetros depois do texto são opcionais e podem ser omitidos ou especificados fora de ordem usando a sintaxe name=value.

Parâmetros

text é o texto que será sobreposto no clipe a partir do first_frame e terminando com last_frame. font são as fontes do texto (todas as fontes instaladas na máquina atual estão disponíveis, elas ficam situados dentro da sua pasta 'windows\fonts'). size é o tamanho do texto. (x,y) é a posição do texto. Os parâmetros x e y podem ser fixados a -1 para calcular automaticamente e usar as coordenadas de centro horizontal ou vertical. Devem ser dados text_color e halo_color em valores hexadecimais RGB, como em HTML - a não ser que eles começam com $ em vez de # (eu já estava usando # para introduzir comentários).

O parâmetro align permite fixar onde o texto é colocado relativo ao local (x,y) e está baseado no teclado complementar numérico como segue:

<left> 7 <top> | <center> 8 <top> | <right> 9 <top> | topo do texto alinhado ao local y para align=7,8,9
<left> 4 <baseline> | <center> 5 <baseline> | <right> 6 <baseline> | linha base do texto alinhado ao local y para align=4,5,6
<left> 1 <bottom> | <center> 2 <bottom> | <right> 3 <bottom> | fundo do texto alinhado ao local y para align=1,2,3
start at x for align=1,4,7 | center on x for align=2,5,8 | end at x for align=3,6,9 |

Nota: não há nenhuma colocação de alinhamento de centro Y

O parâmetro spc permite modificar o caráter espaço (0=imutável). O valor pode ser positivo ou negativo para alargar ou estreitar o texto. Pela documentação da função do Visual C++ que executa esta tarefa, este valor é em unidades lógicas e arredondado ao mais próximo píxel. Isto é útil para tentar igualar fontes típicas no PC a fontes usadas em créditos de filme e televisão que é normalmente mais largo para a mesma altura ou ajustar ou preencher um espaço com um ajuste de caractere fixo.

O substituto, forma curta é útil quando você realmente não quer se preocupar com o que o subtítulo se parece, contanto que possa vê-lo - por exemplo, quando você está usando StackVertical e sua classe para exibir imediatamente várias versões de um quadro e você os quer rotular para lembrar o que é.

Este filtro é usado internamente por AviSynth para o comando Version e para informar erros e o aparato de escrever subtítulos é também usado por ShowFrameNumber.

Valores Padrões

clip | último
text | Sem padrão, deve ser especificado
x | 8 se align=1,4,7 ou nenhum; -1 se align=2,5,8; ou largura-8 se align=3,6,9
y | altura-1 se align=1,2,3; tamanho se align=4,5,6 ou nenhum; ou 0 se align=7,8,9
first_frame | 0
last_frame | framecount(clip)-1
font | "Arial"
size | 18
text_color | $FFFF00 <amarelo>
halo_color | 0 <preto>
align | Normalmente 4 <esquerda e linha de base>; se x=-1, então 5 <centro horizontal e linha de base>
spc | 0 <fonte de espaço inalterado>

Exemplos

    # Algum texto no centro do clipe
    AviSource("D:\clip.avi")
    Subtitle("Hello world!", align=5)

    # Algum texto no canto superior direito do clipe com fonte, tamanho e cor especificados.
    AviSource("D:\clip.avi")
    Subtitle("Alô Mundo!", font="georgia", size=24, text_color=$ff0000, align=9)

Informação Específica da Versão

v1.00 | Fixando x=-1 usa centro horizontal e alinhamento de centro (não documentado antes da v2.07)
v2.07 | Incluídos os parâmetros spc e align. Fixando y=-1 calcula centro vertical (não afetado) de alinhamento Valor Padão x e y dependente do alinhamento (previamente x=8, y=size),

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