@remotion/media-parser 4.0.193 → 4.0.195

package/dist/boxes/webm/get-track.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTrack = void 0;
+const buffer_iterator_1 = require("../../buffer-iterator");
+const make_hvc1_codec_strings_1 = require("../../make-hvc1-codec-strings");
+const traversal_1 = require("../../traversal");
+const av1_codec_private_1 = require("./av1-codec-private");
+const description_1 = require("./description");
+const getDescription = (track) => {
+    const codec = (0, traversal_1.getCodecSegment)(track);
+    if (!codec) {
+        return undefined;
+    }
+    if (codec.codec === 'V_MPEG4/ISO/AVC' || codec.codec === 'V_MPEGH/ISO/HEVC') {
+        const priv = (0, traversal_1.getPrivateData)(track);
+        if (priv) {
+            return priv;
+        }
+    }
+    return undefined;
+};
+const getMatroskaVideoCodecString = ({ track, codecSegment: codec, }) => {
+    if (codec.codec === 'V_VP8') {
+        return 'vp8';
+    }
+    if (codec.codec === 'V_VP9') {
+        const priv = (0, traversal_1.getPrivateData)(track);
+        if (priv) {
+            throw new Error('@remotion/media-parser cannot handle the private data for VP9. Do you have an example file you could send so we can implement it?');
+        }
+        return 'vp09.00.10.08';
+    }
+    if (codec.codec === 'V_MPEG4/ISO/AVC') {
+        const priv = (0, traversal_1.getPrivateData)(track);
+        if (priv) {
+            return `avc1.${priv[1].toString(16).padStart(2, '0')}${priv[2].toString(16).padStart(2, '0')}${priv[3].toString(16).padStart(2, '0')}`;
+        }
+        throw new Error('Could not find a CodecPrivate field in TrackEntry');
+    }
+    if (codec.codec === 'V_AV1') {
+        const priv = (0, traversal_1.getPrivateData)(track);
+        if (!priv) {
+            throw new Error('Expected private data in AV1 track');
+        }
+        return (0, av1_codec_private_1.parseAv1PrivateData)(priv, null);
+    }
+    if (codec.codec === 'V_MPEGH/ISO/HEVC') {
+        const priv = (0, traversal_1.getPrivateData)(track);
+        const iterator = (0, buffer_iterator_1.getArrayBufferIterator)(priv);
+        return 'hvc1.' + (0, make_hvc1_codec_strings_1.getHvc1CodecString)(iterator);
+    }
+    throw new Error(`Unknown codec: ${codec.codec}`);
+};
+const getMatroskaAudioCodecString = (track) => {
+    const codec = (0, traversal_1.getCodecSegment)(track);
+    if (!codec) {
+        throw new Error('Expected codec segment');
+    }
+    if (codec.codec === 'A_OPUS') {
+        return 'opus';
+    }
+    if (codec.codec === 'A_VORBIS') {
+        return 'vorbis';
+    }
+    if (codec.codec === 'A_PCM/INT/LIT') {
+        // https://github.com/ietf-wg-cellar/matroska-specification/issues/142#issuecomment-330004950
+        // Audio samples MUST be considered as signed values, except if the audio bit depth is 8 which MUST be interpreted as unsigned values.
+        const bitDepth = (0, traversal_1.getBitDepth)(track);
+        if (bitDepth === null) {
+            throw new Error('Expected bit depth');
+        }
+        if (bitDepth === 8) {
+            return 'pcm-u8';
+        }
+        return 'pcm-s' + bitDepth;
+    }
+    if (codec.codec === 'A_AAC') {
+        const priv = (0, traversal_1.getPrivateData)(track);
+        const iterator = (0, buffer_iterator_1.getArrayBufferIterator)(priv);
+        iterator.startReadingBits();
+        /**
+         * ChatGPT
+         * 	▪	The first 5 bits represent the AOT.
+                ▪	Common values:
+                ◦	1 for AAC Main
+                ◦	2 for AAC LC (Low Complexity)
+                ◦	3 for AAC SSR (Scalable Sample Rate)
+                ◦	4 for AAC LTP (Long Term Prediction)
+                ◦	5 for SBR (Spectral Band Replication)
+                ◦	29 for HE-AAC (which uses SBR with AAC LC)
+         */
+        /**
+         * Fully qualified codec:
+         * This codec has multiple possible codec strings:
+            "mp4a.40.2" — MPEG-4 AAC LC
+            "mp4a.40.02" — MPEG-4 AAC LC, leading 0 for Aud-OTI compatibility
+            "mp4a.40.5" — MPEG-4 HE-AAC v1 (AAC LC + SBR)
+            "mp4a.40.05" — MPEG-4 HE-AAC v1 (AAC LC + SBR), leading 0 for Aud-OTI compatibility
+            "mp4a.40.29" — MPEG-4 HE-AAC v2 (AAC LC + SBR + PS)
+            "mp4a.67" — MPEG-2 AAC LC
+        */
+        const profile = iterator.getBits(5);
+        iterator.stopReadingBits();
+        iterator.destroy();
+        return `mp4a.40.${profile.toString().padStart(2, '0')}`;
+    }
+    if (codec.codec === 'A_MPEG/L3') {
+        return 'mp3';
+    }
+    throw new Error(`Unknown codec: ${codec.codec}`);
+};
+const getTrack = ({ timescale, track, }) => {
+    const trackType = (0, traversal_1.getTrackTypeSegment)(track);
+    if (!trackType) {
+        throw new Error('Expected track type segment');
+    }
+    const trackId = (0, traversal_1.getTrackId)(track);
+    if (trackType.trackType === 'video') {
+        const width = (0, traversal_1.getWidthSegment)(track);
+        if (width === null) {
+            throw new Error('Expected width segment');
+        }
+        const height = (0, traversal_1.getHeightSegment)(track);
+        if (height === null) {
+            throw new Error('Expected height segment');
+        }
+        const displayHeight = (0, traversal_1.getDisplayHeightSegment)(track);
+        const displayWidth = (0, traversal_1.getDisplayWidthSegment)(track);
+        const codec = (0, traversal_1.getCodecSegment)(track);
+        if (!codec) {
+            return null;
+        }
+        const codecString = getMatroskaVideoCodecString({
+            track,
+            codecSegment: codec,
+        });
+        if (!codecString) {
+            return null;
+        }
+        return {
+            type: 'video',
+            trackId,
+            codec: codecString,
+            description: getDescription(track),
+            height: displayHeight ? displayHeight.displayHeight : height.height,
+            width: displayWidth ? displayWidth.displayWidth : width.width,
+            sampleAspectRatio: {
+                numerator: 1,
+                denominator: 1,
+            },
+            timescale,
+            samplePositions: [],
+            codedHeight: height.height,
+            codedWidth: width.width,
+            displayAspectHeight: displayHeight
+                ? displayHeight.displayHeight
+                : height.height,
+            displayAspectWidth: displayWidth
+                ? displayWidth.displayWidth
+                : width.width,
+            rotation: 0,
+        };
+    }
+    if (trackType.trackType === 'audio') {
+        const sampleRate = (0, traversal_1.getSampleRate)(track);
+        const numberOfChannels = (0, traversal_1.getNumberOfChannels)(track);
+        if (sampleRate === null) {
+            throw new Error('Could not find sample rate or number of channels');
+        }
+        return {
+            type: 'audio',
+            trackId,
+            codec: getMatroskaAudioCodecString(track),
+            samplePositions: null,
+            timescale,
+            numberOfChannels,
+            sampleRate,
+            description: (0, description_1.getAudioDescription)(track),
+        };
+    }
+    return null;
+};
+exports.getTrack = getTrack;

package/dist/boxes/webm/parse-webm-header.d.ts

@@ -1,3 +1,4 @@
 import type { BufferIterator } from '../../buffer-iterator';
 import type { ParseResult } from '../../parse-result';
-export declare const parseWebm: (counter: BufferIterator) => ParseResult;
+import type { ParserContext } from '../../parser-context';
+export declare const parseWebm: (counter: BufferIterator, parserContext: ParserContext) => Promise<ParseResult>;

package/dist/boxes/webm/parse-webm-header.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseWebm = void 0;
 const segments_1 = require("./segments");
 // Parsing according to https://darkcoding.net/software/reading-mediarecorders-webm-opus-output/
-const parseWebm = (counter) => {
+const parseWebm = (counter, parserContext) => {
     counter.discard(4);
     const length = counter.getVint();
     if (length !== 31 && length !== 35) {
@@ -11,6 +11,6 @@ const parseWebm = (counter) => {
     }
     // Discard header for now
     counter.discard(length);
-    return { status: 'done', segments: [(0, segments_1.expectSegment)(counter)] };
+    return (0, segments_1.expectSegment)(counter, parserContext);
 };
 exports.parseWebm = parseWebm;

package/dist/boxes/webm/segments/all-segments.d.ts

@@ -0,0 +1,269 @@
+export declare const matroskaElements: {
+    readonly EBMLMaxIDLength: "0x42f2";
+    readonly EBMLMaxSizeLength: "0x42f3";
+    readonly Segment: "0x18538067";
+    readonly SeekHead: "0x114d9b74";
+    readonly Seek: "0x4dbb";
+    readonly SeekID: "0x53ab";
+    readonly SeekPosition: "0x53ac";
+    readonly Info: "0x1549a966";
+    readonly SegmentUUID: "0x73a4";
+    readonly SegmentFilename: "0x7384";
+    readonly PrevUUID: "0x3cb923";
+    readonly PrevFilename: "0x3c83ab";
+    readonly NextUUID: "0x3eb923";
+    readonly NextFilename: "0x3e83bb";
+    readonly SegmentFamily: "0x4444";
+    readonly ChapterTranslate: "0x6924";
+    readonly ChapterTranslateID: "0x69a5";
+    readonly ChapterTranslateCodec: "0x69bf";
+    readonly ChapterTranslateEditionUID: "0x69fc";
+    readonly TimestampScale: "0x2ad7b1";
+    readonly Duration: "0x4489";
+    readonly DateUTC: "0x4461";
+    readonly Title: "0x7ba9";
+    readonly MuxingApp: "0x4d80";
+    readonly WritingApp: "0x5741";
+    readonly Cluster: "0x1f43b675";
+    readonly Timestamp: "0xe7";
+    readonly SilentTracks: "0x5854";
+    readonly SilentTrackNumber: "0x58d7";
+    readonly Position: "0xa7";
+    readonly PrevSize: "0xab";
+    readonly SimpleBlock: "0xa3";
+    readonly BlockGroup: "0xa0";
+    readonly Block: "0xa1";
+    readonly BlockVirtual: "0xa2";
+    readonly BlockAdditions: "0x75a1";
+    readonly BlockMore: "0xa6";
+    readonly BlockAdditional: "0xa5";
+    readonly BlockAddID: "0xee";
+    readonly BlockDuration: "0x9b";
+    readonly ReferencePriority: "0xfa";
+    readonly ReferenceBlock: "0xfb";
+    readonly ReferenceVirtual: "0xfd";
+    readonly CodecState: "0xa4";
+    readonly DiscardPadding: "0x75a2";
+    readonly Slices: "0x8e";
+    readonly TimeSlice: "0xe8";
+    readonly LaceNumber: "0xcc";
+    readonly FrameNumber: "0xcd";
+    readonly BlockAdditionID: "0xcb";
+    readonly Delay: "0xce";
+    readonly SliceDuration: "0xcf";
+    readonly ReferenceFrame: "0xc8";
+    readonly ReferenceOffset: "0xc9";
+    readonly ReferenceTimestamp: "0xca";
+    readonly EncryptedBlock: "0xaf";
+    readonly Tracks: "0x1654ae6b";
+    readonly TrackEntry: "0xae";
+    readonly TrackNumber: "0xd7";
+    readonly TrackUID: "0x73c5";
+    readonly TrackType: "0x83";
+    readonly FlagEnabled: "0xb9";
+    readonly FlagDefault: "0x88";
+    readonly FlagForced: "0x55aa";
+    readonly FlagHearingImpaired: "0x55ab";
+    readonly FlagVisualImpaired: "0x55ac";
+    readonly FlagTextDescriptions: "0x55ad";
+    readonly FlagOriginal: "0x55ae";
+    readonly FlagCommentary: "0x55af";
+    readonly FlagLacing: "0x9c";
+    readonly MinCache: "0x6de7";
+    readonly MaxCache: "0x6df8";
+    readonly DefaultDuration: "0x23e383";
+    readonly DefaultDecodedFieldDuration: "0x234e7a";
+    readonly TrackTimestampScale: "0x23314f";
+    readonly TrackOffset: "0x537f";
+    readonly MaxBlockAdditionID: "0x55ee";
+    readonly BlockAdditionMapping: "0x41e4";
+    readonly BlockAddIDValue: "0x41f0";
+    readonly BlockAddIDName: "0x41a4";
+    readonly BlockAddIDType: "0x41e7";
+    readonly BlockAddIDExtraData: "0x41ed";
+    readonly Name: "0x536e";
+    readonly Language: "0x22b59c";
+    readonly LanguageBCP47: "0x22b59d";
+    readonly CodecID: "0x86";
+    readonly CodecPrivate: "0x63a2";
+    readonly CodecName: "0x258688";
+    readonly AttachmentLink: "0x7446";
+    readonly CodecSettings: "0x3a9697";
+    readonly CodecInfoURL: "0x3b4040";
+    readonly CodecDownloadURL: "0x26b240";
+    readonly CodecDecodeAll: "0xaa";
+    readonly TrackOverlay: "0x6fab";
+    readonly CodecDelay: "0x56aa";
+    readonly SeekPreRoll: "0x56bb";
+    readonly TrackTranslate: "0x6624";
+    readonly TrackTranslateTrackID: "0x66a5";
+    readonly TrackTranslateCodec: "0x66bf";
+    readonly TrackTranslateEditionUID: "0x66fc";
+    readonly Video: "0xe0";
+    readonly FlagInterlaced: "0x9a";
+    readonly FieldOrder: "0x9d";
+    readonly StereoMode: "0x53b8";
+    readonly AlphaMode: "0x53c0";
+    readonly OldStereoMode: "0x53b9";
+    readonly PixelWidth: "0xb0";
+    readonly PixelHeight: "0xba";
+    readonly PixelCropBottom: "0x54aa";
+    readonly PixelCropTop: "0x54bb";
+    readonly PixelCropLeft: "0x54cc";
+    readonly PixelCropRight: "0x54dd";
+    readonly DisplayWidth: "0x54b0";
+    readonly DisplayHeight: "0x54ba";
+    readonly DisplayUnit: "0x54b2";
+    readonly AspectRatioType: "0x54b3";
+    readonly UncompressedFourCC: "0x2eb524";
+    readonly GammaValue: "0x2fb523";
+    readonly FrameRate: "0x2383e3";
+    readonly Colour: "0x55b0";
+    readonly MatrixCoefficients: "0x55b1";
+    readonly BitsPerChannel: "0x55b2";
+    readonly ChromaSubsamplingHorz: "0x55b3";
+    readonly ChromaSubsamplingVert: "0x55b4";
+    readonly CbSubsamplingHorz: "0x55b5";
+    readonly CbSubsamplingVert: "0x55b6";
+    readonly ChromaSitingHorz: "0x55b7";
+    readonly ChromaSitingVert: "0x55b8";
+    readonly Range: "0x55b9";
+    readonly TransferCharacteristics: "0x55ba";
+    readonly Primaries: "0x55bb";
+    readonly MaxCLL: "0x55bc";
+    readonly MaxFALL: "0x55bd";
+    readonly MasteringMetadata: "0x55d0";
+    readonly PrimaryRChromaticityX: "0x55d1";
+    readonly PrimaryRChromaticityY: "0x55d2";
+    readonly PrimaryGChromaticityX: "0x55d3";
+    readonly PrimaryGChromaticityY: "0x55d4";
+    readonly PrimaryBChromaticityX: "0x55d5";
+    readonly PrimaryBChromaticityY: "0x55d6";
+    readonly WhitePointChromaticityX: "0x55d7";
+    readonly WhitePointChromaticityY: "0x55d8";
+    readonly LuminanceMax: "0x55d9";
+    readonly LuminanceMin: "0x55da";
+    readonly Projection: "0x7670";
+    readonly ProjectionType: "0x7671";
+    readonly ProjectionPrivate: "0x7672";
+    readonly ProjectionPoseYaw: "0x7673";
+    readonly ProjectionPosePitch: "0x7674";
+    readonly ProjectionPoseRoll: "0x7675";
+    readonly Audio: "0xe1";
+    readonly SamplingFrequency: "0xb5";
+    readonly OutputSamplingFrequency: "0x78b5";
+    readonly Channels: "0x9f";
+    readonly ChannelPositions: "0x7d7b";
+    readonly BitDepth: "0x6264";
+    readonly Emphasis: "0x52f1";
+    readonly TrackOperation: "0xe2";
+    readonly TrackCombinePlanes: "0xe3";
+    readonly TrackPlane: "0xe4";
+    readonly TrackPlaneUID: "0xe5";
+    readonly TrackPlaneType: "0xe6";
+    readonly TrackJoinBlocks: "0xe9";
+    readonly TrackJoinUID: "0xed";
+    readonly TrickTrackUID: "0xc0";
+    readonly TrickTrackSegmentUID: "0xc1";
+    readonly TrickTrackFlag: "0xc6";
+    readonly TrickMasterTrackUID: "0xc7";
+    readonly TrickMasterTrackSegmentUID: "0xc4";
+    readonly ContentEncodings: "0x6d80";
+    readonly ContentEncoding: "0x6240";
+    readonly ContentEncodingOrder: "0x5031";
+    readonly ContentEncodingScope: "0x5032";
+    readonly ContentEncodingType: "0x5033";
+    readonly ContentCompression: "0x5034";
+    readonly ContentCompAlgo: "0x4254";
+    readonly ContentCompSettings: "0x4255";
+    readonly ContentEncryption: "0x5035";
+    readonly ContentEncAlgo: "0x47e1";
+    readonly ContentEncKeyID: "0x47e2";
+    readonly ContentEncAESSettings: "0x47e7";
+    readonly AESSettingsCipherMode: "0x47e8";
+    readonly ContentSignature: "0x47e3";
+    readonly ContentSigKeyID: "0x47e4";
+    readonly ContentSigAlgo: "0x47e5";
+    readonly ContentSigHashAlgo: "0x47e6";
+    readonly Cues: "0x1c53bb6b";
+    readonly CuePoint: "0xbb";
+    readonly CueTime: "0xb3";
+    readonly CueTrackPositions: "0xb7";
+    readonly CueTrack: "0xf7";
+    readonly CueClusterPosition: "0xf1";
+    readonly CueRelativePosition: "0xf0";
+    readonly CueDuration: "0xb2";
+    readonly CueBlockNumber: "0x5378";
+    readonly CueCodecState: "0xea";
+    readonly CueReference: "0xdb";
+    readonly CueRefTime: "0x96";
+    readonly CueRefCluster: "0x97";
+    readonly CueRefNumber: "0x535f";
+    readonly CueRefCodecState: "0xeb";
+    readonly Attachments: "0x1941a469";
+    readonly AttachedFile: "0x61a7";
+    readonly FileDescription: "0x467e";
+    readonly FileName: "0x466e";
+    readonly FileMediaType: "0x4660";
+    readonly FileData: "0x465c";
+    readonly FileUID: "0x46ae";
+    readonly FileReferral: "0x4675";
+    readonly FileUsedStartTime: "0x4661";
+    readonly FileUsedEndTime: "0x4662";
+    readonly Chapters: "0x1043a770";
+    readonly EditionEntry: "0x45b9";
+    readonly EditionUID: "0x45bc";
+    readonly EditionFlagHidden: "0x45bd";
+    readonly EditionFlagDefault: "0x45db";
+    readonly EditionFlagOrdered: "0x45dd";
+    readonly EditionDisplay: "0x4520";
+    readonly EditionString: "0x4521";
+    readonly EditionLanguageIETF: "0x45e4";
+    readonly ChapterAtom: "0xb6";
+    readonly ChapterUID: "0x73c4";
+    readonly ChapterStringUID: "0x5654";
+    readonly ChapterTimeStart: "0x91";
+    readonly ChapterTimeEnd: "0x92";
+    readonly ChapterFlagHidden: "0x98";
+    readonly ChapterFlagEnabled: "0x4598";
+    readonly ChapterSegmentUUID: "0x6e67";
+    readonly ChapterSkipType: "0x4588";
+    readonly ChapterSegmentEditionUID: "0x6ebc";
+    readonly ChapterPhysicalEquiv: "0x63c3";
+    readonly ChapterTrack: "0x8f";
+    readonly ChapterTrackUID: "0x89";
+    readonly ChapterDisplay: "0x80";
+    readonly ChapString: "0x85";
+    readonly ChapLanguage: "0x437c";
+    readonly ChapLanguageBCP47: "0x437d";
+    readonly ChapCountry: "0x437e";
+    readonly ChapProcess: "0x6944";
+    readonly ChapProcessCodecID: "0x6955";
+    readonly ChapProcessPrivate: "0x450d";
+    readonly ChapProcessCommand: "0x6911";
+    readonly ChapProcessTime: "0x6922";
+    readonly ChapProcessData: "0x6933";
+    readonly Tags: "0x1254c367";
+    readonly Tag: "0x7373";
+    readonly Targets: "0x63c0";
+    readonly TargetTypeValue: "0x68ca";
+    readonly TargetType: "0x63ca";
+    readonly TagTrackUID: "0x63c5";
+    readonly TagEditionUID: "0x63c9";
+    readonly TagChapterUID: "0x63c4";
+    readonly TagAttachmentUID: "0x63c6";
+    readonly SimpleTag: "0x67c8";
+    readonly TagName: "0x45a3";
+    readonly TagLanguage: "0x447a";
+    readonly TagLanguageBCP47: "0x447b";
+    readonly TagDefault: "0x4484";
+    readonly TagDefaultBogus: "0x44b4";
+    readonly TagString: "0x4487";
+    readonly TagBinary: "0x4485";
+    readonly Void: "0xec";
+    readonly Crc32: "0xbf";
+};
+export declare const knownIdsWithOneLength: string[];
+export declare const knownIdsWithTwoLength: string[];
+export declare const knownIdsWithThreeLength: string[];
+export declare const getSegmentName: (id: string) => string | undefined;