@danything/arib 0.1.0 → 1.0.1

package/dist/synth-av.js

@@ -1,7 +1,7 @@
 /**
  * **本物の MPEG-2 映像と AAC 音声を、ffmpeg 無しで組み立てる** (試験用)。
  *
- * ライブを変換せずに送る経路 (docs/stream.md#放送そのままmpeg-2を送る) は、ブラウザが MPEG-2 をデコードして映像を出す
+ * denpa のライブを変換せずに送る経路 (docs/stream.md#放送そのままmpeg-2を送る) は、ブラウザが MPEG-2 をデコードして映像を出す
  * ところまでが仕事で、そこを試すには**本当にデコードできる放送**が要る。偽エージェントの
  * 放送は中身を 0xFF で埋めていて、デコードするものが無い。E2E のイメージには本物の ffmpeg も
  * 入っていない (数十分かかる組み立てを避けている) ので、ここで小さく作る。
@@ -100,7 +100,7 @@ function colorAt(col, row, n, field) {
  * (放送は GOP ごとに書く。試験ではその手間を省く)。
  *
  * @param n 何枚目か。色と time_code に使う
- * @param color マクロブロック (16x16) ごとの色。既定は流れる縞 (スクリーンショットを撮るときはカラーバー。`tests/fake/docs.ts`)
+ * @param color マクロブロック (16x16) ごとの色。既定は流れる縞 (スクリーンショットを撮るときはカラーバー。denpa の `tests/fake/docs.ts`)
  */
 export function mpeg2Frame(n, color = colorAt) {
     const bits = new Bits();
@@ -241,7 +241,7 @@ function stamp(pts) {
 /**
  * PES にする。映像は長さ 0 (「次の頭まで」。放送もそう書く)、音声は長さを書く
  *
- * @param streamId 0xE0 (映像) / 0xC0 (音声)
+ * @param streamId 0xE0 (映像) / 0xC0 (音声) / 0xBD (字幕。`synth-caption.ts`)
  */
 export function pes(streamId, pts, data) {
     const header = [0x80, 0x80, 5, ...stamp(pts)];

package/dist/synth-caption.d.ts

@@ -1,5 +1,5 @@
 /**
- * **放送の字幕 (ARIB STD-B24) を組み立てる** (試験用)。読む側は [b24caption.ts](../../../packages/arib/src/b24caption.ts)。
+ * **放送の字幕 (ARIB STD-B24) を組み立てる** (試験用)。読む側は [b24caption.ts](b24caption.ts)。
  *
  * 出来るのは字幕の PES の中身 (データ識別 0x80 から) で、ffmpeg が `-c:s copy` で
  * Matroska に入れたコマと同じ形式。TS に載せるなら `synth-av.ts` の `pes(0xbd, …)` で包む。

package/dist/synth-caption.js

@@ -1,5 +1,5 @@
 /**
- * **放送の字幕 (ARIB STD-B24) を組み立てる** (試験用)。読む側は [b24caption.ts](../../../packages/arib/src/b24caption.ts)。
+ * **放送の字幕 (ARIB STD-B24) を組み立てる** (試験用)。読む側は [b24caption.ts](b24caption.ts)。
  *
  * 出来るのは字幕の PES の中身 (データ識別 0x80 から) で、ffmpeg が `-c:s copy` で
  * Matroska に入れたコマと同じ形式。TS に載せるなら `synth-av.ts` の `pes(0xbd, …)` で包む。

package/dist/synth.d.ts

@@ -2,7 +2,7 @@
  * TS のセクションを組み立てる。
  *
  * 実チューナーが無いので、解析のテストにも偽エージェントにも「それらしい TS」が要る。
- * 読む側 (psi.ts・eit.ts・dsmcc.ts・logo.ts・ait.ts など) と対になる書く側で、ここだけが仕様の写し。
+ * 読む側 (psi.ts・eit.ts・dsmcc.ts・ait.ts、denpa の logo.ts など) と対になる書く側で、ここだけが仕様の写し。
  */
 import { withCrc } from "./psi.js";
 export { withCrc };
@@ -45,6 +45,17 @@ export interface SynthEvent {
      * 3 がコピー禁止、2 が1世代のみ。省くと記述子を載せない ({@link copyControlDescriptor})
      */
     copyControl?: number;
+    /** シリーズ。省くと記述子を載せない ({@link seriesDescriptor}) */
+    series?: SynthSeries;
+}
+/** series_descriptor の中身。省いた数は 0 (話数なら「分からない」) */
+export interface SynthSeries {
+    seriesId: number;
+    repeatLabel?: number;
+    programPattern?: number;
+    episode?: number;
+    lastEpisode?: number;
+    name?: string;
 }
 /**
  * デジタルコピー制御記述子 (0xC1)。EIT の番組と PMT に載る。
@@ -96,7 +107,7 @@ export declare function pmtSection(serviceId: number, esPid: number, componentTa
  * ふつうの PMT。映像・音声のような ES を並べる。
  *
  * ロゴ用の `pmtSection` と違って中身を選べる。局を選り分ける
- * [service-filter.ts](../../../packages/arib/src/service-filter.ts) を試すのに要る
+ * [service-filter.ts](service-filter.ts) を試すのに要る
  */
 export declare function programMap(serviceId: number, pcrPid: number, 
 /** `[種別, PID]`。**3つ目は記述子**の並び (字幕の部品タグなど) */
@@ -113,6 +124,13 @@ export declare function bxmlDescriptor(options?: {
     dataComponentId?: number;
     entryPoint?: boolean;
 }): number[];
+/**
+ * 字幕の ES (stream_type 0x06) に付ける記述子。**字幕の目印。**
+ *
+ * 部品タグ (stream_identifier_descriptor。ふつうの字幕は 0x30〜0x37) と、データ符号化方式記述子の
+ * data_component_id 0x0008 (字幕)。続く1バイトの DMF・時刻制御モードは denpa も ffmpeg も見ない
+ */
+export declare function captionDescriptors(componentTag?: number): number[];
 export interface DiiModuleSpec {
     moduleId: number;
     moduleSize: number;
@@ -135,7 +153,7 @@ export interface DiiModuleSpec {
  * 載せられない作りでは CS を取りこぼす経路を試せない。
  */
 export declare function diiSection(downloadId: number, blockSize: number, modules: DiiModuleSpec | DiiModuleSpec[], 
-/** カルーセルの版。**同じ番号で送り直しても組み立て直されない** */
+/** カルーセルのバージョン。**同じ番号で送り直しても組み立て直されない** */
 transactionId?: number): Uint8Array;
 /** DDB。モジュールを割ったブロックを1つ運ぶ */
 export declare function ddbSection(downloadId: number, moduleId: number, moduleVersion: number, blockNumber: number, block: Uint8Array): Uint8Array;

package/dist/synth.js

@@ -2,15 +2,15 @@
  * TS のセクションを組み立てる。
  *
  * 実チューナーが無いので、解析のテストにも偽エージェントにも「それらしい TS」が要る。
- * 読む側 (psi.ts・eit.ts・dsmcc.ts・logo.ts・ait.ts など) と対になる書く側で、ここだけが仕様の写し。
+ * 読む側 (psi.ts・eit.ts・dsmcc.ts・ait.ts、denpa の logo.ts など) と対になる書く側で、ここだけが仕様の写し。
  */
 import { joinBytes } from "./bytes.js";
 import { PACKET, SYNC, withCrc } from "./psi.js";
-// 組み立てる道具と一緒にここから取るテストがある (logo.test.ts) ので、そのまま出しておく
+// 組み立てる道具と一緒にここから取るテストがある (denpa の logo.test.ts) ので、そのまま出しておく
 export { withCrc };
 const be = (value) => [(value >> 8) & 0xff, value & 0xff];
 const be32 = (value) => [...be(value >>> 16), ...be(value & 0xffff)];
-/** セクションの頭8バイト (長さは `withCrc` が埋める)。版 0・節 0/0 */
+/** セクションの頭8バイト (長さは `withCrc` が埋める)。バージョン 0・節 0/0 */
 function head(tableId, extension) {
     return [tableId, 0x00, 0x00, ...be(extension), 0xc1, 0x00, 0x00];
 }
@@ -130,6 +130,28 @@ function bcdDuration(ms) {
         bcd(total % 60),
     ];
 }
+/**
+ * シリーズ記述子 (0xD5。ARIB STD-B10 第2部)。
+ *
+ * series_id(16) / repeat_label(4) program_pattern(3) expire_date_valid_flag(1) /
+ * expire_date(16) / episode_number(12) last_episode_number(12) / series_name_char。
+ * 有効期限は載せない (flag 0、日付は全ビット1)
+ */
+function seriesDescriptor(series) {
+    const episode = series.episode ?? 0;
+    const last = series.lastEpisode ?? 0;
+    const body = [
+        ...be(series.seriesId),
+        ((series.repeatLabel ?? 0) << 4) | ((series.programPattern ?? 0) << 1),
+        0xff,
+        0xff,
+        (episode >> 4) & 0xff,
+        ((episode & 0x0f) << 4) | ((last >> 8) & 0x0f),
+        last & 0xff,
+        ...encodeSiText(series.name ?? ""),
+    ];
+    return [0xd5, body.length, ...body];
+}
 /**
  * デジタルコピー制御記述子 (0xC1)。EIT の番組と PMT に載る。
  * 中身は1バイトだけ: 記録制御 (2) 最大ビットレートの有無 (1) 部品ごとの制御の有無 (1) 出力の制御 (4)
@@ -155,6 +177,8 @@ function eventDescriptors(event) {
         out.push(...event.rawDescriptors);
     if (event.copyControl !== undefined)
         out.push(...copyControlDescriptor(event.copyControl));
+    if (event.series !== undefined)
+        out.push(...seriesDescriptor(event.series));
     if (event.genres !== undefined && event.genres.length > 0) {
         const body = event.genres.flatMap(([lv1, lv2]) => [(lv1 << 4) | lv2, 0xff]);
         out.push(0x54, body.length, ...body);
@@ -295,7 +319,7 @@ export function pmtSection(serviceId, esPid, componentTag) {
  * ふつうの PMT。映像・音声のような ES を並べる。
  *
  * ロゴ用の `pmtSection` と違って中身を選べる。局を選り分ける
- * [service-filter.ts](../../../packages/arib/src/service-filter.ts) を試すのに要る
+ * [service-filter.ts](service-filter.ts) を試すのに要る
  */
 export function programMap(serviceId, pcrPid, 
 /** `[種別, PID]`。**3つ目は記述子**の並び (字幕の部品タグなど) */
@@ -337,6 +361,15 @@ export function bxmlDescriptor(options = {}) {
     ];
     return [0xfd, body.length, ...body];
 }
+/**
+ * 字幕の ES (stream_type 0x06) に付ける記述子。**字幕の目印。**
+ *
+ * 部品タグ (stream_identifier_descriptor。ふつうの字幕は 0x30〜0x37) と、データ符号化方式記述子の
+ * data_component_id 0x0008 (字幕)。続く1バイトの DMF・時刻制御モードは denpa も ffmpeg も見ない
+ */
+export function captionDescriptors(componentTag = 0x30) {
+    return [0x52, 0x01, componentTag, 0xfd, 0x03, 0x00, 0x08, 0x3d];
+}
 /** DSM-CC のセクションで包む */
 function dsmccSection(tableId, message) {
     return withCrc([...head(tableId, 0), ...message]);
@@ -349,7 +382,7 @@ function dsmccSection(tableId, message) {
  * 載せられない作りでは CS を取りこぼす経路を試せない。
  */
 export function diiSection(downloadId, blockSize, modules, 
-/** カルーセルの版。**同じ番号で送り直しても組み立て直されない** */
+/** カルーセルのバージョン。**同じ番号で送り直しても組み立て直されない** */
 transactionId = 1) {
     const list = Array.isArray(modules) ? modules : [modules];
     const entries = list.flatMap((module) => {
@@ -428,7 +461,7 @@ export function logoModule(logoType, logos) {
 }
 /*
  * --- データ放送のテストで使う定番の割り振り ---
- * bml / data-timeline / recorded-bml の3つのテストが、同じ表と同じ組み立てを
+ * denpa の bml / data-timeline / recorded-bml の3つのテストが、同じ表と同じ組み立てを
  * それぞれに書いていた。番号そのものに意味は無く、揃っていることに意味がある。
  */
 export const BML_TS = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danything/arib",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "日本のデジタル放送 (ARIB) の TS を読む: PSI・PES・EIT・ARIB の文字・字幕・データ放送",
   "license": "MIT",
   "repository": {