73 lines
2.4 KiB
TypeScript
73 lines
2.4 KiB
TypeScript
/**
|
|
* 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;
|
|
}
|