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"
71 #define EBML_UNKNOWN_LENGTH UINT64_MAX /* EBML unknown length, in uint64_t */
72 #define NEEDS_CHECKING 2 /* Indicates that some error checks
73 * still need to be performed */
74 #define LEVEL_ENDED 3 /* return value of ebml_parse when the
75 * syntax level used for parsing ended. */
91 typedef const struct EbmlSyntax {
101 const struct EbmlSyntax *n;
105 typedef struct EbmlList {
110 typedef struct EbmlBin {
117 typedef struct Ebml {
122 uint64_t doctype_version;
125 typedef struct MatroskaTrackCompression {
128 } MatroskaTrackCompression;
130 typedef struct MatroskaTrackEncryption {
133 } MatroskaTrackEncryption;
135 typedef struct MatroskaTrackEncoding {
138 MatroskaTrackCompression compression;
139 MatroskaTrackEncryption encryption;
140 } MatroskaTrackEncoding;
142 typedef struct MatroskaMasteringMeta {
151 double max_luminance;
152 double min_luminance;
153 } MatroskaMasteringMeta;
155 typedef struct MatroskaTrackVideoColor {
156 uint64_t matrix_coefficients;
157 uint64_t bits_per_channel;
158 uint64_t chroma_sub_horz;
159 uint64_t chroma_sub_vert;
160 uint64_t cb_sub_horz;
161 uint64_t cb_sub_vert;
162 uint64_t chroma_siting_horz;
163 uint64_t chroma_siting_vert;
165 uint64_t transfer_characteristics;
169 MatroskaMasteringMeta mastering_meta;
170 } MatroskaTrackVideoColor;
172 typedef struct MatroskaTrackVideoProjection {
178 } MatroskaTrackVideoProjection;
180 typedef struct MatroskaTrackVideo {
182 uint64_t display_width;
183 uint64_t display_height;
184 uint64_t pixel_width;
185 uint64_t pixel_height;
187 uint64_t display_unit;
189 uint64_t field_order;
190 uint64_t stereo_mode;
193 MatroskaTrackVideoProjection projection;
194 } MatroskaTrackVideo;
196 typedef struct MatroskaTrackAudio {
198 double out_samplerate;
202 /* real audio header (extracted from extradata) */
209 uint64_t buf_timecode;
211 } MatroskaTrackAudio;
213 typedef struct MatroskaTrackPlane {
216 } MatroskaTrackPlane;
218 typedef struct MatroskaTrackOperation {
219 EbmlList combine_planes;
220 } MatroskaTrackOperation;
222 typedef struct MatroskaTrack {
231 uint64_t default_duration;
232 uint64_t flag_default;
233 uint64_t flag_forced;
234 uint64_t seek_preroll;
235 MatroskaTrackVideo video;
236 MatroskaTrackAudio audio;
237 MatroskaTrackOperation operation;
239 uint64_t codec_delay;
240 uint64_t codec_delay_in_track_tb;
243 int64_t end_timecode;
245 uint64_t max_block_additional_id;
247 uint32_t palette[AVPALETTE_COUNT];
251 typedef struct MatroskaAttachment {
258 } MatroskaAttachment;
260 typedef struct MatroskaChapter {
269 typedef struct MatroskaIndexPos {
274 typedef struct MatroskaIndex {
279 typedef struct MatroskaTag {
287 typedef struct MatroskaTagTarget {
295 typedef struct MatroskaTags {
296 MatroskaTagTarget target;
300 typedef struct MatroskaSeekhead {
305 typedef struct MatroskaLevel {
310 typedef struct MatroskaBlock {
315 uint64_t additional_id;
317 int64_t discard_padding;
320 typedef struct MatroskaCluster {
326 typedef struct MatroskaLevel1Element {
330 } MatroskaLevel1Element;
332 typedef struct MatroskaDemuxContext {
333 const AVClass *class;
334 AVFormatContext *ctx;
338 MatroskaLevel levels[EBML_MAX_DEPTH];
348 EbmlList attachments;
354 /* byte position of the segment inside the stream */
355 int64_t segment_start;
357 /* the packet queue */
359 AVPacketList *queue_end;
363 /* What to skip before effectively reading a packet. */
364 int skip_to_keyframe;
365 uint64_t skip_to_timecode;
367 /* File has a CUES element, but we defer parsing until it is needed. */
368 int cues_parsing_deferred;
370 /* Level1 elements and whether they were read yet */
371 MatroskaLevel1Element level1_elems[64];
372 int num_level1_elems;
374 MatroskaCluster current_cluster;
376 /* WebM DASH Manifest live flag */
379 /* Bandwidth value for WebM DASH Manifest */
381 } MatroskaDemuxContext;
383 #define CHILD_OF(parent) { .def = { .n = parent } }
385 static const EbmlSyntax ebml_syntax[], matroska_segment[], matroska_track_video_color[], matroska_track_video[],
386 matroska_track[], matroska_track_encoding[], matroska_track_encodings[],
387 matroska_track_combine_planes[], matroska_track_operation[], matroska_tracks[],
388 matroska_attachments[], matroska_chapter_entry[], matroska_chapter[], matroska_chapters[],
389 matroska_index_entry[], matroska_index[], matroska_tag[], matroska_tags[], matroska_seekhead[],
390 matroska_blockadditions[], matroska_blockgroup[], matroska_cluster_parsing[];
392 static const EbmlSyntax ebml_header[] = {
393 { EBML_ID_EBMLREADVERSION, EBML_UINT, 0, offsetof(Ebml, version), { .u = EBML_VERSION } },
394 { EBML_ID_EBMLMAXSIZELENGTH, EBML_UINT, 0, offsetof(Ebml, max_size), { .u = 8 } },
395 { EBML_ID_EBMLMAXIDLENGTH, EBML_UINT, 0, offsetof(Ebml, id_length), { .u = 4 } },
396 { EBML_ID_DOCTYPE, EBML_STR, 0, offsetof(Ebml, doctype), { .s = "(none)" } },
397 { EBML_ID_DOCTYPEREADVERSION, EBML_UINT, 0, offsetof(Ebml, doctype_version), { .u = 1 } },
398 { EBML_ID_EBMLVERSION, EBML_NONE },
399 { EBML_ID_DOCTYPEVERSION, EBML_NONE },
400 CHILD_OF(ebml_syntax)
403 static const EbmlSyntax ebml_syntax[] = {
404 { EBML_ID_HEADER, EBML_NEST, 0, 0, { .n = ebml_header } },
405 { MATROSKA_ID_SEGMENT, EBML_STOP },
409 static const EbmlSyntax matroska_info[] = {
410 { MATROSKA_ID_TIMECODESCALE, EBML_UINT, 0, offsetof(MatroskaDemuxContext, time_scale), { .u = 1000000 } },
411 { MATROSKA_ID_DURATION, EBML_FLOAT, 0, offsetof(MatroskaDemuxContext, duration) },
412 { MATROSKA_ID_TITLE, EBML_UTF8, 0, offsetof(MatroskaDemuxContext, title) },
413 { MATROSKA_ID_WRITINGAPP, EBML_NONE },
414 { MATROSKA_ID_MUXINGAPP, EBML_UTF8, 0, offsetof(MatroskaDemuxContext, muxingapp) },
415 { MATROSKA_ID_DATEUTC, EBML_BIN, 0, offsetof(MatroskaDemuxContext, date_utc) },
416 { MATROSKA_ID_SEGMENTUID, EBML_NONE },
417 CHILD_OF(matroska_segment)
420 static const EbmlSyntax matroska_mastering_meta[] = {
421 { MATROSKA_ID_VIDEOCOLOR_RX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, r_x), { .f=-1 } },
422 { MATROSKA_ID_VIDEOCOLOR_RY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, r_y), { .f=-1 } },
423 { MATROSKA_ID_VIDEOCOLOR_GX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, g_x), { .f=-1 } },
424 { MATROSKA_ID_VIDEOCOLOR_GY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, g_y), { .f=-1 } },
425 { MATROSKA_ID_VIDEOCOLOR_BX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, b_x), { .f=-1 } },
426 { MATROSKA_ID_VIDEOCOLOR_BY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, b_y), { .f=-1 } },
427 { MATROSKA_ID_VIDEOCOLOR_WHITEX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, white_x), { .f=-1 } },
428 { MATROSKA_ID_VIDEOCOLOR_WHITEY, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, white_y), { .f=-1 } },
429 { MATROSKA_ID_VIDEOCOLOR_LUMINANCEMIN, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, min_luminance), { .f=-1 } },
430 { MATROSKA_ID_VIDEOCOLOR_LUMINANCEMAX, EBML_FLOAT, 0, offsetof(MatroskaMasteringMeta, max_luminance), { .f=-1 } },
431 CHILD_OF(matroska_track_video_color)
434 static const EbmlSyntax matroska_track_video_color[] = {
435 { MATROSKA_ID_VIDEOCOLORMATRIXCOEFF, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, matrix_coefficients), { .u = AVCOL_SPC_UNSPECIFIED } },
436 { MATROSKA_ID_VIDEOCOLORBITSPERCHANNEL, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, bits_per_channel), { .u=0 } },
437 { MATROSKA_ID_VIDEOCOLORCHROMASUBHORZ, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_sub_horz), { .u=0 } },
438 { MATROSKA_ID_VIDEOCOLORCHROMASUBVERT, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_sub_vert), { .u=0 } },
439 { MATROSKA_ID_VIDEOCOLORCBSUBHORZ, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, cb_sub_horz), { .u=0 } },
440 { MATROSKA_ID_VIDEOCOLORCBSUBVERT, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, cb_sub_vert), { .u=0 } },
441 { MATROSKA_ID_VIDEOCOLORCHROMASITINGHORZ, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_siting_horz), { .u = MATROSKA_COLOUR_CHROMASITINGHORZ_UNDETERMINED } },
442 { MATROSKA_ID_VIDEOCOLORCHROMASITINGVERT, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, chroma_siting_vert), { .u = MATROSKA_COLOUR_CHROMASITINGVERT_UNDETERMINED } },
443 { MATROSKA_ID_VIDEOCOLORRANGE, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, range), { .u = AVCOL_RANGE_UNSPECIFIED } },
444 { MATROSKA_ID_VIDEOCOLORTRANSFERCHARACTERISTICS, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, transfer_characteristics), { .u = AVCOL_TRC_UNSPECIFIED } },
445 { MATROSKA_ID_VIDEOCOLORPRIMARIES, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, primaries), { .u = AVCOL_PRI_UNSPECIFIED } },
446 { MATROSKA_ID_VIDEOCOLORMAXCLL, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, max_cll), { .u=0 } },
447 { MATROSKA_ID_VIDEOCOLORMAXFALL, EBML_UINT, 0, offsetof(MatroskaTrackVideoColor, max_fall), { .u=0 } },
448 { MATROSKA_ID_VIDEOCOLORMASTERINGMETA, EBML_NEST, 0, offsetof(MatroskaTrackVideoColor, mastering_meta), { .n = matroska_mastering_meta } },
449 CHILD_OF(matroska_track_video)
452 static const EbmlSyntax matroska_track_video_projection[] = {
453 { MATROSKA_ID_VIDEOPROJECTIONTYPE, EBML_UINT, 0, offsetof(MatroskaTrackVideoProjection, type), { .u = MATROSKA_VIDEO_PROJECTION_TYPE_RECTANGULAR } },
454 { MATROSKA_ID_VIDEOPROJECTIONPRIVATE, EBML_BIN, 0, offsetof(MatroskaTrackVideoProjection, private) },
455 { MATROSKA_ID_VIDEOPROJECTIONPOSEYAW, EBML_FLOAT, 0, offsetof(MatroskaTrackVideoProjection, yaw), { .f=0.0 } },
456 { MATROSKA_ID_VIDEOPROJECTIONPOSEPITCH, EBML_FLOAT, 0, offsetof(MatroskaTrackVideoProjection, pitch), { .f=0.0 } },
457 { MATROSKA_ID_VIDEOPROJECTIONPOSEROLL, EBML_FLOAT, 0, offsetof(MatroskaTrackVideoProjection, roll), { .f=0.0 } },
458 CHILD_OF(matroska_track_video)
461 static const EbmlSyntax matroska_track_video[] = {
462 { MATROSKA_ID_VIDEOFRAMERATE, EBML_FLOAT, 0, offsetof(MatroskaTrackVideo, frame_rate) },
463 { MATROSKA_ID_VIDEODISPLAYWIDTH, EBML_UINT, 0, offsetof(MatroskaTrackVideo, display_width), { .u=-1 } },
464 { MATROSKA_ID_VIDEODISPLAYHEIGHT, EBML_UINT, 0, offsetof(MatroskaTrackVideo, display_height), { .u=-1 } },
465 { MATROSKA_ID_VIDEOPIXELWIDTH, EBML_UINT, 0, offsetof(MatroskaTrackVideo, pixel_width) },
466 { MATROSKA_ID_VIDEOPIXELHEIGHT, EBML_UINT, 0, offsetof(MatroskaTrackVideo, pixel_height) },
467 { MATROSKA_ID_VIDEOCOLORSPACE, EBML_BIN, 0, offsetof(MatroskaTrackVideo, color_space) },
468 { MATROSKA_ID_VIDEOALPHAMODE, EBML_UINT, 0, offsetof(MatroskaTrackVideo, alpha_mode) },
469 { MATROSKA_ID_VIDEOCOLOR, EBML_NEST, sizeof(MatroskaTrackVideoColor), offsetof(MatroskaTrackVideo, color), { .n = matroska_track_video_color } },
470 { MATROSKA_ID_VIDEOPROJECTION, EBML_NEST, 0, offsetof(MatroskaTrackVideo, projection), { .n = matroska_track_video_projection } },
471 { MATROSKA_ID_VIDEOPIXELCROPB, EBML_NONE },
472 { MATROSKA_ID_VIDEOPIXELCROPT, EBML_NONE },
473 { MATROSKA_ID_VIDEOPIXELCROPL, EBML_NONE },
474 { MATROSKA_ID_VIDEOPIXELCROPR, EBML_NONE },
475 { MATROSKA_ID_VIDEODISPLAYUNIT, EBML_UINT, 0, offsetof(MatroskaTrackVideo, display_unit), { .u= MATROSKA_VIDEO_DISPLAYUNIT_PIXELS } },
476 { MATROSKA_ID_VIDEOFLAGINTERLACED, EBML_UINT, 0, offsetof(MatroskaTrackVideo, interlaced), { .u = MATROSKA_VIDEO_INTERLACE_FLAG_UNDETERMINED } },
477 { MATROSKA_ID_VIDEOFIELDORDER, EBML_UINT, 0, offsetof(MatroskaTrackVideo, field_order), { .u = MATROSKA_VIDEO_FIELDORDER_UNDETERMINED } },
478 { MATROSKA_ID_VIDEOSTEREOMODE, EBML_UINT, 0, offsetof(MatroskaTrackVideo, stereo_mode), { .u = MATROSKA_VIDEO_STEREOMODE_TYPE_NB } },
479 { MATROSKA_ID_VIDEOASPECTRATIO, EBML_NONE },
480 CHILD_OF(matroska_track)
483 static const EbmlSyntax matroska_track_audio[] = {
484 { MATROSKA_ID_AUDIOSAMPLINGFREQ, EBML_FLOAT, 0, offsetof(MatroskaTrackAudio, samplerate), { .f = 8000.0 } },
485 { MATROSKA_ID_AUDIOOUTSAMPLINGFREQ, EBML_FLOAT, 0, offsetof(MatroskaTrackAudio, out_samplerate) },
486 { MATROSKA_ID_AUDIOBITDEPTH, EBML_UINT, 0, offsetof(MatroskaTrackAudio, bitdepth) },
487 { MATROSKA_ID_AUDIOCHANNELS, EBML_UINT, 0, offsetof(MatroskaTrackAudio, channels), { .u = 1 } },
488 CHILD_OF(matroska_track)
491 static const EbmlSyntax matroska_track_encoding_compression[] = {
492 { MATROSKA_ID_ENCODINGCOMPALGO, EBML_UINT, 0, offsetof(MatroskaTrackCompression, algo), { .u = 0 } },
493 { MATROSKA_ID_ENCODINGCOMPSETTINGS, EBML_BIN, 0, offsetof(MatroskaTrackCompression, settings) },
494 CHILD_OF(matroska_track_encoding)
497 static const EbmlSyntax matroska_track_encoding_encryption[] = {
498 { MATROSKA_ID_ENCODINGENCALGO, EBML_UINT, 0, offsetof(MatroskaTrackEncryption,algo), {.u = 0} },
499 { MATROSKA_ID_ENCODINGENCKEYID, EBML_BIN, 0, offsetof(MatroskaTrackEncryption,key_id) },
500 { MATROSKA_ID_ENCODINGENCAESSETTINGS, EBML_NONE },
501 { MATROSKA_ID_ENCODINGSIGALGO, EBML_NONE },
502 { MATROSKA_ID_ENCODINGSIGHASHALGO, EBML_NONE },
503 { MATROSKA_ID_ENCODINGSIGKEYID, EBML_NONE },
504 { MATROSKA_ID_ENCODINGSIGNATURE, EBML_NONE },
505 CHILD_OF(matroska_track_encoding)
507 static const EbmlSyntax matroska_track_encoding[] = {
508 { MATROSKA_ID_ENCODINGSCOPE, EBML_UINT, 0, offsetof(MatroskaTrackEncoding, scope), { .u = 1 } },
509 { MATROSKA_ID_ENCODINGTYPE, EBML_UINT, 0, offsetof(MatroskaTrackEncoding, type), { .u = 0 } },
510 { MATROSKA_ID_ENCODINGCOMPRESSION, EBML_NEST, 0, offsetof(MatroskaTrackEncoding, compression), { .n = matroska_track_encoding_compression } },
511 { MATROSKA_ID_ENCODINGENCRYPTION, EBML_NEST, 0, offsetof(MatroskaTrackEncoding, encryption), { .n = matroska_track_encoding_encryption } },
512 { MATROSKA_ID_ENCODINGORDER, EBML_NONE },
513 CHILD_OF(matroska_track_encodings)
516 static const EbmlSyntax matroska_track_encodings[] = {
517 { MATROSKA_ID_TRACKCONTENTENCODING, EBML_NEST, sizeof(MatroskaTrackEncoding), offsetof(MatroskaTrack, encodings), { .n = matroska_track_encoding } },
518 CHILD_OF(matroska_track)
521 static const EbmlSyntax matroska_track_plane[] = {
522 { MATROSKA_ID_TRACKPLANEUID, EBML_UINT, 0, offsetof(MatroskaTrackPlane,uid) },
523 { MATROSKA_ID_TRACKPLANETYPE, EBML_UINT, 0, offsetof(MatroskaTrackPlane,type) },
524 CHILD_OF(matroska_track_combine_planes)
527 static const EbmlSyntax matroska_track_combine_planes[] = {
528 { MATROSKA_ID_TRACKPLANE, EBML_NEST, sizeof(MatroskaTrackPlane), offsetof(MatroskaTrackOperation,combine_planes), {.n = matroska_track_plane} },
529 CHILD_OF(matroska_track_operation)
532 static const EbmlSyntax matroska_track_operation[] = {
533 { MATROSKA_ID_TRACKCOMBINEPLANES, EBML_NEST, 0, 0, {.n = matroska_track_combine_planes} },
534 CHILD_OF(matroska_track)
537 static const EbmlSyntax matroska_track[] = {
538 { MATROSKA_ID_TRACKNUMBER, EBML_UINT, 0, offsetof(MatroskaTrack, num) },
539 { MATROSKA_ID_TRACKNAME, EBML_UTF8, 0, offsetof(MatroskaTrack, name) },
540 { MATROSKA_ID_TRACKUID, EBML_UINT, 0, offsetof(MatroskaTrack, uid) },
541 { MATROSKA_ID_TRACKTYPE, EBML_UINT, 0, offsetof(MatroskaTrack, type) },
542 { MATROSKA_ID_CODECID, EBML_STR, 0, offsetof(MatroskaTrack, codec_id) },
543 { MATROSKA_ID_CODECPRIVATE, EBML_BIN, 0, offsetof(MatroskaTrack, codec_priv) },
544 { MATROSKA_ID_CODECDELAY, EBML_UINT, 0, offsetof(MatroskaTrack, codec_delay) },
545 { MATROSKA_ID_TRACKLANGUAGE, EBML_UTF8, 0, offsetof(MatroskaTrack, language), { .s = "eng" } },
546 { MATROSKA_ID_TRACKDEFAULTDURATION, EBML_UINT, 0, offsetof(MatroskaTrack, default_duration) },
547 { MATROSKA_ID_TRACKTIMECODESCALE, EBML_FLOAT, 0, offsetof(MatroskaTrack, time_scale), { .f = 1.0 } },
548 { MATROSKA_ID_TRACKFLAGDEFAULT, EBML_UINT, 0, offsetof(MatroskaTrack, flag_default), { .u = 1 } },
549 { MATROSKA_ID_TRACKFLAGFORCED, EBML_UINT, 0, offsetof(MatroskaTrack, flag_forced), { .u = 0 } },
550 { MATROSKA_ID_TRACKVIDEO, EBML_NEST, 0, offsetof(MatroskaTrack, video), { .n = matroska_track_video } },
551 { MATROSKA_ID_TRACKAUDIO, EBML_NEST, 0, offsetof(MatroskaTrack, audio), { .n = matroska_track_audio } },
552 { MATROSKA_ID_TRACKOPERATION, EBML_NEST, 0, offsetof(MatroskaTrack, operation), { .n = matroska_track_operation } },
553 { MATROSKA_ID_TRACKCONTENTENCODINGS, EBML_NEST, 0, 0, { .n = matroska_track_encodings } },
554 { MATROSKA_ID_TRACKMAXBLKADDID, EBML_UINT, 0, offsetof(MatroskaTrack, max_block_additional_id) },
555 { MATROSKA_ID_SEEKPREROLL, EBML_UINT, 0, offsetof(MatroskaTrack, seek_preroll) },
556 { MATROSKA_ID_TRACKFLAGENABLED, EBML_NONE },
557 { MATROSKA_ID_TRACKFLAGLACING, EBML_NONE },
558 { MATROSKA_ID_CODECNAME, EBML_NONE },
559 { MATROSKA_ID_CODECDECODEALL, EBML_NONE },
560 { MATROSKA_ID_CODECINFOURL, EBML_NONE },
561 { MATROSKA_ID_CODECDOWNLOADURL, EBML_NONE },
562 { MATROSKA_ID_TRACKMINCACHE, EBML_NONE },
563 { MATROSKA_ID_TRACKMAXCACHE, EBML_NONE },
564 CHILD_OF(matroska_tracks)
567 static const EbmlSyntax matroska_tracks[] = {
568 { MATROSKA_ID_TRACKENTRY, EBML_NEST, sizeof(MatroskaTrack), offsetof(MatroskaDemuxContext, tracks), { .n = matroska_track } },
569 CHILD_OF(matroska_segment)
572 static const EbmlSyntax matroska_attachment[] = {
573 { MATROSKA_ID_FILEUID, EBML_UINT, 0, offsetof(MatroskaAttachment, uid) },
574 { MATROSKA_ID_FILENAME, EBML_UTF8, 0, offsetof(MatroskaAttachment, filename) },
575 { MATROSKA_ID_FILEMIMETYPE, EBML_STR, 0, offsetof(MatroskaAttachment, mime) },
576 { MATROSKA_ID_FILEDATA, EBML_BIN, 0, offsetof(MatroskaAttachment, bin) },
577 { MATROSKA_ID_FILEDESC, EBML_NONE },
578 CHILD_OF(matroska_attachments)
581 static const EbmlSyntax matroska_attachments[] = {
582 { MATROSKA_ID_ATTACHEDFILE, EBML_NEST, sizeof(MatroskaAttachment), offsetof(MatroskaDemuxContext, attachments), { .n = matroska_attachment } },
583 CHILD_OF(matroska_segment)
586 static const EbmlSyntax matroska_chapter_display[] = {
587 { MATROSKA_ID_CHAPSTRING, EBML_UTF8, 0, offsetof(MatroskaChapter, title) },
588 { MATROSKA_ID_CHAPLANG, EBML_NONE },
589 { MATROSKA_ID_CHAPCOUNTRY, EBML_NONE },
590 CHILD_OF(matroska_chapter_entry)
593 static const EbmlSyntax matroska_chapter_entry[] = {
594 { MATROSKA_ID_CHAPTERTIMESTART, EBML_UINT, 0, offsetof(MatroskaChapter, start), { .u = AV_NOPTS_VALUE } },
595 { MATROSKA_ID_CHAPTERTIMEEND, EBML_UINT, 0, offsetof(MatroskaChapter, end), { .u = AV_NOPTS_VALUE } },
596 { MATROSKA_ID_CHAPTERUID, EBML_UINT, 0, offsetof(MatroskaChapter, uid) },
597 { MATROSKA_ID_CHAPTERDISPLAY, EBML_NEST, 0, 0, { .n = matroska_chapter_display } },
598 { MATROSKA_ID_CHAPTERFLAGHIDDEN, EBML_NONE },
599 { MATROSKA_ID_CHAPTERFLAGENABLED, EBML_NONE },
600 { MATROSKA_ID_CHAPTERPHYSEQUIV, EBML_NONE },
601 { MATROSKA_ID_CHAPTERATOM, EBML_NONE },
602 CHILD_OF(matroska_chapter)
605 static const EbmlSyntax matroska_chapter[] = {
606 { MATROSKA_ID_CHAPTERATOM, EBML_NEST, sizeof(MatroskaChapter), offsetof(MatroskaDemuxContext, chapters), { .n = matroska_chapter_entry } },
607 { MATROSKA_ID_EDITIONUID, EBML_NONE },
608 { MATROSKA_ID_EDITIONFLAGHIDDEN, EBML_NONE },
609 { MATROSKA_ID_EDITIONFLAGDEFAULT, EBML_NONE },
610 { MATROSKA_ID_EDITIONFLAGORDERED, EBML_NONE },
611 CHILD_OF(matroska_chapters)
614 static const EbmlSyntax matroska_chapters[] = {
615 { MATROSKA_ID_EDITIONENTRY, EBML_NEST, 0, 0, { .n = matroska_chapter } },
616 CHILD_OF(matroska_segment)
619 static const EbmlSyntax matroska_index_pos[] = {
620 { MATROSKA_ID_CUETRACK, EBML_UINT, 0, offsetof(MatroskaIndexPos, track) },
621 { MATROSKA_ID_CUECLUSTERPOSITION, EBML_UINT, 0, offsetof(MatroskaIndexPos, pos) },
622 { MATROSKA_ID_CUERELATIVEPOSITION,EBML_NONE },
623 { MATROSKA_ID_CUEDURATION, EBML_NONE },
624 { MATROSKA_ID_CUEBLOCKNUMBER, EBML_NONE },
625 CHILD_OF(matroska_index_entry)
628 static const EbmlSyntax matroska_index_entry[] = {
629 { MATROSKA_ID_CUETIME, EBML_UINT, 0, offsetof(MatroskaIndex, time) },
630 { MATROSKA_ID_CUETRACKPOSITION, EBML_NEST, sizeof(MatroskaIndexPos), offsetof(MatroskaIndex, pos), { .n = matroska_index_pos } },
631 CHILD_OF(matroska_index)
634 static const EbmlSyntax matroska_index[] = {
635 { MATROSKA_ID_POINTENTRY, EBML_NEST, sizeof(MatroskaIndex), offsetof(MatroskaDemuxContext, index), { .n = matroska_index_entry } },
636 CHILD_OF(matroska_segment)
639 static const EbmlSyntax matroska_simpletag[] = {
640 { MATROSKA_ID_TAGNAME, EBML_UTF8, 0, offsetof(MatroskaTag, name) },
641 { MATROSKA_ID_TAGSTRING, EBML_UTF8, 0, offsetof(MatroskaTag, string) },
642 { MATROSKA_ID_TAGLANG, EBML_STR, 0, offsetof(MatroskaTag, lang), { .s = "und" } },
643 { MATROSKA_ID_TAGDEFAULT, EBML_UINT, 0, offsetof(MatroskaTag, def) },
644 { MATROSKA_ID_TAGDEFAULT_BUG, EBML_UINT, 0, offsetof(MatroskaTag, def) },
645 { MATROSKA_ID_SIMPLETAG, EBML_NEST, sizeof(MatroskaTag), offsetof(MatroskaTag, sub), { .n = matroska_simpletag } },
646 CHILD_OF(matroska_tag)
649 static const EbmlSyntax matroska_tagtargets[] = {
650 { MATROSKA_ID_TAGTARGETS_TYPE, EBML_STR, 0, offsetof(MatroskaTagTarget, type) },
651 { MATROSKA_ID_TAGTARGETS_TYPEVALUE, EBML_UINT, 0, offsetof(MatroskaTagTarget, typevalue), { .u = 50 } },
652 { MATROSKA_ID_TAGTARGETS_TRACKUID, EBML_UINT, 0, offsetof(MatroskaTagTarget, trackuid) },
653 { MATROSKA_ID_TAGTARGETS_CHAPTERUID, EBML_UINT, 0, offsetof(MatroskaTagTarget, chapteruid) },
654 { MATROSKA_ID_TAGTARGETS_ATTACHUID, EBML_UINT, 0, offsetof(MatroskaTagTarget, attachuid) },
655 CHILD_OF(matroska_tag)
658 static const EbmlSyntax matroska_tag[] = {
659 { MATROSKA_ID_SIMPLETAG, EBML_NEST, sizeof(MatroskaTag), offsetof(MatroskaTags, tag), { .n = matroska_simpletag } },
660 { MATROSKA_ID_TAGTARGETS, EBML_NEST, 0, offsetof(MatroskaTags, target), { .n = matroska_tagtargets } },
661 CHILD_OF(matroska_tags)
664 static const EbmlSyntax matroska_tags[] = {
665 { MATROSKA_ID_TAG, EBML_NEST, sizeof(MatroskaTags), offsetof(MatroskaDemuxContext, tags), { .n = matroska_tag } },
666 CHILD_OF(matroska_segment)
669 static const EbmlSyntax matroska_seekhead_entry[] = {
670 { MATROSKA_ID_SEEKID, EBML_UINT, 0, offsetof(MatroskaSeekhead, id) },
671 { MATROSKA_ID_SEEKPOSITION, EBML_UINT, 0, offsetof(MatroskaSeekhead, pos), { .u = -1 } },
672 CHILD_OF(matroska_seekhead)
675 static const EbmlSyntax matroska_seekhead[] = {
676 { MATROSKA_ID_SEEKENTRY, EBML_NEST, sizeof(MatroskaSeekhead), offsetof(MatroskaDemuxContext, seekhead), { .n = matroska_seekhead_entry } },
677 CHILD_OF(matroska_segment)
680 static const EbmlSyntax matroska_segment[] = {
681 { MATROSKA_ID_INFO, EBML_LEVEL1, 0, 0, { .n = matroska_info } },
682 { MATROSKA_ID_TRACKS, EBML_LEVEL1, 0, 0, { .n = matroska_tracks } },
683 { MATROSKA_ID_ATTACHMENTS, EBML_LEVEL1, 0, 0, { .n = matroska_attachments } },
684 { MATROSKA_ID_CHAPTERS, EBML_LEVEL1, 0, 0, { .n = matroska_chapters } },
685 { MATROSKA_ID_CUES, EBML_LEVEL1, 0, 0, { .n = matroska_index } },
686 { MATROSKA_ID_TAGS, EBML_LEVEL1, 0, 0, { .n = matroska_tags } },
687 { MATROSKA_ID_SEEKHEAD, EBML_LEVEL1, 0, 0, { .n = matroska_seekhead } },
688 { MATROSKA_ID_CLUSTER, EBML_STOP },
689 { 0 } /* We don't want to go back to level 0, so don't add the parent. */
692 static const EbmlSyntax matroska_segments[] = {
693 { MATROSKA_ID_SEGMENT, EBML_NEST, 0, 0, { .n = matroska_segment } },
697 static const EbmlSyntax matroska_blockmore[] = {
698 { MATROSKA_ID_BLOCKADDID, EBML_UINT, 0, offsetof(MatroskaBlock,additional_id) },
699 { MATROSKA_ID_BLOCKADDITIONAL, EBML_BIN, 0, offsetof(MatroskaBlock,additional) },
700 CHILD_OF(matroska_blockadditions)
703 static const EbmlSyntax matroska_blockadditions[] = {
704 { MATROSKA_ID_BLOCKMORE, EBML_NEST, 0, 0, {.n = matroska_blockmore} },
705 CHILD_OF(matroska_blockgroup)
708 static const EbmlSyntax matroska_blockgroup[] = {
709 { MATROSKA_ID_BLOCK, EBML_BIN, 0, offsetof(MatroskaBlock, bin) },
710 { MATROSKA_ID_BLOCKADDITIONS, EBML_NEST, 0, 0, { .n = matroska_blockadditions} },
711 { MATROSKA_ID_BLOCKDURATION, EBML_UINT, 0, offsetof(MatroskaBlock, duration) },
712 { MATROSKA_ID_DISCARDPADDING, EBML_SINT, 0, offsetof(MatroskaBlock, discard_padding) },
713 { MATROSKA_ID_BLOCKREFERENCE, EBML_SINT, 0, offsetof(MatroskaBlock, reference), { .i = INT64_MIN } },
714 { MATROSKA_ID_CODECSTATE, EBML_NONE },
715 { 1, EBML_UINT, 0, offsetof(MatroskaBlock, non_simple), { .u = 1 } },
716 CHILD_OF(matroska_cluster_parsing)
719 static const EbmlSyntax matroska_cluster_parsing[] = {
720 { MATROSKA_ID_CLUSTERTIMECODE, EBML_UINT, 0, offsetof(MatroskaCluster, timecode) },
721 { MATROSKA_ID_BLOCKGROUP, EBML_NEST, 0, 0, { .n = matroska_blockgroup } },
722 { MATROSKA_ID_SIMPLEBLOCK, EBML_BIN, 0, offsetof(MatroskaBlock, bin) },
723 { MATROSKA_ID_CLUSTERPOSITION, EBML_NONE },
724 { MATROSKA_ID_CLUSTERPREVSIZE, EBML_NONE },
725 CHILD_OF(matroska_segment)
728 static const EbmlSyntax matroska_cluster_initial[] = {
729 { MATROSKA_ID_CLUSTERTIMECODE, EBML_UINT, 0, offsetof(MatroskaCluster, timecode) },
730 { MATROSKA_ID_BLOCKGROUP, EBML_STOP },
731 { MATROSKA_ID_SIMPLEBLOCK, EBML_STOP },
732 { MATROSKA_ID_CLUSTERPOSITION, EBML_NONE },
733 { MATROSKA_ID_CLUSTERPREVSIZE, EBML_NONE },
734 CHILD_OF(matroska_segment)
737 static const EbmlSyntax matroska_cluster_enter[] = {
738 { MATROSKA_ID_CLUSTER, EBML_NEST, 0, 0, { .n = matroska_cluster_initial } },
742 static const EbmlSyntax matroska_clusters[] = {
743 { MATROSKA_ID_CLUSTER, EBML_STOP },
744 { MATROSKA_ID_CUES, EBML_NONE },
745 { MATROSKA_ID_TAGS, EBML_NONE },
746 { MATROSKA_ID_INFO, EBML_NONE },
747 { MATROSKA_ID_TRACKS, EBML_NONE },
748 { MATROSKA_ID_ATTACHMENTS, EBML_NONE },
749 { MATROSKA_ID_CHAPTERS, EBML_NONE },
750 { MATROSKA_ID_SEEKHEAD, EBML_NONE },
751 { 0 } /* We don't want to go back to level 0, so don't add the parent. */
755 static const char *const matroska_doctypes[] = { "matroska", "webm" };
757 static int matroska_read_close(AVFormatContext *s);
760 * This function prepares the status for parsing of level 1 elements.
762 static int matroska_reset_status(MatroskaDemuxContext *matroska,
763 uint32_t id, int64_t position)
766 int err = avio_seek(matroska->ctx->pb, position, SEEK_SET);
771 matroska->current_id = id;
772 matroska->num_levels = 1;
773 matroska->current_cluster.pos = 0;
774 matroska->resync_pos = avio_tell(matroska->ctx->pb);
776 matroska->resync_pos -= (av_log2(id) + 7) / 8;
781 static int matroska_resync(MatroskaDemuxContext *matroska, int64_t last_pos)
783 AVIOContext *pb = matroska->ctx->pb;
786 /* Try to seek to the last position to resync from. If this doesn't work,
787 * we resync from the earliest position available: The start of the buffer. */
788 if (last_pos < avio_tell(pb) && avio_seek(pb, last_pos + 1, SEEK_SET) < 0) {
789 av_log(matroska->ctx, AV_LOG_WARNING,
790 "Seek to desired resync point failed. Seeking to "
791 "earliest point available instead.\n");
792 avio_seek(pb, FFMAX(avio_tell(pb) + (pb->buffer - pb->buf_ptr),
793 last_pos + 1), SEEK_SET);
798 // try to find a toplevel element
799 while (!avio_feof(pb)) {
800 if (id == MATROSKA_ID_INFO || id == MATROSKA_ID_TRACKS ||
801 id == MATROSKA_ID_CUES || id == MATROSKA_ID_TAGS ||
802 id == MATROSKA_ID_SEEKHEAD || id == MATROSKA_ID_ATTACHMENTS ||
803 id == MATROSKA_ID_CLUSTER || id == MATROSKA_ID_CHAPTERS) {
804 /* Prepare the context for parsing of a level 1 element. */
805 matroska_reset_status(matroska, id, -1);
806 /* Given that we are here means that an error has occured,
807 * so treat the segment as unknown length in order not to
808 * discard valid data that happens to be beyond the designated
809 * end of the segment. */
810 matroska->levels[0].length = EBML_UNKNOWN_LENGTH;
813 id = (id << 8) | avio_r8(pb);
817 return pb->error ? pb->error : AVERROR_EOF;
821 * Read: an "EBML number", which is defined as a variable-length
822 * array of bytes. The first byte indicates the length by giving a
823 * number of 0-bits followed by a one. The position of the first
824 * "one" bit inside the first byte indicates the length of this
826 * Returns: number of bytes read, < 0 on error
828 static int ebml_read_num(MatroskaDemuxContext *matroska, AVIOContext *pb,
829 int max_size, uint64_t *number, int eof_forbidden)
835 /* The first byte tells us the length in bytes - except when it is zero. */
840 /* get the length of the EBML number */
841 read = 8 - ff_log2_tab[total];
843 if (!total || read > max_size) {
844 pos = avio_tell(pb) - 1;
846 av_log(matroska->ctx, AV_LOG_ERROR,
847 "0x00 at pos %"PRId64" (0x%"PRIx64") invalid as first byte "
848 "of an EBML number\n", pos, pos);
850 av_log(matroska->ctx, AV_LOG_ERROR,
851 "Length %d indicated by an EBML number's first byte 0x%02x "
852 "at pos %"PRId64" (0x%"PRIx64") exceeds max length %d.\n",
853 read, (uint8_t) total, pos, pos, max_size);
855 return AVERROR_INVALIDDATA;
858 /* read out length */
859 total ^= 1 << ff_log2_tab[total];
861 total = (total << 8) | avio_r8(pb);
863 if (pb->eof_reached) {
875 av_log(matroska->ctx, AV_LOG_ERROR,
876 "Read error at pos. %"PRIu64" (0x%"PRIx64")\n",
881 av_log(matroska->ctx, AV_LOG_ERROR, "File ended prematurely "
882 "at pos. %"PRIu64" (0x%"PRIx64")\n", pos, pos);
889 * Read a EBML length value.
890 * This needs special handling for the "unknown length" case which has multiple
893 static int ebml_read_length(MatroskaDemuxContext *matroska, AVIOContext *pb,
896 int res = ebml_read_num(matroska, pb, 8, number, 1);
897 if (res > 0 && *number + 1 == 1ULL << (7 * res))
898 *number = EBML_UNKNOWN_LENGTH;
903 * Read the next element as an unsigned int.
904 * Returns NEEDS_CHECKING.
906 static int ebml_read_uint(AVIOContext *pb, int size, uint64_t *num)
910 /* big-endian ordering; build up number */
913 *num = (*num << 8) | avio_r8(pb);
915 return NEEDS_CHECKING;
919 * Read the next element as a signed int.
920 * Returns NEEDS_CHECKING.
922 static int ebml_read_sint(AVIOContext *pb, int size, int64_t *num)
929 *num = sign_extend(avio_r8(pb), 8);
931 /* big-endian ordering; build up number */
933 *num = ((uint64_t)*num << 8) | avio_r8(pb);
936 return NEEDS_CHECKING;
940 * Read the next element as a float.
941 * Returns NEEDS_CHECKING or < 0 on obvious failure.
943 static int ebml_read_float(AVIOContext *pb, int size, double *num)
948 *num = av_int2float(avio_rb32(pb));
950 *num = av_int2double(avio_rb64(pb));
952 return AVERROR_INVALIDDATA;
954 return NEEDS_CHECKING;
958 * Read the next element as an ASCII string.
959 * 0 is success, < 0 or NEEDS_CHECKING is failure.
961 static int ebml_read_ascii(AVIOContext *pb, int size, char **str)
966 /* EBML strings are usually not 0-terminated, so we allocate one
967 * byte more, read the string and NULL-terminate it ourselves. */
968 if (!(res = av_malloc(size + 1)))
969 return AVERROR(ENOMEM);
970 if ((ret = avio_read(pb, (uint8_t *) res, size)) != size) {
972 return ret < 0 ? ret : NEEDS_CHECKING;
982 * Read the next element as binary data.
983 * 0 is success, < 0 or NEEDS_CHECKING is failure.
985 static int ebml_read_binary(AVIOContext *pb, int length, EbmlBin *bin)
989 ret = av_buffer_realloc(&bin->buf, length + AV_INPUT_BUFFER_PADDING_SIZE);
992 memset(bin->buf->data + length, 0, AV_INPUT_BUFFER_PADDING_SIZE);
994 bin->data = bin->buf->data;
996 bin->pos = avio_tell(pb);
997 if ((ret = avio_read(pb, bin->data, length)) != length) {
998 av_buffer_unref(&bin->buf);
1001 return ret < 0 ? ret : NEEDS_CHECKING;
1008 * Read the next element, but only the header. The contents
1009 * are supposed to be sub-elements which can be read separately.
1010 * 0 is success, < 0 is failure.
1012 static int ebml_read_master(MatroskaDemuxContext *matroska, uint64_t length)
1014 AVIOContext *pb = matroska->ctx->pb;
1015 MatroskaLevel *level;
1017 if (matroska->num_levels >= EBML_MAX_DEPTH) {
1018 av_log(matroska->ctx, AV_LOG_ERROR,
1019 "File moves beyond max. allowed depth (%d)\n", EBML_MAX_DEPTH);
1020 return AVERROR(ENOSYS);
1023 level = &matroska->levels[matroska->num_levels++];
1024 level->start = avio_tell(pb);
1025 level->length = length;
1031 * Read signed/unsigned "EBML" numbers.
1032 * Return: number of bytes processed, < 0 on error
1034 static int matroska_ebmlnum_uint(MatroskaDemuxContext *matroska,
1035 uint8_t *data, uint32_t size, uint64_t *num)
1038 ffio_init_context(&pb, data, size, 0, NULL, NULL, NULL, NULL);
1039 return ebml_read_num(matroska, &pb, FFMIN(size, 8), num, 1);
1043 * Same as above, but signed.
1045 static int matroska_ebmlnum_sint(MatroskaDemuxContext *matroska,
1046 uint8_t *data, uint32_t size, int64_t *num)
1051 /* read as unsigned number first */
1052 if ((res = matroska_ebmlnum_uint(matroska, data, size, &unum)) < 0)
1055 /* make signed (weird way) */
1056 *num = unum - ((1LL << (7 * res - 1)) - 1);
1061 static int ebml_parse(MatroskaDemuxContext *matroska,
1062 EbmlSyntax *syntax, void *data);
1064 static EbmlSyntax *ebml_parse_id(EbmlSyntax *syntax, uint32_t id)
1067 for (i = 0; syntax[i].id; i++)
1068 if (id == syntax[i].id)
1074 static int ebml_parse_nest(MatroskaDemuxContext *matroska, EbmlSyntax *syntax,
1079 for (i = 0; syntax[i].id; i++)
1080 switch (syntax[i].type) {
1082 *(int64_t *) ((char *) data + syntax[i].data_offset) = syntax[i].def.i;
1085 *(uint64_t *) ((char *) data + syntax[i].data_offset) = syntax[i].def.u;
1088 *(double *) ((char *) data + syntax[i].data_offset) = syntax[i].def.f;
1092 // the default may be NULL
1093 if (syntax[i].def.s) {
1094 uint8_t **dst = (uint8_t **) ((uint8_t *) data + syntax[i].data_offset);
1095 *dst = av_strdup(syntax[i].def.s);
1097 return AVERROR(ENOMEM);
1102 if (!matroska->levels[matroska->num_levels - 1].length) {
1103 matroska->num_levels--;
1108 res = ebml_parse(matroska, syntax, data);
1111 return res == LEVEL_ENDED ? 0 : res;
1114 static int is_ebml_id_valid(uint32_t id)
1116 // Due to endian nonsense in Matroska, the highest byte with any bits set
1117 // will contain the leading length bit. This bit in turn identifies the
1118 // total byte length of the element by its position within the byte.
1119 unsigned int bits = av_log2(id);
1120 return id && (bits + 7) / 8 == (8 - bits % 8);
1124 * Allocate and return the entry for the level1 element with the given ID. If
1125 * an entry already exists, return the existing entry.
1127 static MatroskaLevel1Element *matroska_find_level1_elem(MatroskaDemuxContext *matroska,
1131 MatroskaLevel1Element *elem;
1133 if (!is_ebml_id_valid(id))
1136 // Some files link to all clusters; useless.
1137 if (id == MATROSKA_ID_CLUSTER)
1140 // There can be multiple seekheads.
1141 if (id != MATROSKA_ID_SEEKHEAD) {
1142 for (i = 0; i < matroska->num_level1_elems; i++) {
1143 if (matroska->level1_elems[i].id == id)
1144 return &matroska->level1_elems[i];
1148 // Only a completely broken file would have more elements.
1149 // It also provides a low-effort way to escape from circular seekheads
1150 // (every iteration will add a level1 entry).
1151 if (matroska->num_level1_elems >= FF_ARRAY_ELEMS(matroska->level1_elems)) {
1152 av_log(matroska->ctx, AV_LOG_ERROR, "Too many level1 elements or circular seekheads.\n");
1156 elem = &matroska->level1_elems[matroska->num_level1_elems++];
1157 *elem = (MatroskaLevel1Element){.id = id};
1162 static int ebml_parse(MatroskaDemuxContext *matroska,
1163 EbmlSyntax *syntax, void *data)
1165 static const uint64_t max_lengths[EBML_TYPE_COUNT] = {
1169 // max. 16 MB for strings
1170 [EBML_STR] = 0x1000000,
1171 [EBML_UTF8] = 0x1000000,
1172 // max. 256 MB for binary data
1173 [EBML_BIN] = 0x10000000,
1174 // no limits for anything else
1176 AVIOContext *pb = matroska->ctx->pb;
1179 int64_t pos = avio_tell(pb);
1180 int res, update_pos = 1, level_check;
1182 MatroskaLevel1Element *level1_elem;
1183 MatroskaLevel *level = matroska->num_levels ? &matroska->levels[matroska->num_levels - 1] : NULL;
1185 if (!matroska->current_id) {
1187 res = ebml_read_num(matroska, pb, 4, &id, 0);
1189 if (pb->eof_reached && res == AVERROR_EOF) {
1190 if (matroska->is_live)
1191 // in live mode, finish parsing if EOF is reached.
1193 if (level && level->length == EBML_UNKNOWN_LENGTH && pos == avio_tell(pb)) {
1194 // Unknown-length levels automatically end at EOF.
1195 matroska->num_levels--;
1201 matroska->current_id = id | 1 << 7 * res;
1203 pos -= (av_log2(matroska->current_id) + 7) / 8;
1205 id = matroska->current_id;
1207 syntax = ebml_parse_id(syntax, id);
1208 if (!syntax->id && id != EBML_ID_VOID && id != EBML_ID_CRC32) {
1209 if (level && level->length == EBML_UNKNOWN_LENGTH) {
1210 // Unknown-length levels end when an element from an upper level
1211 // in the hierarchy is encountered.
1212 while (syntax->def.n) {
1213 syntax = ebml_parse_id(syntax->def.n, id);
1215 matroska->num_levels--;
1221 av_log(matroska->ctx, AV_LOG_DEBUG, "Unknown entry 0x%"PRIX32" at pos. "
1222 "%"PRId64"\n", id, pos);
1223 update_pos = 0; /* Don't update resync_pos as an error might have happened. */
1226 data = (char *) data + syntax->data_offset;
1227 if (syntax->list_elem_size) {
1228 EbmlList *list = data;
1229 newelem = av_realloc_array(list->elem, list->nb_elem + 1, syntax->list_elem_size);
1231 return AVERROR(ENOMEM);
1232 list->elem = newelem;
1233 data = (char *) list->elem + list->nb_elem * syntax->list_elem_size;
1234 memset(data, 0, syntax->list_elem_size);
1238 if (syntax->type != EBML_STOP) {
1239 matroska->current_id = 0;
1240 if ((res = ebml_read_length(matroska, pb, &length)) < 0)
1242 if (max_lengths[syntax->type] && length > max_lengths[syntax->type]) {
1243 av_log(matroska->ctx, AV_LOG_ERROR,
1244 "Invalid length 0x%"PRIx64" > 0x%"PRIx64" for syntax element %i\n",
1245 length, max_lengths[syntax->type], syntax->type);
1246 return AVERROR_INVALIDDATA;
1248 if (matroska->num_levels > 0) {
1249 MatroskaLevel *level = &matroska->levels[matroska->num_levels - 1];
1250 AVIOContext *pb = matroska->ctx->pb;
1251 int64_t pos = avio_tell(pb);
1253 if (length != EBML_UNKNOWN_LENGTH &&
1254 level->length != EBML_UNKNOWN_LENGTH) {
1255 uint64_t elem_end = pos + length,
1256 level_end = level->start + level->length;
1258 if (elem_end < level_end) {
1260 } else if (elem_end == level_end) {
1261 level_check = LEVEL_ENDED;
1263 av_log(matroska->ctx, AV_LOG_ERROR,
1264 "Element at 0x%"PRIx64" ending at 0x%"PRIx64" exceeds "
1265 "containing master element ending at 0x%"PRIx64"\n",
1266 pos, elem_end, level_end);
1267 return AVERROR_INVALIDDATA;
1269 } else if (length != EBML_UNKNOWN_LENGTH) {
1271 } else if (level->length != EBML_UNKNOWN_LENGTH) {
1272 av_log(matroska->ctx, AV_LOG_ERROR, "Unknown-sized element "
1273 "at 0x%"PRIx64" inside parent with finite size\n", pos);
1274 return AVERROR_INVALIDDATA;
1275 } else if (id != MATROSKA_ID_CLUSTER) {
1276 // According to the specifications only clusters and segments
1277 // are allowed to be unknown-sized.
1278 av_log(matroska->ctx, AV_LOG_ERROR,
1279 "Found unknown-sized element other than a cluster at "
1280 "0x%"PRIx64". Dropping the invalid element.\n", pos);
1281 return AVERROR_INVALIDDATA;
1288 // We have found an element that is allowed at this place
1289 // in the hierarchy and it passed all checks, so treat the beginning
1290 // of the element as the "last known good" position.
1291 matroska->resync_pos = pos;
1295 switch (syntax->type) {
1297 res = ebml_read_uint(pb, length, data);
1300 res = ebml_read_sint(pb, length, data);
1303 res = ebml_read_float(pb, length, data);
1307 res = ebml_read_ascii(pb, length, data);
1310 res = ebml_read_binary(pb, length, data);
1314 if ((res = ebml_read_master(matroska, length)) < 0)
1316 if (id == MATROSKA_ID_SEGMENT)
1317 matroska->segment_start = avio_tell(matroska->ctx->pb);
1318 if (id == MATROSKA_ID_CUES)
1319 matroska->cues_parsing_deferred = 0;
1320 if (syntax->type == EBML_LEVEL1 &&
1321 (level1_elem = matroska_find_level1_elem(matroska, syntax->id))) {
1322 if (level1_elem->parsed)
1323 av_log(matroska->ctx, AV_LOG_ERROR, "Duplicate element\n");
1324 level1_elem->parsed = 1;
1326 if (res = ebml_parse_nest(matroska, syntax->def.n, data))
1334 if (ffio_limit(pb, length) != length) {
1335 // ffio_limit emits its own error message,
1336 // so we don't have to.
1337 return AVERROR(EIO);
1339 if ((res2 = avio_skip(pb, length - 1)) >= 0) {
1340 // avio_skip might take us past EOF. We check for this
1341 // by skipping only length - 1 bytes, reading a byte and
1342 // checking the error flags. This is done in order to check
1343 // that the element has been properly skipped even when
1344 // no filesize (that ffio_limit relies on) is available.
1346 res = NEEDS_CHECKING;
1353 if (res == NEEDS_CHECKING) {
1354 if (pb->eof_reached) {
1363 if (res == AVERROR_INVALIDDATA)
1364 av_log(matroska->ctx, AV_LOG_ERROR, "Invalid element\n");
1365 else if (res == AVERROR(EIO))
1366 av_log(matroska->ctx, AV_LOG_ERROR, "Read error\n");
1367 else if (res == AVERROR_EOF) {
1368 av_log(matroska->ctx, AV_LOG_ERROR, "File ended prematurely\n");
1376 if (level_check == LEVEL_ENDED && matroska->num_levels) {
1377 level = &matroska->levels[matroska->num_levels - 1];
1378 pos = avio_tell(pb);
1380 // Given that pos >= level->start no check for
1381 // level->length != EBML_UNKNOWN_LENGTH is necessary.
1382 while (matroska->num_levels && pos == level->start + level->length) {
1383 matroska->num_levels--;
1391 static void ebml_free(EbmlSyntax *syntax, void *data)
1394 for (i = 0; syntax[i].id; i++) {
1395 void *data_off = (char *) data + syntax[i].data_offset;
1396 switch (syntax[i].type) {
1402 av_buffer_unref(&((EbmlBin *) data_off)->buf);
1406 if (syntax[i].list_elem_size) {
1407 EbmlList *list = data_off;
1408 char *ptr = list->elem;
1409 for (j = 0; j < list->nb_elem;
1410 j++, ptr += syntax[i].list_elem_size)
1411 ebml_free(syntax[i].def.n, ptr);
1412 av_freep(&list->elem);
1415 ebml_free(syntax[i].def.n, data_off);
1425 static int matroska_probe(const AVProbeData *p)
1428 int len_mask = 0x80, size = 1, n = 1, i;
1431 if (AV_RB32(p->buf) != EBML_ID_HEADER)
1434 /* length of header */
1436 while (size <= 8 && !(total & len_mask)) {
1442 total &= (len_mask - 1);
1444 total = (total << 8) | p->buf[4 + n++];
1446 /* Does the probe data contain the whole header? */
1447 if (p->buf_size < 4 + size + total)
1450 /* The header should contain a known document type. For now,
1451 * we don't parse the whole header but simply check for the
1452 * availability of that array of characters inside the header.
1453 * Not fully fool-proof, but good enough. */
1454 for (i = 0; i < FF_ARRAY_ELEMS(matroska_doctypes); i++) {
1455 size_t probelen = strlen(matroska_doctypes[i]);
1456 if (total < probelen)
1458 for (n = 4 + size; n <= 4 + size + total - probelen; n++)
1459 if (!memcmp(p->buf + n, matroska_doctypes[i], probelen))
1460 return AVPROBE_SCORE_MAX;
1463 // probably valid EBML header but no recognized doctype
1464 return AVPROBE_SCORE_EXTENSION;
1467 static MatroskaTrack *matroska_find_track_by_num(MatroskaDemuxContext *matroska,
1470 MatroskaTrack *tracks = matroska->tracks.elem;
1473 for (i = 0; i < matroska->tracks.nb_elem; i++)
1474 if (tracks[i].num == num)
1477 av_log(matroska->ctx, AV_LOG_ERROR, "Invalid track number %d\n", num);
1481 static int matroska_decode_buffer(uint8_t **buf, int *buf_size,
1482 MatroskaTrack *track)
1484 MatroskaTrackEncoding *encodings = track->encodings.elem;
1485 uint8_t *data = *buf;
1486 int isize = *buf_size;
1487 uint8_t *pkt_data = NULL;
1488 uint8_t av_unused *newpktdata;
1489 int pkt_size = isize;
1493 if (pkt_size >= 10000000U)
1494 return AVERROR_INVALIDDATA;
1496 switch (encodings[0].compression.algo) {
1497 case MATROSKA_TRACK_ENCODING_COMP_HEADERSTRIP:
1499 int header_size = encodings[0].compression.settings.size;
1500 uint8_t *header = encodings[0].compression.settings.data;
1502 if (header_size && !header) {
1503 av_log(NULL, AV_LOG_ERROR, "Compression size but no data in headerstrip\n");
1510 pkt_size = isize + header_size;
1511 pkt_data = av_malloc(pkt_size + AV_INPUT_BUFFER_PADDING_SIZE);
1513 return AVERROR(ENOMEM);
1515 memcpy(pkt_data, header, header_size);
1516 memcpy(pkt_data + header_size, data, isize);
1520 case MATROSKA_TRACK_ENCODING_COMP_LZO:
1522 olen = pkt_size *= 3;
1523 newpktdata = av_realloc(pkt_data, pkt_size + AV_LZO_OUTPUT_PADDING
1524 + AV_INPUT_BUFFER_PADDING_SIZE);
1526 result = AVERROR(ENOMEM);
1529 pkt_data = newpktdata;
1530 result = av_lzo1x_decode(pkt_data, &olen, data, &isize);
1531 } while (result == AV_LZO_OUTPUT_FULL && pkt_size < 10000000);
1533 result = AVERROR_INVALIDDATA;
1540 case MATROSKA_TRACK_ENCODING_COMP_ZLIB:
1542 z_stream zstream = { 0 };
1543 if (inflateInit(&zstream) != Z_OK)
1545 zstream.next_in = data;
1546 zstream.avail_in = isize;
1549 newpktdata = av_realloc(pkt_data, pkt_size + AV_INPUT_BUFFER_PADDING_SIZE);
1551 inflateEnd(&zstream);
1552 result = AVERROR(ENOMEM);
1555 pkt_data = newpktdata;
1556 zstream.avail_out = pkt_size - zstream.total_out;
1557 zstream.next_out = pkt_data + zstream.total_out;
1558 result = inflate(&zstream, Z_NO_FLUSH);
1559 } while (result == Z_OK && pkt_size < 10000000);
1560 pkt_size = zstream.total_out;
1561 inflateEnd(&zstream);
1562 if (result != Z_STREAM_END) {
1563 if (result == Z_MEM_ERROR)
1564 result = AVERROR(ENOMEM);
1566 result = AVERROR_INVALIDDATA;
1573 case MATROSKA_TRACK_ENCODING_COMP_BZLIB:
1575 bz_stream bzstream = { 0 };
1576 if (BZ2_bzDecompressInit(&bzstream, 0, 0) != BZ_OK)
1578 bzstream.next_in = data;
1579 bzstream.avail_in = isize;
1582 newpktdata = av_realloc(pkt_data, pkt_size + AV_INPUT_BUFFER_PADDING_SIZE);
1584 BZ2_bzDecompressEnd(&bzstream);
1585 result = AVERROR(ENOMEM);
1588 pkt_data = newpktdata;
1589 bzstream.avail_out = pkt_size - bzstream.total_out_lo32;
1590 bzstream.next_out = pkt_data + bzstream.total_out_lo32;
1591 result = BZ2_bzDecompress(&bzstream);
1592 } while (result == BZ_OK && pkt_size < 10000000);
1593 pkt_size = bzstream.total_out_lo32;
1594 BZ2_bzDecompressEnd(&bzstream);
1595 if (result != BZ_STREAM_END) {
1596 if (result == BZ_MEM_ERROR)
1597 result = AVERROR(ENOMEM);
1599 result = AVERROR_INVALIDDATA;
1606 return AVERROR_INVALIDDATA;
1609 memset(pkt_data + pkt_size, 0, AV_INPUT_BUFFER_PADDING_SIZE);
1612 *buf_size = pkt_size;
1620 static void matroska_convert_tag(AVFormatContext *s, EbmlList *list,
1621 AVDictionary **metadata, char *prefix)
1623 MatroskaTag *tags = list->elem;
1627 for (i = 0; i < list->nb_elem; i++) {
1628 const char *lang = tags[i].lang &&
1629 strcmp(tags[i].lang, "und") ? tags[i].lang : NULL;
1631 if (!tags[i].name) {
1632 av_log(s, AV_LOG_WARNING, "Skipping invalid tag with no TagName.\n");
1636 snprintf(key, sizeof(key), "%s/%s", prefix, tags[i].name);
1638 av_strlcpy(key, tags[i].name, sizeof(key));
1639 if (tags[i].def || !lang) {
1640 av_dict_set(metadata, key, tags[i].string, 0);
1641 if (tags[i].sub.nb_elem)
1642 matroska_convert_tag(s, &tags[i].sub, metadata, key);
1645 av_strlcat(key, "-", sizeof(key));
1646 av_strlcat(key, lang, sizeof(key));
1647 av_dict_set(metadata, key, tags[i].string, 0);
1648 if (tags[i].sub.nb_elem)
1649 matroska_convert_tag(s, &tags[i].sub, metadata, key);
1652 ff_metadata_conv(metadata, NULL, ff_mkv_metadata_conv);
1655 static void matroska_convert_tags(AVFormatContext *s)
1657 MatroskaDemuxContext *matroska = s->priv_data;
1658 MatroskaTags *tags = matroska->tags.elem;
1661 for (i = 0; i < matroska->tags.nb_elem; i++) {
1662 if (tags[i].target.attachuid) {
1663 MatroskaAttachment *attachment = matroska->attachments.elem;
1665 for (j = 0; j < matroska->attachments.nb_elem; j++) {
1666 if (attachment[j].uid == tags[i].target.attachuid &&
1667 attachment[j].stream) {
1668 matroska_convert_tag(s, &tags[i].tag,
1669 &attachment[j].stream->metadata, NULL);
1674 av_log(NULL, AV_LOG_WARNING,
1675 "The tags at index %d refer to a "
1676 "non-existent attachment %"PRId64".\n",
1677 i, tags[i].target.attachuid);
1679 } else if (tags[i].target.chapteruid) {
1680 MatroskaChapter *chapter = matroska->chapters.elem;
1682 for (j = 0; j < matroska->chapters.nb_elem; j++) {
1683 if (chapter[j].uid == tags[i].target.chapteruid &&
1684 chapter[j].chapter) {
1685 matroska_convert_tag(s, &tags[i].tag,
1686 &chapter[j].chapter->metadata, NULL);
1691 av_log(NULL, AV_LOG_WARNING,
1692 "The tags at index %d refer to a non-existent chapter "
1694 i, tags[i].target.chapteruid);
1696 } else if (tags[i].target.trackuid) {
1697 MatroskaTrack *track = matroska->tracks.elem;
1699 for (j = 0; j < matroska->tracks.nb_elem; j++) {
1700 if (track[j].uid == tags[i].target.trackuid &&
1702 matroska_convert_tag(s, &tags[i].tag,
1703 &track[j].stream->metadata, NULL);
1708 av_log(NULL, AV_LOG_WARNING,
1709 "The tags at index %d refer to a non-existent track "
1711 i, tags[i].target.trackuid);
1714 matroska_convert_tag(s, &tags[i].tag, &s->metadata,
1715 tags[i].target.type);
1720 static int matroska_parse_seekhead_entry(MatroskaDemuxContext *matroska,
1723 uint32_t saved_id = matroska->current_id;
1724 int64_t before_pos = avio_tell(matroska->ctx->pb);
1725 MatroskaLevel level;
1730 offset = pos + matroska->segment_start;
1731 if (avio_seek(matroska->ctx->pb, offset, SEEK_SET) == offset) {
1732 /* We don't want to lose our seekhead level, so we add
1733 * a dummy. This is a crude hack. */
1734 if (matroska->num_levels == EBML_MAX_DEPTH) {
1735 av_log(matroska->ctx, AV_LOG_INFO,
1736 "Max EBML element depth (%d) reached, "
1737 "cannot parse further.\n", EBML_MAX_DEPTH);
1738 ret = AVERROR_INVALIDDATA;
1741 level.length = EBML_UNKNOWN_LENGTH;
1742 matroska->levels[matroska->num_levels] = level;
1743 matroska->num_levels++;
1744 matroska->current_id = 0;
1746 ret = ebml_parse(matroska, matroska_segment, matroska);
1747 if (ret == LEVEL_ENDED) {
1748 /* This can only happen if the seek brought us beyond EOF. */
1753 /* Seek back - notice that in all instances where this is used it is safe
1754 * to set the level to 1 and unset the position of the current cluster. */
1755 matroska_reset_status(matroska, saved_id, before_pos);
1760 static void matroska_execute_seekhead(MatroskaDemuxContext *matroska)
1762 EbmlList *seekhead_list = &matroska->seekhead;
1765 // we should not do any seeking in the streaming case
1766 if (!(matroska->ctx->pb->seekable & AVIO_SEEKABLE_NORMAL))
1769 for (i = 0; i < seekhead_list->nb_elem; i++) {
1770 MatroskaSeekhead *seekheads = seekhead_list->elem;
1771 uint32_t id = seekheads[i].id;
1772 uint64_t pos = seekheads[i].pos;
1774 MatroskaLevel1Element *elem = matroska_find_level1_elem(matroska, id);
1775 if (!elem || elem->parsed)
1780 // defer cues parsing until we actually need cue data.
1781 if (id == MATROSKA_ID_CUES)
1784 if (matroska_parse_seekhead_entry(matroska, pos) < 0) {
1785 // mark index as broken
1786 matroska->cues_parsing_deferred = -1;
1794 static void matroska_add_index_entries(MatroskaDemuxContext *matroska)
1796 EbmlList *index_list;
1797 MatroskaIndex *index;
1798 uint64_t index_scale = 1;
1801 if (matroska->ctx->flags & AVFMT_FLAG_IGNIDX)
1804 index_list = &matroska->index;
1805 index = index_list->elem;
1806 if (index_list->nb_elem < 2)
1808 if (index[1].time > 1E14 / matroska->time_scale) {
1809 av_log(matroska->ctx, AV_LOG_WARNING, "Dropping apparently-broken index.\n");
1812 for (i = 0; i < index_list->nb_elem; i++) {
1813 EbmlList *pos_list = &index[i].pos;
1814 MatroskaIndexPos *pos = pos_list->elem;
1815 for (j = 0; j < pos_list->nb_elem; j++) {
1816 MatroskaTrack *track = matroska_find_track_by_num(matroska,
1818 if (track && track->stream)
1819 av_add_index_entry(track->stream,
1820 pos[j].pos + matroska->segment_start,
1821 index[i].time / index_scale, 0, 0,
1827 static void matroska_parse_cues(MatroskaDemuxContext *matroska) {
1830 if (matroska->ctx->flags & AVFMT_FLAG_IGNIDX)
1833 for (i = 0; i < matroska->num_level1_elems; i++) {
1834 MatroskaLevel1Element *elem = &matroska->level1_elems[i];
1835 if (elem->id == MATROSKA_ID_CUES && !elem->parsed) {
1836 if (matroska_parse_seekhead_entry(matroska, elem->pos) < 0)
1837 matroska->cues_parsing_deferred = -1;
1843 matroska_add_index_entries(matroska);
1846 static int matroska_aac_profile(char *codec_id)
1848 static const char *const aac_profiles[] = { "MAIN", "LC", "SSR" };
1851 for (profile = 0; profile < FF_ARRAY_ELEMS(aac_profiles); profile++)
1852 if (strstr(codec_id, aac_profiles[profile]))
1857 static int matroska_aac_sri(int samplerate)
1861 for (sri = 0; sri < FF_ARRAY_ELEMS(avpriv_mpeg4audio_sample_rates); sri++)
1862 if (avpriv_mpeg4audio_sample_rates[sri] == samplerate)
1867 static void matroska_metadata_creation_time(AVDictionary **metadata, int64_t date_utc)
1869 /* Convert to seconds and adjust by number of seconds between 2001-01-01 and Epoch */
1870 avpriv_dict_set_timestamp(metadata, "creation_time", date_utc / 1000 + 978307200000000LL);
1873 static int matroska_parse_flac(AVFormatContext *s,
1874 MatroskaTrack *track,
1877 AVStream *st = track->stream;
1878 uint8_t *p = track->codec_priv.data;
1879 int size = track->codec_priv.size;
1881 if (size < 8 + FLAC_STREAMINFO_SIZE || p[4] & 0x7f) {
1882 av_log(s, AV_LOG_WARNING, "Invalid FLAC private data\n");
1883 track->codec_priv.size = 0;
1887 track->codec_priv.size = 8 + FLAC_STREAMINFO_SIZE;
1889 p += track->codec_priv.size;
1890 size -= track->codec_priv.size;
1892 /* parse the remaining metadata blocks if present */
1894 int block_last, block_type, block_size;
1896 flac_parse_block_header(p, &block_last, &block_type, &block_size);
1900 if (block_size > size)
1903 /* check for the channel mask */
1904 if (block_type == FLAC_METADATA_TYPE_VORBIS_COMMENT) {
1905 AVDictionary *dict = NULL;
1906 AVDictionaryEntry *chmask;
1908 ff_vorbis_comment(s, &dict, p, block_size, 0);
1909 chmask = av_dict_get(dict, "WAVEFORMATEXTENSIBLE_CHANNEL_MASK", NULL, 0);
1911 uint64_t mask = strtol(chmask->value, NULL, 0);
1912 if (!mask || mask & ~0x3ffffULL) {
1913 av_log(s, AV_LOG_WARNING,
1914 "Invalid value of WAVEFORMATEXTENSIBLE_CHANNEL_MASK\n");
1916 st->codecpar->channel_layout = mask;
1918 av_dict_free(&dict);
1928 static int mkv_field_order(MatroskaDemuxContext *matroska, int64_t field_order)
1930 int major, minor, micro, bttb = 0;
1932 /* workaround a bug in our Matroska muxer, introduced in version 57.36 alongside
1933 * this function, and fixed in 57.52 */
1934 if (matroska->muxingapp && sscanf(matroska->muxingapp, "Lavf%d.%d.%d", &major, &minor, µ) == 3)
1935 bttb = (major == 57 && minor >= 36 && minor <= 51 && micro >= 100);
1937 switch (field_order) {
1938 case MATROSKA_VIDEO_FIELDORDER_PROGRESSIVE:
1939 return AV_FIELD_PROGRESSIVE;
1940 case MATROSKA_VIDEO_FIELDORDER_UNDETERMINED:
1941 return AV_FIELD_UNKNOWN;
1942 case MATROSKA_VIDEO_FIELDORDER_TT:
1944 case MATROSKA_VIDEO_FIELDORDER_BB:
1946 case MATROSKA_VIDEO_FIELDORDER_BT:
1947 return bttb ? AV_FIELD_TB : AV_FIELD_BT;
1948 case MATROSKA_VIDEO_FIELDORDER_TB:
1949 return bttb ? AV_FIELD_BT : AV_FIELD_TB;
1951 return AV_FIELD_UNKNOWN;
1955 static void mkv_stereo_mode_display_mul(int stereo_mode,
1956 int *h_width, int *h_height)
1958 switch (stereo_mode) {
1959 case MATROSKA_VIDEO_STEREOMODE_TYPE_MONO:
1960 case MATROSKA_VIDEO_STEREOMODE_TYPE_CHECKERBOARD_RL:
1961 case MATROSKA_VIDEO_STEREOMODE_TYPE_CHECKERBOARD_LR:
1962 case MATROSKA_VIDEO_STEREOMODE_TYPE_BOTH_EYES_BLOCK_RL:
1963 case MATROSKA_VIDEO_STEREOMODE_TYPE_BOTH_EYES_BLOCK_LR:
1965 case MATROSKA_VIDEO_STEREOMODE_TYPE_RIGHT_LEFT:
1966 case MATROSKA_VIDEO_STEREOMODE_TYPE_LEFT_RIGHT:
1967 case MATROSKA_VIDEO_STEREOMODE_TYPE_COL_INTERLEAVED_RL:
1968 case MATROSKA_VIDEO_STEREOMODE_TYPE_COL_INTERLEAVED_LR:
1971 case MATROSKA_VIDEO_STEREOMODE_TYPE_BOTTOM_TOP:
1972 case MATROSKA_VIDEO_STEREOMODE_TYPE_TOP_BOTTOM:
1973 case MATROSKA_VIDEO_STEREOMODE_TYPE_ROW_INTERLEAVED_RL:
1974 case MATROSKA_VIDEO_STEREOMODE_TYPE_ROW_INTERLEAVED_LR:
1980 static int mkv_parse_video_color(AVStream *st, const MatroskaTrack *track) {
1981 const MatroskaTrackVideoColor *color = track->video.color.elem;
1982 const MatroskaMasteringMeta *mastering_meta;
1983 int has_mastering_primaries, has_mastering_luminance;
1985 if (!track->video.color.nb_elem)
1988 mastering_meta = &color->mastering_meta;
1989 // Mastering primaries are CIE 1931 coords, and must be > 0.
1990 has_mastering_primaries =
1991 mastering_meta->r_x > 0 && mastering_meta->r_y > 0 &&
1992 mastering_meta->g_x > 0 && mastering_meta->g_y > 0 &&
1993 mastering_meta->b_x > 0 && mastering_meta->b_y > 0 &&
1994 mastering_meta->white_x > 0 && mastering_meta->white_y > 0;
1995 has_mastering_luminance = mastering_meta->max_luminance > 0;
1997 if (color->matrix_coefficients != AVCOL_SPC_RESERVED)
1998 st->codecpar->color_space = color->matrix_coefficients;
1999 if (color->primaries != AVCOL_PRI_RESERVED &&
2000 color->primaries != AVCOL_PRI_RESERVED0)
2001 st->codecpar->color_primaries = color->primaries;
2002 if (color->transfer_characteristics != AVCOL_TRC_RESERVED &&
2003 color->transfer_characteristics != AVCOL_TRC_RESERVED0)
2004 st->codecpar->color_trc = color->transfer_characteristics;
2005 if (color->range != AVCOL_RANGE_UNSPECIFIED &&
2006 color->range <= AVCOL_RANGE_JPEG)
2007 st->codecpar->color_range = color->range;
2008 if (color->chroma_siting_horz != MATROSKA_COLOUR_CHROMASITINGHORZ_UNDETERMINED &&
2009 color->chroma_siting_vert != MATROSKA_COLOUR_CHROMASITINGVERT_UNDETERMINED &&
2010 color->chroma_siting_horz < MATROSKA_COLOUR_CHROMASITINGHORZ_NB &&
2011 color->chroma_siting_vert < MATROSKA_COLOUR_CHROMASITINGVERT_NB) {
2012 st->codecpar->chroma_location =
2013 avcodec_chroma_pos_to_enum((color->chroma_siting_horz - 1) << 7,
2014 (color->chroma_siting_vert - 1) << 7);
2016 if (color->max_cll && color->max_fall) {
2019 AVContentLightMetadata *metadata = av_content_light_metadata_alloc(&size);
2021 return AVERROR(ENOMEM);
2022 ret = av_stream_add_side_data(st, AV_PKT_DATA_CONTENT_LIGHT_LEVEL,
2023 (uint8_t *)metadata, size);
2025 av_freep(&metadata);
2028 metadata->MaxCLL = color->max_cll;
2029 metadata->MaxFALL = color->max_fall;
2032 if (has_mastering_primaries || has_mastering_luminance) {
2033 // Use similar rationals as other standards.
2034 const int chroma_den = 50000;
2035 const int luma_den = 10000;
2036 AVMasteringDisplayMetadata *metadata =
2037 (AVMasteringDisplayMetadata*) av_stream_new_side_data(
2038 st, AV_PKT_DATA_MASTERING_DISPLAY_METADATA,
2039 sizeof(AVMasteringDisplayMetadata));
2041 return AVERROR(ENOMEM);
2043 memset(metadata, 0, sizeof(AVMasteringDisplayMetadata));
2044 if (has_mastering_primaries) {
2045 metadata->display_primaries[0][0] = av_make_q(
2046 round(mastering_meta->r_x * chroma_den), chroma_den);
2047 metadata->display_primaries[0][1] = av_make_q(
2048 round(mastering_meta->r_y * chroma_den), chroma_den);
2049 metadata->display_primaries[1][0] = av_make_q(
2050 round(mastering_meta->g_x * chroma_den), chroma_den);
2051 metadata->display_primaries[1][1] = av_make_q(
2052 round(mastering_meta->g_y * chroma_den), chroma_den);
2053 metadata->display_primaries[2][0] = av_make_q(
2054 round(mastering_meta->b_x * chroma_den), chroma_den);
2055 metadata->display_primaries[2][1] = av_make_q(
2056 round(mastering_meta->b_y * chroma_den), chroma_den);
2057 metadata->white_point[0] = av_make_q(
2058 round(mastering_meta->white_x * chroma_den), chroma_den);
2059 metadata->white_point[1] = av_make_q(
2060 round(mastering_meta->white_y * chroma_den), chroma_den);
2061 metadata->has_primaries = 1;
2063 if (has_mastering_luminance) {
2064 metadata->max_luminance = av_make_q(
2065 round(mastering_meta->max_luminance * luma_den), luma_den);
2066 metadata->min_luminance = av_make_q(
2067 round(mastering_meta->min_luminance * luma_den), luma_den);
2068 metadata->has_luminance = 1;
2074 static int mkv_parse_video_projection(AVStream *st, const MatroskaTrack *track) {
2075 AVSphericalMapping *spherical;
2076 enum AVSphericalProjection projection;
2077 size_t spherical_size;
2078 uint32_t l = 0, t = 0, r = 0, b = 0;
2079 uint32_t padding = 0;
2083 bytestream2_init(&gb, track->video.projection.private.data,
2084 track->video.projection.private.size);
2086 if (bytestream2_get_byte(&gb) != 0) {
2087 av_log(NULL, AV_LOG_WARNING, "Unknown spherical metadata\n");
2091 bytestream2_skip(&gb, 3); // flags
2093 switch (track->video.projection.type) {
2094 case MATROSKA_VIDEO_PROJECTION_TYPE_EQUIRECTANGULAR:
2095 if (track->video.projection.private.size == 20) {
2096 t = bytestream2_get_be32(&gb);
2097 b = bytestream2_get_be32(&gb);
2098 l = bytestream2_get_be32(&gb);
2099 r = bytestream2_get_be32(&gb);
2101 if (b >= UINT_MAX - t || r >= UINT_MAX - l) {
2102 av_log(NULL, AV_LOG_ERROR,
2103 "Invalid bounding rectangle coordinates "
2104 "%"PRIu32",%"PRIu32",%"PRIu32",%"PRIu32"\n",
2106 return AVERROR_INVALIDDATA;
2108 } else if (track->video.projection.private.size != 0) {
2109 av_log(NULL, AV_LOG_ERROR, "Unknown spherical metadata\n");
2110 return AVERROR_INVALIDDATA;
2113 if (l || t || r || b)
2114 projection = AV_SPHERICAL_EQUIRECTANGULAR_TILE;
2116 projection = AV_SPHERICAL_EQUIRECTANGULAR;
2118 case MATROSKA_VIDEO_PROJECTION_TYPE_CUBEMAP:
2119 if (track->video.projection.private.size < 4) {
2120 av_log(NULL, AV_LOG_ERROR, "Missing projection private properties\n");
2121 return AVERROR_INVALIDDATA;
2122 } else if (track->video.projection.private.size == 12) {
2123 uint32_t layout = bytestream2_get_be32(&gb);
2125 av_log(NULL, AV_LOG_WARNING,
2126 "Unknown spherical cubemap layout %"PRIu32"\n", layout);
2129 projection = AV_SPHERICAL_CUBEMAP;
2130 padding = bytestream2_get_be32(&gb);
2132 av_log(NULL, AV_LOG_ERROR, "Unknown spherical metadata\n");
2133 return AVERROR_INVALIDDATA;
2136 case MATROSKA_VIDEO_PROJECTION_TYPE_RECTANGULAR:
2137 /* No Spherical metadata */
2140 av_log(NULL, AV_LOG_WARNING,
2141 "Unknown spherical metadata type %"PRIu64"\n",
2142 track->video.projection.type);
2146 spherical = av_spherical_alloc(&spherical_size);
2148 return AVERROR(ENOMEM);
2150 spherical->projection = projection;
2152 spherical->yaw = (int32_t) (track->video.projection.yaw * (1 << 16));
2153 spherical->pitch = (int32_t) (track->video.projection.pitch * (1 << 16));
2154 spherical->roll = (int32_t) (track->video.projection.roll * (1 << 16));
2156 spherical->padding = padding;
2158 spherical->bound_left = l;
2159 spherical->bound_top = t;
2160 spherical->bound_right = r;
2161 spherical->bound_bottom = b;
2163 ret = av_stream_add_side_data(st, AV_PKT_DATA_SPHERICAL, (uint8_t *)spherical,
2166 av_freep(&spherical);
2173 static int get_qt_codec(MatroskaTrack *track, uint32_t *fourcc, enum AVCodecID *codec_id)
2175 const AVCodecTag *codec_tags;
2177 codec_tags = track->type == MATROSKA_TRACK_TYPE_VIDEO ?
2178 ff_codec_movvideo_tags : ff_codec_movaudio_tags;
2180 /* Normalize noncompliant private data that starts with the fourcc
2181 * by expanding/shifting the data by 4 bytes and storing the data
2182 * size at the start. */
2183 if (ff_codec_get_id(codec_tags, AV_RL32(track->codec_priv.data))) {
2184 int ret = av_buffer_realloc(&track->codec_priv.buf,
2185 track->codec_priv.size + 4 + AV_INPUT_BUFFER_PADDING_SIZE);
2189 track->codec_priv.data = track->codec_priv.buf->data;
2190 memmove(track->codec_priv.data + 4, track->codec_priv.data, track->codec_priv.size);
2191 track->codec_priv.size += 4;
2192 AV_WB32(track->codec_priv.data, track->codec_priv.size);
2195 *fourcc = AV_RL32(track->codec_priv.data + 4);
2196 *codec_id = ff_codec_get_id(codec_tags, *fourcc);
2201 static int matroska_parse_tracks(AVFormatContext *s)
2203 MatroskaDemuxContext *matroska = s->priv_data;
2204 MatroskaTrack *tracks = matroska->tracks.elem;
2209 for (i = 0; i < matroska->tracks.nb_elem; i++) {
2210 MatroskaTrack *track = &tracks[i];
2211 enum AVCodecID codec_id = AV_CODEC_ID_NONE;
2212 EbmlList *encodings_list = &track->encodings;
2213 MatroskaTrackEncoding *encodings = encodings_list->elem;
2214 uint8_t *extradata = NULL;
2215 int extradata_size = 0;
2216 int extradata_offset = 0;
2217 uint32_t fourcc = 0;
2219 char* key_id_base64 = NULL;
2222 /* Apply some sanity checks. */
2223 if (track->type != MATROSKA_TRACK_TYPE_VIDEO &&
2224 track->type != MATROSKA_TRACK_TYPE_AUDIO &&
2225 track->type != MATROSKA_TRACK_TYPE_SUBTITLE &&
2226 track->type != MATROSKA_TRACK_TYPE_METADATA) {
2227 av_log(matroska->ctx, AV_LOG_INFO,
2228 "Unknown or unsupported track type %"PRIu64"\n",
2232 if (!track->codec_id)
2235 if (track->audio.samplerate < 0 || track->audio.samplerate > INT_MAX ||
2236 isnan(track->audio.samplerate)) {
2237 av_log(matroska->ctx, AV_LOG_WARNING,
2238 "Invalid sample rate %f, defaulting to 8000 instead.\n",
2239 track->audio.samplerate);
2240 track->audio.samplerate = 8000;
2243 if (track->type == MATROSKA_TRACK_TYPE_VIDEO) {
2244 if (!track->default_duration && track->video.frame_rate > 0) {
2245 double default_duration = 1000000000 / track->video.frame_rate;
2246 if (default_duration > UINT64_MAX || default_duration < 0) {
2247 av_log(matroska->ctx, AV_LOG_WARNING,
2248 "Invalid frame rate %e. Cannot calculate default duration.\n",
2249 track->video.frame_rate);
2251 track->default_duration = default_duration;
2254 if (track->video.display_width == -1)
2255 track->video.display_width = track->video.pixel_width;
2256 if (track->video.display_height == -1)
2257 track->video.display_height = track->video.pixel_height;
2258 if (track->video.color_space.size == 4)
2259 fourcc = AV_RL32(track->video.color_space.data);
2260 } else if (track->type == MATROSKA_TRACK_TYPE_AUDIO) {
2261 if (!track->audio.out_samplerate)
2262 track->audio.out_samplerate = track->audio.samplerate;
2264 if (encodings_list->nb_elem > 1) {
2265 av_log(matroska->ctx, AV_LOG_ERROR,
2266 "Multiple combined encodings not supported");
2267 } else if (encodings_list->nb_elem == 1) {
2268 if (encodings[0].type) {
2269 if (encodings[0].encryption.key_id.size > 0) {
2270 /* Save the encryption key id to be stored later as a
2272 const int b64_size = AV_BASE64_SIZE(encodings[0].encryption.key_id.size);
2273 key_id_base64 = av_malloc(b64_size);
2274 if (key_id_base64 == NULL)
2275 return AVERROR(ENOMEM);
2277 av_base64_encode(key_id_base64, b64_size,
2278 encodings[0].encryption.key_id.data,
2279 encodings[0].encryption.key_id.size);
2281 encodings[0].scope = 0;
2282 av_log(matroska->ctx, AV_LOG_ERROR,
2283 "Unsupported encoding type");
2287 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_ZLIB &&
2290 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_BZLIB &&
2293 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_LZO &&
2295 encodings[0].compression.algo != MATROSKA_TRACK_ENCODING_COMP_HEADERSTRIP) {
2296 encodings[0].scope = 0;
2297 av_log(matroska->ctx, AV_LOG_ERROR,
2298 "Unsupported encoding type");
2299 } else if (track->codec_priv.size && encodings[0].scope & 2) {
2300 uint8_t *codec_priv = track->codec_priv.data;
2301 int ret = matroska_decode_buffer(&track->codec_priv.data,
2302 &track->codec_priv.size,
2305 track->codec_priv.data = NULL;
2306 track->codec_priv.size = 0;
2307 av_log(matroska->ctx, AV_LOG_ERROR,
2308 "Failed to decode codec private data\n");
2311 if (codec_priv != track->codec_priv.data) {
2312 av_buffer_unref(&track->codec_priv.buf);
2313 if (track->codec_priv.data) {
2314 track->codec_priv.buf = av_buffer_create(track->codec_priv.data,
2315 track->codec_priv.size + AV_INPUT_BUFFER_PADDING_SIZE,
2317 if (!track->codec_priv.buf) {
2318 av_freep(&track->codec_priv.data);
2319 track->codec_priv.size = 0;
2320 return AVERROR(ENOMEM);
2327 for (j = 0; ff_mkv_codec_tags[j].id != AV_CODEC_ID_NONE; j++) {
2328 if (!strncmp(ff_mkv_codec_tags[j].str, track->codec_id,
2329 strlen(ff_mkv_codec_tags[j].str))) {
2330 codec_id = ff_mkv_codec_tags[j].id;
2335 st = track->stream = avformat_new_stream(s, NULL);
2337 av_free(key_id_base64);
2338 return AVERROR(ENOMEM);
2341 if (key_id_base64) {
2342 /* export encryption key id as base64 metadata tag */
2343 av_dict_set(&st->metadata, "enc_key_id", key_id_base64, 0);
2344 av_freep(&key_id_base64);
2347 if (!strcmp(track->codec_id, "V_MS/VFW/FOURCC") &&
2348 track->codec_priv.size >= 40 &&
2349 track->codec_priv.data) {
2350 track->ms_compat = 1;
2351 bit_depth = AV_RL16(track->codec_priv.data + 14);
2352 fourcc = AV_RL32(track->codec_priv.data + 16);
2353 codec_id = ff_codec_get_id(ff_codec_bmp_tags,
2356 codec_id = ff_codec_get_id(ff_codec_movvideo_tags,
2358 extradata_offset = 40;
2359 } else if (!strcmp(track->codec_id, "A_MS/ACM") &&
2360 track->codec_priv.size >= 14 &&
2361 track->codec_priv.data) {
2363 ffio_init_context(&b, track->codec_priv.data,
2364 track->codec_priv.size,
2365 0, NULL, NULL, NULL, NULL);
2366 ret = ff_get_wav_header(s, &b, st->codecpar, track->codec_priv.size, 0);
2369 codec_id = st->codecpar->codec_id;
2370 fourcc = st->codecpar->codec_tag;
2371 extradata_offset = FFMIN(track->codec_priv.size, 18);
2372 } else if (!strcmp(track->codec_id, "A_QUICKTIME")
2373 /* Normally 36, but allow noncompliant private data */
2374 && (track->codec_priv.size >= 32)
2375 && (track->codec_priv.data)) {
2376 uint16_t sample_size;
2377 int ret = get_qt_codec(track, &fourcc, &codec_id);
2380 sample_size = AV_RB16(track->codec_priv.data + 26);
2382 if (sample_size == 8) {
2383 fourcc = MKTAG('r','a','w',' ');
2384 codec_id = ff_codec_get_id(ff_codec_movaudio_tags, fourcc);
2385 } else if (sample_size == 16) {
2386 fourcc = MKTAG('t','w','o','s');
2387 codec_id = ff_codec_get_id(ff_codec_movaudio_tags, fourcc);
2390 if ((fourcc == MKTAG('t','w','o','s') ||
2391 fourcc == MKTAG('s','o','w','t')) &&
2393 codec_id = AV_CODEC_ID_PCM_S8;
2394 } else if (!strcmp(track->codec_id, "V_QUICKTIME") &&
2395 (track->codec_priv.size >= 21) &&
2396 (track->codec_priv.data)) {
2397 int ret = get_qt_codec(track, &fourcc, &codec_id);
2400 if (codec_id == AV_CODEC_ID_NONE && AV_RL32(track->codec_priv.data+4) == AV_RL32("SMI ")) {
2401 fourcc = MKTAG('S','V','Q','3');
2402 codec_id = ff_codec_get_id(ff_codec_movvideo_tags, fourcc);
2404 if (codec_id == AV_CODEC_ID_NONE)
2405 av_log(matroska->ctx, AV_LOG_ERROR,
2406 "mov FourCC not found %s.\n", av_fourcc2str(fourcc));
2407 if (track->codec_priv.size >= 86) {
2408 bit_depth = AV_RB16(track->codec_priv.data + 82);
2409 ffio_init_context(&b, track->codec_priv.data,
2410 track->codec_priv.size,
2411 0, NULL, NULL, NULL, NULL);
2412 if (ff_get_qtpalette(codec_id, &b, track->palette)) {
2414 track->has_palette = 1;
2417 } else if (codec_id == AV_CODEC_ID_PCM_S16BE) {
2418 switch (track->audio.bitdepth) {
2420 codec_id = AV_CODEC_ID_PCM_U8;
2423 codec_id = AV_CODEC_ID_PCM_S24BE;
2426 codec_id = AV_CODEC_ID_PCM_S32BE;
2429 } else if (codec_id == AV_CODEC_ID_PCM_S16LE) {
2430 switch (track->audio.bitdepth) {
2432 codec_id = AV_CODEC_ID_PCM_U8;
2435 codec_id = AV_CODEC_ID_PCM_S24LE;
2438 codec_id = AV_CODEC_ID_PCM_S32LE;
2441 } else if (codec_id == AV_CODEC_ID_PCM_F32LE &&
2442 track->audio.bitdepth == 64) {
2443 codec_id = AV_CODEC_ID_PCM_F64LE;
2444 } else if (codec_id == AV_CODEC_ID_AAC && !track->codec_priv.size) {
2445 int profile = matroska_aac_profile(track->codec_id);
2446 int sri = matroska_aac_sri(track->audio.samplerate);
2447 extradata = av_mallocz(5 + AV_INPUT_BUFFER_PADDING_SIZE);
2449 return AVERROR(ENOMEM);
2450 extradata[0] = (profile << 3) | ((sri & 0x0E) >> 1);
2451 extradata[1] = ((sri & 0x01) << 7) | (track->audio.channels << 3);
2452 if (strstr(track->codec_id, "SBR")) {
2453 sri = matroska_aac_sri(track->audio.out_samplerate);
2454 extradata[2] = 0x56;
2455 extradata[3] = 0xE5;
2456 extradata[4] = 0x80 | (sri << 3);
2460 } else if (codec_id == AV_CODEC_ID_ALAC && track->codec_priv.size && track->codec_priv.size < INT_MAX - 12 - AV_INPUT_BUFFER_PADDING_SIZE) {
2461 /* Only ALAC's magic cookie is stored in Matroska's track headers.
2462 * Create the "atom size", "tag", and "tag version" fields the
2463 * decoder expects manually. */
2464 extradata_size = 12 + track->codec_priv.size;
2465 extradata = av_mallocz(extradata_size +
2466 AV_INPUT_BUFFER_PADDING_SIZE);
2468 return AVERROR(ENOMEM);
2469 AV_WB32(extradata, extradata_size);
2470 memcpy(&extradata[4], "alac", 4);
2471 AV_WB32(&extradata[8], 0);
2472 memcpy(&extradata[12], track->codec_priv.data,
2473 track->codec_priv.size);
2474 } else if (codec_id == AV_CODEC_ID_TTA) {
2475 extradata_size = 30;
2476 extradata = av_mallocz(extradata_size + AV_INPUT_BUFFER_PADDING_SIZE);
2478 return AVERROR(ENOMEM);
2479 ffio_init_context(&b, extradata, extradata_size, 1,
2480 NULL, NULL, NULL, NULL);
2481 avio_write(&b, "TTA1", 4);
2483 if (track->audio.channels > UINT16_MAX ||
2484 track->audio.bitdepth > UINT16_MAX) {
2485 av_log(matroska->ctx, AV_LOG_WARNING,
2486 "Too large audio channel number %"PRIu64
2487 " or bitdepth %"PRIu64". Skipping track.\n",
2488 track->audio.channels, track->audio.bitdepth);
2489 av_freep(&extradata);
2490 if (matroska->ctx->error_recognition & AV_EF_EXPLODE)
2491 return AVERROR_INVALIDDATA;
2495 avio_wl16(&b, track->audio.channels);
2496 avio_wl16(&b, track->audio.bitdepth);
2497 if (track->audio.out_samplerate < 0 || track->audio.out_samplerate > INT_MAX)
2498 return AVERROR_INVALIDDATA;
2499 avio_wl32(&b, track->audio.out_samplerate);
2500 avio_wl32(&b, av_rescale((matroska->duration * matroska->time_scale),
2501 track->audio.out_samplerate,
2502 AV_TIME_BASE * 1000));
2503 } else if (codec_id == AV_CODEC_ID_RV10 ||
2504 codec_id == AV_CODEC_ID_RV20 ||
2505 codec_id == AV_CODEC_ID_RV30 ||
2506 codec_id == AV_CODEC_ID_RV40) {
2507 extradata_offset = 26;
2508 } else if (codec_id == AV_CODEC_ID_RA_144) {
2509 track->audio.out_samplerate = 8000;
2510 track->audio.channels = 1;
2511 } else if ((codec_id == AV_CODEC_ID_RA_288 ||
2512 codec_id == AV_CODEC_ID_COOK ||
2513 codec_id == AV_CODEC_ID_ATRAC3 ||
2514 codec_id == AV_CODEC_ID_SIPR)
2515 && track->codec_priv.data) {
2518 ffio_init_context(&b, track->codec_priv.data,
2519 track->codec_priv.size,
2520 0, NULL, NULL, NULL, NULL);
2522 flavor = avio_rb16(&b);
2523 track->audio.coded_framesize = avio_rb32(&b);
2525 track->audio.sub_packet_h = avio_rb16(&b);
2526 track->audio.frame_size = avio_rb16(&b);
2527 track->audio.sub_packet_size = avio_rb16(&b);
2529 track->audio.coded_framesize <= 0 ||
2530 track->audio.sub_packet_h <= 0 ||
2531 track->audio.frame_size <= 0 ||
2532 track->audio.sub_packet_size <= 0 && codec_id != AV_CODEC_ID_SIPR)
2533 return AVERROR_INVALIDDATA;
2534 track->audio.buf = av_malloc_array(track->audio.sub_packet_h,
2535 track->audio.frame_size);
2536 if (!track->audio.buf)
2537 return AVERROR(ENOMEM);
2538 if (codec_id == AV_CODEC_ID_RA_288) {
2539 st->codecpar->block_align = track->audio.coded_framesize;
2540 track->codec_priv.size = 0;
2542 if (codec_id == AV_CODEC_ID_SIPR && flavor < 4) {
2543 static const int sipr_bit_rate[4] = { 6504, 8496, 5000, 16000 };
2544 track->audio.sub_packet_size = ff_sipr_subpk_size[flavor];
2545 st->codecpar->bit_rate = sipr_bit_rate[flavor];
2547 st->codecpar->block_align = track->audio.sub_packet_size;
2548 extradata_offset = 78;
2550 } else if (codec_id == AV_CODEC_ID_FLAC && track->codec_priv.size) {
2551 ret = matroska_parse_flac(s, track, &extradata_offset);
2554 } else if (codec_id == AV_CODEC_ID_PRORES && track->codec_priv.size == 4) {
2555 fourcc = AV_RL32(track->codec_priv.data);
2556 } else if (codec_id == AV_CODEC_ID_VP9 && track->codec_priv.size) {
2557 /* we don't need any value stored in CodecPrivate.
2558 make sure that it's not exported as extradata. */
2559 track->codec_priv.size = 0;
2560 } else if (codec_id == AV_CODEC_ID_AV1 && track->codec_priv.size) {
2561 /* For now, propagate only the OBUs, if any. Once libavcodec is
2562 updated to handle isobmff style extradata this can be removed. */
2563 extradata_offset = 4;
2565 track->codec_priv.size -= extradata_offset;
2567 if (codec_id == AV_CODEC_ID_NONE)
2568 av_log(matroska->ctx, AV_LOG_INFO,
2569 "Unknown/unsupported AVCodecID %s.\n", track->codec_id);
2571 if (track->time_scale < 0.01)
2572 track->time_scale = 1.0;
2573 avpriv_set_pts_info(st, 64, matroska->time_scale * track->time_scale,
2574 1000 * 1000 * 1000); /* 64 bit pts in ns */
2576 /* convert the delay from ns to the track timebase */
2577 track->codec_delay_in_track_tb = av_rescale_q(track->codec_delay,
2578 (AVRational){ 1, 1000000000 },
2581 st->codecpar->codec_id = codec_id;
2583 if (strcmp(track->language, "und"))
2584 av_dict_set(&st->metadata, "language", track->language, 0);
2585 av_dict_set(&st->metadata, "title", track->name, 0);
2587 if (track->flag_default)
2588 st->disposition |= AV_DISPOSITION_DEFAULT;
2589 if (track->flag_forced)
2590 st->disposition |= AV_DISPOSITION_FORCED;
2592 if (!st->codecpar->extradata) {
2594 st->codecpar->extradata = extradata;
2595 st->codecpar->extradata_size = extradata_size;
2596 } else if (track->codec_priv.data && track->codec_priv.size > 0) {
2597 if (ff_alloc_extradata(st->codecpar, track->codec_priv.size))
2598 return AVERROR(ENOMEM);
2599 memcpy(st->codecpar->extradata,
2600 track->codec_priv.data + extradata_offset,
2601 track->codec_priv.size);
2605 if (track->type == MATROSKA_TRACK_TYPE_VIDEO) {
2606 MatroskaTrackPlane *planes = track->operation.combine_planes.elem;
2607 int display_width_mul = 1;
2608 int display_height_mul = 1;
2610 st->codecpar->codec_type = AVMEDIA_TYPE_VIDEO;
2611 st->codecpar->codec_tag = fourcc;
2613 st->codecpar->bits_per_coded_sample = bit_depth;
2614 st->codecpar->width = track->video.pixel_width;
2615 st->codecpar->height = track->video.pixel_height;
2617 if (track->video.interlaced == MATROSKA_VIDEO_INTERLACE_FLAG_INTERLACED)
2618 st->codecpar->field_order = mkv_field_order(matroska, track->video.field_order);
2619 else if (track->video.interlaced == MATROSKA_VIDEO_INTERLACE_FLAG_PROGRESSIVE)
2620 st->codecpar->field_order = AV_FIELD_PROGRESSIVE;
2622 if (track->video.stereo_mode && track->video.stereo_mode < MATROSKA_VIDEO_STEREOMODE_TYPE_NB)
2623 mkv_stereo_mode_display_mul(track->video.stereo_mode, &display_width_mul, &display_height_mul);
2625 if (track->video.display_unit < MATROSKA_VIDEO_DISPLAYUNIT_UNKNOWN) {
2626 av_reduce(&st->sample_aspect_ratio.num,
2627 &st->sample_aspect_ratio.den,
2628 st->codecpar->height * track->video.display_width * display_width_mul,
2629 st->codecpar->width * track->video.display_height * display_height_mul,
2632 if (st->codecpar->codec_id != AV_CODEC_ID_HEVC)
2633 st->need_parsing = AVSTREAM_PARSE_HEADERS;
2635 if (track->default_duration) {
2636 av_reduce(&st->avg_frame_rate.num, &st->avg_frame_rate.den,
2637 1000000000, track->default_duration, 30000);
2638 #if FF_API_R_FRAME_RATE
2639 if ( st->avg_frame_rate.num < st->avg_frame_rate.den * 1000LL
2640 && st->avg_frame_rate.num > st->avg_frame_rate.den * 5LL)
2641 st->r_frame_rate = st->avg_frame_rate;
2645 /* export stereo mode flag as metadata tag */
2646 if (track->video.stereo_mode && track->video.stereo_mode < MATROSKA_VIDEO_STEREOMODE_TYPE_NB)
2647 av_dict_set(&st->metadata, "stereo_mode", ff_matroska_video_stereo_mode[track->video.stereo_mode], 0);
2649 /* export alpha mode flag as metadata tag */
2650 if (track->video.alpha_mode)
2651 av_dict_set(&st->metadata, "alpha_mode", "1", 0);
2653 /* if we have virtual track, mark the real tracks */
2654 for (j=0; j < track->operation.combine_planes.nb_elem; j++) {
2656 if (planes[j].type >= MATROSKA_VIDEO_STEREO_PLANE_COUNT)
2658 snprintf(buf, sizeof(buf), "%s_%d",
2659 ff_matroska_video_stereo_plane[planes[j].type], i);
2660 for (k=0; k < matroska->tracks.nb_elem; k++)
2661 if (planes[j].uid == tracks[k].uid && tracks[k].stream) {
2662 av_dict_set(&tracks[k].stream->metadata,
2663 "stereo_mode", buf, 0);
2667 // add stream level stereo3d side data if it is a supported format
2668 if (track->video.stereo_mode < MATROSKA_VIDEO_STEREOMODE_TYPE_NB &&
2669 track->video.stereo_mode != 10 && track->video.stereo_mode != 12) {
2670 int ret = ff_mkv_stereo3d_conv(st, track->video.stereo_mode);
2675 ret = mkv_parse_video_color(st, track);
2678 ret = mkv_parse_video_projection(st, track);
2681 } else if (track->type == MATROSKA_TRACK_TYPE_AUDIO) {
2682 st->codecpar->codec_type = AVMEDIA_TYPE_AUDIO;
2683 st->codecpar->codec_tag = fourcc;
2684 st->codecpar->sample_rate = track->audio.out_samplerate;
2685 st->codecpar->channels = track->audio.channels;
2686 if (!st->codecpar->bits_per_coded_sample)
2687 st->codecpar->bits_per_coded_sample = track->audio.bitdepth;
2688 if (st->codecpar->codec_id == AV_CODEC_ID_MP3 ||
2689 st->codecpar->codec_id == AV_CODEC_ID_MLP ||
2690 st->codecpar->codec_id == AV_CODEC_ID_TRUEHD)
2691 st->need_parsing = AVSTREAM_PARSE_FULL;
2692 else if (st->codecpar->codec_id != AV_CODEC_ID_AAC)
2693 st->need_parsing = AVSTREAM_PARSE_HEADERS;
2694 if (track->codec_delay > 0) {
2695 st->codecpar->initial_padding = av_rescale_q(track->codec_delay,
2696 (AVRational){1, 1000000000},
2697 (AVRational){1, st->codecpar->codec_id == AV_CODEC_ID_OPUS ?
2698 48000 : st->codecpar->sample_rate});
2700 if (track->seek_preroll > 0) {
2701 st->codecpar->seek_preroll = av_rescale_q(track->seek_preroll,
2702 (AVRational){1, 1000000000},
2703 (AVRational){1, st->codecpar->sample_rate});
2705 } else if (codec_id == AV_CODEC_ID_WEBVTT) {
2706 st->codecpar->codec_type = AVMEDIA_TYPE_SUBTITLE;
2708 if (!strcmp(track->codec_id, "D_WEBVTT/CAPTIONS")) {
2709 st->disposition |= AV_DISPOSITION_CAPTIONS;
2710 } else if (!strcmp(track->codec_id, "D_WEBVTT/DESCRIPTIONS")) {
2711 st->disposition |= AV_DISPOSITION_DESCRIPTIONS;
2712 } else if (!strcmp(track->codec_id, "D_WEBVTT/METADATA")) {
2713 st->disposition |= AV_DISPOSITION_METADATA;
2715 } else if (track->type == MATROSKA_TRACK_TYPE_SUBTITLE) {
2716 st->codecpar->codec_type = AVMEDIA_TYPE_SUBTITLE;
2723 static int matroska_read_header(AVFormatContext *s)
2725 MatroskaDemuxContext *matroska = s->priv_data;
2726 EbmlList *attachments_list = &matroska->attachments;
2727 EbmlList *chapters_list = &matroska->chapters;
2728 MatroskaAttachment *attachments;
2729 MatroskaChapter *chapters;
2730 uint64_t max_start = 0;
2736 matroska->cues_parsing_deferred = 1;
2738 /* First read the EBML header. */
2739 if (ebml_parse(matroska, ebml_syntax, &ebml) || !ebml.doctype) {
2740 av_log(matroska->ctx, AV_LOG_ERROR, "EBML header parsing failed\n");
2741 ebml_free(ebml_syntax, &ebml);
2742 return AVERROR_INVALIDDATA;
2744 if (ebml.version > EBML_VERSION ||
2745 ebml.max_size > sizeof(uint64_t) ||
2746 ebml.id_length > sizeof(uint32_t) ||
2747 ebml.doctype_version > 3) {
2748 avpriv_report_missing_feature(matroska->ctx,
2749 "EBML version %"PRIu64", doctype %s, doc version %"PRIu64,
2750 ebml.version, ebml.doctype, ebml.doctype_version);
2751 ebml_free(ebml_syntax, &ebml);
2752 return AVERROR_PATCHWELCOME;
2753 } else if (ebml.doctype_version == 3) {
2754 av_log(matroska->ctx, AV_LOG_WARNING,
2755 "EBML header using unsupported features\n"
2756 "(EBML version %"PRIu64", doctype %s, doc version %"PRIu64")\n",
2757 ebml.version, ebml.doctype, ebml.doctype_version);
2759 for (i = 0; i < FF_ARRAY_ELEMS(matroska_doctypes); i++)
2760 if (!strcmp(ebml.doctype, matroska_doctypes[i]))
2762 if (i >= FF_ARRAY_ELEMS(matroska_doctypes)) {
2763 av_log(s, AV_LOG_WARNING, "Unknown EBML doctype '%s'\n", ebml.doctype);
2764 if (matroska->ctx->error_recognition & AV_EF_EXPLODE) {
2765 ebml_free(ebml_syntax, &ebml);
2766 return AVERROR_INVALIDDATA;
2769 ebml_free(ebml_syntax, &ebml);
2771 /* The next thing is a segment. */
2772 pos = avio_tell(matroska->ctx->pb);
2773 res = ebml_parse(matroska, matroska_segments, matroska);
2774 // try resyncing until we find a EBML_STOP type element.
2776 res = matroska_resync(matroska, pos);
2779 pos = avio_tell(matroska->ctx->pb);
2780 res = ebml_parse(matroska, matroska_segment, matroska);
2782 /* Set data_offset as it might be needed later by seek_frame_generic. */
2783 if (matroska->current_id == MATROSKA_ID_CLUSTER)
2784 s->internal->data_offset = avio_tell(matroska->ctx->pb) - 4;
2785 matroska_execute_seekhead(matroska);
2787 if (!matroska->time_scale)
2788 matroska->time_scale = 1000000;
2789 if (matroska->duration)
2790 matroska->ctx->duration = matroska->duration * matroska->time_scale *
2791 1000 / AV_TIME_BASE;
2792 av_dict_set(&s->metadata, "title", matroska->title, 0);
2793 av_dict_set(&s->metadata, "encoder", matroska->muxingapp, 0);
2795 if (matroska->date_utc.size == 8)
2796 matroska_metadata_creation_time(&s->metadata, AV_RB64(matroska->date_utc.data));
2798 res = matroska_parse_tracks(s);
2802 attachments = attachments_list->elem;
2803 for (j = 0; j < attachments_list->nb_elem; j++) {
2804 if (!(attachments[j].filename && attachments[j].mime &&
2805 attachments[j].bin.data && attachments[j].bin.size > 0)) {
2806 av_log(matroska->ctx, AV_LOG_ERROR, "incomplete attachment\n");
2808 AVStream *st = avformat_new_stream(s, NULL);
2811 av_dict_set(&st->metadata, "filename", attachments[j].filename, 0);
2812 av_dict_set(&st->metadata, "mimetype", attachments[j].mime, 0);
2813 st->codecpar->codec_id = AV_CODEC_ID_NONE;
2815 for (i = 0; ff_mkv_image_mime_tags[i].id != AV_CODEC_ID_NONE; i++) {
2816 if (!strncmp(ff_mkv_image_mime_tags[i].str, attachments[j].mime,
2817 strlen(ff_mkv_image_mime_tags[i].str))) {
2818 st->codecpar->codec_id = ff_mkv_image_mime_tags[i].id;
2823 attachments[j].stream = st;
2825 if (st->codecpar->codec_id != AV_CODEC_ID_NONE) {
2826 AVPacket *pkt = &st->attached_pic;
2828 st->disposition |= AV_DISPOSITION_ATTACHED_PIC;
2829 st->codecpar->codec_type = AVMEDIA_TYPE_VIDEO;
2831 av_init_packet(pkt);
2832 pkt->buf = av_buffer_ref(attachments[j].bin.buf);
2834 return AVERROR(ENOMEM);
2835 pkt->data = attachments[j].bin.data;
2836 pkt->size = attachments[j].bin.size;
2837 pkt->stream_index = st->index;
2838 pkt->flags |= AV_PKT_FLAG_KEY;
2840 st->codecpar->codec_type = AVMEDIA_TYPE_ATTACHMENT;
2841 if (ff_alloc_extradata(st->codecpar, attachments[j].bin.size))
2843 memcpy(st->codecpar->extradata, attachments[j].bin.data,
2844 attachments[j].bin.size);
2846 for (i = 0; ff_mkv_mime_tags[i].id != AV_CODEC_ID_NONE; i++) {
2847 if (!strncmp(ff_mkv_mime_tags[i].str, attachments[j].mime,
2848 strlen(ff_mkv_mime_tags[i].str))) {
2849 st->codecpar->codec_id = ff_mkv_mime_tags[i].id;
2857 chapters = chapters_list->elem;
2858 for (i = 0; i < chapters_list->nb_elem; i++)
2859 if (chapters[i].start != AV_NOPTS_VALUE && chapters[i].uid &&
2860 (max_start == 0 || chapters[i].start > max_start)) {
2861 chapters[i].chapter =
2862 avpriv_new_chapter(s, chapters[i].uid,
2863 (AVRational) { 1, 1000000000 },
2864 chapters[i].start, chapters[i].end,
2866 if (chapters[i].chapter) {
2867 av_dict_set(&chapters[i].chapter->metadata,
2868 "title", chapters[i].title, 0);
2870 max_start = chapters[i].start;
2873 matroska_add_index_entries(matroska);
2875 matroska_convert_tags(s);
2879 matroska_read_close(s);
2884 * Put one packet in an application-supplied AVPacket struct.
2885 * Returns 0 on success or -1 on failure.
2887 static int matroska_deliver_packet(MatroskaDemuxContext *matroska,
2890 if (matroska->queue) {
2891 MatroskaTrack *tracks = matroska->tracks.elem;
2892 MatroskaTrack *track;
2894 ff_packet_list_get(&matroska->queue, &matroska->queue_end, pkt);
2895 track = &tracks[pkt->stream_index];
2896 if (track->has_palette) {
2897 uint8_t *pal = av_packet_new_side_data(pkt, AV_PKT_DATA_PALETTE, AVPALETTE_SIZE);
2899 av_log(matroska->ctx, AV_LOG_ERROR, "Cannot append palette to packet\n");
2901 memcpy(pal, track->palette, AVPALETTE_SIZE);
2903 track->has_palette = 0;
2912 * Free all packets in our internal queue.
2914 static void matroska_clear_queue(MatroskaDemuxContext *matroska)
2916 ff_packet_list_free(&matroska->queue, &matroska->queue_end);
2919 static int matroska_parse_laces(MatroskaDemuxContext *matroska, uint8_t **buf,
2920 int *buf_size, int type,
2921 uint32_t **lace_buf, int *laces)
2923 int res = 0, n, size = *buf_size;
2924 uint8_t *data = *buf;
2925 uint32_t *lace_size;
2929 *lace_buf = av_malloc(sizeof(**lace_buf));
2931 return AVERROR(ENOMEM);
2933 *lace_buf[0] = size;
2937 av_assert0(size > 0);
2941 lace_size = av_malloc_array(*laces, sizeof(*lace_size));
2943 return AVERROR(ENOMEM);
2946 case 0x1: /* Xiph lacing */
2950 for (n = 0; res == 0 && n < *laces - 1; n++) {
2954 if (size <= total) {
2955 res = AVERROR_INVALIDDATA;
2960 lace_size[n] += temp;
2967 if (size <= total) {
2968 res = AVERROR_INVALIDDATA;
2972 lace_size[n] = size - total;
2976 case 0x2: /* fixed-size lacing */
2977 if (size % (*laces)) {
2978 res = AVERROR_INVALIDDATA;
2981 for (n = 0; n < *laces; n++)
2982 lace_size[n] = size / *laces;
2985 case 0x3: /* EBML lacing */
2989 n = matroska_ebmlnum_uint(matroska, data, size, &num);
2990 if (n < 0 || num > INT_MAX) {
2991 av_log(matroska->ctx, AV_LOG_INFO,
2992 "EBML block data error\n");
2993 res = n<0 ? n : AVERROR_INVALIDDATA;
2998 total = lace_size[0] = num;
2999 for (n = 1; res == 0 && n < *laces - 1; n++) {
3002 r = matroska_ebmlnum_sint(matroska, data, size, &snum);
3003 if (r < 0 || lace_size[n - 1] + snum > (uint64_t)INT_MAX) {
3004 av_log(matroska->ctx, AV_LOG_INFO,
3005 "EBML block data error\n");
3006 res = r<0 ? r : AVERROR_INVALIDDATA;
3011 lace_size[n] = lace_size[n - 1] + snum;
3012 total += lace_size[n];
3014 if (size <= total) {
3015 res = AVERROR_INVALIDDATA;
3018 lace_size[*laces - 1] = size - total;
3024 *lace_buf = lace_size;
3030 static int matroska_parse_rm_audio(MatroskaDemuxContext *matroska,
3031 MatroskaTrack *track, AVStream *st,
3032 uint8_t *data, int size, uint64_t timecode,
3035 int a = st->codecpar->block_align;
3036 int sps = track->audio.sub_packet_size;
3037 int cfs = track->audio.coded_framesize;
3038 int h = track->audio.sub_packet_h;
3039 int y = track->audio.sub_packet_cnt;
3040 int w = track->audio.frame_size;
3043 if (!track->audio.pkt_cnt) {
3044 if (track->audio.sub_packet_cnt == 0)
3045 track->audio.buf_timecode = timecode;
3046 if (st->codecpar->codec_id == AV_CODEC_ID_RA_288) {
3047 if (size < cfs * h / 2) {
3048 av_log(matroska->ctx, AV_LOG_ERROR,
3049 "Corrupt int4 RM-style audio packet size\n");
3050 return AVERROR_INVALIDDATA;
3052 for (x = 0; x < h / 2; x++)
3053 memcpy(track->audio.buf + x * 2 * w + y * cfs,
3054 data + x * cfs, cfs);
3055 } else if (st->codecpar->codec_id == AV_CODEC_ID_SIPR) {
3057 av_log(matroska->ctx, AV_LOG_ERROR,
3058 "Corrupt sipr RM-style audio packet size\n");
3059 return AVERROR_INVALIDDATA;
3061 memcpy(track->audio.buf + y * w, data, w);
3063 if (size < sps * w / sps || h<=0 || w%sps) {
3064 av_log(matroska->ctx, AV_LOG_ERROR,
3065 "Corrupt generic RM-style audio packet size\n");
3066 return AVERROR_INVALIDDATA;
3068 for (x = 0; x < w / sps; x++)
3069 memcpy(track->audio.buf +
3070 sps * (h * x + ((h + 1) / 2) * (y & 1) + (y >> 1)),
3071 data + x * sps, sps);
3074 if (++track->audio.sub_packet_cnt >= h) {
3075 if (st->codecpar->codec_id == AV_CODEC_ID_SIPR)
3076 ff_rm_reorder_sipr_data(track->audio.buf, h, w);
3077 track->audio.sub_packet_cnt = 0;
3078 track->audio.pkt_cnt = h * w / a;
3082 while (track->audio.pkt_cnt) {
3084 AVPacket pktl, *pkt = &pktl;
3086 ret = av_new_packet(pkt, a);
3091 track->audio.buf + a * (h * w / a - track->audio.pkt_cnt--),
3093 pkt->pts = track->audio.buf_timecode;
3094 track->audio.buf_timecode = AV_NOPTS_VALUE;
3096 pkt->stream_index = st->index;
3097 ret = ff_packet_list_put(&matroska->queue, &matroska->queue_end, pkt, 0);
3099 av_packet_unref(pkt);
3100 return AVERROR(ENOMEM);
3107 /* reconstruct full wavpack blocks from mangled matroska ones */
3108 static int matroska_parse_wavpack(MatroskaTrack *track, uint8_t *src,
3109 uint8_t **pdst, int *size)
3111 uint8_t *dst = NULL;
3116 int ret, offset = 0;
3118 if (srclen < 12 || track->stream->codecpar->extradata_size < 2)
3119 return AVERROR_INVALIDDATA;
3121 ver = AV_RL16(track->stream->codecpar->extradata);
3123 samples = AV_RL32(src);
3127 while (srclen >= 8) {
3132 uint32_t flags = AV_RL32(src);
3133 uint32_t crc = AV_RL32(src + 4);
3137 multiblock = (flags & 0x1800) != 0x1800;
3140 ret = AVERROR_INVALIDDATA;
3143 blocksize = AV_RL32(src);
3149 if (blocksize > srclen) {
3150 ret = AVERROR_INVALIDDATA;
3154 tmp = av_realloc(dst, dstlen + blocksize + 32 + AV_INPUT_BUFFER_PADDING_SIZE);
3156 ret = AVERROR(ENOMEM);
3160 dstlen += blocksize + 32;
3162 AV_WL32(dst + offset, MKTAG('w', 'v', 'p', 'k')); // tag
3163 AV_WL32(dst + offset + 4, blocksize + 24); // blocksize - 8
3164 AV_WL16(dst + offset + 8, ver); // version
3165 AV_WL16(dst + offset + 10, 0); // track/index_no
3166 AV_WL32(dst + offset + 12, 0); // total samples
3167 AV_WL32(dst + offset + 16, 0); // block index
3168 AV_WL32(dst + offset + 20, samples); // number of samples
3169 AV_WL32(dst + offset + 24, flags); // flags
3170 AV_WL32(dst + offset + 28, crc); // crc
3171 memcpy(dst + offset + 32, src, blocksize); // block data
3174 srclen -= blocksize;
3175 offset += blocksize + 32;
3178 memset(dst + dstlen, 0, AV_INPUT_BUFFER_PADDING_SIZE);
3190 static int matroska_parse_prores(MatroskaTrack *track, uint8_t *src,
3191 uint8_t **pdst, int *size)
3196 if (AV_RB32(&src[4]) != MKBETAG('i', 'c', 'p', 'f')) {
3197 dst = av_malloc(dstlen + 8 + AV_INPUT_BUFFER_PADDING_SIZE);
3199 return AVERROR(ENOMEM);
3201 AV_WB32(dst, dstlen);
3202 AV_WB32(dst + 4, MKBETAG('i', 'c', 'p', 'f'));
3203 memcpy(dst + 8, src, dstlen);
3204 memset(dst + 8 + dstlen, 0, AV_INPUT_BUFFER_PADDING_SIZE);
3214 static int matroska_parse_webvtt(MatroskaDemuxContext *matroska,
3215 MatroskaTrack *track,
3217 uint8_t *data, int data_len,
3222 AVPacket pktl, *pkt = &pktl;
3223 uint8_t *id, *settings, *text, *buf;
3224 int id_len, settings_len, text_len;
3229 return AVERROR_INVALIDDATA;
3232 q = data + data_len;
3237 if (*p == '\r' || *p == '\n') {
3246 if (p >= q || *p != '\n')
3247 return AVERROR_INVALIDDATA;
3253 if (*p == '\r' || *p == '\n') {
3254 settings_len = p - settings;
3262 if (p >= q || *p != '\n')
3263 return AVERROR_INVALIDDATA;
3268 while (text_len > 0) {
3269 const int len = text_len - 1;
3270 const uint8_t c = p[len];
3271 if (c != '\r' && c != '\n')
3277 return AVERROR_INVALIDDATA;
3279 err = av_new_packet(pkt, text_len);
3284 memcpy(pkt->data, text, text_len);
3287 buf = av_packet_new_side_data(pkt,
3288 AV_PKT_DATA_WEBVTT_IDENTIFIER,
3291 av_packet_unref(pkt);
3292 return AVERROR(ENOMEM);
3294 memcpy(buf, id, id_len);
3297 if (settings_len > 0) {
3298 buf = av_packet_new_side_data(pkt,
3299 AV_PKT_DATA_WEBVTT_SETTINGS,
3302 av_packet_unref(pkt);
3303 return AVERROR(ENOMEM);
3305 memcpy(buf, settings, settings_len);
3308 // Do we need this for subtitles?
3309 // pkt->flags = AV_PKT_FLAG_KEY;
3311 pkt->stream_index = st->index;
3312 pkt->pts = timecode;
3314 // Do we need this for subtitles?
3315 // pkt->dts = timecode;
3317 pkt->duration = duration;
3320 err = ff_packet_list_put(&matroska->queue, &matroska->queue_end, pkt, 0);
3322 av_packet_unref(pkt);
3323 return AVERROR(ENOMEM);
3329 static int matroska_parse_frame(MatroskaDemuxContext *matroska,
3330 MatroskaTrack *track, AVStream *st,
3331 AVBufferRef *buf, uint8_t *data, int pkt_size,
3332 uint64_t timecode, uint64_t lace_duration,
3333 int64_t pos, int is_keyframe,
3334 uint8_t *additional, uint64_t additional_id, int additional_size,
3335 int64_t discard_padding)
3337 MatroskaTrackEncoding *encodings = track->encodings.elem;
3338 uint8_t *pkt_data = data;
3340 AVPacket pktl, *pkt = &pktl;
3342 if (encodings && !encodings->type && encodings->scope & 1) {
3343 res = matroska_decode_buffer(&pkt_data, &pkt_size, track);
3348 if (st->codecpar->codec_id == AV_CODEC_ID_WAVPACK) {
3350 res = matroska_parse_wavpack(track, pkt_data, &wv_data, &pkt_size);
3352 av_log(matroska->ctx, AV_LOG_ERROR,
3353 "Error parsing a wavpack block.\n");
3356 if (pkt_data != data)
3357 av_freep(&pkt_data);
3361 if (st->codecpar->codec_id == AV_CODEC_ID_PRORES) {
3363 res = matroska_parse_prores(track, pkt_data, &pr_data, &pkt_size);
3365 av_log(matroska->ctx, AV_LOG_ERROR,
3366 "Error parsing a prores block.\n");
3369 if (pkt_data != data)
3370 av_freep(&pkt_data);
3374 av_init_packet(pkt);
3375 if (pkt_data != data)
3376 pkt->buf = av_buffer_create(pkt_data, pkt_size + AV_INPUT_BUFFER_PADDING_SIZE,
3379 pkt->buf = av_buffer_ref(buf);
3382 res = AVERROR(ENOMEM);
3386 pkt->data = pkt_data;
3387 pkt->size = pkt_size;
3388 pkt->flags = is_keyframe;
3389 pkt->stream_index = st->index;
3391 if (additional_size > 0) {
3392 uint8_t *side_data = av_packet_new_side_data(pkt,
3393 AV_PKT_DATA_MATROSKA_BLOCKADDITIONAL,
3394 additional_size + 8);
3396 av_packet_unref(pkt);
3397 return AVERROR(ENOMEM);
3399 AV_WB64(side_data, additional_id);
3400 memcpy(side_data + 8, additional, additional_size);
3403 if (discard_padding) {
3404 uint8_t *side_data = av_packet_new_side_data(pkt,
3405 AV_PKT_DATA_SKIP_SAMPLES,
3408 av_packet_unref(pkt);
3409 return AVERROR(ENOMEM);
3411 discard_padding = av_rescale_q(discard_padding,
3412 (AVRational){1, 1000000000},
3413 (AVRational){1, st->codecpar->sample_rate});
3414 if (discard_padding > 0) {
3415 AV_WL32(side_data + 4, discard_padding);
3417 AV_WL32(side_data, -discard_padding);
3421 if (track->ms_compat)
3422 pkt->dts = timecode;
3424 pkt->pts = timecode;
3426 pkt->duration = lace_duration;
3428 #if FF_API_CONVERGENCE_DURATION
3429 FF_DISABLE_DEPRECATION_WARNINGS
3430 if (st->codecpar->codec_id == AV_CODEC_ID_SUBRIP) {
3431 pkt->convergence_duration = lace_duration;
3433 FF_ENABLE_DEPRECATION_WARNINGS
3436 res = ff_packet_list_put(&matroska->queue, &matroska->queue_end, pkt, 0);
3438 av_packet_unref(pkt);
3439 return AVERROR(ENOMEM);
3445 if (pkt_data != data)
3446 av_freep(&pkt_data);
3450 static int matroska_parse_block(MatroskaDemuxContext *matroska, AVBufferRef *buf, uint8_t *data,
3451 int size, int64_t pos, uint64_t cluster_time,
3452 uint64_t block_duration, int is_keyframe,
3453 uint8_t *additional, uint64_t additional_id, int additional_size,
3454 int64_t cluster_pos, int64_t discard_padding)
3456 uint64_t timecode = AV_NOPTS_VALUE;
3457 MatroskaTrack *track;
3461 uint32_t *lace_size = NULL;
3462 int n, flags, laces = 0;
3464 int trust_default_duration = 1;
3466 if ((n = matroska_ebmlnum_uint(matroska, data, size, &num)) < 0) {
3472 track = matroska_find_track_by_num(matroska, num);
3473 if (!track || !track->stream) {
3474 av_log(matroska->ctx, AV_LOG_INFO,
3475 "Invalid stream %"PRIu64"\n", num);
3476 return AVERROR_INVALIDDATA;
3477 } else if (size <= 3)
3480 if (st->discard >= AVDISCARD_ALL)
3482 av_assert1(block_duration != AV_NOPTS_VALUE);
3484 block_time = sign_extend(AV_RB16(data), 16);
3488 if (is_keyframe == -1)
3489 is_keyframe = flags & 0x80 ? AV_PKT_FLAG_KEY : 0;
3491 if (cluster_time != (uint64_t) -1 &&
3492 (block_time >= 0 || cluster_time >= -block_time)) {
3493 timecode = cluster_time + block_time - track->codec_delay_in_track_tb;
3494 if (track->type == MATROSKA_TRACK_TYPE_SUBTITLE &&
3495 timecode < track->end_timecode)
3496 is_keyframe = 0; /* overlapping subtitles are not key frame */
3498 ff_reduce_index(matroska->ctx, st->index);
3499 av_add_index_entry(st, cluster_pos, timecode, 0, 0,
3504 if (matroska->skip_to_keyframe &&
3505 track->type != MATROSKA_TRACK_TYPE_SUBTITLE) {
3506 // Compare signed timecodes. Timecode may be negative due to codec delay
3507 // offset. We don't support timestamps greater than int64_t anyway - see
3509 if ((int64_t)timecode < (int64_t)matroska->skip_to_timecode)
3512 matroska->skip_to_keyframe = 0;
3513 else if (!st->skip_to_keyframe) {
3514 av_log(matroska->ctx, AV_LOG_ERROR, "File is broken, keyframes not correctly marked!\n");
3515 matroska->skip_to_keyframe = 0;
3519 res = matroska_parse_laces(matroska, &data, &size, (flags & 0x06) >> 1,
3520 &lace_size, &laces);
3525 if (track->audio.samplerate == 8000) {
3526 // If this is needed for more codecs, then add them here
3527 if (st->codecpar->codec_id == AV_CODEC_ID_AC3) {
3528 if (track->audio.samplerate != st->codecpar->sample_rate || !st->codecpar->frame_size)
3529 trust_default_duration = 0;
3533 if (!block_duration && trust_default_duration)
3534 block_duration = track->default_duration * laces / matroska->time_scale;
3536 if (cluster_time != (uint64_t)-1 && (block_time >= 0 || cluster_time >= -block_time))
3537 track->end_timecode =
3538 FFMAX(track->end_timecode, timecode + block_duration);
3540 for (n = 0; n < laces; n++) {
3541 int64_t lace_duration = block_duration*(n+1) / laces - block_duration*n / laces;
3543 if (lace_size[n] > size) {
3544 av_log(matroska->ctx, AV_LOG_ERROR, "Invalid packet size\n");
3548 if ((st->codecpar->codec_id == AV_CODEC_ID_RA_288 ||
3549 st->codecpar->codec_id == AV_CODEC_ID_COOK ||
3550 st->codecpar->codec_id == AV_CODEC_ID_SIPR ||
3551 st->codecpar->codec_id == AV_CODEC_ID_ATRAC3) &&
3552 st->codecpar->block_align && track->audio.sub_packet_size) {
3553 res = matroska_parse_rm_audio(matroska, track, st, data,
3559 } else if (st->codecpar->codec_id == AV_CODEC_ID_WEBVTT) {
3560 res = matroska_parse_webvtt(matroska, track, st,
3562 timecode, lace_duration,
3567 res = matroska_parse_frame(matroska, track, st, buf, data, lace_size[n],
3568 timecode, lace_duration, pos,
3569 !n ? is_keyframe : 0,
3570 additional, additional_id, additional_size,
3576 if (timecode != AV_NOPTS_VALUE)
3577 timecode = lace_duration ? timecode + lace_duration : AV_NOPTS_VALUE;
3578 data += lace_size[n];
3579 size -= lace_size[n];
3587 static int matroska_parse_cluster(MatroskaDemuxContext *matroska)
3589 MatroskaCluster *cluster = &matroska->current_cluster;
3590 MatroskaBlock *block = &cluster->block;
3593 av_assert0(matroska->num_levels <= 2);
3595 if (matroska->num_levels == 1) {
3596 res = ebml_parse(matroska, matroska_clusters, NULL);
3599 /* Found a cluster: subtract the size of the ID already read. */
3600 cluster->pos = avio_tell(matroska->ctx->pb) - 4;
3602 res = ebml_parse(matroska, matroska_cluster_enter, cluster);
3608 if (matroska->num_levels == 2) {
3610 /* We are inside a cluster. */
3611 res = ebml_parse(matroska, matroska_cluster_parsing, cluster);
3613 if (res >= 0 && block->bin.size > 0) {
3614 int is_keyframe = block->non_simple ? block->reference == INT64_MIN : -1;
3615 uint8_t* additional = block->additional.size > 0 ?
3616 block->additional.data : NULL;
3618 err = matroska_parse_block(matroska, block->bin.buf, block->bin.data,
3619 block->bin.size, block->bin.pos,
3620 cluster->timecode, block->duration,
3621 is_keyframe, additional, block->additional_id,
3622 block->additional.size, cluster->pos,
3623 block->discard_padding);
3626 if (res == LEVEL_ENDED)
3629 ebml_free(matroska_blockgroup, block);
3630 memset(block, 0, sizeof(*block));
3634 } else if (!matroska->num_levels) {
3642 static int matroska_read_packet(AVFormatContext *s, AVPacket *pkt)
3644 MatroskaDemuxContext *matroska = s->priv_data;
3647 if (matroska->resync_pos == -1) {
3648 // This can only happen if generic seeking has been used.
3649 matroska->resync_pos = avio_tell(s->pb);
3652 while (matroska_deliver_packet(matroska, pkt)) {
3654 return (ret < 0) ? ret : AVERROR_EOF;
3655 if (matroska_parse_cluster(matroska) < 0)
3656 ret = matroska_resync(matroska, matroska->resync_pos);
3662 static int matroska_read_seek(AVFormatContext *s, int stream_index,
3663 int64_t timestamp, int flags)
3665 MatroskaDemuxContext *matroska = s->priv_data;
3666 MatroskaTrack *tracks = NULL;
3667 AVStream *st = s->streams[stream_index];
3670 /* Parse the CUES now since we need the index data to seek. */
3671 if (matroska->cues_parsing_deferred > 0) {
3672 matroska->cues_parsing_deferred = 0;
3673 matroska_parse_cues(matroska);
3676 if (!st->nb_index_entries)
3678 timestamp = FFMAX(timestamp, st->index_entries[0].timestamp);
3680 if ((index = av_index_search_timestamp(st, timestamp, flags)) < 0 || index == st->nb_index_entries - 1) {
3681 matroska_reset_status(matroska, 0, st->index_entries[st->nb_index_entries - 1].pos);
3682 while ((index = av_index_search_timestamp(st, timestamp, flags)) < 0 || index == st->nb_index_entries - 1) {
3683 matroska_clear_queue(matroska);
3684 if (matroska_parse_cluster(matroska) < 0)
3689 matroska_clear_queue(matroska);
3690 if (index < 0 || (matroska->cues_parsing_deferred < 0 && index == st->nb_index_entries - 1))
3693 tracks = matroska->tracks.elem;
3694 for (i = 0; i < matroska->tracks.nb_elem; i++) {
3695 tracks[i].audio.pkt_cnt = 0;
3696 tracks[i].audio.sub_packet_cnt = 0;
3697 tracks[i].audio.buf_timecode = AV_NOPTS_VALUE;
3698 tracks[i].end_timecode = 0;
3701 /* We seek to a level 1 element, so set the appropriate status. */
3702 matroska_reset_status(matroska, 0, st->index_entries[index].pos);
3703 if (flags & AVSEEK_FLAG_ANY) {
3704 st->skip_to_keyframe = 0;
3705 matroska->skip_to_timecode = timestamp;
3707 st->skip_to_keyframe = 1;
3708 matroska->skip_to_timecode = st->index_entries[index].timestamp;
3710 matroska->skip_to_keyframe = 1;
3712 ff_update_cur_dts(s, st, st->index_entries[index].timestamp);
3715 // slightly hackish but allows proper fallback to
3716 // the generic seeking code.
3717 matroska_reset_status(matroska, 0, -1);
3718 matroska->resync_pos = -1;
3719 matroska_clear_queue(matroska);
3720 st->skip_to_keyframe =
3721 matroska->skip_to_keyframe = 0;
3726 static int matroska_read_close(AVFormatContext *s)
3728 MatroskaDemuxContext *matroska = s->priv_data;
3729 MatroskaTrack *tracks = matroska->tracks.elem;
3732 matroska_clear_queue(matroska);
3734 for (n = 0; n < matroska->tracks.nb_elem; n++)
3735 if (tracks[n].type == MATROSKA_TRACK_TYPE_AUDIO)
3736 av_freep(&tracks[n].audio.buf);
3737 ebml_free(matroska_segment, matroska);
3743 int64_t start_time_ns;
3744 int64_t end_time_ns;
3745 int64_t start_offset;
3749 /* This function searches all the Cues and returns the CueDesc corresponding to
3750 * the timestamp ts. Returned CueDesc will be such that start_time_ns <= ts <
3751 * end_time_ns. All 4 fields will be set to -1 if ts >= file's duration.
3753 static CueDesc get_cue_desc(AVFormatContext *s, int64_t ts, int64_t cues_start) {
3754 MatroskaDemuxContext *matroska = s->priv_data;
3757 int nb_index_entries = s->streams[0]->nb_index_entries;
3758 AVIndexEntry *index_entries = s->streams[0]->index_entries;
3759 if (ts >= matroska->duration * matroska->time_scale) return (CueDesc) {-1, -1, -1, -1};
3760 for (i = 1; i < nb_index_entries; i++) {
3761 if (index_entries[i - 1].timestamp * matroska->time_scale <= ts &&
3762 index_entries[i].timestamp * matroska->time_scale > ts) {
3767 cue_desc.start_time_ns = index_entries[i].timestamp * matroska->time_scale;
3768 cue_desc.start_offset = index_entries[i].pos - matroska->segment_start;
3769 if (i != nb_index_entries - 1) {
3770 cue_desc.end_time_ns = index_entries[i + 1].timestamp * matroska->time_scale;
3771 cue_desc.end_offset = index_entries[i + 1].pos - matroska->segment_start;
3773 cue_desc.end_time_ns = matroska->duration * matroska->time_scale;
3774 // FIXME: this needs special handling for files where Cues appear
3775 // before Clusters. the current logic assumes Cues appear after
3777 cue_desc.end_offset = cues_start - matroska->segment_start;
3782 static int webm_clusters_start_with_keyframe(AVFormatContext *s)
3784 MatroskaDemuxContext *matroska = s->priv_data;
3785 uint32_t id = matroska->current_id;
3786 int64_t cluster_pos, before_pos;
3788 if (s->streams[0]->nb_index_entries <= 0) return 0;
3789 // seek to the first cluster using cues.
3790 index = av_index_search_timestamp(s->streams[0], 0, 0);
3791 if (index < 0) return 0;
3792 cluster_pos = s->streams[0]->index_entries[index].pos;
3793 before_pos = avio_tell(s->pb);
3795 uint64_t cluster_id, cluster_length;
3798 avio_seek(s->pb, cluster_pos, SEEK_SET);
3799 // read cluster id and length
3800 read = ebml_read_num(matroska, matroska->ctx->pb, 4, &cluster_id, 1);
3801 if (read < 0 || cluster_id != 0xF43B675) // done with all clusters
3803 read = ebml_read_length(matroska, matroska->ctx->pb, &cluster_length);
3807 matroska_reset_status(matroska, 0, cluster_pos);
3808 matroska_clear_queue(matroska);
3809 if (matroska_parse_cluster(matroska) < 0 ||
3813 pkt = &matroska->queue->pkt;
3814 // 4 + read is the length of the cluster id and the cluster length field.
3815 cluster_pos += 4 + read + cluster_length;
3816 if (!(pkt->flags & AV_PKT_FLAG_KEY)) {
3822 /* Restore the status after matroska_read_header: */
3823 matroska_reset_status(matroska, id, before_pos);
3828 static int buffer_size_after_time_downloaded(int64_t time_ns, double search_sec, int64_t bps,
3829 double min_buffer, double* buffer,
3830 double* sec_to_download, AVFormatContext *s,
3833 double nano_seconds_per_second = 1000000000.0;
3834 double time_sec = time_ns / nano_seconds_per_second;
3836 int64_t time_to_search_ns = (int64_t)(search_sec * nano_seconds_per_second);
3837 int64_t end_time_ns = time_ns + time_to_search_ns;
3838 double sec_downloaded = 0.0;
3839 CueDesc desc_curr = get_cue_desc(s, time_ns, cues_start);
3840 if (desc_curr.start_time_ns == -1)
3842 *sec_to_download = 0.0;
3844 // Check for non cue start time.
3845 if (time_ns > desc_curr.start_time_ns) {
3846 int64_t cue_nano = desc_curr.end_time_ns - time_ns;
3847 double percent = (double)(cue_nano) / (desc_curr.end_time_ns - desc_curr.start_time_ns);
3848 double cueBytes = (desc_curr.end_offset - desc_curr.start_offset) * percent;
3849 double timeToDownload = (cueBytes * 8.0) / bps;
3851 sec_downloaded += (cue_nano / nano_seconds_per_second) - timeToDownload;
3852 *sec_to_download += timeToDownload;
3854 // Check if the search ends within the first cue.
3855 if (desc_curr.end_time_ns >= end_time_ns) {
3856 double desc_end_time_sec = desc_curr.end_time_ns / nano_seconds_per_second;
3857 double percent_to_sub = search_sec / (desc_end_time_sec - time_sec);
3858 sec_downloaded = percent_to_sub * sec_downloaded;
3859 *sec_to_download = percent_to_sub * *sec_to_download;
3862 if ((sec_downloaded + *buffer) <= min_buffer) {
3866 // Get the next Cue.
3867 desc_curr = get_cue_desc(s, desc_curr.end_time_ns, cues_start);
3870 while (desc_curr.start_time_ns != -1) {
3871 int64_t desc_bytes = desc_curr.end_offset - desc_curr.start_offset;
3872 int64_t desc_ns = desc_curr.end_time_ns - desc_curr.start_time_ns;
3873 double desc_sec = desc_ns / nano_seconds_per_second;
3874 double bits = (desc_bytes * 8.0);
3875 double time_to_download = bits / bps;
3877 sec_downloaded += desc_sec - time_to_download;
3878 *sec_to_download += time_to_download;
3880 if (desc_curr.end_time_ns >= end_time_ns) {
3881 double desc_end_time_sec = desc_curr.end_time_ns / nano_seconds_per_second;
3882 double percent_to_sub = search_sec / (desc_end_time_sec - time_sec);
3883 sec_downloaded = percent_to_sub * sec_downloaded;
3884 *sec_to_download = percent_to_sub * *sec_to_download;
3886 if ((sec_downloaded + *buffer) <= min_buffer)
3891 if ((sec_downloaded + *buffer) <= min_buffer) {
3896 desc_curr = get_cue_desc(s, desc_curr.end_time_ns, cues_start);
3898 *buffer = *buffer + sec_downloaded;
3902 /* This function computes the bandwidth of the WebM file with the help of
3903 * buffer_size_after_time_downloaded() function. Both of these functions are
3904 * adapted from WebM Tools project and are adapted to work with FFmpeg's
3905 * Matroska parsing mechanism.
3907 * Returns the bandwidth of the file on success; -1 on error.
3909 static int64_t webm_dash_manifest_compute_bandwidth(AVFormatContext *s, int64_t cues_start)
3911 MatroskaDemuxContext *matroska = s->priv_data;
3912 AVStream *st = s->streams[0];
3913 double bandwidth = 0.0;
3916 for (i = 0; i < st->nb_index_entries; i++) {
3917 int64_t prebuffer_ns = 1000000000;
3918 int64_t time_ns = st->index_entries[i].timestamp * matroska->time_scale;
3919 double nano_seconds_per_second = 1000000000.0;
3920 int64_t prebuffered_ns = time_ns + prebuffer_ns;
3921 double prebuffer_bytes = 0.0;
3922 int64_t temp_prebuffer_ns = prebuffer_ns;
3923 int64_t pre_bytes, pre_ns;
3924 double pre_sec, prebuffer, bits_per_second;
3925 CueDesc desc_beg = get_cue_desc(s, time_ns, cues_start);
3927 // Start with the first Cue.
3928 CueDesc desc_end = desc_beg;
3930 // Figure out how much data we have downloaded for the prebuffer. This will
3931 // be used later to adjust the bits per sample to try.
3932 while (desc_end.start_time_ns != -1 && desc_end.end_time_ns < prebuffered_ns) {
3933 // Prebuffered the entire Cue.
3934 prebuffer_bytes += desc_end.end_offset - desc_end.start_offset;
3935 temp_prebuffer_ns -= desc_end.end_time_ns - desc_end.start_time_ns;
3936 desc_end = get_cue_desc(s, desc_end.end_time_ns, cues_start);
3938 if (desc_end.start_time_ns == -1) {
3939 // The prebuffer is larger than the duration.
3940 if (matroska->duration * matroska->time_scale >= prebuffered_ns)
3942 bits_per_second = 0.0;
3944 // The prebuffer ends in the last Cue. Estimate how much data was
3946 pre_bytes = desc_end.end_offset - desc_end.start_offset;
3947 pre_ns = desc_end.end_time_ns - desc_end.start_time_ns;
3948 pre_sec = pre_ns / nano_seconds_per_second;
3950 pre_bytes * ((temp_prebuffer_ns / nano_seconds_per_second) / pre_sec);
3952 prebuffer = prebuffer_ns / nano_seconds_per_second;
3954 // Set this to 0.0 in case our prebuffer buffers the entire video.
3955 bits_per_second = 0.0;
3957 int64_t desc_bytes = desc_end.end_offset - desc_beg.start_offset;
3958 int64_t desc_ns = desc_end.end_time_ns - desc_beg.start_time_ns;
3959 double desc_sec = desc_ns / nano_seconds_per_second;
3960 double calc_bits_per_second = (desc_bytes * 8) / desc_sec;
3962 // Drop the bps by the percentage of bytes buffered.
3963 double percent = (desc_bytes - prebuffer_bytes) / desc_bytes;
3964 double mod_bits_per_second = calc_bits_per_second * percent;
3966 if (prebuffer < desc_sec) {
3968 (double)(matroska->duration * matroska->time_scale) / nano_seconds_per_second;
3970 // Add 1 so the bits per second should be a little bit greater than file
3972 int64_t bps = (int64_t)(mod_bits_per_second) + 1;
3973 const double min_buffer = 0.0;
3974 double buffer = prebuffer;
3975 double sec_to_download = 0.0;
3977 int rv = buffer_size_after_time_downloaded(prebuffered_ns, search_sec, bps,
3978 min_buffer, &buffer, &sec_to_download,
3982 } else if (rv == 0) {
3983 bits_per_second = (double)(bps);
3988 desc_end = get_cue_desc(s, desc_end.end_time_ns, cues_start);
3989 } while (desc_end.start_time_ns != -1);
3991 if (bandwidth < bits_per_second) bandwidth = bits_per_second;
3993 return (int64_t)bandwidth;
3996 static int webm_dash_manifest_cues(AVFormatContext *s, int64_t init_range)
3998 MatroskaDemuxContext *matroska = s->priv_data;
3999 EbmlList *seekhead_list = &matroska->seekhead;
4000 MatroskaSeekhead *seekhead = seekhead_list->elem;
4002 int64_t cues_start = -1, cues_end = -1, before_pos, bandwidth;
4006 // determine cues start and end positions
4007 for (i = 0; i < seekhead_list->nb_elem; i++)
4008 if (seekhead[i].id == MATROSKA_ID_CUES)
4011 if (i >= seekhead_list->nb_elem) return -1;
4013 before_pos = avio_tell(matroska->ctx->pb);
4014 cues_start = seekhead[i].pos + matroska->segment_start;
4015 if (avio_seek(matroska->ctx->pb, cues_start, SEEK_SET) == cues_start) {
4016 // cues_end is computed as cues_start + cues_length + length of the
4017 // Cues element ID (i.e. 4) + EBML length of the Cues element.
4018 // cues_end is inclusive and the above sum is reduced by 1.
4019 uint64_t cues_length, cues_id;
4021 bytes_read = ebml_read_num (matroska, matroska->ctx->pb, 4, &cues_id, 1);
4022 if (bytes_read < 0 || cues_id != (MATROSKA_ID_CUES & 0xfffffff))
4023 return bytes_read < 0 ? bytes_read : AVERROR_INVALIDDATA;
4024 bytes_read = ebml_read_length(matroska, matroska->ctx->pb, &cues_length);
4027 cues_end = cues_start + 4 + bytes_read + cues_length - 1;
4029 avio_seek(matroska->ctx->pb, before_pos, SEEK_SET);
4030 if (cues_start == -1 || cues_end == -1) return -1;
4033 matroska_parse_cues(matroska);
4036 av_dict_set_int(&s->streams[0]->metadata, CUES_START, cues_start, 0);
4039 av_dict_set_int(&s->streams[0]->metadata, CUES_END, cues_end, 0);
4041 // if the file has cues at the start, fix up the init range so tht
4042 // it does not include it
4043 if (cues_start <= init_range)
4044 av_dict_set_int(&s->streams[0]->metadata, INITIALIZATION_RANGE, cues_start - 1, 0);
4047 bandwidth = webm_dash_manifest_compute_bandwidth(s, cues_start);
4048 if (bandwidth < 0) return -1;
4049 av_dict_set_int(&s->streams[0]->metadata, BANDWIDTH, bandwidth, 0);
4051 // check if all clusters start with key frames
4052 av_dict_set_int(&s->streams[0]->metadata, CLUSTER_KEYFRAME, webm_clusters_start_with_keyframe(s), 0);
4054 // store cue point timestamps as a comma separated list for checking subsegment alignment in
4055 // the muxer. assumes that each timestamp cannot be more than 20 characters long.
4056 buf = av_malloc_array(s->streams[0]->nb_index_entries, 20);
4057 if (!buf) return -1;
4059 for (i = 0; i < s->streams[0]->nb_index_entries; i++) {
4060 int ret = snprintf(buf + end, 20,
4061 "%" PRId64"%s", s->streams[0]->index_entries[i].timestamp,
4062 i != s->streams[0]->nb_index_entries - 1 ? "," : "");
4063 if (ret <= 0 || (ret == 20 && i == s->streams[0]->nb_index_entries - 1)) {
4064 av_log(s, AV_LOG_ERROR, "timestamp too long.\n");
4066 return AVERROR_INVALIDDATA;
4070 av_dict_set(&s->streams[0]->metadata, CUE_TIMESTAMPS, buf, 0);
4076 static int webm_dash_manifest_read_header(AVFormatContext *s)
4079 int ret = matroska_read_header(s);
4081 MatroskaTrack *tracks;
4082 MatroskaDemuxContext *matroska = s->priv_data;
4084 av_log(s, AV_LOG_ERROR, "Failed to read file headers\n");
4087 if (!s->nb_streams) {
4088 matroska_read_close(s);
4089 av_log(s, AV_LOG_ERROR, "No streams found\n");
4090 return AVERROR_INVALIDDATA;
4093 if (!matroska->is_live) {
4094 buf = av_asprintf("%g", matroska->duration);
4095 if (!buf) return AVERROR(ENOMEM);
4096 av_dict_set(&s->streams[0]->metadata, DURATION, buf, 0);
4099 // initialization range
4100 // 5 is the offset of Cluster ID.
4101 init_range = avio_tell(s->pb) - 5;
4102 av_dict_set_int(&s->streams[0]->metadata, INITIALIZATION_RANGE, init_range, 0);
4105 // basename of the file
4106 buf = strrchr(s->url, '/');
4107 av_dict_set(&s->streams[0]->metadata, FILENAME, buf ? ++buf : s->url, 0);
4110 tracks = matroska->tracks.elem;
4111 av_dict_set_int(&s->streams[0]->metadata, TRACK_NUMBER, tracks[0].num, 0);
4113 // parse the cues and populate Cue related fields
4114 if (!matroska->is_live) {
4115 ret = webm_dash_manifest_cues(s, init_range);
4117 av_log(s, AV_LOG_ERROR, "Error parsing Cues\n");
4122 // use the bandwidth from the command line if it was provided
4123 if (matroska->bandwidth > 0) {
4124 av_dict_set_int(&s->streams[0]->metadata, BANDWIDTH,
4125 matroska->bandwidth, 0);
4130 static int webm_dash_manifest_read_packet(AVFormatContext *s, AVPacket *pkt)
4135 #define OFFSET(x) offsetof(MatroskaDemuxContext, x)
4136 static const AVOption options[] = {
4137 { "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 },
4138 { "bandwidth", "bandwidth of this stream to be specified in the DASH manifest.", OFFSET(bandwidth), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, AV_OPT_FLAG_DECODING_PARAM },
4142 static const AVClass webm_dash_class = {
4143 .class_name = "WebM DASH Manifest demuxer",
4144 .item_name = av_default_item_name,
4146 .version = LIBAVUTIL_VERSION_INT,
4149 AVInputFormat ff_matroska_demuxer = {
4150 .name = "matroska,webm",
4151 .long_name = NULL_IF_CONFIG_SMALL("Matroska / WebM"),
4152 .extensions = "mkv,mk3d,mka,mks",
4153 .priv_data_size = sizeof(MatroskaDemuxContext),
4154 .read_probe = matroska_probe,
4155 .read_header = matroska_read_header,
4156 .read_packet = matroska_read_packet,
4157 .read_close = matroska_read_close,
4158 .read_seek = matroska_read_seek,
4159 .mime_type = "audio/webm,audio/x-matroska,video/webm,video/x-matroska"
4162 AVInputFormat ff_webm_dash_manifest_demuxer = {
4163 .name = "webm_dash_manifest",
4164 .long_name = NULL_IF_CONFIG_SMALL("WebM DASH Manifest"),
4165 .priv_data_size = sizeof(MatroskaDemuxContext),
4166 .read_header = webm_dash_manifest_read_header,
4167 .read_packet = webm_dash_manifest_read_packet,
4168 .read_close = matroska_read_close,
4169 .priv_class = &webm_dash_class,