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 quadros. 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