Initial working version

2022-12-22 20:22:22 +11:00
parent ce9675a1cc
commit ced7fa5092
902 changed files with 150252 additions and 0 deletions
@@ -0,0 +1,72 @@
+/**
+ * Page header
+ * Ref: https://www.xiph.org/ogg/doc/framing.html#page_header
+ */
+export interface IPageHeader {
+    /**
+     * capture_pattern
+     * A header begins with a capture pattern that simplifies identifying pages;
+     * once the decoder has found the capture pattern it can do a more intensive job of verifying that it has in fact found a page boundary (as opposed to an inadvertent coincidence in the byte stream).
+     */
+    capturePattern: string;
+    /**
+     * stream_structure_version
+     */
+    version: number;
+    /**
+     * header_type_flag
+     */
+    headerType: {
+        /**
+         * True: continued packet;
+         * False: fresh packet
+         */
+        continued: boolean;
+        /**
+         * True: first page of logical bitstream (bos)
+         * False: not first page of logical bitstream
+         */
+        firstPage: boolean;
+        /**
+         * True: last page of logical bitstream (eos)
+         * False: not last page of logical bitstream
+         */
+        lastPage: boolean;
+    };
+    /**
+     * The total samples encoded after including all packets finished on this page
+     * The position specified in the frame header of the last page tells how long the data coded by the bitstream is.
+     */
+    absoluteGranulePosition: number;
+    streamSerialNumber: number;
+    pageSequenceNo: number;
+    pageChecksum: number;
+    /**
+     * The number of segment entries to appear in the segment table.
+     * The maximum number of 255 segments (255 bytes each) sets the maximum possible physical page size at 65307 bytes or
+     * just under 64kB (thus we know that a header corrupted so as destroy sizing/alignment information will not cause a
+     * runaway bitstream. We'll read in the page according to the corrupted size information that's guaranteed to be a
+     * reasonable size regardless, notice the checksum mismatch, drop sync and then look for recapture).
+     */
+    page_segments: number;
+}
+export interface ISegmentTable {
+    totalPageSize: number;
+}
+export interface IPageConsumer {
+    /**
+     * Parse Ogg page
+     * @param {IPageHeader} header Ogg page header
+     * @param {Buffer} pageData Ogg page data
+     */
+    parsePage(header: IPageHeader, pageData: Uint8Array): any;
+    /**
+     * Calculate duration of provided header
+     * @param header Ogg header
+     */
+    calculateDuration(header: IPageHeader): any;
+    /**
+     * Force to parse pending segments
+     */
+    flush(): any;
+}