@danything/arib 1.0.2 → 1.2.1

package/dist/synth.js

@@ -10,9 +10,17 @@ import { PACKET, SYNC, withCrc } from "./psi.js";
 export { withCrc };
 const be = (value) => [(value >> 8) & 0xff, value & 0xff];
 const be32 = (value) => [...be(value >>> 16), ...be(value & 0xffff)];
-/** セクションの頭8バイト (長さは `withCrc` が埋める)。バージョン 0・節 0/0 */
-function head(tableId, extension) {
-    return [tableId, 0x00, 0x00, ...be(extension), 0xc1, 0x00, 0x00];
+/** セクションの頭 8 バイト (長さは `withCrc` が埋める) */
+function head(tableId, extension, part = {}) {
+    return [
+        tableId,
+        0x00,
+        0x00,
+        ...be(extension),
+        0xc1 | (((part.version ?? 0) & 0x1f) << 1),
+        part.sectionNumber ?? 0,
+        part.lastSectionNumber ?? 0,
+    ];
 }
 /** PCR の基準部 (90kHz) を適応フィールドに書く (旗は呼ぶ側)。拡張部 (27MHz の端数) は読む側が見ていないので 0 */
 export function putPcr(packet, pcr) {
@@ -27,8 +35,8 @@ export function putPcr(packet, pcr) {
 /**
  * Unicode → JIS X 0208 の区点。**読む側の裏返し。**
  *
- * 表を抱え込まずに、EUC-JP のデコーダを1回だけ総当たりして作る
- * (84区 × 94点 = 7896 文字)。テストと偽放送局からしか呼ばないので、
+ * 表を抱え込まずに、EUC-JP のデコーダを 1 回だけ総当たりして作る
+ * (84 区 × 94 点 = 7896 文字)。テストと偽放送局からしか呼ばないので、
  * 最初に使うときまで作らない。
  */
 let jis = null;
@@ -49,7 +57,7 @@ function jisTable() {
     return jis;
 }
 /**
- * 文字列を ARIB STD-B24 の8単位符号にする。
+ * 文字列を ARIB STD-B24 の 8 単位符号にする。
  *
  * 初期状態 (G0=漢字) から始めて、ASCII のところだけ英数集合へ切り替える。
  * 本物の放送はもっと凝った切り替え方をするが、**読む側が同じ経路を通れば足りる**。
@@ -73,13 +81,13 @@ export function encodeAribText(text, half = false) {
             out.push(0x1b, 0x24, 0x42, ...(half ? [0x8a] : []));
         alnum = false;
         const kuten = jisTable().get(char);
-        // 表に無い字は下駄で埋める (2区14点)。長さが変わらないので位置がずれない
+        // 表に無い字は下駄で埋める (2 区 14 点)。長さが変わらないので位置がずれない
         out.push(...be(kuten ?? 0x222e));
     }
     return out;
 }
 /**
- * 番組名・局名 (SI) に書く形式。**ASCII は中型 (MSZ) で挟んで半角で読ませる** — 標準の大きさの
+ * 番組名・局名 (SI) に書く形式。**ASCII は中型 (MSZ) で挟んで半角で読ませる。** 標準の大きさの
  * 英数はテレビが全角で描く (読む側 `aribtext.ts` も全角にする)。全角の英数 (「Ｖｅｎｕｅ」) は
  * 漢字の集合の字として書くので、読めば書いたとおりの文字列に戻る
  */
@@ -88,14 +96,16 @@ function encodeSiText(text) {
 }
 /** 言語の符号 "jpn" (ISO 639-2) */
 const JPN = [0x6a, 0x70, 0x6e];
-/** 長さ1バイトを頭に付けた文字列。SI の記述子はどこもこの形式 */
+/** 長さ 1 バイトを頭に付けた文字列。SI の記述子はどこもこの形式 */
 const sized = (text) => {
     const body = encodeSiText(text);
     return [body.length, ...body];
 };
-export function sdtSection(transportStreamId, originalNetworkId, services) {
+export function sdtSection(transportStreamId, originalNetworkId, services, 
+/** `other` なら SDT[other] (0x46。ほかの TS のもの) */
+options = {}) {
     const body = [
-        ...head(0x42, transportStreamId),
+        ...head(options.other === true ? 0x46 : 0x42, transportStreamId, options),
         ...be(originalNetworkId),
         0xff,
     ];
@@ -107,9 +117,9 @@ export function sdtSection(transportStreamId, originalNetworkId, services) {
     }
     return withCrc(body);
 }
-/** 2桁の10進を BCD の1バイトに */
+/** 2 桁の 10 進を BCD の 1 バイトに */
 const bcd = (value) => ((Math.floor(value / 10) << 4) | (value % 10)) & 0xff;
-/** epoch ms → MJD + BCD の5バイト。放送の時刻は日本時間で書く */
+/** epoch ms → MJD + BCD の 5 バイト。放送の時刻は日本時間で書く */
 function mjdTime(at) {
     const jst = Math.floor(at / 1000) + 9 * 3600;
     const mjd = Math.floor(jst / 86400) + 40587;
@@ -121,7 +131,7 @@ function mjdTime(at) {
         bcd(rest % 60),
     ];
 }
-/** ms → BCD 3バイトの尺 */
+/** ms → BCD 3 バイトの尺 */
 function bcdDuration(ms) {
     const total = Math.floor(ms / 1000);
     return [
@@ -131,11 +141,11 @@ function bcdDuration(ms) {
     ];
 }
 /**
- * シリーズ記述子 (0xD5。ARIB STD-B10 第2部)。
+ * シリーズ記述子 (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)
+ * 有効期限は載せない (flag 0、日付は全ビット 1)
  */
 function seriesDescriptor(series) {
     const episode = series.episode ?? 0;
@@ -154,7 +164,7 @@ function seriesDescriptor(series) {
 }
 /**
  * デジタルコピー制御記述子 (0xC1)。EIT の番組と PMT に載る。
- * 中身は1バイトだけ: 記録制御 (2) 最大ビットレートの有無 (1) 部品ごとの制御の有無 (1) 出力の制御 (4)
+ * 中身は 1 バイトだけ: 記録制御 (2) 最大ビットレートの有無 (1) 部品ごとの制御の有無 (1) 出力の制御 (4)
  */
 export function copyControlDescriptor(control) {
     return [0xc1, 0x01, ((control & 0b11) << 6) | 0b0100];
@@ -193,7 +203,7 @@ function eventDescriptors(event) {
          * simulcast_group_tag / フラグ / 言語 / **放送が付けた名前**。
          *
          * フラグは 多言語(1) 主音声(1) 品質(2) 標本化周波数(3) reserved(1)。
-         * 名前は、種別も言語も同じ音声が2本あるとき**唯一の見分け**になる
+         * 名前は、種別も言語も同じ音声が 2 本あるとき**唯一の見分け**になる
          */
         const lang = [...(audio.lang ?? "jpn")].map((c) => c.charCodeAt(0));
         const text = encodeSiText(audio.text ?? "");
@@ -235,21 +245,66 @@ export function eitSection(options) {
     }
     return withCrc(body);
 }
-export function nitSection(networkId, remoteControlKeyId, streams) {
-    const body = [...head(0x40, networkId), ...be(0xf000)];
+/**
+ * NIT。TS ごとに `[TSID, ONID, [サービスID, 種別][], 足す記述子]`。
+ * 足す記述子は分配の記述子 (`satelliteDeliveryDescriptor`・`terrestrialDeliveryDescriptor`) など
+ */
+export function nitSection(networkId, remoteControlKeyId, streams, 
+/** `other` なら NIT[other] (0x41。ほかのネットワークのもの) */
+options = {}) {
+    const body = [
+        ...head(options.other === true ? 0x41 : 0x40, networkId, options),
+        ...be(0xf000),
+    ];
     const loop = [];
-    for (const [transportStreamId, originalNetworkId, services] of streams) {
+    for (const [transportStreamId, originalNetworkId, services, extra,] of streams) {
         const descriptors = [];
         // TS information descriptor (0xCD)
         if (remoteControlKeyId !== null)
             descriptors.push(0xcd, 0x02, remoteControlKeyId, 0x00);
         const serviceList = services.flatMap(([id, type]) => [...be(id), type]);
         descriptors.push(0x41, serviceList.length, ...serviceList);
+        descriptors.push(...(extra ?? []));
         loop.push(...be(transportStreamId), ...be(originalNetworkId), ...be(0xf000 | descriptors.length), ...descriptors);
     }
     body.push(...be(0xf000 | loop.length), ...loop);
     return withCrc(body);
 }
+/** 10 進の整数を `digits` 桁の BCD のバイト列にする (桁が奇数なら最後の半バイトは 0) */
+function bcdBytes(value, digits) {
+    const text = String(value).padStart(digits, "0");
+    const out = [];
+    for (let i = 0; i < digits; i += 2) {
+        out.push((Number(text[i]) << 4) | Number(text[i + 1] ?? 0));
+    }
+    return out;
+}
+/**
+ * 衛星の分配の記述子 (0x43)。周波数は kHz、シンボルレートはシンボル/秒で渡す
+ * (BS-1 は 11727480 kHz・28860000)。東経 110 度・右旋・ISDB-S (変調 0x08) にしておく
+ */
+export function satelliteDeliveryDescriptor(frequency, symbolRate = 28_860_000) {
+    const symbol = bcdBytes(symbolRate / 100, 7);
+    return [
+        0x43,
+        11,
+        ...bcdBytes(frequency / 10, 8),
+        ...bcdBytes(1100, 4),
+        0x80 | (3 << 5) | 0x08,
+        symbol[0],
+        symbol[1],
+        symbol[2],
+        (symbol[3] & 0xf0) | 0x01,
+    ];
+}
+/** 地上の分配の記述子 (0xFA)。周波数は Hz で渡す (1/7 MHz 単位に丸める) */
+export function terrestrialDeliveryDescriptor(areaCode, frequencies) {
+    const body = [
+        ...be((areaCode << 4) | (1 << 2) | 0x02),
+        ...frequencies.flatMap((hz) => be(Math.round((hz * 7) / 1_000_000))),
+    ];
+    return [0xfa, body.length, ...body];
+}
 /** セクションを TS パケットに詰める。頭のパケットには pointer_field が付く */
 export function packetize(pid, section, counter = 0) {
     const packets = [];
@@ -265,11 +320,11 @@ export function packetize(pid, section, counter = 0) {
     }
     return Uint8Array.from(packets);
 }
-/** 部品を1本のバイト列に繋ぐ。組んだパケットを流し込むときの糊 */
+/** 部品を 1 本のバイト列に繋ぐ。組んだパケットを流し込むときの糊 */
 export function stream(...parts) {
     return joinBytes(parts);
 }
-/** PCR を1つ運ぶだけのパケット */
+/** PCR を 1 つ運ぶだけのパケット */
 export function pcrPacket(pid, seconds, counter = 0) {
     const packet = new Uint8Array(PACKET).fill(0xff);
     packet[0] = SYNC;
@@ -282,11 +337,11 @@ export function pcrPacket(pid, seconds, counter = 0) {
     putPcr(packet, seconds * 90_000);
     return packet;
 }
-/** 放送の実時刻 (TDT) を1パケットに。BML の `getCurrentDateTime` が見る */
+/** 放送の実時刻 (TDT) を 1 パケットに。BML の `getCurrentDateTime` が見る */
 export function tdtPacket(unixMs) {
     return packetize(0x0014, Uint8Array.from([0x70, 0x70, 0x05, ...mjdTime(unixMs)]));
 }
-/** PAT。サービスID → PMT の PID */
+/** PAT。サービス ID → PMT の PID */
 export function patSection(programs, transportStreamId = 1) {
     const body = head(0x00, transportStreamId);
     for (const [serviceId, pmtPid] of programs) {
@@ -295,7 +350,7 @@ export function patSection(programs, transportStreamId = 1) {
     return withCrc(body);
 }
 /**
- * PMT。ロゴのカルーセルが乗る ES を1つだけ持たせる。
+ * PMT。ロゴのカルーセルが乗る ES を 1 つだけ持たせる。
  * 目印は stream_identifier_descriptor (0x52) の component_tag
  */
 export function pmtSection(serviceId, esPid, componentTag) {
@@ -322,7 +377,7 @@ export function pmtSection(serviceId, esPid, componentTag) {
  * [service-filter.ts](service-filter.ts) を試すのに要る
  */
 export function programMap(serviceId, pcrPid, 
-/** `[種別, PID]`。**3つ目は記述子**の並び (字幕の部品タグなど) */
+/** `[種別, PID]`。**3 つ目は記述子**の並び (字幕の部品タグなど) */
 streams, ecmPid, 
 /** 番組ぜんたいに掛かる記述子 (program_info) に足すもの。コピー制御 ({@link copyControlDescriptor}) など */
 extra = []) {
@@ -354,7 +409,7 @@ export function bxmlDescriptor(options = {}) {
     const { dataComponentId = 0x0c, entryPoint = true } = options;
     const body = [
         ...be(dataComponentId),
-        // 伝送方式00 / 入口 / 自動起動 / 解像度0011 (960x540)
+        // 伝送方式 00 / 入口 / 自動起動 / 解像度 0011 (960x540)
         ...(entryPoint ? [0x33, 0x70] : [0x00, 0xff]),
         0xf8, // dataEventId 0xF / event_section_flag
         0xa0, // 即時取得あり / 蓄積不可 / 起動優先
@@ -365,7 +420,7 @@ export function bxmlDescriptor(options = {}) {
  * 字幕の ES (stream_type 0x06) に付ける記述子。**字幕の目印。**
  *
  * 部品タグ (stream_identifier_descriptor。ふつうの字幕は 0x30〜0x37) と、データ符号化方式記述子の
- * data_component_id 0x0008 (字幕)。続く1バイトの DMF・時刻制御モードは denpa も ffmpeg も見ない
+ * data_component_id 0x0008 (字幕)。続く 1 バイトの DMF・時刻制御モードは denpa も ffmpeg も見ない
  */
 export function captionDescriptors(componentTag = 0x30) {
     return [0x52, 0x01, componentTag, 0xfd, 0x03, 0x00, 0x08, 0x3d];
@@ -378,7 +433,7 @@ function dsmccSection(tableId, message) {
  * DII。「このモジュールは何バイトで、名前は何か」を伝える。
  *
  * **複数のモジュールを載せられる。** 本物の BS はここに `LOGO-05` と
- * `CS_LOGO-05` を並べて流していて (実機の `BS15_0` で確認)、1つしか
+ * `CS_LOGO-05` を並べて流していて (実機の `BS15:16625` で確認)、1 つしか
  * 載せられない作りでは CS を取りこぼす経路を試せない。
  */
 export function diiSection(downloadId, blockSize, modules, 
@@ -430,7 +485,7 @@ transactionId = 1) {
         ...rest,
     ]);
 }
-/** DDB。モジュールを割ったブロックを1つ運ぶ */
+/** DDB。モジュールを割ったブロックを 1 つ運ぶ */
 export function ddbSection(downloadId, moduleId, moduleVersion, blockNumber, block) {
     return dsmccSection(0x3c, [
         0x11,
@@ -461,7 +516,7 @@ export function logoModule(logoType, logos) {
 }
 /*
  * --- データ放送のテストで使う定番の割り振り ---
- * denpa の bml / data-timeline / recorded-bml の3つのテストが、同じ表と同じ組み立てを
+ * denpa の bml / data-timeline / recorded-bml の 3 つのテストが、同じ表と同じ組み立てを
  * それぞれに書いていた。番号そのものに意味は無く、揃っていることに意味がある。
  */
 export const BML_TS = {
@@ -472,7 +527,7 @@ export const BML_TS = {
     downloadId: 0xf0000001,
     componentTag: 0x40,
 };
-/** BML の ES が1本だけ載った PMT (`BML_TS` の割り振り) */
+/** BML の ES が 1 本だけ載った PMT (`BML_TS` の割り振り) */
 export function bmlPmt() {
     return programMap(BML_TS.service, BML_TS.videoPid, [
         [0x02, BML_TS.videoPid, [0x52, 0x01, 0x00]],
@@ -491,7 +546,7 @@ export function bmlHead() {
     ];
 }
 /**
- * モジュール1つぶんの中身。**放送は multipart/mixed で複数のファイルを詰める。**
+ * モジュール 1 つぶんの中身。**放送は multipart/mixed で複数のファイルを詰める。**
  * 本物と同じく、頭に Content-Type、境界で区切って各ファイルに Content-Location
  */
 export function multipartModule(files) {

package/package.json

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