Timed Text Markup Language

Anatomia de um arquivo

Um documento XML: um cabeçalho que nomeia estilos e regiões, e um corpo de parágrafos, um para cada legenda.

<tt xml:lang="en" …>
<head>styles, regions</head>
<body><div>
<p begin="00:00:23.000"
   end="00:00:24.500">
You're a jerk,<br/>Thom.</p>
</div></body>
</tt>

Tempos

O TTML escreve um tempo de mais maneiras do que qualquer outro formato de legenda:

Estilos

Um estilo é um conjunto de atributos tts:. O texto os recebe em ordem: da sua região, depois do corpo, da div, do parágrafo e do span ao redor. Cada elemento recebe os estilos que nomeia (style="s1 s2", e os que estes nomeiam), depois os seus próprios atributos.

Regiões

Uma região é uma caixa sobre a imagem, posicionada por tts:origin e dimensionada por tts:extent. Dentro dela, tts:displayAlign põe o texto no topo, no meio ou na base (before, center, after), e tts:textAlign a um lado ou no centro.

<region xml:id="top"
        tts:origin="10% 10%"
        tts:extent="80% 80%"
        tts:displayAlign="before"/>

O Subtitld descobre onde o texto cai, se a região é medida em porcentagens, pixels ou células, e escolhe o mais próximo dos nove lugares que {\an1} a {\an9} do SubRip nomeiam. Ao gravar um arquivo, cada lugar usado é uma região com esse nome: bottom, top, top-left…

Perfis

A maior parte do TTML é escrita em um perfil: um subconjunto da linguagem, com regras próprias. O Subtitld lê cada um deles como TTML.

TTML no Subtitld

Abrindo um arquivo TTML

O Subtitld abre .ttml, .dfxp, .itt e .xml, e:

• lê o TTML como ele estiver escrito: no seu namespace, no namespace antigo do DFXP, ou com tt: antes de cada elemento;
• lê todas as formas de tempo, cada uma contada a partir da div e do body em que está;
• segue os estilos como o TTML os aplica, mantendo itálico, negrito, sublinhado, tachado e qualquer cor diferente do branco;
• coloca cada legenda onde a sua região a mostra;
• toma os agentes como falantes, prontos para dublagem, e o xml:lang do arquivo como o idioma do projeto;
• lê a codificação que o arquivo declara, e as entidades do HTML, como  .

Um arquivo que não é XML bem formado abre com uma mensagem indicando a linha e a coluna. Um arquivo que não é TTML de forma alguma diz isso.

Exportando TTML

Exportar, depois Legendas e TTML ou DFXP, oferece:

• TextoO original, uma tradução, ou os dois, com a tradução abaixo.
• Nomes dos falantesOmitidos, antes do texto (Thom: …), ou como agentes (ttm:agent), a forma própria do TTML.
• FormataçãoMantida, ou removida.
• Deslocar horáriosCada legenda antes ou depois, pelo mesmo intervalo.
• VisualBranco com contorno preto, ou como a pré-visualização do Subtitld a desenha: sua fonte, cor e uma caixa translúcida.

O arquivo é TTML 1 em UTF-8. Os tempos são escritos como 00:00:23.000, cada lugar em que as legendas ficam como uma região, a formatação como spans e as quebras de linha como <br/>. Seu xml:lang é o idioma do texto que ele guarda. TTML e DFXP recebem o mesmo arquivo; só a extensão muda.

TTML ou WebVTT?

WebVTT para um <track> em uma página web: os navegadores o leem sozinhos. TTML para emissoras, para serviços de streaming que o pedem, e para players que o leem, como dash.js e Shaka Player. A página do WebVTT traz o resto.

Curiosidades