GPAC Timed Text XML

開く保存XMLMP4

MP4のテキストトラックをXMLとして書き出したものです。GPACのツールMP4Boxが、ファイルから3GPP timed textトラックを取り出すときに書き出し、トラックを入れるときに読み込みます。プレーヤーがtx3g、FFmpegがmov_textと呼ぶ字幕です。

概要

拡張子.ttxt
メディアタイプ登録なし
仕様ファイル:GPACのTTXTドキュメント。トラック:3GPP TS 26.245(2004年)とMPEG-4 Part 17。
時間の精度ミリ秒
文字コードUTF-8(XMLで宣言)
装飾太字、斜体、下線、色、サイズ、フォント。点滅、カラオケ、ハイライト、リンク
配置映像上のテキストボックスと、その中でのテキストの揃え:左、中央、右、上、中央、下
話者なし
コンテナ内ファイルではなくトラックとして。MP4、3GP、QuickTimeの tx3g テキストトラック

ファイルの構成

テキストの描き方を示すヘッダーの後に、画面上の変化ごとのサンプルが続きます。Subtitldが書き出すものを、一部省略して示します。

<TextStream version="1.1">
<TextStreamHeader width="1920" height="1080" …>
<TextSampleDescription horizontalJustification="center"
    verticalJustification="bottom" …>
  <FontTable><FontTableEntry fontName="Sans-Serif" fontID="1"/></FontTable>
  <Style styles="Normal" fontID="1" fontSize="54" color="ff ff ff ff"/>
</TextSampleDescription>
</TextStreamHeader>
<TextSample sampleTime="00:00:23.000" sampleDescriptionIndex="1"
    xml:space="preserve">You're a jerk, Thom.</TextSample>
<TextSample sampleTime="00:00:24.500" text=""/>
<TextSample sampleTime="00:00:25.120" sampleDescriptionIndex="2" …>Celia, wait.
I can explain.<Style fromChar="0" toChar="6" styles="Italic" …/>
</TextSample>
  1. 1 · ストリーム

    ファイルのバージョン。

  2. 2 · ヘッダー

    トラックのサイズと、テキストの描き方ごとの記述。揃え方、フォント、最初のスタイル。

  3. 3 · サンプル

    各サンプルの時刻と、使う記述。空のサンプルは画面を消します。

  4. 4 · テキスト

    テキストと、その一部を装飾するもの。0から数えた文字位置で指定します。

字幕ではなくサンプル

tx3gトラックは、一度に1つのサンプルを表示します。各サンプルは、その時刻から次のサンプルの時刻まで表示されます。字幕自体に終わりはないため、空のサンプルで終えます。2つの字幕を同時に表示することはできません。

テキストの後に続くもの

要素 働き Subtitldでの扱い
<Style> 一定の範囲の太字、斜体、下線、色(16進数の r g b a)、サイズ、フォント フォント以外は保持
<Blinking> 点滅するテキスト 点滅テキストとして保持
<Karaoke> 範囲が順に点灯し、それぞれ endTime まで続く カラオケのタイミングとして保持
<Highlight>、<HyperLink> 範囲のハイライト、またはリンク 保持しない
<TextBox> このサンプルだけのボックス 保持しない

文字はUTF-16で数えます。 fromChar と toChar は、トラックが保存するとおり、テキストをUTF-16の単位で数えます。絵文字のように最初の65,536文字より後の文字は、2つと数えます。

1つの拡張子、2つのフォーマット

テレビの録画からキャプションを取り出すCCExtractorも、時刻付きのトランスクリプトを .ttxt と名付けます。プレーンテキストで、1行に1つのキャプション、列は | で区切られます。

フォーマット 中身 Subtitldでの扱い
GPAC TTXT XML、<TextStream> TTXTとして開く
CCExtractorの時刻付きトランスクリプト プレーンテキスト。時刻、その他の列、言葉が縦棒で区切られる 開けません。CCExtractorのトランスクリプトである旨を表示します

Subtitldはファイルの先頭のバイトを見て、両者を見分けます。CCExtractorのキャプションをSubtitldで開くには、CCExtractorにSubRip(-srt)で出力させてください。

Subtitldでの TTXT

.ttxtに残るもの
  • 各字幕のテキストと改行
  • 斜体、太字、下線、取り消し線、色、サイズ
  • 点滅テキストとカラオケのタイミング
  • 表示位置:上、中、下。左、中央、右
  • 縦書きのテキスト
  • 開始と終了(ミリ秒単位)
残らないもの
  • 重なる字幕:次の字幕が始まるところで前の字幕が終わります
  • フォント、ルビ、9つ以外の位置
  • 話者、原文の横に並べた翻訳
  • 吹き替え、話者の顔や色

これらを残すには、.usfx プロジェクトとして保存してください。

TTXTファイルを開く

Subtitldは次を読み取ります。

  • テキストのある各サンプルを、次のサンプルまでの1つの字幕として。後にサンプルのない最後のものは3秒間。
  • サンプル内のテキスト、またはバージョン1.0のファイルの text 属性(各行はシングルクォートで囲まれます)。
  • 太字、斜体、下線、取り消し線、記述と異なる色、記述のサイズに対する相対的なサイズは装飾として。点滅は点滅テキストとして、カラオケはカラオケのタイミングとして。
  • 記述の揃え方は9つの位置のいずれかとして(指定がない場合は、MP4Boxと同じく左と下)。verticalText は縦書きのテキストとして。

GPACのTTXTではないファイルは、その旨を表示します。

TTXTの書き出し

Subtitldのエクスポートダイアログ。TTXTを選択し、話者名は省略、装飾は残す

エクスポート、字幕、TTXTの順に選ぶと、次の項目が表示されます。

  • テキスト原文、翻訳、または両方(翻訳は下に表示)。
  • 話者名省略、またはテキストの前(Thom: …)。
  • 装飾残す、または削除。
  • 時刻をずらすすべての字幕を同じ量だけ前後にずらします。

トラックは動画と同じサイズで(動画がなければGPACの400×80)、文字の大きさは高さの20分の1です。字幕の位置ごとに独自の記述を作ります。各字幕は1つのサンプルで、次の字幕が始まる前に終わる箇所には空のサンプルを置きます。テキストはUTF-8で、ルビの読みは含みません。

MP4Box -add subtitles.ttxt video.mp4 で、字幕をテキストトラックとして動画に入れられます。

豆知識

2004

3GPPは、携帯電話への動画ストリーミング向けに、timed textフォーマットTS 26.245を承認しました。MPEGは2006年、ほとんど変更を加えずにこれをMPEG-4 Part 17としました。

tx3g

MP4ファイル内のテキストトラックの名前です。あらゆる種類のトラックと同じく4文字です。MP4BoxとQuickTime Proのどちらでも作れます。

mov_text

同じトラックのFFmpegでの名前です。FFmpegで字幕をMP4に変換すると、これが作られます。

関連する形式

.ttxt の修正が必要ですか?

Subtitld で動画と一緒に開き、波形上でタイミングを調整しましょう。

Subtitld をダウンロード