GPAC Timed Text XML
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 · ストリーム
ファイルのバージョン。
- 2 · ヘッダー
トラックのサイズと、テキストの描き方ごとの記述。揃え方、フォント、最初のスタイル。
- 3 · サンプル
各サンプルの時刻と、使う記述。空のサンプルは画面を消します。
- 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
- 各字幕のテキストと改行
- 斜体、太字、下線、取り消し線、色、サイズ
- 点滅テキストとカラオケのタイミング
- 表示位置:上、中、下。左、中央、右
- 縦書きのテキスト
- 開始と終了(ミリ秒単位)
- 重なる字幕:次の字幕が始まるところで前の字幕が終わります
- フォント、ルビ、9つ以外の位置
- 話者、原文の横に並べた翻訳
- 吹き替え、話者の顔や色
これらを残すには、.usfx プロジェクトとして保存してください。
TTXTファイルを開く
Subtitldは次を読み取ります。
- テキストのある各サンプルを、次のサンプルまでの1つの字幕として。後にサンプルのない最後のものは3秒間。
- サンプル内のテキスト、またはバージョン1.0のファイルの
text属性(各行はシングルクォートで囲まれます)。 - 太字、斜体、下線、取り消し線、記述と異なる色、記述のサイズに対する相対的なサイズは装飾として。点滅は点滅テキストとして、カラオケはカラオケのタイミングとして。
- 記述の揃え方は9つの位置のいずれかとして(指定がない場合は、MP4Boxと同じく左と下)。
verticalTextは縦書きのテキストとして。
GPACのTTXTではないファイルは、その旨を表示します。
TTXTの書き出し
エクスポート、字幕、TTXTの順に選ぶと、次の項目が表示されます。
- テキスト原文、翻訳、または両方(翻訳は下に表示)。
- 話者名省略、またはテキストの前(Thom: …)。
- 装飾残す、または削除。
- 時刻をずらすすべての字幕を同じ量だけ前後にずらします。
トラックは動画と同じサイズで(動画がなければGPACの400×80)、文字の大きさは高さの20分の1です。字幕の位置ごとに独自の記述を作ります。各字幕は1つのサンプルで、次の字幕が始まる前に終わる箇所には空のサンプルを置きます。テキストはUTF-8で、ルビの読みは含みません。
MP4Box -add subtitles.ttxt video.mp4 で、字幕をテキストトラックとして動画に入れられます。
豆知識
3GPPは、携帯電話への動画ストリーミング向けに、timed textフォーマットTS 26.245を承認しました。MPEGは2006年、ほとんど変更を加えずにこれをMPEG-4 Part 17としました。
MP4ファイル内のテキストトラックの名前です。あらゆる種類のトラックと同じく4文字です。MP4BoxとQuickTime Proのどちらでも作れます。
同じトラックのFFmpegでの名前です。FFmpegで字幕をMP4に変換すると、これが作られます。
関連する形式
Subtitld で動画と一緒に開き、波形上でタイミングを調整しましょう。