Timed Text Markup Language

Anatomie souboru

Dokument XML: hlavička, která pojmenovává styly a oblasti, a tělo s odstavci, jeden pro každý titulek.

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

Časy

TTML zapisuje čas více způsoby než jakýkoli jiný titulkový formát:

Styly

Styl je sada atributů tts:. Text je přebírá v pořadí: od své oblasti, pak z body, div, odstavce a rozpětí kolem něj. Každý prvek přebírá styly, které jmenuje (style="s1 s2", a ty, které ony jmenují), pak své vlastní atributy.

Oblasti

Oblast je rámeček na obraze, umístěný pomocí tts:origin a velikostí tts:extent. Uvnitř něj tts:displayAlign umístí text nahoru, doprostřed nebo dolů (before, center, after), a tts:textAlign k jedné straně nebo na střed.

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

Subtitld spočítá, kam text dopadne, ať je oblast měřena v procentech, pixelech nebo buňkách, a vybere nejbližší z devíti míst, která SubRip pojmenovává {\an1} až {\an9}. Když soubor zapisuje, každé použité místo je oblast s tímto názvem: bottom, top, top-left…

Profily

Většina TTML je zapsána podle profilu: podmnožiny jazyka s vlastními pravidly. Subtitld čte každý z nich jako TTML.

TTML v Subtitld

Otevření souboru TTML

Subtitld otevře .ttml, .dfxp, .itt a .xml, a:

• čte TTML bez ohledu na to, jak je zapsáno: v jeho jmenném prostoru, ve starém jmenném prostoru DFXP, nebo s tt: před každým prvkem;
• čte každou formu času, počítanou od div a body, ve kterém je;
• sleduje styly tak, jak je TTML používá, a zachovává kurzívu, tučné, podtržení, přeškrtnutí a jakoukoli barvu jinou než bílou;
• umístí každý titulek tam, kam jej ukazuje jeho oblast;
• bere agenty jako mluvčí, připravené pro dabing, a xml:lang souboru jako jazyk projektu;
• čte kódování, které soubor deklaruje, a entity HTML, jako  .

Soubor, který není správně utvořeným XML, se otevře se zprávou udávající řádek a sloupec. Soubor, který vůbec není TTML, to řekne.

Export TTML

Export, pak Titulky a TTML nebo DFXP, nabízí:

• TextOriginál, překlad, nebo oba, s překladem pod ním.
• Jména mluvčíchVynechána, před textem (Thom: …), nebo jako agenti (ttm:agent), vlastní způsob TTML.
• FormátováníZachováno, nebo odstraněno.
• Posun časůKaždý titulek dříve nebo později o stejný interval.
• VzhledBílá s černým obrysem, nebo tak, jak jej kreslí náhled Subtitld: jeho písmo, barva a průhledný rámeček.

Soubor je TTML 1 v UTF-8. Časy se zapisují jako 00:00:23.000, každé místo, kde titulky sedí, jako oblast, formátování jako rozpětí (span) a zalomení řádků jako <br/>. Jeho xml:lang je jazyk textu, který drží. TTML a DFXP dostanou stejný soubor; liší se jen přípona.

TTML nebo WebVTT?

WebVTT pro <track> na webové stránce: prohlížeče jej čtou samy. TTML pro vysílatele, pro streamovací služby, které jej vyžadují, a pro přehrávače, které jej čtou, například dash.js a Shaka Player. Stránka WebVTT má zbytek.

Zajímavosti