2 * Matroska file demuxer
3 * Copyright (c) 2003-2008 The FFmpeg Project
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * Matroska file demuxer
25 * @author Ronald Bultje <rbultje@ronald.bitfreak.net>
26 * @author with a little help from Moritz Bunkus <moritz@bunkus.org>
27 * @author totally reworked by Aurelien Jacobs <aurel@gnuage.org>
28 * @see specs available on the Matroska project page: http://www.matroska.org/
36 #include "libavutil/avstring.h"
37 #include "libavutil/base64.h"
38 #include "libavutil/dict.h"
39 #include "libavutil/intfloat.h"
40 #include "libavutil/intreadwrite.h"
41 #include "libavutil/lzo.h"
42 #include "libavutil/mastering_display_metadata.h"
43 #include "libavutil/mathematics.h"
44 #include "libavutil/opt.h"
45 #include "libavutil/time_internal.h"
46 #include "libavutil/spherical.h"
48 #include "libavcodec/bytestream.h"
49 #include "libavcodec/flac.h"
50 #include "libavcodec/mpeg4audio.h"
53 #include "avio_internal.h"
58 /* For ff_codec_get_id(). */
69 #include "qtpalette.h"
86 typedef const struct EbmlSyntax {
95 const struct EbmlSyntax *n;
99 typedef struct EbmlList {
104 typedef struct EbmlBin {
110 typedef struct Ebml {
115 uint64_t doctype_version;
118 typedef struct MatroskaTrackCompression {
121 } MatroskaTrackCompression;
123 typedef struct MatroskaTrackEncryption {
126 } MatroskaTrackEncryption;
128 typedef struct MatroskaTrackEncoding {
131 MatroskaTrackCompression compression;
132 MatroskaTrackEncryption encryption;
133 } MatroskaTrackEncoding;
135 typedef struct MatroskaMasteringMeta {
144 double max_luminance;
145 double min_luminance;
146 } MatroskaMasteringMeta;
148 typedef struct MatroskaTrackVideoColor {
149 uint64_t matrix_coefficients;
150 uint64_t bits_per_channel;
151 uint64_t chroma_sub_horz;
152 uint64_t chroma_sub_vert;
153 uint64_t cb_sub_horz;
154 uint64_t cb_sub_vert;
155 uint64_t chroma_siting_horz;
156 uint64_t chroma_siting_vert;
158 uint64_t transfer_characteristics;
162 MatroskaMasteringMeta mastering_meta;
163 } MatroskaTrackVideoColor;
165 typedef struct MatroskaTrackVideoProjection {
171 } MatroskaTrackVideoProjection;
173 typedef struct MatroskaTrackVideo {
175 uint64_t display_width;
176 uint64_t display_height;
177 uint64_t pixel_width;
178 uint64_t pixel_height;
180 uint64_t display_unit;
182 uint64_t field_order;
183 uint64_t stereo_mode;
185 MatroskaTrackVideoColor color;
186 MatroskaTrackVideoProjection projection;
187 } MatroskaTrackVideo;
189 typedef struct MatroskaTrackAudio {
191 double out_samplerate;
195 /* real audio header (extracted from extradata) */
202 uint64_t buf_timecode;
204 } MatroskaTrackAudio;
206 typedef struct MatroskaTrackPlane {
209 } MatroskaTrackPlane;
211 typedef struct MatroskaTrackOperation {
212 EbmlList combine_planes;
213 } MatroskaTrackOperation;
215 typedef struct MatroskaTrack {
224 uint64_t default_duration;
225 uint64_t flag_default;
226 uint64_t flag_forced;
227 uint64_t seek_preroll;
228 MatroskaTrackVideo video;
229 MatroskaTrackAudio audio;
230 MatroskaTrackOperation operation;
232 uint64_t codec_delay;
233 uint64_t codec_delay_in_track_tb;
236 int64_t end_timecode;
238 uint64_t max_block_additional_id;
240 uint32_t palette[AVPALETTE_COUNT];
244 typedef struct MatroskaAttachment {
251 } MatroskaAttachment;
253 typedef struct MatroskaChapter {
262 typedef struct MatroskaIndexPos {
267 typedef struct MatroskaIndex {
272 typedef struct MatroskaTag {
280 typedef struct MatroskaTagTarget {
288 typedef struct MatroskaTags {
289 MatroskaTagTarget target;
293 typedef struct MatroskaSeekhead {
298 typedef struct MatroskaLevel {
303 typedef struct MatroskaCluster {
308 typedef struct MatroskaLevel1Element {
312 } MatroskaLevel1Element;
314 typedef struct MatroskaDemuxContext {
315 const AVClass *class;
316 AVFormatContext *ctx;
320 MatroskaLevel levels[EBML_MAX_DEPTH];
330 EbmlList attachments;
336 /* byte position of the segment inside the stream */
337 int64_t segment_start;
339 /* the packet queue */
346 /* What to skip before effectively reading a packet. */
347 int skip_to_keyframe;
348 uint64_t skip_to_timecode;
350 /* File has a CUES element, but we defer parsing until it is needed. */
351 int cues_parsing_deferred;
353 /* Level1 elements and whether they were read yet */
354 MatroskaLevel1Element level1_elems[64];
355 int num_level1_elems;
357 int current_cluster_num_blocks;
358 int64_t current_cluster_pos;
359 MatroskaCluster current_cluster;
361 /* File has SSA subtitles which prevent incremental cluster parsing. */
364 /* WebM DASH Manifest live flag/ */
366 } MatroskaDemuxContext;
368 typedef struct MatroskaBlock {
373 uint64_t additional_id;
375 int64_t discard_padding;
378 static const EbmlSyntax ebml_header[] = {
379 { EBML_ID_EBMLREADVERSION, EBML_UINT, 0, offsetof(Ebml, version), { .u = EBML_VERSION } },
380 { EBML_ID_EBMLMAXSIZELENGTH, EBML_UINT, 0, offsetof(Ebml, max_size), { .u = 8 } },
381 { EBML_ID_EBMLMAXIDLENGTH, EBML_UINT, 0, offsetof(Ebml, id_length), { .u = 4 } },
382 { EBML_ID_DOCTYPE, EBML_STR, 0, offsetof(Ebml, doctype), { .s = "(none)" } },
383 { EBML_ID_DOCTYPEREADVERSION, EBML_UINT, 0, offsetof(Ebml, doctype_version), { .u = 1 } },
384 { EBML_ID_EBMLVERSION, EBML_NONE },
385 { EBML_ID_DOCTYPEVERSION, EBML_NONE },
389 static const EbmlSyntax ebml_syntax[] = {
390 { EBML_ID_HEADER, EBML_NEST, 0, 0, { .n = ebml_header } },
394 static const EbmlSyntax matroska_info[] = {
395 { MATROSKA_ID_TIMECODESCALE, EBML_UINT, 0, offsetof(MatroskaDemuxContext, time_scale), { .u = 1000000 } },
396 { MATROSKA_ID_DURATION, EBML_FLOAT, 0, offsetof(MatroskaDemuxContext, duration) },
397 { MATROSKA_ID_TITLE, EBML_UTF8, 0, offsetof(MatroskaDemuxContext, title) },
398 { MATROSKA_ID_WRITINGAPP, EBML_NONE },
399 { MATROSKA_ID_MUXINGAPP, EBML_UTF8, 0, offsetof(MatroskaDemuxContext, muxingapp) },
400 { MATROSKA_ID_DATEUTC, EBML_BIN, 0, offsetof(MatroskaDemuxContext, date_utc) },
401 { MATROSKA_ID_SEGMENTUID, EBML_NONE },
405 static const EbmlSyntax matroska_mastering_meta[] = {
406 { MATROSKA_ID_VIDEOCOLOR_RX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, r_x), { .f=-1 } },
407 { MATROSKA_ID_VIDEOCOLOR_RY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, r_y), { .f=-1 } },
408 { MATROSKA_ID_VIDEOCOLOR_GX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, g_x), { .f=-1 } },
409 { MATROSKA_ID_VIDEOCOLOR_GY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, g_y), { .f=-1 } },
410 { MATROSKA_ID_VIDEOCOLOR_BX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, b_x), { .f=-1 } },
411 { MATROSKA_ID_VIDEOCOLOR_BY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, b_y), { .f=-1 } },
412 { MATROSKA_ID_VIDEOCOLOR_WHITEX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, white_x), { .f=-1 } },
413 { MATROSKA_ID_VIDEOCOLOR_WHITEY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, white_y), { .f=-1 } },
414 { MATROSKA_ID_VIDEOCOLOR_LUMINANCEMIN, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, min_luminance), { .f=-1 } },
415 { MATROSKA_ID_VIDEOCOLOR_LUMINANCEMAX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, max_luminance), { .f=-1 } },
419 static const EbmlSyntax matroska_track_video_color[] = {
420 { MATROSKA_ID_VIDEOCOLORMATRIXCOEFF, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, matrix_coefficients), { .u = AVCOL_SPC_UNSPECIFIED } },
421 { MATROSKA_ID_VIDEOCOLORBITSPERCHANNEL, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, bits_per_channel), { .u=0 } },
422 { MATROSKA_ID_VIDEOCOLORCHROMASUBHORZ, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_sub_horz), { .u=0 } },
423 { MATROSKA_ID_VIDEOCOLORCHROMASUBVERT, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_sub_vert), { .u=0 } },
424 { MATROSKA_ID_VIDEOCOLORCBSUBHORZ, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, cb_sub_horz), { .u=0 } },
425 { MATROSKA_ID_VIDEOCOLORCBSUBVERT, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, cb_sub_vert), { .u=0 } },
426 { MATROSKA_ID_VIDEOCOLORCHROMASITINGHORZ, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_siting_horz), { .u = MATROSKA_COLOUR_CHROMASITINGHORZ_UNDETERMINED } },
427 { MATROSKA_ID_VIDEOCOLORCHROMASITINGVERT, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_siting_vert), { .u = MATROSKA_COLOUR_CHROMASITINGVERT_UNDETERMINED } },
428 { MATROSKA_ID_VIDEOCOLORRANGE, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, range), { .u = AVCOL_RANGE_UNSPECIFIED } },
429 { MATROSKA_ID_VIDEOCOLORTRANSFERCHARACTERISTICS, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, transfer_characteristics), { .u = AVCOL_TRC_UNSPECIFIED } },
430 { MATROSKA_ID_VIDEOCOLORPRIMARIES, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, primaries), { .u = AVCOL_PRI_UNSPECIFIED } },
431 { MATROSKA_ID_VIDEOCOLORMAXCLL, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, max_cll), { .u=0 } },
432 { MATROSKA_ID_VIDEOCOLORMAXFALL, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, max_fall), { .u=0 } },
433 { MATROSKA_ID_VIDEOCOLORMASTERINGMETA, EBML_NEST, 0, offsetof(MatroskaTrackVideoColor, mastering_meta), { .n = matroska_mastering_meta } },
437 static const EbmlSyntax matroska_track_video_projection[] = {
438 { MATROSKA_ID_VIDEOPROJECTIONTYPE, EBML_UINT, 0, offsetof(MatroskaTrackVideoProjection, type), { .u = MATROSKA_VIDEO_PROJECTION_TYPE_RECTANGULAR } },
439 { MATROSKA_ID_VIDEOPROJECTIONPRIVATE, EBML_BIN, 0, offsetof(MatroskaTrackVideoProjection, private) },
440 { MATROSKA_ID_VIDEOPROJECTIONPOSEYAW, EBML_FLOAT, 0, offsetof(MatroskaTrackVideoProjection, yaw), { .f=0.0 } },
441 { MATROSKA_ID_VIDEOPROJECTIONPOSEPITCH, EBML_FLOAT, 0, offsetof(MatroskaTrackVideoProjection, pitch), { .f=0.0 } },
442 { MATROSKA_ID_VIDEOPROJECTIONPOSEROLL, EBML_FLOAT, 0, offsetof(MatroskaTrackVideoProjection, roll), { .f=0.0 } },
446 static const EbmlSyntax matroska_track_video[] = {
447 { MATROSKA_ID_VIDEOFRAMERATE, EBML_FLOAT, 0, offsetof(MatroskaTrackVideo, frame_rate) },
448 { MATROSKA_ID_VIDEODISPLAYWIDTH, EBML_UINT, 0, offsetof(MatroskaTrackVideo, display_width), { .u=-1 } },
449 { MATROSKA_ID_VIDEODISPLAYHEIGHT, EBML_UINT, 0, offsetof(MatroskaTrackVideo, display_height), { .u=-1 } },
450 { MATROSKA_ID_VIDEOPIXELWIDTH, EBML_UINT, 0, offsetof(MatroskaTrackVideo, pixel_width) },
451 { MATROSKA_ID_VIDEOPIXELHEIGHT, EBML_UINT, 0, offsetof(MatroskaTrackVideo, pixel_height) },
452 { MATROSKA_ID_VIDEOCOLORSPACE, EBML_BIN, 0, offsetof(MatroskaTrackVideo, color_space) },
453 { MATROSKA_ID_VIDEOALPHAMODE, EBML_UINT, 0, offsetof(MatroskaTrackVideo, alpha_mode) },
454 { MATROSKA_ID_VIDEOCOLOR, EBML_NEST, 0, offsetof(MatroskaTrackVideo, color), { .n = matroska_track_video_color } },
455 { MATROSKA_ID_VIDEOPROJECTION, EBML_NEST, 0, offsetof(MatroskaTrackVideo, projection), { .n = matroska_track_video_projection } },
456 { MATROSKA_ID_VIDEOPIXELCROPB, EBML_NONE },
457 { MATROSKA_ID_VIDEOPIXELCROPT, EBML_NONE },
458 { MATROSKA_ID_VIDEOPIXELCROPL, EBML_NONE },
459 { MATROSKA_ID_VIDEOPIXELCROPR, EBML_NONE },
460 { MATROSKA_ID_VIDEODISPLAYUNIT, EBML_UINT, 0, offsetof(MatroskaTrackVideo, display_unit), { .u= MATROSKA_VIDEO_DISPLAYUNIT_PIXELS } },
461 { MATROSKA_ID_VIDEOFLAGINTERLACED, EBML_UINT, 0, offsetof(MatroskaTrackVideo, interlaced), { .u = MATROSKA_VIDEO_INTERLACE_FLAG_UNDETERMINED } },
462 { MATROSKA_ID_VIDEOFIELDORDER, EBML_UINT, 0, offsetof(MatroskaTrackVideo, field_order), { .u = MATROSKA_VIDEO_FIELDORDER_UNDETERMINED } },
463 { MATROSKA_ID_VIDEOSTEREOMODE, EBML_UINT, 0, offsetof(MatroskaTrackVideo, stereo_mode), { .u = MATROSKA_VIDEO_STEREOMODE_TYPE_NB } },
464 { MATROSKA_ID_VIDEOASPECTRATIO, EBML_NONE },
468 static const EbmlSyntax matroska_track_audio[] = {
469 { MATROSKA_ID_AUDIOSAMPLINGFREQ, EBML_FLOAT, 0, offsetof(MatroskaTrackAudio, samplerate), { .f = 8000.0 } },
470 { MATROSKA_ID_AUDIOOUTSAMPLINGFREQ, EBML_FLOAT, 0, offsetof(MatroskaTrackAudio, out_samplerate) },
471 { MATROSKA_ID_AUDIOBITDEPTH, EBML_UINT, 0, offsetof(MatroskaTrackAudio, bitdepth) },
472 { MATROSKA_ID_AUDIOCHANNELS, EBML_UINT, 0, offsetof(MatroskaTrackAudio, channels), { .u = 1 } },
476 static const EbmlSyntax matroska_track_encoding_compression[] = {
477 { MATROSKA_ID_ENCODINGCOMPALGO, EBML_UINT, 0, offsetof(MatroskaTrackCompression, algo), { .u = 0 } },
478 { MATROSKA_ID_ENCODINGCOMPSETTINGS, EBML_BIN, 0, offsetof(MatroskaTrackCompression, settings) },
482 static const EbmlSyntax matroska_track_encoding_encryption[] = {
483 { MATROSKA_ID_ENCODINGENCALGO, EBML_UINT, 0, offsetof(MatroskaTrackEncryption,algo), {.u = 0} },
484 { MATROSKA_ID_ENCODINGENCKEYID, EBML_BIN, 0, offsetof(MatroskaTrackEncryption,key_id) },
485 { MATROSKA_ID_ENCODINGENCAESSETTINGS, EBML_NONE },
486 { MATROSKA_ID_ENCODINGSIGALGO, EBML_NONE },
487 { MATROSKA_ID_ENCODINGSIGHASHALGO, EBML_NONE },
488 { MATROSKA_ID_ENCODINGSIGKEYID, EBML_NONE },
489 { MATROSKA_ID_ENCODINGSIGNATURE, EBML_NONE },
492 static const EbmlSyntax matroska_track_encoding[] = {
493 { MATROSKA_ID_ENCODINGSCOPE, EBML_UINT, 0, offsetof(MatroskaTrackEncoding, scope), { .u = 1 } },
494 { MATROSKA_ID_ENCODINGTYPE, EBML_UINT, 0, offsetof(MatroskaTrackEncoding, type), { .u = 0 } },
495 { MATROSKA_ID_ENCODINGCOMPRESSION, EBML_NEST, 0, offsetof(MatroskaTrackEncoding, compression), { .n = matroska_track_encoding_compression } },
496 { MATROSKA_ID_ENCODINGENCRYPTION, EBML_NEST, 0, offsetof(MatroskaTrackEncoding, encryption), { .n = matroska_track_encoding_encryption } },
497 { MATROSKA_ID_ENCODINGORDER, EBML_NONE },
501 static const EbmlSyntax matroska_track_encodings[] = {
502 { MATROSKA_ID_TRACKCONTENTENCODING, EBML_NEST, sizeof(MatroskaTrackEncoding), offsetof(MatroskaTrack, encodings), { .n = matroska_track_encoding } },
506 static const EbmlSyntax matroska_track_plane[] = {
507 { MATROSKA_ID_TRACKPLANEUID, EBML_UINT, 0, offsetof(MatroskaTrackPlane,uid) },
508 { MATROSKA_ID_TRACKPLANETYPE, EBML_UINT, 0, offsetof(MatroskaTrackPlane,type) },
512 static const EbmlSyntax matroska_track_combine_planes[] = {
513 { MATROSKA_ID_TRACKPLANE, EBML_NEST, sizeof(MatroskaTrackPlane), offsetof(MatroskaTrackOperation,combine_planes), {.n = matroska_track_plane} },
517 static const EbmlSyntax matroska_track_operation[] = {
518 { MATROSKA_ID_TRACKCOMBINEPLANES, EBML_NEST, 0, 0, {.n = matroska_track_combine_planes} },
522 static const EbmlSyntax matroska_track[] = {
523 { MATROSKA_ID_TRACKNUMBER, EBML_UINT, 0, offsetof(MatroskaTrack, num) },
524 { MATROSKA_ID_TRACKNAME, EBML_UTF8, 0, offsetof(MatroskaTrack, name) },
525 { MATROSKA_ID_TRACKUID, EBML_UINT, 0, offsetof(MatroskaTrack, uid) },
526 { MATROSKA_ID_TRACKTYPE, EBML_UINT, 0, offsetof(MatroskaTrack, type) },
527 { MATROSKA_ID_CODECID, EBML_STR, 0, offsetof(MatroskaTrack, codec_id) },
528 { MATROSKA_ID_CODECPRIVATE, EBML_BIN, 0, offsetof(MatroskaTrack, codec_priv) },
529 { MATROSKA_ID_CODECDELAY, EBML_UINT, 0, offsetof(MatroskaTrack, codec_delay) },
530 { MATROSKA_ID_TRACKLANGUAGE, EBML_UTF8, 0, offsetof(MatroskaTrack, language), { .s = "eng" } },
531 { MATROSKA_ID_TRACKDEFAULTDURATION, EBML_UINT, 0, offsetof(MatroskaTrack, default_duration) },
532 { MATROSKA_ID_TRACKTIMECODESCALE, EBML_FLOAT, 0, offsetof(MatroskaTrack, time_scale), { .f = 1.0 } },
533 { MATROSKA_ID_TRACKFLAGDEFAULT, EBML_UINT, 0, offsetof(MatroskaTrack, flag_default), { .u = 1 } },
534 { MATROSKA_ID_TRACKFLAGFORCED, EBML_UINT, 0, offsetof(MatroskaTrack, flag_forced), { .u = 0 } },
535 { MATROSKA_ID_TRACKVIDEO, EBML_NEST, 0, offsetof(MatroskaTrack, video), { .n = matroska_track_video } },
536 { MATROSKA_ID_TRACKAUDIO, EBML_NEST, 0, offsetof(MatroskaTrack, audio), { .n = matroska_track_audio } },
537 { MATROSKA_ID_TRACKOPERATION, EBML_NEST, 0, offsetof(MatroskaTrack, operation), { .n = matroska_track_operation } },
538 { MATROSKA_ID_TRACKCONTENTENCODINGS, EBML_NEST, 0, 0, { .n = matroska_track_encodings } },
539 { MATROSKA_ID_TRACKMAXBLKADDID, EBML_UINT, 0, offsetof(MatroskaTrack, max_block_additional_id) },
540 { MATROSKA_ID_SEEKPREROLL, EBML_UINT, 0, offsetof(MatroskaTrack, seek_preroll) },
541 { MATROSKA_ID_TRACKFLAGENABLED, EBML_NONE },
542 { MATROSKA_ID_TRACKFLAGLACING, EBML_NONE },
543 { MATROSKA_ID_CODECNAME, EBML_NONE },
544 { MATROSKA_ID_CODECDECODEALL, EBML_NONE },
545 { MATROSKA_ID_CODECINFOURL, EBML_NONE },
546 { MATROSKA_ID_CODECDOWNLOADURL, EBML_NONE },
547 { MATROSKA_ID_TRACKMINCACHE, EBML_NONE },
548 { MATROSKA_ID_TRACKMAXCACHE, EBML_NONE },
552 static const EbmlSyntax matroska_tracks[] = {
553 { MATROSKA_ID_TRACKENTRY, EBML_NEST, sizeof(MatroskaTrack), offsetof(MatroskaDemuxContext, tracks), { .n = matroska_track } },
557 static const EbmlSyntax matroska_attachment[] = {
558 { MATROSKA_ID_FILEUID, EBML_UINT, 0, offsetof(MatroskaAttachment, uid) },
559 { MATROSKA_ID_FILENAME, EBML_UTF8, 0, offsetof(MatroskaAttachment, filename) },
560 { MATROSKA_ID_FILEMIMETYPE, EBML_STR, 0, offsetof(MatroskaAttachment, mime) },
561 { MATROSKA_ID_FILEDATA, EBML_BIN, 0, offsetof(MatroskaAttachment, bin) },
562 { MATROSKA_ID_FILEDESC, EBML_NONE },
566 static const EbmlSyntax matroska_attachments[] = {
567 { MATROSKA_ID_ATTACHEDFILE, EBML_NEST, sizeof(MatroskaAttachment), offsetof(MatroskaDemuxContext, attachments), { .n = matroska_attachment } },
571 static const EbmlSyntax matroska_chapter_display[] = {
572 { MATROSKA_ID_CHAPSTRING, EBML_UTF8, 0, offsetof(MatroskaChapter, title) },
573 { MATROSKA_ID_CHAPLANG, EBML_NONE },
574 { MATROSKA_ID_CHAPCOUNTRY, EBML_NONE },
578 static const EbmlSyntax matroska_chapter_entry[] = {
579 { MATROSKA_ID_CHAPTERTIMESTART, EBML_UINT, 0, offsetof(MatroskaChapter, start), { .u = AV_NOPTS_VALUE } },
580 { MATROSKA_ID_CHAPTERTIMEEND, EBML_UINT, 0, offsetof(MatroskaChapter, end), { .u = AV_NOPTS_VALUE } },
581 { MATROSKA_ID_CHAPTERUID, EBML_UINT, 0, offsetof(MatroskaChapter, uid) },
582 { MATROSKA_ID_CHAPTERDISPLAY, EBML_NEST, 0, 0, { .n = matroska_chapter_display } },
583 { MATROSKA_ID_CHAPTERFLAGHIDDEN, EBML_NONE },
584 { MATROSKA_ID_CHAPTERFLAGENABLED, EBML_NONE },
585 { MATROSKA_ID_CHAPTERPHYSEQUIV, EBML_NONE },
586 { MATROSKA_ID_CHAPTERATOM, EBML_NONE },
590 static const EbmlSyntax matroska_chapter[] = {
591 { MATROSKA_ID_CHAPTERATOM, EBML_NEST, sizeof(MatroskaChapter), offsetof(MatroskaDemuxContext, chapters), { .n = matroska_chapter_entry } },
592 { MATROSKA_ID_EDITIONUID, EBML_NONE },
593 { MATROSKA_ID_EDITIONFLAGHIDDEN, EBML_NONE },
594 { MATROSKA_ID_EDITIONFLAGDEFAULT, EBML_NONE },
595 { MATROSKA_ID_EDITIONFLAGORDERED, EBML_NONE },
599 static const EbmlSyntax matroska_chapters[] = {
600 { MATROSKA_ID_EDITIONENTRY, EBML_NEST, 0, 0, { .n = matroska_chapter } },
604 static const EbmlSyntax matroska_index_pos[] = {
605 { MATROSKA_ID_CUETRACK, EBML_UINT, 0, offsetof(MatroskaIndexPos, track) },
606 { MATROSKA_ID_CUECLUSTERPOSITION, EBML_UINT, 0, offsetof(MatroskaIndexPos, pos) },
607 { MATROSKA_ID_CUERELATIVEPOSITION,EBML_NONE },
608 { MATROSKA_ID_CUEDURATION, EBML_NONE },
609 { MATROSKA_ID_CUEBLOCKNUMBER, EBML_NONE },
613 static const EbmlSyntax matroska_index_entry[] = {
614 { MATROSKA_ID_CUETIME, EBML_UINT, 0, offsetof(MatroskaIndex, time) },
615 { MATROSKA_ID_CUETRACKPOSITION, EBML_NEST, sizeof(MatroskaIndexPos), offsetof(MatroskaIndex, pos), { .n = matroska_index_pos } },
619 static const EbmlSyntax matroska_index[] = {
620 { MATROSKA_ID_POINTENTRY, EBML_NEST, sizeof(MatroskaIndex), offsetof(MatroskaDemuxContext, index), { .n = matroska_index_entry } },
624 static const EbmlSyntax matroska_simpletag[] = {
625 { MATROSKA_ID_TAGNAME, EBML_UTF8, 0, offsetof(MatroskaTag, name) },
626 { MATROSKA_ID_TAGSTRING, EBML_UTF8, 0, offsetof(MatroskaTag, string) },
627 { MATROSKA_ID_TAGLANG, EBML_STR, 0, offsetof(MatroskaTag, lang), { .s = "und" } },
628 { MATROSKA_ID_TAGDEFAULT, EBML_UINT, 0, offsetof(MatroskaTag, def) },
629 { MATROSKA_ID_TAGDEFAULT_BUG, EBML_UINT, 0, offsetof(MatroskaTag, def) },
630 { MATROSKA_ID_SIMPLETAG, EBML_NEST, sizeof(MatroskaTag), offsetof(MatroskaTag, sub), { .n = matroska_simpletag } },
634 static const EbmlSyntax matroska_tagtargets[] = {
635 { MATROSKA_ID_TAGTARGETS_TYPE, EBML_STR, 0, offsetof(MatroskaTagTarget, type) },
636 { MATROSKA_ID_TAGTARGETS_TYPEVALUE, EBML_UINT, 0, offsetof(MatroskaTagTarget, typevalue), { .u = 50 } },
637 { MATROSKA_ID_TAGTARGETS_TRACKUID, EBML_UINT, 0, offsetof(MatroskaTagTarget, trackuid) },
638 { MATROSKA_ID_TAGTARGETS_CHAPTERUID, EBML_UINT, 0, offsetof(MatroskaTagTarget, chapteruid) },
639 { MATROSKA_ID_TAGTARGETS_ATTACHUID, EBML_UINT, 0, offsetof(MatroskaTagTarget, attachuid) },
643 static const EbmlSyntax matroska_tag[] = {
644 { MATROSKA_ID_SIMPLETAG, EBML_NEST, sizeof(MatroskaTag), offsetof(MatroskaTags, tag), { .n = matroska_simpletag } },
645 { MATROSKA_ID_TAGTARGETS, EBML_NEST, 0, offsetof(MatroskaTags, target), { .n = matroska_tagtargets } },
649 static const EbmlSyntax matroska_tags[] = {
650 { MATROSKA_ID_TAG, EBML_NEST, sizeof(MatroskaTags), offsetof(MatroskaDemuxContext, tags), { .n = matroska_tag } },
654 static const EbmlSyntax matroska_seekhead_entry[] = {
655 { MATROSKA_ID_SEEKID, EBML_UINT, 0, offsetof(MatroskaSeekhead, id) },
656 { MATROSKA_ID_SEEKPOSITION, EBML_UINT, 0, offsetof(MatroskaSeekhead, pos), { .u = -1 } },
660 static const EbmlSyntax matroska_seekhead[] = {
661 { MATROSKA_ID_SEEKENTRY, EBML_NEST, sizeof(MatroskaSeekhead), offsetof(MatroskaDemuxContext, seekhead), { .n = matroska_seekhead_entry } },
665 static const EbmlSyntax matroska_segment[] = {
666 { MATROSKA_ID_INFO, EBML_LEVEL1, 0, 0, { .n = matroska_info } },
667 { MATROSKA_ID_TRACKS, EBML_LEVEL1, 0, 0, { .n = matroska_tracks } },
668 { MATROSKA_ID_ATTACHMENTS, EBML_LEVEL1, 0, 0, { .n = matroska_attachments } },
669 { MATROSKA_ID_CHAPTERS, EBML_LEVEL1, 0, 0, { .n = matroska_chapters } },
670 { MATROSKA_ID_CUES, EBML_LEVEL1, 0, 0, { .n = matroska_index } },
671 { MATROSKA_ID_TAGS, EBML_LEVEL1, 0, 0, { .n = matroska_tags } },
672 { MATROSKA_ID_SEEKHEAD, EBML_LEVEL1, 0, 0, { .n = matroska_seekhead } },
673 { MATROSKA_ID_CLUSTER, EBML_STOP },
677 static const EbmlSyntax matroska_segments[] = {
678 { MATROSKA_ID_SEGMENT, EBML_NEST, 0, 0, { .n = matroska_segment } },
682 static const EbmlSyntax matroska_blockmore[] = {
683 { MATROSKA_ID_BLOCKADDID, EBML_UINT, 0, offsetof(MatroskaBlock,additional_id) },
684 { MATROSKA_ID_BLOCKADDITIONAL, EBML_BIN, 0, offsetof(MatroskaBlock,additional) },
688 static const EbmlSyntax matroska_blockadditions[] = {
689 { MATROSKA_ID_BLOCKMORE, EBML_NEST, 0, 0, {.n = matroska_blockmore} },
693 static const EbmlSyntax matroska_blockgroup[] = {
694 { MATROSKA_ID_BLOCK, EBML_BIN, 0, offsetof(MatroskaBlock, bin) },
695 { MATROSKA_ID_BLOCKADDITIONS, EBML_NEST, 0, 0, { .n = matroska_blockadditions} },
696 { MATROSKA_ID_SIMPLEBLOCK, EBML_BIN, 0, offsetof(MatroskaBlock, bin) },
697 { MATROSKA_ID_BLOCKDURATION, EBML_UINT, 0, offsetof(MatroskaBlock, duration) },
698 { MATROSKA_ID_DISCARDPADDING, EBML_SINT, 0, offsetof(MatroskaBlock, discard_padding) },
699 { MATROSKA_ID_BLOCKREFERENCE, EBML_SINT, 0, offsetof(MatroskaBlock, reference) },
700 { MATROSKA_ID_CODECSTATE, EBML_NONE },
701 { 1, EBML_UINT, 0, offsetof(MatroskaBlock, non_simple), { .u = 1 } },
705 static const EbmlSyntax matroska_cluster[] = {
706 { MATROSKA_ID_CLUSTERTIMECODE, EBML_UINT, 0, offsetof(MatroskaCluster, timecode) },
707 { MATROSKA_ID_BLOCKGROUP, EBML_NEST, sizeof(MatroskaBlock), offsetof(MatroskaCluster, blocks), { .n = matroska_blockgroup } },
708 { MATROSKA_ID_SIMPLEBLOCK, EBML_PASS, sizeof(MatroskaBlock), offsetof(MatroskaCluster, blocks), { .n = matroska_blockgroup } },
709 { MATROSKA_ID_CLUSTERPOSITION, EBML_NONE },
710 { MATROSKA_ID_CLUSTERPREVSIZE, EBML_NONE },
714 static const EbmlSyntax matroska_clusters[] = {
715 { MATROSKA_ID_CLUSTER, EBML_NEST, 0, 0, { .n = matroska_cluster } },
716 { MATROSKA_ID_INFO, EBML_NONE },
717 { MATROSKA_ID_CUES, EBML_NONE },
718 { MATROSKA_ID_TAGS, EBML_NONE },
719 { MATROSKA_ID_SEEKHEAD, EBML_NONE },
723 static const EbmlSyntax matroska_cluster_incremental_parsing[] = {
724 { MATROSKA_ID_CLUSTERTIMECODE, EBML_UINT, 0, offsetof(MatroskaCluster, timecode) },
725 { MATROSKA_ID_BLOCKGROUP, EBML_NEST, sizeof(MatroskaBlock), offsetof(MatroskaCluster, blocks), { .n = matroska_blockgroup } },
726 { MATROSKA_ID_SIMPLEBLOCK, EBML_PASS, sizeof(MatroskaBlock), offsetof(MatroskaCluster, blocks), { .n = matroska_blockgroup } },
727 { MATROSKA_ID_CLUSTERPOSITION, EBML_NONE },
728 { MATROSKA_ID_CLUSTERPREVSIZE, EBML_NONE },
729 { MATROSKA_ID_INFO, EBML_NONE },
730 { MATROSKA_ID_CUES, EBML_NONE },
731 { MATROSKA_ID_TAGS, EBML_NONE },
732 { MATROSKA_ID_SEEKHEAD, EBML_NONE },
733 { MATROSKA_ID_CLUSTER, EBML_STOP },
737 static const EbmlSyntax matroska_cluster_incremental[] = {
738 { MATROSKA_ID_CLUSTERTIMECODE, EBML_UINT, 0, offsetof(MatroskaCluster, timecode) },
739 { MATROSKA_ID_BLOCKGROUP, EBML_STOP },
740 { MATROSKA_ID_SIMPLEBLOCK, EBML_STOP },
741 { MATROSKA_ID_CLUSTERPOSITION, EBML_NONE },
742 { MATROSKA_ID_CLUSTERPREVSIZE, EBML_NONE },
746 static const EbmlSyntax matroska_clusters_incremental[] = {
747 { MATROSKA_ID_CLUSTER, EBML_NEST, 0, 0, { .n = matroska_cluster_incremental } },
748 { MATROSKA_ID_INFO, EBML_NONE },
749 { MATROSKA_ID_CUES, EBML_NONE },
750 { MATROSKA_ID_TAGS, EBML_NONE },
751 { MATROSKA_ID_SEEKHEAD, EBML_NONE },
755 static const char *const matroska_doctypes[] = { "matroska", "webm" };
757 static int matroska_read_close(AVFormatContext *s);
759 static int matroska_resync(MatroskaDemuxContext *matroska, int64_t last_pos)
761 AVIOContext *pb = matroska->ctx->pb;
764 matroska->current_id = 0;
765 matroska->num_levels = 0;
767 /* seek to next position to resync from */
768 if ((ret = avio_seek(pb, last_pos + 1, SEEK_SET)) < 0) {
775 // try to find a toplevel element
776 while (!avio_feof(pb)) {
777 if (id == MATROSKA_ID_INFO || id == MATROSKA_ID_TRACKS ||
778 id == MATROSKA_ID_CUES || id == MATROSKA_ID_TAGS ||
779 id == MATROSKA_ID_SEEKHEAD || id == MATROSKA_ID_ATTACHMENTS ||
780 id == MATROSKA_ID_CLUSTER || id == MATROSKA_ID_CHAPTERS) {
781 matroska->current_id = id;
784 id = (id << 8) | avio_r8(pb);
792 * Return: Whether we reached the end of a level in the hierarchy or not.
794 static int ebml_level_end(MatroskaDemuxContext *matroska)
796 AVIOContext *pb = matroska->ctx->pb;
797 int64_t pos = avio_tell(pb);
799 if (matroska->num_levels > 0) {
800 MatroskaLevel *level = &matroska->levels[matroska->num_levels - 1];
801 if (pos - level->start >= level->length || matroska->current_id) {
802 matroska->num_levels--;
806 return (matroska->is_live && matroska->ctx->pb->eof_reached) ? 1 : 0;
810 * Read: an "EBML number", which is defined as a variable-length
811 * array of bytes. The first byte indicates the length by giving a
812 * number of 0-bits followed by a one. The position of the first
813 * "one" bit inside the first byte indicates the length of this
815 * Returns: number of bytes read, < 0 on error
817 static int ebml_read_num(MatroskaDemuxContext *matroska, AVIOContext *pb,
818 int max_size, uint64_t *number)
823 /* The first byte tells us the length in bytes - avio_r8() can normally
824 * return 0, but since that's not a valid first ebmlID byte, we can
825 * use it safely here to catch EOS. */
826 if (!(total = avio_r8(pb))) {
827 /* we might encounter EOS here */
828 if (!avio_feof(pb)) {
829 int64_t pos = avio_tell(pb);
830 av_log(matroska->ctx, AV_LOG_ERROR,
831 "Read error at pos. %"PRIu64" (0x%"PRIx64")\n",
833 return pb->error ? pb->error : AVERROR(EIO);
838 /* get the length of the EBML number */
839 read = 8 - ff_log2_tab[total];
840 if (read > max_size) {
841 int64_t pos = avio_tell(pb) - 1;
842 av_log(matroska->ctx, AV_LOG_ERROR,
843 "Invalid EBML number size tag 0x%02x at pos %"PRIu64" (0x%"PRIx64")\n",
844 (uint8_t) total, pos, pos);
845 return AVERROR_INVALIDDATA;
848 /* read out length */
849 total ^= 1 << ff_log2_tab[total];
851 total = (total << 8) | avio_r8(pb);
859 * Read a EBML length value.
860 * This needs special handling for the "unknown length" case which has multiple
863 static int ebml_read_length(MatroskaDemuxContext *matroska, AVIOContext *pb,
866 int res = ebml_read_num(matroska, pb, 8, number);
867 if (res > 0 && *number + 1 == 1ULL << (7 * res))
868 *number = 0xffffffffffffffULL;
873 * Read the next element as an unsigned int.
874 * 0 is success, < 0 is failure.
876 static int ebml_read_uint(AVIOContext *pb, int size, uint64_t *num)
881 return AVERROR_INVALIDDATA;
883 /* big-endian ordering; build up number */
886 *num = (*num << 8) | avio_r8(pb);
892 * Read the next element as a signed int.
893 * 0 is success, < 0 is failure.
895 static int ebml_read_sint(AVIOContext *pb, int size, int64_t *num)
900 return AVERROR_INVALIDDATA;
905 *num = sign_extend(avio_r8(pb), 8);
907 /* big-endian ordering; build up number */
909 *num = ((uint64_t)*num << 8) | avio_r8(pb);
916 * Read the next element as a float.
917 * 0 is success, < 0 is failure.
919 static int ebml_read_float(AVIOContext *pb, int size, double *num)
924 *num = av_int2float(avio_rb32(pb));
926 *num = av_int2double(avio_rb64(pb));
928 return AVERROR_INVALIDDATA;
934 * Read the next element as an ASCII string.
935 * 0 is success, < 0 is failure.
937 static int ebml_read_ascii(AVIOContext *pb, int size, char **str)
941 /* EBML strings are usually not 0-terminated, so we allocate one
942 * byte more, read the string and NULL-terminate it ourselves. */
943 if (!(res = av_malloc(size + 1)))
944 return AVERROR(ENOMEM);
945 if (avio_read(pb, (uint8_t *) res, size) != size) {
957 * Read the next element as binary data.
958 * 0 is success, < 0 is failure.
960 static int ebml_read_binary(AVIOContext *pb, int length, EbmlBin *bin)
962 av_fast_padded_malloc(&bin->data, &bin->size, length);
964 return AVERROR(ENOMEM);
967 bin->pos = avio_tell(pb);
968 if (avio_read(pb, bin->data, length) != length) {
969 av_freep(&bin->data);
978 * Read the next element, but only the header. The contents
979 * are supposed to be sub-elements which can be read separately.
980 * 0 is success, < 0 is failure.
982 static int ebml_read_master(MatroskaDemuxContext *matroska, uint64_t length)
984 AVIOContext *pb = matroska->ctx->pb;
985 MatroskaLevel *level;
987 if (matroska->num_levels >= EBML_MAX_DEPTH) {
988 av_log(matroska->ctx, AV_LOG_ERROR,
989 "File moves beyond max. allowed depth (%d)\n", EBML_MAX_DEPTH);
990 return AVERROR(ENOSYS);
993 level = &matroska->levels[matroska->num_levels++];
994 level->start = avio_tell(pb);
995 level->length = length;
1001 * Read signed/unsigned "EBML" numbers.
1002 * Return: number of bytes processed, < 0 on error
1004 static int matroska_ebmlnum_uint(MatroskaDemuxContext *matroska,
1005 uint8_t *data, uint32_t size, uint64_t *num)
1008 ffio_init_context(&pb, data, size, 0, NULL, NULL, NULL, NULL);
1009 return ebml_read_num(matroska, &pb, FFMIN(size, 8), num);
1013 * Same as above, but signed.
1015 static int matroska_ebmlnum_sint(MatroskaDemuxContext *matroska,
1016 uint8_t *data, uint32_t size, int64_t *num)
1021 /* read as unsigned number first */
1022 if ((res = matroska_ebmlnum_uint(matroska, data, size, &unum)) < 0)
1025 /* make signed (weird way) */
1026 *num = unum - ((1LL << (7 * res - 1)) - 1);
1031 static int ebml_parse_elem(MatroskaDemuxContext *matroska,
1032 EbmlSyntax *syntax, void *data);
1034 static int ebml_parse_id(MatroskaDemuxContext *matroska, EbmlSyntax *syntax,
1035 uint32_t id, void *data)
1038 for (i = 0; syntax[i].id; i++)
1039 if (id == syntax[i].id)
1041 if (!syntax[i].id && id == MATROSKA_ID_CLUSTER &&
1042 matroska->num_levels > 0 &&
1043 matroska->levels[matroska->num_levels - 1].length == 0xffffffffffffff)
1044 return 0; // we reached the end of an unknown size cluster
1045 if (!syntax[i].id && id != EBML_ID_VOID && id != EBML_ID_CRC32) {
1046 av_log(matroska->ctx, AV_LOG_DEBUG, "Unknown entry 0x%"PRIX32"\n", id);
1048 return ebml_parse_elem(matroska, &syntax[i], data);
1051 static int ebml_parse(MatroskaDemuxContext *matroska, EbmlSyntax *syntax,
1054 if (!matroska->current_id) {
1056 int res = ebml_read_num(matroska, matroska->ctx->pb, 4, &id);
1058 // in live mode, finish parsing if EOF is reached.
1059 return (matroska->is_live && matroska->ctx->pb->eof_reached &&
1060 res == AVERROR_EOF) ? 1 : res;
1062 matroska->current_id = id | 1 << 7 * res;
1064 return ebml_parse_id(matroska, syntax, matroska->current_id, data);
1067 static int ebml_parse_nest(MatroskaDemuxContext *matroska, EbmlSyntax *syntax,
1072 for (i = 0; syntax[i].id; i++)
1073 switch (syntax[i].type) {
1075 *(uint64_t *) ((char *) data + syntax[i].data_offset) = syntax[i].def.u;
1078 *(double *) ((char *) data + syntax[i].data_offset) = syntax[i].def.f;
1082 // the default may be NULL
1083 if (syntax[i].def.s) {
1084 uint8_t **dst = (uint8_t **) ((uint8_t *) data + syntax[i].data_offset);
1085 *dst = av_strdup(syntax[i].def.s);
1087 return AVERROR(ENOMEM);
1092 while (!res && !ebml_level_end(matroska))
1093 res = ebml_parse(matroska, syntax, data);
1098 static int is_ebml_id_valid(uint32_t id)
1100 // Due to endian nonsense in Matroska, the highest byte with any bits set
1101 // will contain the leading length bit. This bit in turn identifies the
1102 // total byte length of the element by its position within the byte.
1103 unsigned int bits = av_log2(id);
1104 return id && (bits + 7) / 8 == (8 - bits % 8);
1108 * Allocate and return the entry for the level1 element with the given ID. If
1109 * an entry already exists, return the existing entry.
1111 static MatroskaLevel1Element *matroska_find_level1_elem(MatroskaDemuxContext *matroska,
1115 MatroskaLevel1Element *elem;
1117 if (!is_ebml_id_valid(id))
1120 // Some files link to all clusters; useless.
1121 if (id == MATROSKA_ID_CLUSTER)
1124 // There can be multiple seekheads.
1125 if (id != MATROSKA_ID_SEEKHEAD) {
1126 for (i = 0; i < matroska->num_level1_elems; i++) {
1127 if (matroska->level1_elems[i].id == id)
1128 return &matroska->level1_elems[i];
1132 // Only a completely broken file would have more elements.
1133 // It also provides a low-effort way to escape from circular seekheads
1134 // (every iteration will add a level1 entry).
1135 if (matroska->num_level1_elems >= FF_ARRAY_ELEMS(matroska->level1_elems)) {
1136 av_log(matroska->ctx, AV_LOG_ERROR, "Too many level1 elements or circular seekheads.\n");
1140 elem = &matroska->level1_elems[matroska->num_level1_elems++];
1141 *elem = (MatroskaLevel1Element){.id = id};
1146 static int ebml_parse_elem(MatroskaDemuxContext *matroska,
1147 EbmlSyntax *syntax, void *data)
1149 static const uint64_t max_lengths[EBML_TYPE_COUNT] = {
1152 // max. 16 MB for strings
1153 [EBML_STR] = 0x1000000,
1154 [EBML_UTF8] = 0x1000000,
1155 // max. 256 MB for binary data
1156 [EBML_BIN] = 0x10000000,
1157 // no limits for anything else
1159 AVIOContext *pb = matroska->ctx->pb;
1160 uint32_t id = syntax->id;
1164 MatroskaLevel1Element *level1_elem;
1166 data = (char *) data + syntax->data_offset;
1167 if (syntax->list_elem_size) {
1168 EbmlList *list = data;
1169 newelem = av_realloc_array(list->elem, list->nb_elem + 1, syntax->list_elem_size);
1171 return AVERROR(ENOMEM);
1172 list->elem = newelem;
1173 data = (char *) list->elem + list->nb_elem * syntax->list_elem_size;
1174 memset(data, 0, syntax->list_elem_size);
1178 if (syntax->type != EBML_PASS && syntax->type != EBML_STOP) {
1179 matroska->current_id = 0;
1180 if ((res = ebml_read_length(matroska, pb, &length)) < 0)
1182 if (max_lengths[syntax->type] && length > max_lengths[syntax->type]) {
1183 av_log(matroska->ctx, AV_LOG_ERROR,
1184 "Invalid length 0x%"PRIx64" > 0x%"PRIx64" for syntax element %i\n",
1185 length, max_lengths[syntax->type], syntax->type);
1186 return AVERROR_INVALIDDATA;
1190 switch (syntax->type) {
1192 res = ebml_read_uint(pb, length, data);
1195 res = ebml_read_sint(pb, length, data);
1198 res = ebml_read_float(pb, length, data);
1202 res = ebml_read_ascii(pb, length, data);
1205 res = ebml_read_binary(pb, length, data);
1209 if ((res = ebml_read_master(matroska, length)) < 0)
1211 if (id == MATROSKA_ID_SEGMENT)
1212 matroska->segment_start = avio_tell(matroska->ctx->pb);
1213 if (id == MATROSKA_ID_CUES)
1214 matroska->cues_parsing_deferred = 0;
1215 if (syntax->type == EBML_LEVEL1 &&
1216 (level1_elem = matroska_find_level1_elem(matroska, syntax->id))) {
1217 if (level1_elem->parsed)
1218 av_log(matroska->ctx, AV_LOG_ERROR, "Duplicate element\n");
1219 level1_elem->parsed = 1;
1221 return ebml_parse_nest(matroska, syntax->def.n, data);
1223 return ebml_parse_id(matroska, syntax->def.n, id, data);
1227 if (ffio_limit(pb, length) != length)
1228 return AVERROR(EIO);
1229 return avio_skip(pb, length) < 0 ? AVERROR(EIO) : 0;
1231 if (res == AVERROR_INVALIDDATA)
1232 av_log(matroska->ctx, AV_LOG_ERROR, "Invalid element\n");
1233 else if (res == AVERROR(EIO))
1234 av_log(matroska->ctx, AV_LOG_ERROR, "Read error\n");
1238 static void ebml_free(EbmlSyntax *syntax, void *data)
1241 for (i = 0; syntax[i].id; i++) {
1242 void *data_off = (char *) data + syntax[i].data_offset;
1243 switch (syntax[i].type) {
1249 av_freep(&((EbmlBin *) data_off)->data);
1253 if (syntax[i].list_elem_size) {
1254 EbmlList *list = data_off;
1255 char *ptr = list->elem;
1256 for (j = 0; j < list->nb_elem;
1257 j++, ptr += syntax[i].list_elem_size)
1258 ebml_free(syntax[i].def.n, ptr);
1259 av_freep(&list->elem);
1262 ebml_free(syntax[i].def.n, data_off);
1272 static int matroska_probe(AVProbeData *p)
1275 int len_mask = 0x80, size = 1, n = 1, i;
1278 if (AV_RB32(p->buf) != EBML_ID_HEADER)
1281 /* length of header */
1283 while (size <= 8 && !(total & len_mask)) {
1289 total &= (len_mask - 1);
1291 total = (total << 8) | p->buf[4 + n++];
1293 /* Does the probe data contain the whole header? */
1294 if (p->buf_size < 4 + size + total)
1297 /* The header should contain a known document type. For now,
1298 * we don't parse the whole header but simply check for the
1299 * availability of that array of characters inside the header.
1300 * Not fully fool-proof, but good enough. */
1301 for (i = 0; i < FF_ARRAY_ELEMS(matroska_doctypes); i++) {
1302 size_t probelen = strlen(matroska_doctypes[i]);
1303 if (total < probelen)
1305 for (n = 4 + size; n <= 4 + size + total - probelen; n++)
1306 if (!memcmp(p->buf + n, matroska_doctypes[i], probelen))
1307 return AVPROBE_SCORE_MAX;
1310 // probably valid EBML header but no recognized doctype
1311 return AVPROBE_SCORE_EXTENSION;
1314 static MatroskaTrack *matroska_find_track_by_num(MatroskaDemuxContext *matroska,
1317 MatroskaTrack *tracks = matroska->tracks.elem;
1320 for (i = 0; i < matroska->tracks.nb_elem; i++)
1321 if (tracks[i].num == num)
1324 av_log(matroska->ctx, AV_LOG_ERROR, "Invalid track number %d\n", num);
1328 static int matroska_decode_buffer(uint8_t **buf, int *buf_size,
1329 MatroskaTrack *track)
1331 MatroskaTrackEncoding *encodings = track->encodings.elem;
1332 uint8_t *data = *buf;
1333 int isize = *buf_size;
1334 uint8_t *pkt_data = NULL;
1335 uint8_t av_unused *newpktdata;
1336 int pkt_size = isize;
1340 if (pkt_size >= 10000000U)
1341 return AVERROR_INVALIDDATA;
1343 switch (encodings[0].compression.algo) {
1344 case MATROSKA_TRACK_ENCODING_COMP_HEADERSTRIP:
1346 int header_size = encodings[0].compression.settings.size;
1347 uint8_t *header = encodings[0].compression.settings.data;
1349 if (header_size && !header) {
1350 av_log(NULL, AV_LOG_ERROR, "Compression size but no data in headerstrip\n");
1357 pkt_size = isize + header_size;
1358 pkt_data = av_malloc(pkt_size);
1360 return AVERROR(ENOMEM);
1362 memcpy(pkt_data, header, header_size);
1363 memcpy(pkt_data + header_size, data, isize);
1367 case MATROSKA_TRACK_ENCODING_COMP_LZO:
1369 olen = pkt_size *= 3;
1370 newpktdata = av_realloc(pkt_data, pkt_size + AV_LZO_OUTPUT_PADDING);
1372 result = AVERROR(ENOMEM);
1375 pkt_data = newpktdata;
1376 result = av_lzo1x_decode(pkt_data, &olen, data, &isize);
1377 } while (result == AV_LZO_OUTPUT_FULL && pkt_size < 10000000);
1379 result = AVERROR_INVALIDDATA;
1386 case MATROSKA_TRACK_ENCODING_COMP_ZLIB:
1388 z_stream zstream = { 0 };
1389 if (inflateInit(&zstream) != Z_OK)
1391 zstream.next_in = data;
1392 zstream.avail_in = isize;
1395 newpktdata = av_realloc(pkt_data, pkt_size);
1397 inflateEnd(&zstream);
1398 result = AVERROR(ENOMEM);
1401 pkt_data = newpktdata;
1402 zstream.avail_out = pkt_size - zstream.total_out;
1403 zstream.next_out = pkt_data + zstream.total_out;
1404 result = inflate(&zstream, Z_NO_FLUSH);
1405 } while (result == Z_OK && pkt_size < 10000000);
1406 pkt_size = zstream.total_out;
1407 inflateEnd(&zstream);
1408 if (result != Z_STREAM_END) {
1409 if (result == Z_MEM_ERROR)
1410 result = AVERROR(ENOMEM);
1412 result = AVERROR_INVALIDDATA;
1419 case MATROSKA_TRACK_ENCODING_COMP_BZLIB:
1421 bz_stream bzstream = { 0 };
1422 if (BZ2_bzDecompressInit(&bzstream, 0, 0) != BZ_OK)
1424 bzstream.next_in = data;
1425 bzstream.avail_in = isize;
1428 newpktdata = av_realloc(pkt_data, pkt_size);
1430 BZ2_bzDecompressEnd(&bzstream);
1431 result = AVERROR(ENOMEM);
1434 pkt_data = newpktdata;
1435 bzstream.avail_out = pkt_size - bzstream.total_out_lo32;
1436 bzstream.next_out = pkt_data + bzstream.total_out_lo32;
1437 result = BZ2_bzDecompress(&bzstream);
1438 } while (result == BZ_OK && pkt_size < 10000000);
1439 pkt_size = bzstream.total_out_lo32;
1440 BZ2_bzDecompressEnd(&bzstream);
1441 if (result != BZ_STREAM_END) {
1442 if (result == BZ_MEM_ERROR)
1443 result = AVERROR(ENOMEM);
1445 result = AVERROR_INVALIDDATA;
1452 return AVERROR_INVALIDDATA;
1456 *buf_size = pkt_size;
1464 static void matroska_convert_tag(AVFormatContext *s, EbmlList *list,
1465 AVDictionary **metadata, char *prefix)
1467 MatroskaTag *tags = list->elem;
1471 for (i = 0; i < list->nb_elem; i++) {
1472 const char *lang = tags[i].lang &&
1473 strcmp(tags[i].lang, "und") ? tags[i].lang : NULL;
1475 if (!tags[i].name) {
1476 av_log(s, AV_LOG_WARNING, "Skipping invalid tag with no TagName.\n");
1480 snprintf(key, sizeof(key), "%s/%s", prefix, tags[i].name);
1482 av_strlcpy(key, tags[i].name, sizeof(key));
1483 if (tags[i].def || !lang) {
1484 av_dict_set(metadata, key, tags[i].string, 0);
1485 if (tags[i].sub.nb_elem)
1486 matroska_convert_tag(s, &tags[i].sub, metadata, key);
1489 av_strlcat(key, "-", sizeof(key));
1490 av_strlcat(key, lang, sizeof(key));
1491 av_dict_set(metadata, key, tags[i].string, 0);
1492 if (tags[i].sub.nb_elem)
1493 matroska_convert_tag(s, &tags[i].sub, metadata, key);
1496 ff_metadata_conv(metadata, NULL, ff_mkv_metadata_conv);
1499 static void matroska_convert_tags(AVFormatContext *s)
1501 MatroskaDemuxContext *matroska = s->priv_data;
1502 MatroskaTags *tags = matroska->tags.elem;
1505 for (i = 0; i < matroska->tags.nb_elem; i++) {
1506 if (tags[i].target.attachuid) {
1507 MatroskaAttachment *attachment = matroska->attachments.elem;
1509 for (j = 0; j < matroska->attachments.nb_elem; j++) {
1510 if (attachment[j].uid == tags[i].target.attachuid &&
1511 attachment[j].stream) {
1512 matroska_convert_tag(s, &tags[i].tag,
1513 &attachment[j].stream->metadata, NULL);
1518 av_log(NULL, AV_LOG_WARNING,
1519 "The tags at index %d refer to a "
1520 "non-existent attachment %"PRId64".\n",
1521 i, tags[i].target.attachuid);
1523 } else if (tags[i].target.chapteruid) {
1524 MatroskaChapter *chapter = matroska->chapters.elem;
1526 for (j = 0; j < matroska->chapters.nb_elem; j++) {
1527 if (chapter[j].uid == tags[i].target.chapteruid &&
1528 chapter[j].chapter) {
1529 matroska_convert_tag(s, &tags[i].tag,
1530 &chapter[j].chapter->metadata, NULL);
1535 av_log(NULL, AV_LOG_WARNING,
1536 "The tags at index %d refer to a non-existent chapter "
1538 i, tags[i].target.chapteruid);
1540 } else if (tags[i].target.trackuid) {
1541 MatroskaTrack *track = matroska->tracks.elem;
1543 for (j = 0; j < matroska->tracks.nb_elem; j++) {
1544 if (track[j].uid == tags[i].target.trackuid &&
1546 matroska_convert_tag(s, &tags[i].tag,
1547 &track[j].stream->metadata, NULL);
1552 av_log(NULL, AV_LOG_WARNING,
1553 "The tags at index %d refer to a non-existent track "
1555 i, tags[i].target.trackuid);
1558 matroska_convert_tag(s, &tags[i].tag, &s->metadata,
1559 tags[i].target.type);
1564 static int matroska_parse_seekhead_entry(MatroskaDemuxContext *matroska,
1567 uint32_t level_up = matroska->level_up;
1568 uint32_t saved_id = matroska->current_id;
1569 int64_t before_pos = avio_tell(matroska->ctx->pb);
1570 MatroskaLevel level;
1575 offset = pos + matroska->segment_start;
1576 if (avio_seek(matroska->ctx->pb, offset, SEEK_SET) == offset) {
1577 /* We don't want to lose our seekhead level, so we add
1578 * a dummy. This is a crude hack. */
1579 if (matroska->num_levels == EBML_MAX_DEPTH) {
1580 av_log(matroska->ctx, AV_LOG_INFO,
1581 "Max EBML element depth (%d) reached, "
1582 "cannot parse further.\n", EBML_MAX_DEPTH);
1583 ret = AVERROR_INVALIDDATA;
1586 level.length = (uint64_t) -1;
1587 matroska->levels[matroska->num_levels] = level;
1588 matroska->num_levels++;
1589 matroska->current_id = 0;
1591 ret = ebml_parse(matroska, matroska_segment, matroska);
1593 /* remove dummy level */
1594 while (matroska->num_levels) {
1595 uint64_t length = matroska->levels[--matroska->num_levels].length;
1596 if (length == (uint64_t) -1)
1602 avio_seek(matroska->ctx->pb, before_pos, SEEK_SET);
1603 matroska->level_up = level_up;
1604 matroska->current_id = saved_id;
1609 static void matroska_execute_seekhead(MatroskaDemuxContext *matroska)
1611 EbmlList *seekhead_list = &matroska->seekhead;
1614 // we should not do any seeking in the streaming case
1615 if (!matroska->ctx->pb->seekable)
1618 for (i = 0; i < seekhead_list->nb_elem; i++) {
1619 MatroskaSeekhead *seekheads = seekhead_list->elem;
1620 uint32_t id = seekheads[i].id;
1621 uint64_t pos = seekheads[i].pos;
1623 MatroskaLevel1Element *elem = matroska_find_level1_elem(matroska, id);
1624 if (!elem || elem->parsed)
1629 // defer cues parsing until we actually need cue data.
1630 if (id == MATROSKA_ID_CUES)
1633 if (matroska_parse_seekhead_entry(matroska, pos) < 0) {
1634 // mark index as broken
1635 matroska->cues_parsing_deferred = -1;
1643 static void matroska_add_index_entries(MatroskaDemuxContext *matroska)
1645 EbmlList *index_list;
1646 MatroskaIndex *index;
1647 uint64_t index_scale = 1;
1650 if (matroska->ctx->flags & AVFMT_FLAG_IGNIDX)
1653 index_list = &matroska->index;
1654 index = index_list->elem;
1655 if (index_list->nb_elem < 2)
1657 if (index[1].time > 1E14 / matroska->time_scale) {
1658 av_log(matroska->ctx, AV_LOG_WARNING, "Dropping apparently-broken index.\n");
1661 for (i = 0; i < index_list->nb_elem; i++) {
1662 EbmlList *pos_list = &index[i].pos;
1663 MatroskaIndexPos *pos = pos_list->elem;
1664 for (j = 0; j < pos_list->nb_elem; j++) {
1665 MatroskaTrack *track = matroska_find_track_by_num(matroska,
1667 if (track && track->stream)
1668 av_add_index_entry(track->stream,
1669 pos[j].pos + matroska->segment_start,
1670 index[i].time / index_scale, 0, 0,
1676 static void matroska_parse_cues(MatroskaDemuxContext *matroska) {
1679 if (matroska->ctx->flags & AVFMT_FLAG_IGNIDX)
1682 for (i = 0; i < matroska->num_level1_elems; i++) {
1683 MatroskaLevel1Element *elem = &matroska->level1_elems[i];
1684 if (elem->id == MATROSKA_ID_CUES && !elem->parsed) {
1685 if (matroska_parse_seekhead_entry(matroska, elem->pos) < 0)
1686 matroska->cues_parsing_deferred = -1;
1692 matroska_add_index_entries(matroska);
1695 static int matroska_aac_profile(char *codec_id)
1697 static const char *const aac_profiles[] = { "MAIN", "LC", "SSR" };
1700 for (profile = 0; profile < FF_ARRAY_ELEMS(aac_profiles); profile++)
1701 if (strstr(codec_id, aac_profiles[profile]))
1706 static int matroska_aac_sri(int samplerate)
1710 for (sri = 0; sri < FF_ARRAY_ELEMS(avpriv_mpeg4audio_sample_rates); sri++)
1711 if (avpriv_mpeg4audio_sample_rates[sri] == samplerate)
1716 static void matroska_metadata_creation_time(AVDictionary **metadata, int64_t date_utc)
1718 /* Convert to seconds and adjust by number of seconds between 2001-01-01 and Epoch */
1719 avpriv_dict_set_timestamp(metadata, "creation_time", date_utc / 1000 + 978307200000000LL);
1722 static int matroska_parse_flac(AVFormatContext *s,
1723 MatroskaTrack *track,
1726 AVStream *st = track->stream;
1727 uint8_t *p = track->codec_priv.data;
1728 int size = track->codec_priv.size;
1730 if (size < 8 + FLAC_STREAMINFO_SIZE || p[4] & 0x7f) {
1731 av_log(s, AV_LOG_WARNING, "Invalid FLAC private data\n");
1732 track->codec_priv.size = 0;
1736 track->codec_priv.size = 8 + FLAC_STREAMINFO_SIZE;
1738 p += track->codec_priv.size;
1739 size -= track->codec_priv.size;
1741 /* parse the remaining metadata blocks if present */
1743 int block_last, block_type, block_size;
1745 flac_parse_block_header(p, &block_last, &block_type, &block_size);
1749 if (block_size > size)
1752 /* check for the channel mask */
1753 if (block_type == FLAC_METADATA_TYPE_VORBIS_COMMENT) {
1754 AVDictionary *dict = NULL;
1755 AVDictionaryEntry *chmask;
1757 ff_vorbis_comment(s, &dict, p, block_size, 0);
1758 chmask = av_dict_get(dict, "WAVEFORMATEXTENSIBLE_CHANNEL_MASK", NULL, 0);
1760 uint64_t mask = strtol(chmask->value, NULL, 0);
1761 if (!mask || mask & ~0x3ffffULL) {
1762 av_log(s, AV_LOG_WARNING,
1763 "Invalid value of WAVEFORMATEXTENSIBLE_CHANNEL_MASK\n");
1765 st->codecpar->channel_layout = mask;
1767 av_dict_free(&dict);
1777 static int mkv_field_order(MatroskaDemuxContext *matroska, int64_t field_order)
1779 int major, minor, micro, bttb = 0;
1781 /* workaround a bug in our Matroska muxer, introduced in version 57.36 alongside
1782 * this function, and fixed in 57.52 */
1783 if (matroska->muxingapp && sscanf(matroska->muxingapp, "Lavf%d.%d.%d", &major, &minor, µ) == 3)
1784 bttb = (major == 57 && minor >= 36 && minor <= 51 && micro >= 100);
1786 switch (field_order) {
1787 case MATROSKA_VIDEO_FIELDORDER_PROGRESSIVE:
1788 return AV_FIELD_PROGRESSIVE;
1789 case MATROSKA_VIDEO_FIELDORDER_UNDETERMINED:
1790 return AV_FIELD_UNKNOWN;
1791 case MATROSKA_VIDEO_FIELDORDER_TT:
1793 case MATROSKA_VIDEO_FIELDORDER_BB:
1795 case MATROSKA_VIDEO_FIELDORDER_BT:
1796 return bttb ? AV_FIELD_TB : AV_FIELD_BT;
1797 case MATROSKA_VIDEO_FIELDORDER_TB:
1798 return bttb ? AV_FIELD_BT : AV_FIELD_TB;
1800 return AV_FIELD_UNKNOWN;
1804 static void mkv_stereo_mode_display_mul(int stereo_mode,
1805 int *h_width, int *h_height)
1807 switch (stereo_mode) {
1808 case MATROSKA_VIDEO_STEREOMODE_TYPE_MONO:
1809 case MATROSKA_VIDEO_STEREOMODE_TYPE_CHECKERBOARD_RL:
1810 case MATROSKA_VIDEO_STEREOMODE_TYPE_CHECKERBOARD_LR:
1811 case MATROSKA_VIDEO_STEREOMODE_TYPE_BOTH_EYES_BLOCK_RL:
1812 case MATROSKA_VIDEO_STEREOMODE_TYPE_BOTH_EYES_BLOCK_LR:
1814 case MATROSKA_VIDEO_STEREOMODE_TYPE_RIGHT_LEFT:
1815 case MATROSKA_VIDEO_STEREOMODE_TYPE_LEFT_RIGHT:
1816 case MATROSKA_VIDEO_STEREOMODE_TYPE_COL_INTERLEAVED_RL:
1817 case MATROSKA_VIDEO_STEREOMODE_TYPE_COL_INTERLEAVED_LR:
1820 case MATROSKA_VIDEO_STEREOMODE_TYPE_BOTTOM_TOP:
1821 case MATROSKA_VIDEO_STEREOMODE_TYPE_TOP_BOTTOM:
1822 case MATROSKA_VIDEO_STEREOMODE_TYPE_ROW_INTERLEAVED_RL:
1823 case MATROSKA_VIDEO_STEREOMODE_TYPE_ROW_INTERLEAVED_LR:
1829 static int mkv_parse_video_color(AVStream *st, const MatroskaTrack *track) {
1830 const MatroskaMasteringMeta* mastering_meta =
1831 &track->video.color.mastering_meta;
1832 // Mastering primaries are CIE 1931 coords, and must be > 0.
1833 const int has_mastering_primaries =
1834 mastering_meta->r_x > 0 && mastering_meta->r_y > 0 &&
1835 mastering_meta->g_x > 0 && mastering_meta->g_y > 0 &&
1836 mastering_meta->b_x > 0 && mastering_meta->b_y > 0 &&
1837 mastering_meta->white_x > 0 && mastering_meta->white_y > 0;
1838 const int has_mastering_luminance = mastering_meta->max_luminance > 0;
1840 if (track->video.color.matrix_coefficients != AVCOL_SPC_RESERVED)
1841 st->codecpar->color_space = track->video.color.matrix_coefficients;
1842 if (track->video.color.primaries != AVCOL_PRI_RESERVED &&
1843 track->video.color.primaries != AVCOL_PRI_RESERVED0)
1844 st->codecpar->color_primaries = track->video.color.primaries;
1845 if (track->video.color.transfer_characteristics != AVCOL_TRC_RESERVED &&
1846 track->video.color.transfer_characteristics != AVCOL_TRC_RESERVED0)
1847 st->codecpar->color_trc = track->video.color.transfer_characteristics;
1848 if (track->video.color.range != AVCOL_RANGE_UNSPECIFIED &&
1849 track->video.color.range <= AVCOL_RANGE_JPEG)
1850 st->codecpar->color_range = track->video.color.range;
1851 if (track->video.color.chroma_siting_horz != MATROSKA_COLOUR_CHROMASITINGHORZ_UNDETERMINED &&
1852 track->video.color.chroma_siting_vert != MATROSKA_COLOUR_CHROMASITINGVERT_UNDETERMINED &&
1853 track->video.color.chroma_siting_horz < MATROSKA_COLOUR_CHROMASITINGHORZ_NB &&
1854 track->video.color.chroma_siting_vert < MATROSKA_COLOUR_CHROMASITINGVERT_NB) {
1855 st->codecpar->chroma_location =
1856 avcodec_chroma_pos_to_enum((track->video.color.chroma_siting_horz - 1) << 7,
1857 (track->video.color.chroma_siting_vert - 1) << 7);
1860 if (has_mastering_primaries || has_mastering_luminance) {
1861 // Use similar rationals as other standards.
1862 const int chroma_den = 50000;
1863 const int luma_den = 10000;
1864 AVMasteringDisplayMetadata *metadata =
1865 (AVMasteringDisplayMetadata*) av_stream_new_side_data(
1866 st, AV_PKT_DATA_MASTERING_DISPLAY_METADATA,
1867 sizeof(AVMasteringDisplayMetadata));
1869 return AVERROR(ENOMEM);
1871 memset(metadata, 0, sizeof(AVMasteringDisplayMetadata));
1872 if (has_mastering_primaries) {
1873 metadata->display_primaries[0][0] = av_make_q(
1874 round(mastering_meta->r_x * chroma_den), chroma_den);
1875 metadata->display_primaries[0][1] = av_make_q(
1876 round(mastering_meta->r_y * chroma_den), chroma_den);
1877 metadata->display_primaries[1][0] = av_make_q(
1878 round(mastering_meta->g_x * chroma_den), chroma_den);
1879 metadata->display_primaries[1][1] = av_make_q(
1880 round(mastering_meta->g_y * chroma_den), chroma_den);
1881 metadata->display_primaries[2][0] = av_make_q(
1882 round(mastering_meta->b_x * chroma_den), chroma_den);
1883 metadata->display_primaries[2][1] = av_make_q(
1884 round(mastering_meta->b_y * chroma_den), chroma_den);
1885 metadata->white_point[0] = av_make_q(
1886 round(mastering_meta->white_x * chroma_den), chroma_den);
1887 metadata->white_point[1] = av_make_q(
1888 round(mastering_meta->white_y * chroma_den), chroma_den);
1889 metadata->has_primaries = 1;
1891 if (has_mastering_luminance) {
1892 metadata->max_luminance = av_make_q(
1893 round(mastering_meta->max_luminance * luma_den), luma_den);
1894 metadata->min_luminance = av_make_q(
1895 round(mastering_meta->min_luminance * luma_den), luma_den);
1896 metadata->has_luminance = 1;
1902 static int mkv_parse_video_projection(AVStream *st, const MatroskaTrack *track) {
1903 AVSphericalMapping *spherical;
1904 enum AVSphericalProjection projection;
1905 size_t spherical_size;
1908 switch (track->video.projection.type) {
1909 case MATROSKA_VIDEO_PROJECTION_TYPE_EQUIRECTANGULAR:
1910 if (track->video.projection.private.size < 4)
1911 return AVERROR_INVALIDDATA;
1912 projection = AV_SPHERICAL_EQUIRECTANGULAR;
1914 case MATROSKA_VIDEO_PROJECTION_TYPE_CUBEMAP:
1915 if (track->video.projection.private.size < 4)
1916 return AVERROR_INVALIDDATA;
1917 projection = AV_SPHERICAL_CUBEMAP;
1923 spherical = av_spherical_alloc(&spherical_size);
1925 return AVERROR(ENOMEM);
1926 spherical->projection = projection;
1928 spherical->yaw = (int32_t)(track->video.projection.yaw * (1 << 16));
1929 spherical->pitch = (int32_t)(track->video.projection.pitch * (1 << 16));
1930 spherical->roll = (int32_t)(track->video.projection.roll * (1 << 16));
1932 ret = av_stream_add_side_data(st, AV_PKT_DATA_SPHERICAL, (uint8_t *)spherical,
1940 static int get_qt_codec(MatroskaTrack *track, uint32_t *fourcc, enum AVCodecID *codec_id)
1942 const AVCodecTag *codec_tags;
1944 codec_tags = track->type == MATROSKA_TRACK_TYPE_VIDEO ?
1945 ff_codec_movvideo_tags : ff_codec_movaudio_tags;
1947 /* Normalize noncompliant private data that starts with the fourcc
1948 * by expanding/shifting the data by 4 bytes and storing the data
1949 * size at the start. */
1950 if (ff_codec_get_id(codec_tags, AV_RL32(track->codec_priv.data))) {
1951 uint8_t *p = av_realloc(track->codec_priv.data,
1952 track->codec_priv.size + 4);
1954 return AVERROR(ENOMEM);
1955 memmove(p + 4, p, track->codec_priv.size);
1956 track->codec_priv.data = p;
1957 track->codec_priv.size += 4;
1958 AV_WB32(track->codec_priv.data, track->codec_priv.size);
1961 *fourcc = AV_RL32(track->codec_priv.data + 4);
1962 *codec_id = ff_codec_get_id(codec_tags, *fourcc);
1967 static int matroska_parse_tracks(AVFormatContext *s)
1969 MatroskaDemuxContext *matroska = s->priv_data;
1970 MatroskaTrack *tracks = matroska->tracks.elem;
1975 for (i = 0; i < matroska->tracks.nb_elem; i++) {
1976 MatroskaTrack *track = &tracks[i];
1977 enum AVCodecID codec_id = AV_CODEC_ID_NONE;
1978 EbmlList *encodings_list = &track->encodings;
1979 MatroskaTrackEncoding *encodings = encodings_list->elem;
1980 uint8_t *extradata = NULL;
1981 int extradata_size = 0;
1982 int extradata_offset = 0;
1983 uint32_t fourcc = 0;
1985 char* key_id_base64 = NULL;
1988 /* Apply some sanity checks. */
1989 if (track->type != MATROSKA_TRACK_TYPE_VIDEO &&
1990 track->type != MATROSKA_TRACK_TYPE_AUDIO &&
1991 track->type != MATROSKA_TRACK_TYPE_SUBTITLE &&
1992 track->type != MATROSKA_TRACK_TYPE_METADATA) {
1993 av_log(matroska->ctx, AV_LOG_INFO,
1994 "Unknown or unsupported track type %"PRIu64"\n",
1998 if (!track->codec_id)
2001 if (track->audio.samplerate < 0 || track->audio.samplerate > INT_MAX ||
2002 isnan(track->audio.samplerate)) {
2003 av_log(matroska->ctx, AV_LOG_WARNING,
2004 "Invalid sample rate %f, defaulting to 8000 instead.\n",
2005 track->audio.samplerate);
2006 track->audio.samplerate = 8000;
2009 if (track->type == MATROSKA_TRACK_TYPE_VIDEO) {
2010 if (!track->default_duration && track->video.frame_rate > 0)
2011 track->default_duration = 1000000000 / track->video.frame_rate;
2012 if (track->video.display_width == -1)
2013 track->video.display_width = track->video.pixel_width;
2014 if (track->video.display_height == -1)
2015 track->video.display_height = track->video.pixel_height;
2016 if (track->video.color_space.size == 4)
2017 fourcc = AV_RL32(track->video.color_space.data);
2018 } else if (track->type == MATROSKA_TRACK_TYPE_AUDIO) {
2019 if (!track->audio.out_samplerate)
2020 track->audio.out_samplerate = track->audio.samplerate;
2022 if (encodings_list->nb_elem > 1) {
2023 av_log(matroska->ctx, AV_LOG_ERROR,
2024 "Multiple combined encodings not supported");
2025 } else if (encodings_list->nb_elem == 1) {
2026 if (encodings[0].type) {
2027 if (encodings[0].encryption.key_id.size > 0) {
2028 /* Save the encryption key id to be stored later as a
2030 const int b64_size = AV_BASE64_SIZE(encodings[0].encryption.key_id.size);
2031 key_id_base64 = av_malloc(b64_size);
2032 if (key_id_base64 == NULL)
2033 return AVERROR(ENOMEM);
2035 av_base64_encode(key_id_base64, b64_size,
2036 encodings[0].encryption.key_id.data,
2037 encodings[0].encryption.key_id.size);
2039 encodings[0].scope = 0;
2040 av_log(matroska->ctx, AV_LOG_ERROR,
2041 "Unsupported encoding type");
2045 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_ZLIB &&
2048 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_BZLIB &&
2051 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_LZO &&
2053 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_HEADERSTRIP) {
2054 encodings[0].scope = 0;
2055 av_log(matroska->ctx, AV_LOG_ERROR,
2056 "Unsupported encoding type");
2057 } else if (track->codec_priv.size && encodings[0].scope & 2) {
2058 uint8_t *codec_priv = track->codec_priv.data;
2059 int ret = matroska_decode_buffer(&track->codec_priv.data,
2060 &track->codec_priv.size,
2063 track->codec_priv.data = NULL;
2064 track->codec_priv.size = 0;
2065 av_log(matroska->ctx, AV_LOG_ERROR,
2066 "Failed to decode codec private data\n");
2069 if (codec_priv != track->codec_priv.data)
2070 av_free(codec_priv);
2074 for (j = 0; ff_mkv_codec_tags[j].id != AV_CODEC_ID_NONE; j++) {
2075 if (!strncmp(ff_mkv_codec_tags[j].str, track->codec_id,
2076 strlen(ff_mkv_codec_tags[j].str))) {
2077 codec_id = ff_mkv_codec_tags[j].id;
2082 st = track->stream = avformat_new_stream(s, NULL);
2084 av_free(key_id_base64);
2085 return AVERROR(ENOMEM);
2088 if (key_id_base64) {
2089 /* export encryption key id as base64 metadata tag */
2090 av_dict_set(&st->metadata, "enc_key_id", key_id_base64, 0);
2091 av_freep(&key_id_base64);
2094 if (!strcmp(track->codec_id, "V_MS/VFW/FOURCC") &&
2095 track->codec_priv.size >= 40 &&
2096 track->codec_priv.data) {
2097 track->ms_compat = 1;
2098 bit_depth = AV_RL16(track->codec_priv.data + 14);
2099 fourcc = AV_RL32(track->codec_priv.data + 16);
2100 codec_id = ff_codec_get_id(ff_codec_bmp_tags,
2103 codec_id = ff_codec_get_id(ff_codec_movvideo_tags,
2105 extradata_offset = 40;
2106 } else if (!strcmp(track->codec_id, "A_MS/ACM") &&
2107 track->codec_priv.size >= 14 &&
2108 track->codec_priv.data) {
2110 ffio_init_context(&b, track->codec_priv.data,
2111 track->codec_priv.size,
2112 0, NULL, NULL, NULL, NULL);
2113 ret = ff_get_wav_header(s, &b, st->codecpar, track->codec_priv.size, 0);
2116 codec_id = st->codecpar->codec_id;
2117 fourcc = st->codecpar->codec_tag;
2118 extradata_offset = FFMIN(track->codec_priv.size, 18);
2119 } else if (!strcmp(track->codec_id, "A_QUICKTIME")
2120 /* Normally 36, but allow noncompliant private data */
2121 && (track->codec_priv.size >= 32)
2122 && (track->codec_priv.data)) {
2123 uint16_t sample_size;
2124 int ret = get_qt_codec(track, &fourcc, &codec_id);
2127 sample_size = AV_RB16(track->codec_priv.data + 26);
2129 if (sample_size == 8) {
2130 fourcc = MKTAG('r','a','w',' ');
2131 codec_id = ff_codec_get_id(ff_codec_movaudio_tags, fourcc);
2132 } else if (sample_size == 16) {
2133 fourcc = MKTAG('t','w','o','s');
2134 codec_id = ff_codec_get_id(ff_codec_movaudio_tags, fourcc);
2137 if ((fourcc == MKTAG('t','w','o','s') ||
2138 fourcc == MKTAG('s','o','w','t')) &&
2140 codec_id = AV_CODEC_ID_PCM_S8;
2141 } else if (!strcmp(track->codec_id, "V_QUICKTIME") &&
2142 (track->codec_priv.size >= 21) &&
2143 (track->codec_priv.data)) {
2144 int ret = get_qt_codec(track, &fourcc, &codec_id);
2147 if (codec_id == AV_CODEC_ID_NONE && AV_RL32(track->codec_priv.data+4) == AV_RL32("SMI ")) {
2148 fourcc = MKTAG('S','V','Q','3');
2149 codec_id = ff_codec_get_id(ff_codec_movvideo_tags, fourcc);
2151 if (codec_id == AV_CODEC_ID_NONE) {
2153 av_get_codec_tag_string(buf, sizeof(buf), fourcc);
2154 av_log(matroska->ctx, AV_LOG_ERROR,
2155 "mov FourCC not found %s.\n", buf);
2157 if (track->codec_priv.size >= 86) {
2158 bit_depth = AV_RB16(track->codec_priv.data + 82);
2159 ffio_init_context(&b, track->codec_priv.data,
2160 track->codec_priv.size,
2161 0, NULL, NULL, NULL, NULL);
2162 if (ff_get_qtpalette(codec_id, &b, track->palette)) {
2164 track->has_palette = 1;
2167 } else if (codec_id == AV_CODEC_ID_PCM_S16BE) {
2168 switch (track->audio.bitdepth) {
2170 codec_id = AV_CODEC_ID_PCM_U8;
2173 codec_id = AV_CODEC_ID_PCM_S24BE;
2176 codec_id = AV_CODEC_ID_PCM_S32BE;
2179 } else if (codec_id == AV_CODEC_ID_PCM_S16LE) {
2180 switch (track->audio.bitdepth) {
2182 codec_id = AV_CODEC_ID_PCM_U8;
2185 codec_id = AV_CODEC_ID_PCM_S24LE;
2188 codec_id = AV_CODEC_ID_PCM_S32LE;
2191 } else if (codec_id == AV_CODEC_ID_PCM_F32LE &&
2192 track->audio.bitdepth == 64) {
2193 codec_id = AV_CODEC_ID_PCM_F64LE;
2194 } else if (codec_id == AV_CODEC_ID_AAC && !track->codec_priv.size) {
2195 int profile = matroska_aac_profile(track->codec_id);
2196 int sri = matroska_aac_sri(track->audio.samplerate);
2197 extradata = av_mallocz(5 + AV_INPUT_BUFFER_PADDING_SIZE);
2199 return AVERROR(ENOMEM);
2200 extradata[0] = (profile << 3) | ((sri & 0x0E) >> 1);
2201 extradata[1] = ((sri & 0x01) << 7) | (track->audio.channels << 3);
2202 if (strstr(track->codec_id, "SBR")) {
2203 sri = matroska_aac_sri(track->audio.out_samplerate);
2204 extradata[2] = 0x56;
2205 extradata[3] = 0xE5;
2206 extradata[4] = 0x80 | (sri << 3);
2210 } else if (codec_id == AV_CODEC_ID_ALAC && track->codec_priv.size && track->codec_priv.size < INT_MAX - 12 - AV_INPUT_BUFFER_PADDING_SIZE) {
2211 /* Only ALAC's magic cookie is stored in Matroska's track headers.
2212 * Create the "atom size", "tag", and "tag version" fields the
2213 * decoder expects manually. */
2214 extradata_size = 12 + track->codec_priv.size;
2215 extradata = av_mallocz(extradata_size +
2216 AV_INPUT_BUFFER_PADDING_SIZE);
2218 return AVERROR(ENOMEM);
2219 AV_WB32(extradata, extradata_size);
2220 memcpy(&extradata[4], "alac", 4);
2221 AV_WB32(&extradata[8], 0);
2222 memcpy(&extradata[12], track->codec_priv.data,
2223 track->codec_priv.size);
2224 } else if (codec_id == AV_CODEC_ID_TTA) {
2225 extradata_size = 30;
2226 extradata = av_mallocz(extradata_size + AV_INPUT_BUFFER_PADDING_SIZE);
2228 return AVERROR(ENOMEM);
2229 ffio_init_context(&b, extradata, extradata_size, 1,
2230 NULL, NULL, NULL, NULL);
2231 avio_write(&b, "TTA1", 4);
2233 if (track->audio.channels > UINT16_MAX ||
2234 track->audio.bitdepth > UINT16_MAX) {
2235 av_log(matroska->ctx, AV_LOG_WARNING,
2236 "Too large audio channel number %"PRIu64
2237 " or bitdepth %"PRIu64". Skipping track.\n",
2238 track->audio.channels, track->audio.bitdepth);
2239 av_freep(&extradata);
2240 if (matroska->ctx->error_recognition & AV_EF_EXPLODE)
2241 return AVERROR_INVALIDDATA;
2245 avio_wl16(&b, track->audio.channels);
2246 avio_wl16(&b, track->audio.bitdepth);
2247 if (track->audio.out_samplerate < 0 || track->audio.out_samplerate > INT_MAX)
2248 return AVERROR_INVALIDDATA;
2249 avio_wl32(&b, track->audio.out_samplerate);
2250 avio_wl32(&b, av_rescale((matroska->duration * matroska->time_scale),
2251 track->audio.out_samplerate,
2252 AV_TIME_BASE * 1000));
2253 } else if (codec_id == AV_CODEC_ID_RV10 ||
2254 codec_id == AV_CODEC_ID_RV20 ||
2255 codec_id == AV_CODEC_ID_RV30 ||
2256 codec_id == AV_CODEC_ID_RV40) {
2257 extradata_offset = 26;
2258 } else if (codec_id == AV_CODEC_ID_RA_144) {
2259 track->audio.out_samplerate = 8000;
2260 track->audio.channels = 1;
2261 } else if ((codec_id == AV_CODEC_ID_RA_288 ||
2262 codec_id == AV_CODEC_ID_COOK ||
2263 codec_id == AV_CODEC_ID_ATRAC3 ||
2264 codec_id == AV_CODEC_ID_SIPR)
2265 && track->codec_priv.data) {
2268 ffio_init_context(&b, track->codec_priv.data,
2269 track->codec_priv.size,
2270 0, NULL, NULL, NULL, NULL);
2272 flavor = avio_rb16(&b);
2273 track->audio.coded_framesize = avio_rb32(&b);
2275 track->audio.sub_packet_h = avio_rb16(&b);
2276 track->audio.frame_size = avio_rb16(&b);
2277 track->audio.sub_packet_size = avio_rb16(&b);
2279 track->audio.coded_framesize <= 0 ||
2280 track->audio.sub_packet_h <= 0 ||
2281 track->audio.frame_size <= 0 ||
2282 track->audio.sub_packet_size <= 0)
2283 return AVERROR_INVALIDDATA;
2284 track->audio.buf = av_malloc_array(track->audio.sub_packet_h,
2285 track->audio.frame_size);
2286 if (!track->audio.buf)
2287 return AVERROR(ENOMEM);
2288 if (codec_id == AV_CODEC_ID_RA_288) {
2289 st->codecpar->block_align = track->audio.coded_framesize;
2290 track->codec_priv.size = 0;
2292 if (codec_id == AV_CODEC_ID_SIPR && flavor < 4) {
2293 static const int sipr_bit_rate[4] = { 6504, 8496, 5000, 16000 };
2294 track->audio.sub_packet_size = ff_sipr_subpk_size[flavor];
2295 st->codecpar->bit_rate = sipr_bit_rate[flavor];
2297 st->codecpar->block_align = track->audio.sub_packet_size;
2298 extradata_offset = 78;
2300 } else if (codec_id == AV_CODEC_ID_FLAC && track->codec_priv.size) {
2301 ret = matroska_parse_flac(s, track, &extradata_offset);
2304 } else if (codec_id == AV_CODEC_ID_PRORES && track->codec_priv.size == 4) {
2305 fourcc = AV_RL32(track->codec_priv.data);
2307 track->codec_priv.size -= extradata_offset;
2309 if (codec_id == AV_CODEC_ID_NONE)
2310 av_log(matroska->ctx, AV_LOG_INFO,
2311 "Unknown/unsupported AVCodecID %s.\n", track->codec_id);
2313 if (track->time_scale < 0.01)
2314 track->time_scale = 1.0;
2315 avpriv_set_pts_info(st, 64, matroska->time_scale * track->time_scale,
2316 1000 * 1000 * 1000); /* 64 bit pts in ns */
2318 /* convert the delay from ns to the track timebase */
2319 track->codec_delay_in_track_tb = av_rescale_q(track->codec_delay,
2320 (AVRational){ 1, 1000000000 },
2323 st->codecpar->codec_id = codec_id;
2325 if (strcmp(track->language, "und"))
2326 av_dict_set(&st->metadata, "language", track->language, 0);
2327 av_dict_set(&st->metadata, "title", track->name, 0);
2329 if (track->flag_default)
2330 st->disposition |= AV_DISPOSITION_DEFAULT;
2331 if (track->flag_forced)
2332 st->disposition |= AV_DISPOSITION_FORCED;
2334 if (!st->codecpar->extradata) {
2336 st->codecpar->extradata = extradata;
2337 st->codecpar->extradata_size = extradata_size;
2338 } else if (track->codec_priv.data && track->codec_priv.size > 0) {
2339 if (ff_alloc_extradata(st->codecpar, track->codec_priv.size))
2340 return AVERROR(ENOMEM);
2341 memcpy(st->codecpar->extradata,
2342 track->codec_priv.data + extradata_offset,
2343 track->codec_priv.size);
2347 if (track->type == MATROSKA_TRACK_TYPE_VIDEO) {
2348 MatroskaTrackPlane *planes = track->operation.combine_planes.elem;
2349 int display_width_mul = 1;
2350 int display_height_mul = 1;
2352 st->codecpar->codec_type = AVMEDIA_TYPE_VIDEO;
2353 st->codecpar->codec_tag = fourcc;
2355 st->codecpar->bits_per_coded_sample = bit_depth;
2356 st->codecpar->width = track->video.pixel_width;
2357 st->codecpar->height = track->video.pixel_height;
2359 if (track->video.interlaced == MATROSKA_VIDEO_INTERLACE_FLAG_INTERLACED)
2360 st->codecpar->field_order = mkv_field_order(matroska, track->video.field_order);
2361 else if (track->video.interlaced == MATROSKA_VIDEO_INTERLACE_FLAG_PROGRESSIVE)
2362 st->codecpar->field_order = AV_FIELD_PROGRESSIVE;
2364 if (track->video.stereo_mode && track->video.stereo_mode < MATROSKA_VIDEO_STEREOMODE_TYPE_NB)
2365 mkv_stereo_mode_display_mul(track->video.stereo_mode, &display_width_mul, &display_height_mul);
2367 if (track->video.display_unit < MATROSKA_VIDEO_DISPLAYUNIT_UNKNOWN) {
2368 av_reduce(&st->sample_aspect_ratio.num,
2369 &st->sample_aspect_ratio.den,
2370 st->codecpar->height * track->video.display_width * display_width_mul,
2371 st->codecpar->width * track->video.display_height * display_height_mul,
2374 if (st->codecpar->codec_id != AV_CODEC_ID_HEVC)
2375 st->need_parsing = AVSTREAM_PARSE_HEADERS;
2377 if (track->default_duration) {
2378 av_reduce(&st->avg_frame_rate.num, &st->avg_frame_rate.den,
2379 1000000000, track->default_duration, 30000);
2380 #if FF_API_R_FRAME_RATE
2381 if ( st->avg_frame_rate.num < st->avg_frame_rate.den * 1000LL
2382 && st->avg_frame_rate.num > st->avg_frame_rate.den * 5LL)
2383 st->r_frame_rate = st->avg_frame_rate;
2387 /* export stereo mode flag as metadata tag */
2388 if (track->video.stereo_mode && track->video.stereo_mode < MATROSKA_VIDEO_STEREOMODE_TYPE_NB)
2389 av_dict_set(&st->metadata, "stereo_mode", ff_matroska_video_stereo_mode[track->video.stereo_mode], 0);
2391 /* export alpha mode flag as metadata tag */
2392 if (track->video.alpha_mode)
2393 av_dict_set(&st->metadata, "alpha_mode", "1", 0);
2395 /* if we have virtual track, mark the real tracks */
2396 for (j=0; j < track->operation.combine_planes.nb_elem; j++) {
2398 if (planes[j].type >= MATROSKA_VIDEO_STEREO_PLANE_COUNT)
2400 snprintf(buf, sizeof(buf), "%s_%d",
2401 ff_matroska_video_stereo_plane[planes[j].type], i);
2402 for (k=0; k < matroska->tracks.nb_elem; k++)
2403 if (planes[j].uid == tracks[k].uid && tracks[k].stream) {
2404 av_dict_set(&tracks[k].stream->metadata,
2405 "stereo_mode", buf, 0);
2409 // add stream level stereo3d side data if it is a supported format
2410 if (track->video.stereo_mode < MATROSKA_VIDEO_STEREOMODE_TYPE_NB &&
2411 track->video.stereo_mode != 10 && track->video.stereo_mode != 12) {
2412 int ret = ff_mkv_stereo3d_conv(st, track->video.stereo_mode);
2417 if (s->strict_std_compliance <= FF_COMPLIANCE_UNOFFICIAL) {
2418 int ret = mkv_parse_video_color(st, track);
2423 ret = mkv_parse_video_projection(st, track);
2426 } else if (track->type == MATROSKA_TRACK_TYPE_AUDIO) {
2427 st->codecpar->codec_type = AVMEDIA_TYPE_AUDIO;
2428 st->codecpar->codec_tag = fourcc;
2429 st->codecpar->sample_rate = track->audio.out_samplerate;
2430 st->codecpar->channels = track->audio.channels;
2431 if (!st->codecpar->bits_per_coded_sample)
2432 st->codecpar->bits_per_coded_sample = track->audio.bitdepth;
2433 if (st->codecpar->codec_id == AV_CODEC_ID_MP3)
2434 st->need_parsing = AVSTREAM_PARSE_FULL;
2435 else if (st->codecpar->codec_id != AV_CODEC_ID_AAC)
2436 st->need_parsing = AVSTREAM_PARSE_HEADERS;
2437 if (track->codec_delay > 0) {
2438 st->codecpar->initial_padding = av_rescale_q(track->codec_delay,
2439 (AVRational){1, 1000000000},
2440 (AVRational){1, st->codecpar->codec_id == AV_CODEC_ID_OPUS ?
2441 48000 : st->codecpar->sample_rate});
2443 if (track->seek_preroll > 0) {
2444 st->codecpar->seek_preroll = av_rescale_q(track->seek_preroll,
2445 (AVRational){1, 1000000000},
2446 (AVRational){1, st->codecpar->sample_rate});
2448 } else if (codec_id == AV_CODEC_ID_WEBVTT) {
2449 st->codecpar->codec_type = AVMEDIA_TYPE_SUBTITLE;
2451 if (!strcmp(track->codec_id, "D_WEBVTT/CAPTIONS")) {
2452 st->disposition |= AV_DISPOSITION_CAPTIONS;
2453 } else if (!strcmp(track->codec_id, "D_WEBVTT/DESCRIPTIONS")) {
2454 st->disposition |= AV_DISPOSITION_DESCRIPTIONS;
2455 } else if (!strcmp(track->codec_id, "D_WEBVTT/METADATA")) {
2456 st->disposition |= AV_DISPOSITION_METADATA;
2458 } else if (track->type == MATROSKA_TRACK_TYPE_SUBTITLE) {
2459 st->codecpar->codec_type = AVMEDIA_TYPE_SUBTITLE;
2460 if (st->codecpar->codec_id == AV_CODEC_ID_ASS)
2461 matroska->contains_ssa = 1;
2468 static int matroska_read_header(AVFormatContext *s)
2470 MatroskaDemuxContext *matroska = s->priv_data;
2471 EbmlList *attachments_list = &matroska->attachments;
2472 EbmlList *chapters_list = &matroska->chapters;
2473 MatroskaAttachment *attachments;
2474 MatroskaChapter *chapters;
2475 uint64_t max_start = 0;
2481 matroska->cues_parsing_deferred = 1;
2483 /* First read the EBML header. */
2484 if (ebml_parse(matroska, ebml_syntax, &ebml) || !ebml.doctype) {
2485 av_log(matroska->ctx, AV_LOG_ERROR, "EBML header parsing failed\n");
2486 ebml_free(ebml_syntax, &ebml);
2487 return AVERROR_INVALIDDATA;
2489 if (ebml.version > EBML_VERSION ||
2490 ebml.max_size > sizeof(uint64_t) ||
2491 ebml.id_length > sizeof(uint32_t) ||
2492 ebml.doctype_version > 3) {
2493 av_log(matroska->ctx, AV_LOG_ERROR,
2494 "EBML header using unsupported features\n"
2495 "(EBML version %"PRIu64", doctype %s, doc version %"PRIu64")\n",
2496 ebml.version, ebml.doctype, ebml.doctype_version);
2497 ebml_free(ebml_syntax, &ebml);
2498 return AVERROR_PATCHWELCOME;
2499 } else if (ebml.doctype_version == 3) {
2500 av_log(matroska->ctx, AV_LOG_WARNING,
2501 "EBML header using unsupported features\n"
2502 "(EBML version %"PRIu64", doctype %s, doc version %"PRIu64")\n",
2503 ebml.version, ebml.doctype, ebml.doctype_version);
2505 for (i = 0; i < FF_ARRAY_ELEMS(matroska_doctypes); i++)
2506 if (!strcmp(ebml.doctype, matroska_doctypes[i]))
2508 if (i >= FF_ARRAY_ELEMS(matroska_doctypes)) {
2509 av_log(s, AV_LOG_WARNING, "Unknown EBML doctype '%s'\n", ebml.doctype);
2510 if (matroska->ctx->error_recognition & AV_EF_EXPLODE) {
2511 ebml_free(ebml_syntax, &ebml);
2512 return AVERROR_INVALIDDATA;
2515 ebml_free(ebml_syntax, &ebml);
2517 /* The next thing is a segment. */
2518 pos = avio_tell(matroska->ctx->pb);
2519 res = ebml_parse(matroska, matroska_segments, matroska);
2520 // try resyncing until we find a EBML_STOP type element.
2522 res = matroska_resync(matroska, pos);
2525 pos = avio_tell(matroska->ctx->pb);
2526 res = ebml_parse(matroska, matroska_segment, matroska);
2528 matroska_execute_seekhead(matroska);
2530 if (!matroska->time_scale)
2531 matroska->time_scale = 1000000;
2532 if (matroska->duration)
2533 matroska->ctx->duration = matroska->duration * matroska->time_scale *
2534 1000 / AV_TIME_BASE;
2535 av_dict_set(&s->metadata, "title", matroska->title, 0);
2536 av_dict_set(&s->metadata, "encoder", matroska->muxingapp, 0);
2538 if (matroska->date_utc.size == 8)
2539 matroska_metadata_creation_time(&s->metadata, AV_RB64(matroska->date_utc.data));
2541 res = matroska_parse_tracks(s);
2545 attachments = attachments_list->elem;
2546 for (j = 0; j < attachments_list->nb_elem; j++) {
2547 if (!(attachments[j].filename && attachments[j].mime &&
2548 attachments[j].bin.data && attachments[j].bin.size > 0)) {
2549 av_log(matroska->ctx, AV_LOG_ERROR, "incomplete attachment\n");
2551 AVStream *st = avformat_new_stream(s, NULL);
2554 av_dict_set(&st->metadata, "filename", attachments[j].filename, 0);
2555 av_dict_set(&st->metadata, "mimetype", attachments[j].mime, 0);
2556 st->codecpar->codec_id = AV_CODEC_ID_NONE;
2558 for (i = 0; ff_mkv_image_mime_tags[i].id != AV_CODEC_ID_NONE; i++) {
2559 if (!strncmp(ff_mkv_image_mime_tags[i].str, attachments[j].mime,
2560 strlen(ff_mkv_image_mime_tags[i].str))) {
2561 st->codecpar->codec_id = ff_mkv_image_mime_tags[i].id;
2566 attachments[j].stream = st;
2568 if (st->codecpar->codec_id != AV_CODEC_ID_NONE) {
2569 st->disposition |= AV_DISPOSITION_ATTACHED_PIC;
2570 st->codecpar->codec_type = AVMEDIA_TYPE_VIDEO;
2572 av_init_packet(&st->attached_pic);
2573 if ((res = av_new_packet(&st->attached_pic, attachments[j].bin.size)) < 0)
2575 memcpy(st->attached_pic.data, attachments[j].bin.data, attachments[j].bin.size);
2576 st->attached_pic.stream_index = st->index;
2577 st->attached_pic.flags |= AV_PKT_FLAG_KEY;
2579 st->codecpar->codec_type = AVMEDIA_TYPE_ATTACHMENT;
2580 if (ff_alloc_extradata(st->codecpar, attachments[j].bin.size))
2582 memcpy(st->codecpar->extradata, attachments[j].bin.data,
2583 attachments[j].bin.size);
2585 for (i = 0; ff_mkv_mime_tags[i].id != AV_CODEC_ID_NONE; i++) {
2586 if (!strncmp(ff_mkv_mime_tags[i].str, attachments[j].mime,
2587 strlen(ff_mkv_mime_tags[i].str))) {
2588 st->codecpar->codec_id = ff_mkv_mime_tags[i].id;
2596 chapters = chapters_list->elem;
2597 for (i = 0; i < chapters_list->nb_elem; i++)
2598 if (chapters[i].start != AV_NOPTS_VALUE && chapters[i].uid &&
2599 (max_start == 0 || chapters[i].start > max_start)) {
2600 chapters[i].chapter =
2601 avpriv_new_chapter(s, chapters[i].uid,
2602 (AVRational) { 1, 1000000000 },
2603 chapters[i].start, chapters[i].end,
2605 if (chapters[i].chapter) {
2606 av_dict_set(&chapters[i].chapter->metadata,
2607 "title", chapters[i].title, 0);
2609 max_start = chapters[i].start;
2612 matroska_add_index_entries(matroska);
2614 matroska_convert_tags(s);
2618 matroska_read_close(s);
2623 * Put one packet in an application-supplied AVPacket struct.
2624 * Returns 0 on success or -1 on failure.
2626 static int matroska_deliver_packet(MatroskaDemuxContext *matroska,
2629 if (matroska->num_packets > 0) {
2630 MatroskaTrack *tracks = matroska->tracks.elem;
2631 MatroskaTrack *track;
2632 memcpy(pkt, matroska->packets[0], sizeof(AVPacket));
2633 av_freep(&matroska->packets[0]);
2634 track = &tracks[pkt->stream_index];
2635 if (track->has_palette) {
2636 uint8_t *pal = av_packet_new_side_data(pkt, AV_PKT_DATA_PALETTE, AVPALETTE_SIZE);
2638 av_log(matroska->ctx, AV_LOG_ERROR, "Cannot append palette to packet\n");
2640 memcpy(pal, track->palette, AVPALETTE_SIZE);
2642 track->has_palette = 0;
2644 if (matroska->num_packets > 1) {
2646 memmove(&matroska->packets[0], &matroska->packets[1],
2647 (matroska->num_packets - 1) * sizeof(AVPacket *));
2648 newpackets = av_realloc(matroska->packets,
2649 (matroska->num_packets - 1) *
2650 sizeof(AVPacket *));
2652 matroska->packets = newpackets;
2654 av_freep(&matroska->packets);
2655 matroska->prev_pkt = NULL;
2657 matroska->num_packets--;
2665 * Free all packets in our internal queue.
2667 static void matroska_clear_queue(MatroskaDemuxContext *matroska)
2669 matroska->prev_pkt = NULL;
2670 if (matroska->packets) {
2672 for (n = 0; n < matroska->num_packets; n++) {
2673 av_packet_unref(matroska->packets[n]);
2674 av_freep(&matroska->packets[n]);
2676 av_freep(&matroska->packets);
2677 matroska->num_packets = 0;
2681 static int matroska_parse_laces(MatroskaDemuxContext *matroska, uint8_t **buf,
2682 int *buf_size, int type,
2683 uint32_t **lace_buf, int *laces)
2685 int res = 0, n, size = *buf_size;
2686 uint8_t *data = *buf;
2687 uint32_t *lace_size;
2691 *lace_buf = av_mallocz(sizeof(int));
2693 return AVERROR(ENOMEM);
2695 *lace_buf[0] = size;
2699 av_assert0(size > 0);
2703 lace_size = av_mallocz(*laces * sizeof(int));
2705 return AVERROR(ENOMEM);
2708 case 0x1: /* Xiph lacing */
2712 for (n = 0; res == 0 && n < *laces - 1; n++) {
2714 if (size <= total) {
2715 res = AVERROR_INVALIDDATA;
2720 lace_size[n] += temp;
2727 if (size <= total) {
2728 res = AVERROR_INVALIDDATA;
2732 lace_size[n] = size - total;
2736 case 0x2: /* fixed-size lacing */
2737 if (size % (*laces)) {
2738 res = AVERROR_INVALIDDATA;
2741 for (n = 0; n < *laces; n++)
2742 lace_size[n] = size / *laces;
2745 case 0x3: /* EBML lacing */
2749 n = matroska_ebmlnum_uint(matroska, data, size, &num);
2750 if (n < 0 || num > INT_MAX) {
2751 av_log(matroska->ctx, AV_LOG_INFO,
2752 "EBML block data error\n");
2753 res = n<0 ? n : AVERROR_INVALIDDATA;
2758 total = lace_size[0] = num;
2759 for (n = 1; res == 0 && n < *laces - 1; n++) {
2762 r = matroska_ebmlnum_sint(matroska, data, size, &snum);
2763 if (r < 0 || lace_size[n - 1] + snum > (uint64_t)INT_MAX) {
2764 av_log(matroska->ctx, AV_LOG_INFO,
2765 "EBML block data error\n");
2766 res = r<0 ? r : AVERROR_INVALIDDATA;
2771 lace_size[n] = lace_size[n - 1] + snum;
2772 total += lace_size[n];
2774 if (size <= total) {
2775 res = AVERROR_INVALIDDATA;
2778 lace_size[*laces - 1] = size - total;
2784 *lace_buf = lace_size;
2790 static int matroska_parse_rm_audio(MatroskaDemuxContext *matroska,
2791 MatroskaTrack *track, AVStream *st,
2792 uint8_t *data, int size, uint64_t timecode,
2795 int a = st->codecpar->block_align;
2796 int sps = track->audio.sub_packet_size;
2797 int cfs = track->audio.coded_framesize;
2798 int h = track->audio.sub_packet_h;
2799 int y = track->audio.sub_packet_cnt;
2800 int w = track->audio.frame_size;
2803 if (!track->audio.pkt_cnt) {
2804 if (track->audio.sub_packet_cnt == 0)
2805 track->audio.buf_timecode = timecode;
2806 if (st->codecpar->codec_id == AV_CODEC_ID_RA_288) {
2807 if (size < cfs * h / 2) {
2808 av_log(matroska->ctx, AV_LOG_ERROR,
2809 "Corrupt int4 RM-style audio packet size\n");
2810 return AVERROR_INVALIDDATA;
2812 for (x = 0; x < h / 2; x++)
2813 memcpy(track->audio.buf + x * 2 * w + y * cfs,
2814 data + x * cfs, cfs);
2815 } else if (st->codecpar->codec_id == AV_CODEC_ID_SIPR) {
2817 av_log(matroska->ctx, AV_LOG_ERROR,
2818 "Corrupt sipr RM-style audio packet size\n");
2819 return AVERROR_INVALIDDATA;
2821 memcpy(track->audio.buf + y * w, data, w);
2823 if (size < sps * w / sps || h<=0 || w%sps) {
2824 av_log(matroska->ctx, AV_LOG_ERROR,
2825 "Corrupt generic RM-style audio packet size\n");
2826 return AVERROR_INVALIDDATA;
2828 for (x = 0; x < w / sps; x++)
2829 memcpy(track->audio.buf +
2830 sps * (h * x + ((h + 1) / 2) * (y & 1) + (y >> 1)),
2831 data + x * sps, sps);
2834 if (++track->audio.sub_packet_cnt >= h) {
2835 if (st->codecpar->codec_id == AV_CODEC_ID_SIPR)
2836 ff_rm_reorder_sipr_data(track->audio.buf, h, w);
2837 track->audio.sub_packet_cnt = 0;
2838 track->audio.pkt_cnt = h * w / a;
2842 while (track->audio.pkt_cnt) {
2844 AVPacket *pkt = av_mallocz(sizeof(AVPacket));
2846 return AVERROR(ENOMEM);
2848 ret = av_new_packet(pkt, a);
2854 track->audio.buf + a * (h * w / a - track->audio.pkt_cnt--),
2856 pkt->pts = track->audio.buf_timecode;
2857 track->audio.buf_timecode = AV_NOPTS_VALUE;
2859 pkt->stream_index = st->index;
2860 dynarray_add(&matroska->packets, &matroska->num_packets, pkt);
2866 /* reconstruct full wavpack blocks from mangled matroska ones */
2867 static int matroska_parse_wavpack(MatroskaTrack *track, uint8_t *src,
2868 uint8_t **pdst, int *size)
2870 uint8_t *dst = NULL;
2875 int ret, offset = 0;
2877 if (srclen < 12 || track->stream->codecpar->extradata_size < 2)
2878 return AVERROR_INVALIDDATA;
2880 ver = AV_RL16(track->stream->codecpar->extradata);
2882 samples = AV_RL32(src);
2886 while (srclen >= 8) {
2891 uint32_t flags = AV_RL32(src);
2892 uint32_t crc = AV_RL32(src + 4);
2896 multiblock = (flags & 0x1800) != 0x1800;
2899 ret = AVERROR_INVALIDDATA;
2902 blocksize = AV_RL32(src);
2908 if (blocksize > srclen) {
2909 ret = AVERROR_INVALIDDATA;
2913 tmp = av_realloc(dst, dstlen + blocksize + 32);
2915 ret = AVERROR(ENOMEM);
2919 dstlen += blocksize + 32;
2921 AV_WL32(dst + offset, MKTAG('w', 'v', 'p', 'k')); // tag
2922 AV_WL32(dst + offset + 4, blocksize + 24); // blocksize - 8
2923 AV_WL16(dst + offset + 8, ver); // version
2924 AV_WL16(dst + offset + 10, 0); // track/index_no
2925 AV_WL32(dst + offset + 12, 0); // total samples
2926 AV_WL32(dst + offset + 16, 0); // block index
2927 AV_WL32(dst + offset + 20, samples); // number of samples
2928 AV_WL32(dst + offset + 24, flags); // flags
2929 AV_WL32(dst + offset + 28, crc); // crc
2930 memcpy(dst + offset + 32, src, blocksize); // block data
2933 srclen -= blocksize;
2934 offset += blocksize + 32;
2947 static int matroska_parse_webvtt(MatroskaDemuxContext *matroska,
2948 MatroskaTrack *track,
2950 uint8_t *data, int data_len,
2956 uint8_t *id, *settings, *text, *buf;
2957 int id_len, settings_len, text_len;
2962 return AVERROR_INVALIDDATA;
2965 q = data + data_len;
2970 if (*p == '\r' || *p == '\n') {
2979 if (p >= q || *p != '\n')
2980 return AVERROR_INVALIDDATA;
2986 if (*p == '\r' || *p == '\n') {
2987 settings_len = p - settings;
2995 if (p >= q || *p != '\n')
2996 return AVERROR_INVALIDDATA;
3001 while (text_len > 0) {
3002 const int len = text_len - 1;
3003 const uint8_t c = p[len];
3004 if (c != '\r' && c != '\n')
3010 return AVERROR_INVALIDDATA;
3012 pkt = av_mallocz(sizeof(*pkt));
3014 return AVERROR(ENOMEM);
3015 err = av_new_packet(pkt, text_len);
3018 return AVERROR(err);
3021 memcpy(pkt->data, text, text_len);
3024 buf = av_packet_new_side_data(pkt,
3025 AV_PKT_DATA_WEBVTT_IDENTIFIER,
3029 return AVERROR(ENOMEM);
3031 memcpy(buf, id, id_len);
3034 if (settings_len > 0) {
3035 buf = av_packet_new_side_data(pkt,
3036 AV_PKT_DATA_WEBVTT_SETTINGS,
3040 return AVERROR(ENOMEM);
3042 memcpy(buf, settings, settings_len);
3045 // Do we need this for subtitles?
3046 // pkt->flags = AV_PKT_FLAG_KEY;
3048 pkt->stream_index = st->index;
3049 pkt->pts = timecode;
3051 // Do we need this for subtitles?
3052 // pkt->dts = timecode;
3054 pkt->duration = duration;
3057 dynarray_add(&matroska->packets, &matroska->num_packets, pkt);
3058 matroska->prev_pkt = pkt;
3063 static int matroska_parse_frame(MatroskaDemuxContext *matroska,
3064 MatroskaTrack *track, AVStream *st,
3065 uint8_t *data, int pkt_size,
3066 uint64_t timecode, uint64_t lace_duration,
3067 int64_t pos, int is_keyframe,
3068 uint8_t *additional, uint64_t additional_id, int additional_size,
3069 int64_t discard_padding)
3071 MatroskaTrackEncoding *encodings = track->encodings.elem;
3072 uint8_t *pkt_data = data;
3073 int offset = 0, res;
3076 if (encodings && !encodings->type && encodings->scope & 1) {
3077 res = matroska_decode_buffer(&pkt_data, &pkt_size, track);
3082 if (st->codecpar->codec_id == AV_CODEC_ID_WAVPACK) {
3084 res = matroska_parse_wavpack(track, pkt_data, &wv_data, &pkt_size);
3086 av_log(matroska->ctx, AV_LOG_ERROR,
3087 "Error parsing a wavpack block.\n");
3090 if (pkt_data != data)
3091 av_freep(&pkt_data);
3095 if (st->codecpar->codec_id == AV_CODEC_ID_PRORES &&
3096 AV_RB32(&data[4]) != MKBETAG('i', 'c', 'p', 'f'))
3099 pkt = av_mallocz(sizeof(AVPacket));
3101 if (pkt_data != data)
3102 av_freep(&pkt_data);
3103 return AVERROR(ENOMEM);
3105 /* XXX: prevent data copy... */
3106 if (av_new_packet(pkt, pkt_size + offset) < 0) {
3108 res = AVERROR(ENOMEM);
3112 if (st->codecpar->codec_id == AV_CODEC_ID_PRORES && offset == 8) {
3113 uint8_t *buf = pkt->data;
3114 bytestream_put_be32(&buf, pkt_size);
3115 bytestream_put_be32(&buf, MKBETAG('i', 'c', 'p', 'f'));
3118 memcpy(pkt->data + offset, pkt_data, pkt_size);
3120 if (pkt_data != data)
3121 av_freep(&pkt_data);
3123 pkt->flags = is_keyframe;
3124 pkt->stream_index = st->index;
3126 if (additional_size > 0) {
3127 uint8_t *side_data = av_packet_new_side_data(pkt,
3128 AV_PKT_DATA_MATROSKA_BLOCKADDITIONAL,
3129 additional_size + 8);
3131 av_packet_unref(pkt);
3133 return AVERROR(ENOMEM);
3135 AV_WB64(side_data, additional_id);
3136 memcpy(side_data + 8, additional, additional_size);
3139 if (discard_padding) {
3140 uint8_t *side_data = av_packet_new_side_data(pkt,
3141 AV_PKT_DATA_SKIP_SAMPLES,
3144 av_packet_unref(pkt);
3146 return AVERROR(ENOMEM);
3148 discard_padding = av_rescale_q(discard_padding,
3149 (AVRational){1, 1000000000},
3150 (AVRational){1, st->codecpar->sample_rate});
3151 if (discard_padding > 0) {
3152 AV_WL32(side_data + 4, discard_padding);
3154 AV_WL32(side_data, -discard_padding);
3158 if (track->ms_compat)
3159 pkt->dts = timecode;
3161 pkt->pts = timecode;
3163 pkt->duration = lace_duration;
3165 #if FF_API_CONVERGENCE_DURATION
3166 FF_DISABLE_DEPRECATION_WARNINGS
3167 if (st->codecpar->codec_id == AV_CODEC_ID_SUBRIP) {
3168 pkt->convergence_duration = lace_duration;
3170 FF_ENABLE_DEPRECATION_WARNINGS
3173 dynarray_add(&matroska->packets, &matroska->num_packets, pkt);
3174 matroska->prev_pkt = pkt;
3179 if (pkt_data != data)
3180 av_freep(&pkt_data);
3184 static int matroska_parse_block(MatroskaDemuxContext *matroska, uint8_t *data,
3185 int size, int64_t pos, uint64_t cluster_time,
3186 uint64_t block_duration, int is_keyframe,
3187 uint8_t *additional, uint64_t additional_id, int additional_size,
3188 int64_t cluster_pos, int64_t discard_padding)
3190 uint64_t timecode = AV_NOPTS_VALUE;
3191 MatroskaTrack *track;
3195 uint32_t *lace_size = NULL;
3196 int n, flags, laces = 0;
3198 int trust_default_duration = 1;
3200 if ((n = matroska_ebmlnum_uint(matroska, data, size, &num)) < 0) {
3201 av_log(matroska->ctx, AV_LOG_ERROR, "EBML block data error\n");
3207 track = matroska_find_track_by_num(matroska, num);
3208 if (!track || !track->stream) {
3209 av_log(matroska->ctx, AV_LOG_INFO,
3210 "Invalid stream %"PRIu64" or size %u\n", num, size);
3211 return AVERROR_INVALIDDATA;
3212 } else if (size <= 3)
3215 if (st->discard >= AVDISCARD_ALL)
3217 av_assert1(block_duration != AV_NOPTS_VALUE);
3219 block_time = sign_extend(AV_RB16(data), 16);
3223 if (is_keyframe == -1)
3224 is_keyframe = flags & 0x80 ? AV_PKT_FLAG_KEY : 0;
3226 if (cluster_time != (uint64_t) -1 &&
3227 (block_time >= 0 || cluster_time >= -block_time)) {
3228 timecode = cluster_time + block_time - track->codec_delay_in_track_tb;
3229 if (track->type == MATROSKA_TRACK_TYPE_SUBTITLE &&
3230 timecode < track->end_timecode)
3231 is_keyframe = 0; /* overlapping subtitles are not key frame */
3233 av_add_index_entry(st, cluster_pos, timecode, 0, 0,
3237 if (matroska->skip_to_keyframe &&
3238 track->type != MATROSKA_TRACK_TYPE_SUBTITLE) {
3239 // Compare signed timecodes. Timecode may be negative due to codec delay
3240 // offset. We don't support timestamps greater than int64_t anyway - see
3242 if ((int64_t)timecode < (int64_t)matroska->skip_to_timecode)
3245 matroska->skip_to_keyframe = 0;
3246 else if (!st->skip_to_keyframe) {
3247 av_log(matroska->ctx, AV_LOG_ERROR, "File is broken, keyframes not correctly marked!\n");
3248 matroska->skip_to_keyframe = 0;
3252 res = matroska_parse_laces(matroska, &data, &size, (flags & 0x06) >> 1,
3253 &lace_size, &laces);
3258 if (track->audio.samplerate == 8000) {
3259 // If this is needed for more codecs, then add them here
3260 if (st->codecpar->codec_id == AV_CODEC_ID_AC3) {
3261 if (track->audio.samplerate != st->codecpar->sample_rate || !st->codecpar->frame_size)
3262 trust_default_duration = 0;
3266 if (!block_duration && trust_default_duration)
3267 block_duration = track->default_duration * laces / matroska->time_scale;
3269 if (cluster_time != (uint64_t)-1 && (block_time >= 0 || cluster_time >= -block_time))
3270 track->end_timecode =
3271 FFMAX(track->end_timecode, timecode + block_duration);
3273 for (n = 0; n < laces; n++) {
3274 int64_t lace_duration = block_duration*(n+1) / laces - block_duration*n / laces;
3276 if (lace_size[n] > size) {
3277 av_log(matroska->ctx, AV_LOG_ERROR, "Invalid packet size\n");
3281 if ((st->codecpar->codec_id == AV_CODEC_ID_RA_288 ||
3282 st->codecpar->codec_id == AV_CODEC_ID_COOK ||
3283 st->codecpar->codec_id == AV_CODEC_ID_SIPR ||
3284 st->codecpar->codec_id == AV_CODEC_ID_ATRAC3) &&
3285 st->codecpar->block_align && track->audio.sub_packet_size) {
3286 res = matroska_parse_rm_audio(matroska, track, st, data,
3292 } else if (st->codecpar->codec_id == AV_CODEC_ID_WEBVTT) {
3293 res = matroska_parse_webvtt(matroska, track, st,
3295 timecode, lace_duration,
3300 res = matroska_parse_frame(matroska, track, st, data, lace_size[n],
3301 timecode, lace_duration, pos,
3302 !n ? is_keyframe : 0,
3303 additional, additional_id, additional_size,
3309 if (timecode != AV_NOPTS_VALUE)
3310 timecode = lace_duration ? timecode + lace_duration : AV_NOPTS_VALUE;
3311 data += lace_size[n];
3312 size -= lace_size[n];
3320 static int matroska_parse_cluster_incremental(MatroskaDemuxContext *matroska)
3322 EbmlList *blocks_list;
3323 MatroskaBlock *blocks;
3325 res = ebml_parse(matroska,
3326 matroska_cluster_incremental_parsing,
3327 &matroska->current_cluster);
3330 if (matroska->current_cluster_pos)
3331 ebml_level_end(matroska);
3332 ebml_free(matroska_cluster, &matroska->current_cluster);
3333 memset(&matroska->current_cluster, 0, sizeof(MatroskaCluster));
3334 matroska->current_cluster_num_blocks = 0;
3335 matroska->current_cluster_pos = avio_tell(matroska->ctx->pb);
3336 matroska->prev_pkt = NULL;
3337 /* sizeof the ID which was already read */
3338 if (matroska->current_id)
3339 matroska->current_cluster_pos -= 4;
3340 res = ebml_parse(matroska,
3341 matroska_clusters_incremental,
3342 &matroska->current_cluster);
3343 /* Try parsing the block again. */
3345 res = ebml_parse(matroska,
3346 matroska_cluster_incremental_parsing,
3347 &matroska->current_cluster);
3351 matroska->current_cluster_num_blocks <
3352 matroska->current_cluster.blocks.nb_elem) {
3353 blocks_list = &matroska->current_cluster.blocks;
3354 blocks = blocks_list->elem;
3356 matroska->current_cluster_num_blocks = blocks_list->nb_elem;
3357 i = blocks_list->nb_elem - 1;
3358 if (blocks[i].bin.size > 0 && blocks[i].bin.data) {
3359 int is_keyframe = blocks[i].non_simple ? !blocks[i].reference : -1;
3360 uint8_t* additional = blocks[i].additional.size > 0 ?
3361 blocks[i].additional.data : NULL;
3362 if (!blocks[i].non_simple)
3363 blocks[i].duration = 0;
3364 res = matroska_parse_block(matroska, blocks[i].bin.data,
3365 blocks[i].bin.size, blocks[i].bin.pos,
3366 matroska->current_cluster.timecode,
3367 blocks[i].duration, is_keyframe,
3368 additional, blocks[i].additional_id,
3369 blocks[i].additional.size,
3370 matroska->current_cluster_pos,
3371 blocks[i].discard_padding);
3378 static int matroska_parse_cluster(MatroskaDemuxContext *matroska)
3380 MatroskaCluster cluster = { 0 };
3381 EbmlList *blocks_list;
3382 MatroskaBlock *blocks;
3386 if (!matroska->contains_ssa)
3387 return matroska_parse_cluster_incremental(matroska);
3388 pos = avio_tell(matroska->ctx->pb);
3389 matroska->prev_pkt = NULL;
3390 if (matroska->current_id)
3391 pos -= 4; /* sizeof the ID which was already read */
3392 res = ebml_parse(matroska, matroska_clusters, &cluster);
3393 blocks_list = &cluster.blocks;
3394 blocks = blocks_list->elem;
3395 for (i = 0; i < blocks_list->nb_elem; i++)
3396 if (blocks[i].bin.size > 0 && blocks[i].bin.data) {
3397 int is_keyframe = blocks[i].non_simple ? !blocks[i].reference : -1;
3398 res = matroska_parse_block(matroska, blocks[i].bin.data,
3399 blocks[i].bin.size, blocks[i].bin.pos,
3400 cluster.timecode, blocks[i].duration,
3401 is_keyframe, NULL, 0, 0, pos,
3402 blocks[i].discard_padding);
3404 ebml_free(matroska_cluster, &cluster);
3408 static int matroska_read_packet(AVFormatContext *s, AVPacket *pkt)
3410 MatroskaDemuxContext *matroska = s->priv_data;
3413 while (matroska_deliver_packet(matroska, pkt)) {
3414 int64_t pos = avio_tell(matroska->ctx->pb);
3416 return (ret < 0) ? ret : AVERROR_EOF;
3417 if (matroska_parse_cluster(matroska) < 0)
3418 ret = matroska_resync(matroska, pos);
3424 static int matroska_read_seek(AVFormatContext *s, int stream_index,
3425 int64_t timestamp, int flags)
3427 MatroskaDemuxContext *matroska = s->priv_data;
3428 MatroskaTrack *tracks = NULL;
3429 AVStream *st = s->streams[stream_index];
3430 int i, index, index_sub, index_min;
3432 /* Parse the CUES now since we need the index data to seek. */
3433 if (matroska->cues_parsing_deferred > 0) {
3434 matroska->cues_parsing_deferred = 0;
3435 matroska_parse_cues(matroska);
3438 if (!st->nb_index_entries)
3440 timestamp = FFMAX(timestamp, st->index_entries[0].timestamp);
3442 if ((index = av_index_search_timestamp(st, timestamp, flags)) < 0 || index == st->nb_index_entries - 1) {
3443 avio_seek(s->pb, st->index_entries[st->nb_index_entries - 1].pos,
3445 matroska->current_id = 0;
3446 while ((index = av_index_search_timestamp(st, timestamp, flags)) < 0 || index == st->nb_index_entries - 1) {
3447 matroska_clear_queue(matroska);
3448 if (matroska_parse_cluster(matroska) < 0)
3453 matroska_clear_queue(matroska);
3454 if (index < 0 || (matroska->cues_parsing_deferred < 0 && index == st->nb_index_entries - 1))
3458 tracks = matroska->tracks.elem;
3459 for (i = 0; i < matroska->tracks.nb_elem; i++) {
3460 tracks[i].audio.pkt_cnt = 0;
3461 tracks[i].audio.sub_packet_cnt = 0;
3462 tracks[i].audio.buf_timecode = AV_NOPTS_VALUE;
3463 tracks[i].end_timecode = 0;
3466 avio_seek(s->pb, st->index_entries[index_min].pos, SEEK_SET);
3467 matroska->current_id = 0;
3468 if (flags & AVSEEK_FLAG_ANY) {
3469 st->skip_to_keyframe = 0;
3470 matroska->skip_to_timecode = timestamp;
3472 st->skip_to_keyframe = 1;
3473 matroska->skip_to_timecode = st->index_entries[index].timestamp;
3475 matroska->skip_to_keyframe = 1;
3477 matroska->num_levels = 0;
3478 ff_update_cur_dts(s, st, st->index_entries[index].timestamp);
3481 // slightly hackish but allows proper fallback to
3482 // the generic seeking code.
3483 matroska_clear_queue(matroska);
3484 matroska->current_id = 0;
3485 st->skip_to_keyframe =
3486 matroska->skip_to_keyframe = 0;
3488 matroska->num_levels = 0;
3492 static int matroska_read_close(AVFormatContext *s)
3494 MatroskaDemuxContext *matroska = s->priv_data;
3495 MatroskaTrack *tracks = matroska->tracks.elem;
3498 matroska_clear_queue(matroska);
3500 for (n = 0; n < matroska->tracks.nb_elem; n++)
3501 if (tracks[n].type == MATROSKA_TRACK_TYPE_AUDIO)
3502 av_freep(&tracks[n].audio.buf);
3503 ebml_free(matroska_cluster, &matroska->current_cluster);
3504 ebml_free(matroska_segment, matroska);
3510 int64_t start_time_ns;
3511 int64_t end_time_ns;
3512 int64_t start_offset;
3516 /* This function searches all the Cues and returns the CueDesc corresponding the
3517 * the timestamp ts. Returned CueDesc will be such that start_time_ns <= ts <
3518 * end_time_ns. All 4 fields will be set to -1 if ts >= file's duration.
3520 static CueDesc get_cue_desc(AVFormatContext *s, int64_t ts, int64_t cues_start) {
3521 MatroskaDemuxContext *matroska = s->priv_data;
3524 int nb_index_entries = s->streams[0]->nb_index_entries;
3525 AVIndexEntry *index_entries = s->streams[0]->index_entries;
3526 if (ts >= matroska->duration * matroska->time_scale) return (CueDesc) {-1, -1, -1, -1};
3527 for (i = 1; i < nb_index_entries; i++) {
3528 if (index_entries[i - 1].timestamp * matroska->time_scale <= ts &&
3529 index_entries[i].timestamp * matroska->time_scale > ts) {
3534 cue_desc.start_time_ns = index_entries[i].timestamp * matroska->time_scale;
3535 cue_desc.start_offset = index_entries[i].pos - matroska->segment_start;
3536 if (i != nb_index_entries - 1) {
3537 cue_desc.end_time_ns = index_entries[i + 1].timestamp * matroska->time_scale;
3538 cue_desc.end_offset = index_entries[i + 1].pos - matroska->segment_start;
3540 cue_desc.end_time_ns = matroska->duration * matroska->time_scale;
3541 // FIXME: this needs special handling for files where Cues appear
3542 // before Clusters. the current logic assumes Cues appear after
3544 cue_desc.end_offset = cues_start - matroska->segment_start;
3549 static int webm_clusters_start_with_keyframe(AVFormatContext *s)
3551 MatroskaDemuxContext *matroska = s->priv_data;
3552 int64_t cluster_pos, before_pos;
3554 if (s->streams[0]->nb_index_entries <= 0) return 0;
3555 // seek to the first cluster using cues.
3556 index = av_index_search_timestamp(s->streams[0], 0, 0);
3557 if (index < 0) return 0;
3558 cluster_pos = s->streams[0]->index_entries[index].pos;
3559 before_pos = avio_tell(s->pb);
3561 int64_t cluster_id = 0, cluster_length = 0;
3563 avio_seek(s->pb, cluster_pos, SEEK_SET);
3564 // read cluster id and length
3565 ebml_read_num(matroska, matroska->ctx->pb, 4, &cluster_id);
3566 ebml_read_length(matroska, matroska->ctx->pb, &cluster_length);
3567 if (cluster_id != 0xF43B675) { // done with all clusters
3570 avio_seek(s->pb, cluster_pos, SEEK_SET);
3571 matroska->current_id = 0;
3572 matroska_clear_queue(matroska);
3573 if (matroska_parse_cluster(matroska) < 0 ||
3574 matroska->num_packets <= 0) {
3577 pkt = matroska->packets[0];
3578 cluster_pos += cluster_length + 12; // 12 is the offset of the cluster id and length.
3579 if (!(pkt->flags & AV_PKT_FLAG_KEY)) {
3584 avio_seek(s->pb, before_pos, SEEK_SET);
3588 static int buffer_size_after_time_downloaded(int64_t time_ns, double search_sec, int64_t bps,
3589 double min_buffer, double* buffer,
3590 double* sec_to_download, AVFormatContext *s,
3593 double nano_seconds_per_second = 1000000000.0;
3594 double time_sec = time_ns / nano_seconds_per_second;
3596 int64_t time_to_search_ns = (int64_t)(search_sec * nano_seconds_per_second);
3597 int64_t end_time_ns = time_ns + time_to_search_ns;
3598 double sec_downloaded = 0.0;
3599 CueDesc desc_curr = get_cue_desc(s, time_ns, cues_start);
3600 if (desc_curr.start_time_ns == -1)
3602 *sec_to_download = 0.0;
3604 // Check for non cue start time.
3605 if (time_ns > desc_curr.start_time_ns) {
3606 int64_t cue_nano = desc_curr.end_time_ns - time_ns;
3607 double percent = (double)(cue_nano) / (desc_curr.end_time_ns - desc_curr.start_time_ns);
3608 double cueBytes = (desc_curr.end_offset - desc_curr.start_offset) * percent;
3609 double timeToDownload = (cueBytes * 8.0) / bps;
3611 sec_downloaded += (cue_nano / nano_seconds_per_second) - timeToDownload;
3612 *sec_to_download += timeToDownload;
3614 // Check if the search ends within the first cue.
3615 if (desc_curr.end_time_ns >= end_time_ns) {
3616 double desc_end_time_sec = desc_curr.end_time_ns / nano_seconds_per_second;
3617 double percent_to_sub = search_sec / (desc_end_time_sec - time_sec);
3618 sec_downloaded = percent_to_sub * sec_downloaded;
3619 *sec_to_download = percent_to_sub * *sec_to_download;
3622 if ((sec_downloaded + *buffer) <= min_buffer) {
3626 // Get the next Cue.
3627 desc_curr = get_cue_desc(s, desc_curr.end_time_ns, cues_start);
3630 while (desc_curr.start_time_ns != -1) {
3631 int64_t desc_bytes = desc_curr.end_offset - desc_curr.start_offset;
3632 int64_t desc_ns = desc_curr.end_time_ns - desc_curr.start_time_ns;
3633 double desc_sec = desc_ns / nano_seconds_per_second;
3634 double bits = (desc_bytes * 8.0);
3635 double time_to_download = bits / bps;
3637 sec_downloaded += desc_sec - time_to_download;
3638 *sec_to_download += time_to_download;
3640 if (desc_curr.end_time_ns >= end_time_ns) {
3641 double desc_end_time_sec = desc_curr.end_time_ns / nano_seconds_per_second;
3642 double percent_to_sub = search_sec / (desc_end_time_sec - time_sec);
3643 sec_downloaded = percent_to_sub * sec_downloaded;
3644 *sec_to_download = percent_to_sub * *sec_to_download;
3646 if ((sec_downloaded + *buffer) <= min_buffer)
3651 if ((sec_downloaded + *buffer) <= min_buffer) {
3656 desc_curr = get_cue_desc(s, desc_curr.end_time_ns, cues_start);
3658 *buffer = *buffer + sec_downloaded;
3662 /* This function computes the bandwidth of the WebM file with the help of
3663 * buffer_size_after_time_downloaded() function. Both of these functions are
3664 * adapted from WebM Tools project and are adapted to work with FFmpeg's
3665 * Matroska parsing mechanism.
3667 * Returns the bandwidth of the file on success; -1 on error.
3669 static int64_t webm_dash_manifest_compute_bandwidth(AVFormatContext *s, int64_t cues_start)
3671 MatroskaDemuxContext *matroska = s->priv_data;
3672 AVStream *st = s->streams[0];
3673 double bandwidth = 0.0;
3676 for (i = 0; i < st->nb_index_entries; i++) {
3677 int64_t prebuffer_ns = 1000000000;
3678 int64_t time_ns = st->index_entries[i].timestamp * matroska->time_scale;
3679 double nano_seconds_per_second = 1000000000.0;
3680 int64_t prebuffered_ns = time_ns + prebuffer_ns;
3681 double prebuffer_bytes = 0.0;
3682 int64_t temp_prebuffer_ns = prebuffer_ns;
3683 int64_t pre_bytes, pre_ns;
3684 double pre_sec, prebuffer, bits_per_second;
3685 CueDesc desc_beg = get_cue_desc(s, time_ns, cues_start);
3687 // Start with the first Cue.
3688 CueDesc desc_end = desc_beg;
3690 // Figure out how much data we have downloaded for the prebuffer. This will
3691 // be used later to adjust the bits per sample to try.
3692 while (desc_end.start_time_ns != -1 && desc_end.end_time_ns < prebuffered_ns) {
3693 // Prebuffered the entire Cue.
3694 prebuffer_bytes += desc_end.end_offset - desc_end.start_offset;
3695 temp_prebuffer_ns -= desc_end.end_time_ns - desc_end.start_time_ns;
3696 desc_end = get_cue_desc(s, desc_end.end_time_ns, cues_start);
3698 if (desc_end.start_time_ns == -1) {
3699 // The prebuffer is larger than the duration.
3700 if (matroska->duration * matroska->time_scale >= prebuffered_ns)
3702 bits_per_second = 0.0;
3704 // The prebuffer ends in the last Cue. Estimate how much data was
3706 pre_bytes = desc_end.end_offset - desc_end.start_offset;
3707 pre_ns = desc_end.end_time_ns - desc_end.start_time_ns;
3708 pre_sec = pre_ns / nano_seconds_per_second;
3710 pre_bytes * ((temp_prebuffer_ns / nano_seconds_per_second) / pre_sec);
3712 prebuffer = prebuffer_ns / nano_seconds_per_second;
3714 // Set this to 0.0 in case our prebuffer buffers the entire video.
3715 bits_per_second = 0.0;
3717 int64_t desc_bytes = desc_end.end_offset - desc_beg.start_offset;
3718 int64_t desc_ns = desc_end.end_time_ns - desc_beg.start_time_ns;
3719 double desc_sec = desc_ns / nano_seconds_per_second;
3720 double calc_bits_per_second = (desc_bytes * 8) / desc_sec;
3722 // Drop the bps by the percentage of bytes buffered.
3723 double percent = (desc_bytes - prebuffer_bytes) / desc_bytes;
3724 double mod_bits_per_second = calc_bits_per_second * percent;
3726 if (prebuffer < desc_sec) {
3728 (double)(matroska->duration * matroska->time_scale) / nano_seconds_per_second;
3730 // Add 1 so the bits per second should be a little bit greater than file
3732 int64_t bps = (int64_t)(mod_bits_per_second) + 1;
3733 const double min_buffer = 0.0;
3734 double buffer = prebuffer;
3735 double sec_to_download = 0.0;
3737 int rv = buffer_size_after_time_downloaded(prebuffered_ns, search_sec, bps,
3738 min_buffer, &buffer, &sec_to_download,
3742 } else if (rv == 0) {
3743 bits_per_second = (double)(bps);
3748 desc_end = get_cue_desc(s, desc_end.end_time_ns, cues_start);
3749 } while (desc_end.start_time_ns != -1);
3751 if (bandwidth < bits_per_second) bandwidth = bits_per_second;
3753 return (int64_t)bandwidth;
3756 static int webm_dash_manifest_cues(AVFormatContext *s)
3758 MatroskaDemuxContext *matroska = s->priv_data;
3759 EbmlList *seekhead_list = &matroska->seekhead;
3760 MatroskaSeekhead *seekhead = seekhead_list->elem;
3762 int64_t cues_start = -1, cues_end = -1, before_pos, bandwidth;
3765 // determine cues start and end positions
3766 for (i = 0; i < seekhead_list->nb_elem; i++)
3767 if (seekhead[i].id == MATROSKA_ID_CUES)
3770 if (i >= seekhead_list->nb_elem) return -1;
3772 before_pos = avio_tell(matroska->ctx->pb);
3773 cues_start = seekhead[i].pos + matroska->segment_start;
3774 if (avio_seek(matroska->ctx->pb, cues_start, SEEK_SET) == cues_start) {
3775 // cues_end is computed as cues_start + cues_length + length of the
3776 // Cues element ID + EBML length of the Cues element. cues_end is
3777 // inclusive and the above sum is reduced by 1.
3778 uint64_t cues_length = 0, cues_id = 0, bytes_read = 0;
3779 bytes_read += ebml_read_num(matroska, matroska->ctx->pb, 4, &cues_id);
3780 bytes_read += ebml_read_length(matroska, matroska->ctx->pb, &cues_length);
3781 cues_end = cues_start + cues_length + bytes_read - 1;
3783 avio_seek(matroska->ctx->pb, before_pos, SEEK_SET);
3784 if (cues_start == -1 || cues_end == -1) return -1;
3787 matroska_parse_cues(matroska);
3790 av_dict_set_int(&s->streams[0]->metadata, CUES_START, cues_start, 0);
3793 av_dict_set_int(&s->streams[0]->metadata, CUES_END, cues_end, 0);
3796 bandwidth = webm_dash_manifest_compute_bandwidth(s, cues_start);
3797 if (bandwidth < 0) return -1;
3798 av_dict_set_int(&s->streams[0]->metadata, BANDWIDTH, bandwidth, 0);
3800 // check if all clusters start with key frames
3801 av_dict_set_int(&s->streams[0]->metadata, CLUSTER_KEYFRAME, webm_clusters_start_with_keyframe(s), 0);
3803 // store cue point timestamps as a comma separated list for checking subsegment alignment in
3804 // the muxer. assumes that each timestamp cannot be more than 20 characters long.
3805 buf = av_malloc_array(s->streams[0]->nb_index_entries, 20 * sizeof(char));
3806 if (!buf) return -1;
3808 for (i = 0; i < s->streams[0]->nb_index_entries; i++) {
3809 snprintf(buf, (i + 1) * 20 * sizeof(char),
3810 "%s%" PRId64, buf, s->streams[0]->index_entries[i].timestamp);
3811 if (i != s->streams[0]->nb_index_entries - 1)
3812 strncat(buf, ",", sizeof(char));
3814 av_dict_set(&s->streams[0]->metadata, CUE_TIMESTAMPS, buf, 0);
3820 static int webm_dash_manifest_read_header(AVFormatContext *s)
3823 int ret = matroska_read_header(s);
3824 MatroskaTrack *tracks;
3825 MatroskaDemuxContext *matroska = s->priv_data;
3827 av_log(s, AV_LOG_ERROR, "Failed to read file headers\n");
3830 if (!s->nb_streams) {
3831 matroska_read_close(s);
3832 av_log(s, AV_LOG_ERROR, "No streams found\n");
3833 return AVERROR_INVALIDDATA;
3836 if (!matroska->is_live) {
3837 buf = av_asprintf("%g", matroska->duration);
3838 if (!buf) return AVERROR(ENOMEM);
3839 av_dict_set(&s->streams[0]->metadata, DURATION, buf, 0);
3842 // initialization range
3843 // 5 is the offset of Cluster ID.
3844 av_dict_set_int(&s->streams[0]->metadata, INITIALIZATION_RANGE, avio_tell(s->pb) - 5, 0);
3847 // basename of the file
3848 buf = strrchr(s->filename, '/');
3849 av_dict_set(&s->streams[0]->metadata, FILENAME, buf ? ++buf : s->filename, 0);
3852 tracks = matroska->tracks.elem;
3853 av_dict_set_int(&s->streams[0]->metadata, TRACK_NUMBER, tracks[0].num, 0);
3855 // parse the cues and populate Cue related fields
3856 return matroska->is_live ? 0 : webm_dash_manifest_cues(s);
3859 static int webm_dash_manifest_read_packet(AVFormatContext *s, AVPacket *pkt)
3864 #define OFFSET(x) offsetof(MatroskaDemuxContext, x)
3865 static const AVOption options[] = {
3866 { "live", "flag indicating that the input is a live file that only has the headers.", OFFSET(is_live), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, AV_OPT_FLAG_DECODING_PARAM },
3870 static const AVClass webm_dash_class = {
3871 .class_name = "WebM DASH Manifest demuxer",
3872 .item_name = av_default_item_name,
3874 .version = LIBAVUTIL_VERSION_INT,
3877 AVInputFormat ff_matroska_demuxer = {
3878 .name = "matroska,webm",
3879 .long_name = NULL_IF_CONFIG_SMALL("Matroska / WebM"),
3880 .extensions = "mkv,mk3d,mka,mks",
3881 .priv_data_size = sizeof(MatroskaDemuxContext),
3882 .read_probe = matroska_probe,
3883 .read_header = matroska_read_header,
3884 .read_packet = matroska_read_packet,
3885 .read_close = matroska_read_close,
3886 .read_seek = matroska_read_seek,
3887 .mime_type = "audio/webm,audio/x-matroska,video/webm,video/x-matroska"
3890 AVInputFormat ff_webm_dash_manifest_demuxer = {
3891 .name = "webm_dash_manifest",
3892 .long_name = NULL_IF_CONFIG_SMALL("WebM DASH Manifest"),
3893 .priv_data_size = sizeof(MatroskaDemuxContext),
3894 .read_header = webm_dash_manifest_read_header,
3895 .read_packet = webm_dash_manifest_read_packet,
3896 .read_close = matroska_read_close,
3897 .priv_class = &webm_dash_class,