mxfdec.c
Go to the documentation of this file.
1 /*
2  * MXF demuxer.
3  * Copyright (c) 2006 SmartJog S.A., Baptiste Coudurier <baptiste dot coudurier at smartjog dot com>
4  *
5  * This file is part of Libav.
6  *
7  * Libav 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.
11  *
12  * Libav 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.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with Libav; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 /*
23  * References
24  * SMPTE 336M KLV Data Encoding Protocol Using Key-Length-Value
25  * SMPTE 377M MXF File Format Specifications
26  * SMPTE 378M Operational Pattern 1a
27  * SMPTE 379M MXF Generic Container
28  * SMPTE 381M Mapping MPEG Streams into the MXF Generic Container
29  * SMPTE 382M Mapping AES3 and Broadcast Wave Audio into the MXF Generic Container
30  * SMPTE 383M Mapping DV-DIF Data to the MXF Generic Container
31  *
32  * Principle
33  * Search for Track numbers which will identify essence element KLV packets.
34  * Search for SourcePackage which define tracks which contains Track numbers.
35  * Material Package contains tracks with reference to SourcePackage tracks.
36  * Search for Descriptors (Picture, Sound) which contains codec info and parameters.
37  * Assign Descriptors to correct Tracks.
38  *
39  * Metadata reading functions read Local Tags, get InstanceUID(0x3C0A) then add MetaDataSet to MXFContext.
40  * Metadata parsing resolves Strong References to objects.
41  *
42  * Simple demuxer, only OP1A supported and some files might not work at all.
43  * Only tracks with associated descriptors will be decoded. "Highly Desirable" SMPTE 377M D.1
44  */
45 
46 //#define DEBUG
47 
48 #include "libavutil/aes.h"
49 #include "libavutil/mathematics.h"
50 #include "libavcodec/bytestream.h"
51 #include "avformat.h"
52 #include "internal.h"
53 #include "mxf.h"
54 
55 typedef struct {
60 
61 typedef struct {
66  int64_t duration;
67  int64_t start_position;
70 
71 typedef struct {
77  int64_t duration;
78 } MXFSequence;
79 
80 typedef struct {
83  MXFSequence *sequence; /* mandatory, and only one */
85  int track_id;
86  uint8_t track_number[4];
88 } MXFTrack;
89 
90 typedef struct {
97  int width;
98  int height;
99  int channels;
104  uint8_t *extradata;
107 } MXFDescriptor;
108 
109 typedef struct {
113 
114 typedef struct {
120  MXFDescriptor *descriptor; /* only one */
122 } MXFPackage;
123 
124 typedef struct {
128 
129 typedef struct {
135  struct AVAES *aesc;
136  uint8_t *local_tags;
138 } MXFContext;
139 
143 };
144 
145 typedef int MXFMetadataReadFunc(void *arg, AVIOContext *pb, int tag, int size, UID uid);
146 
147 typedef struct {
148  const UID key;
150  int ctx_size;
153 
154 /* partial keys to match */
155 static const uint8_t mxf_header_partition_pack_key[] = { 0x06,0x0e,0x2b,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x02 };
156 static const uint8_t mxf_essence_element_key[] = { 0x06,0x0e,0x2b,0x34,0x01,0x02,0x01,0x01,0x0d,0x01,0x03,0x01 };
157 static const uint8_t mxf_klv_key[] = { 0x06,0x0e,0x2b,0x34 };
158 /* complete keys to match */
159 static const uint8_t mxf_crypto_source_container_ul[] = { 0x06,0x0e,0x2b,0x34,0x01,0x01,0x01,0x09,0x06,0x01,0x01,0x02,0x02,0x00,0x00,0x00 };
160 static const uint8_t mxf_encrypted_triplet_key[] = { 0x06,0x0e,0x2b,0x34,0x02,0x04,0x01,0x07,0x0d,0x01,0x03,0x01,0x02,0x7e,0x01,0x00 };
161 static const uint8_t mxf_encrypted_essence_container[] = { 0x06,0x0e,0x2b,0x34,0x04,0x01,0x01,0x07,0x0d,0x01,0x03,0x01,0x02,0x0b,0x01,0x00 };
162 static const uint8_t mxf_sony_mpeg4_extradata[] = { 0x06,0x0e,0x2b,0x34,0x04,0x01,0x01,0x01,0x0e,0x06,0x06,0x02,0x02,0x01,0x00,0x00 };
163 
164 #define IS_KLV_KEY(x, y) (!memcmp(x, y, sizeof(y)))
165 
167 {
168  uint64_t size = avio_r8(pb);
169  if (size & 0x80) { /* long form */
170  int bytes_num = size & 0x7f;
171  /* SMPTE 379M 5.3.4 guarantee that bytes_num must not exceed 8 bytes */
172  if (bytes_num > 8)
173  return AVERROR_INVALIDDATA;
174  size = 0;
175  while (bytes_num--)
176  size = size << 8 | avio_r8(pb);
177  }
178  return size;
179 }
180 
181 static int mxf_read_sync(AVIOContext *pb, const uint8_t *key, unsigned size)
182 {
183  int i, b;
184  for (i = 0; i < size && !pb->eof_reached; i++) {
185  b = avio_r8(pb);
186  if (b == key[0])
187  i = 0;
188  else if (b != key[i])
189  i = -1;
190  }
191  return i == size;
192 }
193 
194 static int klv_read_packet(KLVPacket *klv, AVIOContext *pb)
195 {
196  if (!mxf_read_sync(pb, mxf_klv_key, 4))
197  return AVERROR_INVALIDDATA;
198  klv->offset = avio_tell(pb) - 4;
199  memcpy(klv->key, mxf_klv_key, 4);
200  avio_read(pb, klv->key + 4, 12);
201  klv->length = klv_decode_ber_length(pb);
202  return klv->length == -1 ? -1 : 0;
203 }
204 
206 {
207  int i;
208 
209  for (i = 0; i < s->nb_streams; i++) {
210  MXFTrack *track = s->streams[i]->priv_data;
211  /* SMPTE 379M 7.3 */
212  if (!memcmp(klv->key + sizeof(mxf_essence_element_key), track->track_number, sizeof(track->track_number)))
213  return i;
214  }
215  /* return 0 if only one stream, for OP Atom files with 0 as track number */
216  return s->nb_streams == 1 ? 0 : -1;
217 }
218 
219 /* XXX: use AVBitStreamFilter */
220 static int mxf_get_d10_aes3_packet(AVIOContext *pb, AVStream *st, AVPacket *pkt, int64_t length)
221 {
222  const uint8_t *buf_ptr, *end_ptr;
223  uint8_t *data_ptr;
224  int i;
225 
226  if (length > 61444) /* worst case PAL 1920 samples 8 channels */
227  return AVERROR_INVALIDDATA;
228  length = av_get_packet(pb, pkt, length);
229  if (length < 0)
230  return length;
231  data_ptr = pkt->data;
232  end_ptr = pkt->data + length;
233  buf_ptr = pkt->data + 4; /* skip SMPTE 331M header */
234  for (; buf_ptr + st->codec->channels*4 < end_ptr; ) {
235  for (i = 0; i < st->codec->channels; i++) {
236  uint32_t sample = bytestream_get_le32(&buf_ptr);
237  if (st->codec->bits_per_coded_sample == 24)
238  bytestream_put_le24(&data_ptr, (sample >> 4) & 0xffffff);
239  else
240  bytestream_put_le16(&data_ptr, (sample >> 12) & 0xffff);
241  }
242  buf_ptr += 32 - st->codec->channels*4; // always 8 channels stored SMPTE 331M
243  }
244  av_shrink_packet(pkt, data_ptr - pkt->data);
245  return 0;
246 }
247 
249 {
250  static const uint8_t checkv[16] = {0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b};
251  MXFContext *mxf = s->priv_data;
252  AVIOContext *pb = s->pb;
253  int64_t end = avio_tell(pb) + klv->length;
254  int64_t size;
255  uint64_t orig_size;
256  uint64_t plaintext_size;
257  uint8_t ivec[16];
258  uint8_t tmpbuf[16];
259  int index;
260 
261  if (!mxf->aesc && s->key && s->keylen == 16) {
262  mxf->aesc = av_malloc(av_aes_size);
263  if (!mxf->aesc)
264  return AVERROR(ENOMEM);
265  av_aes_init(mxf->aesc, s->key, 128, 1);
266  }
267  // crypto context
269  // plaintext offset
271  plaintext_size = avio_rb64(pb);
272  // source klv key
274  avio_read(pb, klv->key, 16);
276  return AVERROR_INVALIDDATA;
277  index = mxf_get_stream_index(s, klv);
278  if (index < 0)
279  return AVERROR_INVALIDDATA;
280  // source size
282  orig_size = avio_rb64(pb);
283  if (orig_size < plaintext_size)
284  return AVERROR_INVALIDDATA;
285  // enc. code
286  size = klv_decode_ber_length(pb);
287  if (size < 32 || size - 32 < orig_size)
288  return AVERROR_INVALIDDATA;
289  avio_read(pb, ivec, 16);
290  avio_read(pb, tmpbuf, 16);
291  if (mxf->aesc)
292  av_aes_crypt(mxf->aesc, tmpbuf, tmpbuf, 1, ivec, 1);
293  if (memcmp(tmpbuf, checkv, 16))
294  av_log(s, AV_LOG_ERROR, "probably incorrect decryption key\n");
295  size -= 32;
296  size = av_get_packet(pb, pkt, size);
297  if (size < 0)
298  return size;
299  else if (size < plaintext_size)
300  return AVERROR_INVALIDDATA;
301  size -= plaintext_size;
302  if (mxf->aesc)
303  av_aes_crypt(mxf->aesc, &pkt->data[plaintext_size],
304  &pkt->data[plaintext_size], size >> 4, ivec, 1);
305  av_shrink_packet(pkt, orig_size);
306  pkt->stream_index = index;
307  avio_skip(pb, end - avio_tell(pb));
308  return 0;
309 }
310 
312 {
313  KLVPacket klv;
314 
315  while (!s->pb->eof_reached) {
316  int ret;
317  if (klv_read_packet(&klv, s->pb) < 0)
318  return -1;
319  PRINT_KEY(s, "read packet", klv.key);
320  av_dlog(s, "size %"PRIu64" offset %#"PRIx64"\n", klv.length, klv.offset);
322  ret = mxf_decrypt_triplet(s, pkt, &klv);
323  if (ret < 0) {
324  av_log(s, AV_LOG_ERROR, "invalid encoded triplet\n");
325  return AVERROR_INVALIDDATA;
326  }
327  return 0;
328  }
330  int index = mxf_get_stream_index(s, &klv);
331  if (index < 0) {
332  av_log(s, AV_LOG_ERROR, "error getting stream index %d\n", AV_RB32(klv.key+12));
333  goto skip;
334  }
335  if (s->streams[index]->discard == AVDISCARD_ALL)
336  goto skip;
337  /* check for 8 channels AES3 element */
338  if (klv.key[12] == 0x06 && klv.key[13] == 0x01 && klv.key[14] == 0x10) {
339  if (mxf_get_d10_aes3_packet(s->pb, s->streams[index], pkt, klv.length) < 0) {
340  av_log(s, AV_LOG_ERROR, "error reading D-10 aes3 frame\n");
341  return AVERROR_INVALIDDATA;
342  }
343  } else {
344  ret = av_get_packet(s->pb, pkt, klv.length);
345  if (ret < 0)
346  return ret;
347  }
348  pkt->stream_index = index;
349  pkt->pos = klv.offset;
350  return 0;
351  } else
352  skip:
353  avio_skip(s->pb, klv.length);
354  }
355  return AVERROR_EOF;
356 }
357 
358 static int mxf_read_primer_pack(void *arg, AVIOContext *pb, int tag, int size, UID uid)
359 {
360  MXFContext *mxf = arg;
361  int item_num = avio_rb32(pb);
362  int item_len = avio_rb32(pb);
363 
364  if (item_len != 18) {
365  av_log_ask_for_sample(pb, "unsupported primer pack item length %d\n",
366  item_len);
367  return AVERROR_PATCHWELCOME;
368  }
369  if (item_num > UINT_MAX / item_len)
370  return AVERROR_INVALIDDATA;
371  mxf->local_tags_count = item_num;
372  mxf->local_tags = av_malloc(item_num*item_len);
373  if (!mxf->local_tags)
374  return AVERROR(ENOMEM);
375  avio_read(pb, mxf->local_tags, item_num*item_len);
376  return 0;
377 }
378 
379 static int mxf_add_metadata_set(MXFContext *mxf, void *metadata_set)
380 {
381  if (mxf->metadata_sets_count+1 >= UINT_MAX / sizeof(*mxf->metadata_sets))
382  return AVERROR(ENOMEM);
383  mxf->metadata_sets = av_realloc(mxf->metadata_sets, (mxf->metadata_sets_count + 1) * sizeof(*mxf->metadata_sets));
384  if (!mxf->metadata_sets)
385  return AVERROR(ENOMEM);
386  mxf->metadata_sets[mxf->metadata_sets_count] = metadata_set;
387  mxf->metadata_sets_count++;
388  return 0;
389 }
390 
391 static int mxf_read_cryptographic_context(void *arg, AVIOContext *pb, int tag, int size, UID uid)
392 {
393  MXFCryptoContext *cryptocontext = arg;
394  if (size != 16)
395  return AVERROR_INVALIDDATA;
397  avio_read(pb, cryptocontext->source_container_ul, 16);
398  return 0;
399 }
400 
401 static int mxf_read_content_storage(void *arg, AVIOContext *pb, int tag, int size, UID uid)
402 {
403  MXFContext *mxf = arg;
404  switch (tag) {
405  case 0x1901:
406  mxf->packages_count = avio_rb32(pb);
407  if (mxf->packages_count >= UINT_MAX / sizeof(UID))
408  return AVERROR_INVALIDDATA;
409  mxf->packages_refs = av_malloc(mxf->packages_count * sizeof(UID));
410  if (!mxf->packages_refs)
411  return AVERROR(ENOMEM);
412  avio_skip(pb, 4); /* useless size of objects, always 16 according to specs */
413  avio_read(pb, (uint8_t *)mxf->packages_refs, mxf->packages_count * sizeof(UID));
414  break;
415  }
416  return 0;
417 }
418 
419 static int mxf_read_source_clip(void *arg, AVIOContext *pb, int tag, int size, UID uid)
420 {
421  MXFStructuralComponent *source_clip = arg;
422  switch(tag) {
423  case 0x0202:
424  source_clip->duration = avio_rb64(pb);
425  break;
426  case 0x1201:
427  source_clip->start_position = avio_rb64(pb);
428  break;
429  case 0x1101:
430  /* UMID, only get last 16 bytes */
431  avio_skip(pb, 16);
432  avio_read(pb, source_clip->source_package_uid, 16);
433  break;
434  case 0x1102:
435  source_clip->source_track_id = avio_rb32(pb);
436  break;
437  }
438  return 0;
439 }
440 
441 static int mxf_read_material_package(void *arg, AVIOContext *pb, int tag, int size, UID uid)
442 {
443  MXFPackage *package = arg;
444  switch(tag) {
445  case 0x4403:
446  package->tracks_count = avio_rb32(pb);
447  if (package->tracks_count >= UINT_MAX / sizeof(UID))
448  return AVERROR_INVALIDDATA;
449  package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
450  if (!package->tracks_refs)
451  return AVERROR(ENOMEM);
452  avio_skip(pb, 4); /* useless size of objects, always 16 according to specs */
453  avio_read(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
454  break;
455  }
456  return 0;
457 }
458 
459 static int mxf_read_track(void *arg, AVIOContext *pb, int tag, int size, UID uid)
460 {
461  MXFTrack *track = arg;
462  switch(tag) {
463  case 0x4801:
464  track->track_id = avio_rb32(pb);
465  break;
466  case 0x4804:
467  avio_read(pb, track->track_number, 4);
468  break;
469  case 0x4B01:
470  track->edit_rate.den = avio_rb32(pb);
471  track->edit_rate.num = avio_rb32(pb);
472  break;
473  case 0x4803:
474  avio_read(pb, track->sequence_ref, 16);
475  break;
476  }
477  return 0;
478 }
479 
480 static int mxf_read_sequence(void *arg, AVIOContext *pb, int tag, int size, UID uid)
481 {
482  MXFSequence *sequence = arg;
483  switch(tag) {
484  case 0x0202:
485  sequence->duration = avio_rb64(pb);
486  break;
487  case 0x0201:
488  avio_read(pb, sequence->data_definition_ul, 16);
489  break;
490  case 0x1001:
491  sequence->structural_components_count = avio_rb32(pb);
492  if (sequence->structural_components_count >= UINT_MAX / sizeof(UID))
493  return AVERROR_INVALIDDATA;
494  sequence->structural_components_refs = av_malloc(sequence->structural_components_count * sizeof(UID));
495  if (!sequence->structural_components_refs)
496  return AVERROR(ENOMEM);
497  avio_skip(pb, 4); /* useless size of objects, always 16 according to specs */
498  avio_read(pb, (uint8_t *)sequence->structural_components_refs, sequence->structural_components_count * sizeof(UID));
499  break;
500  }
501  return 0;
502 }
503 
504 static int mxf_read_source_package(void *arg, AVIOContext *pb, int tag, int size, UID uid)
505 {
506  MXFPackage *package = arg;
507  switch(tag) {
508  case 0x4403:
509  package->tracks_count = avio_rb32(pb);
510  if (package->tracks_count >= UINT_MAX / sizeof(UID))
511  return AVERROR_INVALIDDATA;
512  package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
513  if (!package->tracks_refs)
514  return AVERROR(ENOMEM);
515  avio_skip(pb, 4); /* useless size of objects, always 16 according to specs */
516  avio_read(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
517  break;
518  case 0x4401:
519  /* UMID, only get last 16 bytes */
520  avio_skip(pb, 16);
521  avio_read(pb, package->package_uid, 16);
522  break;
523  case 0x4701:
524  avio_read(pb, package->descriptor_ref, 16);
525  break;
526  }
527  return 0;
528 }
529 
530 static int mxf_read_index_table_segment(void *arg, AVIOContext *pb, int tag, int size, UID uid)
531 {
532  switch(tag) {
533  case 0x3F05: av_dlog(NULL, "EditUnitByteCount %d\n", avio_rb32(pb)); break;
534  case 0x3F06: av_dlog(NULL, "IndexSID %d\n", avio_rb32(pb)); break;
535  case 0x3F07: av_dlog(NULL, "BodySID %d\n", avio_rb32(pb)); break;
536  case 0x3F0B: av_dlog(NULL, "IndexEditRate %d/%d\n", avio_rb32(pb), avio_rb32(pb)); break;
537  case 0x3F0C: av_dlog(NULL, "IndexStartPosition %"PRIu64"\n", avio_rb64(pb)); break;
538  case 0x3F0D: av_dlog(NULL, "IndexDuration %"PRIu64"\n", avio_rb64(pb)); break;
539  }
540  return 0;
541 }
542 
543 static void mxf_read_pixel_layout(AVIOContext *pb, MXFDescriptor *descriptor)
544 {
545  int code, value, ofs = 0;
546  char layout[16] = {0};
547 
548  do {
549  code = avio_r8(pb);
550  value = avio_r8(pb);
551  av_dlog(NULL, "pixel layout: code %#x\n", code);
552 
553  if (ofs < 16) {
554  layout[ofs++] = code;
555  layout[ofs++] = value;
556  }
557  } while (code != 0); /* SMPTE 377M E.2.46 */
558 
559  ff_mxf_decode_pixel_layout(layout, &descriptor->pix_fmt);
560 }
561 
562 static int mxf_read_generic_descriptor(void *arg, AVIOContext *pb, int tag, int size, UID uid)
563 {
564  MXFDescriptor *descriptor = arg;
565  switch(tag) {
566  case 0x3F01:
567  descriptor->sub_descriptors_count = avio_rb32(pb);
568  if (descriptor->sub_descriptors_count >= UINT_MAX / sizeof(UID))
569  return AVERROR_INVALIDDATA;
570  descriptor->sub_descriptors_refs = av_malloc(descriptor->sub_descriptors_count * sizeof(UID));
571  if (!descriptor->sub_descriptors_refs)
572  return AVERROR(ENOMEM);
573  avio_skip(pb, 4); /* useless size of objects, always 16 according to specs */
574  avio_read(pb, (uint8_t *)descriptor->sub_descriptors_refs, descriptor->sub_descriptors_count * sizeof(UID));
575  break;
576  case 0x3004:
577  avio_read(pb, descriptor->essence_container_ul, 16);
578  break;
579  case 0x3006:
580  descriptor->linked_track_id = avio_rb32(pb);
581  break;
582  case 0x3201: /* PictureEssenceCoding */
583  avio_read(pb, descriptor->essence_codec_ul, 16);
584  break;
585  case 0x3203:
586  descriptor->width = avio_rb32(pb);
587  break;
588  case 0x3202:
589  descriptor->height = avio_rb32(pb);
590  break;
591  case 0x320E:
592  descriptor->aspect_ratio.num = avio_rb32(pb);
593  descriptor->aspect_ratio.den = avio_rb32(pb);
594  break;
595  case 0x3D03:
596  descriptor->sample_rate.num = avio_rb32(pb);
597  descriptor->sample_rate.den = avio_rb32(pb);
598  break;
599  case 0x3D06: /* SoundEssenceCompression */
600  avio_read(pb, descriptor->essence_codec_ul, 16);
601  break;
602  case 0x3D07:
603  descriptor->channels = avio_rb32(pb);
604  break;
605  case 0x3D01:
606  descriptor->bits_per_sample = avio_rb32(pb);
607  break;
608  case 0x3401:
609  mxf_read_pixel_layout(pb, descriptor);
610  break;
611  default:
612  /* Private uid used by SONY C0023S01.mxf */
614  descriptor->extradata = av_malloc(size + FF_INPUT_BUFFER_PADDING_SIZE);
615  if (!descriptor->extradata)
616  return AVERROR(ENOMEM);
617  descriptor->extradata_size = size;
618  avio_read(pb, descriptor->extradata, size);
619  }
620  break;
621  }
622  return 0;
623 }
624 
625 /*
626  * Match an uid independently of the version byte and up to len common bytes
627  * Returns: boolean
628  */
629 static int mxf_match_uid(const UID key, const UID uid, int len)
630 {
631  int i;
632  for (i = 0; i < len; i++) {
633  if (i != 7 && key[i] != uid[i])
634  return 0;
635  }
636  return 1;
637 }
638 
639 static const MXFCodecUL *mxf_get_codec_ul(const MXFCodecUL *uls, UID *uid)
640 {
641  while (uls->uid[0]) {
642  if(mxf_match_uid(uls->uid, *uid, uls->matching_len))
643  break;
644  uls++;
645  }
646  return uls;
647 }
648 
649 static void *mxf_resolve_strong_ref(MXFContext *mxf, UID *strong_ref, enum MXFMetadataSetType type)
650 {
651  int i;
652 
653  if (!strong_ref)
654  return NULL;
655  for (i = 0; i < mxf->metadata_sets_count; i++) {
656  if (!memcmp(*strong_ref, mxf->metadata_sets[i]->uid, 16) &&
657  (type == AnyType || mxf->metadata_sets[i]->type == type)) {
658  return mxf->metadata_sets[i];
659  }
660  }
661  return NULL;
662 }
663 
665  // video essence container uls
666  { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x60,0x01 }, 14, CODEC_ID_MPEG2VIDEO }, /* MPEG-ES Frame wrapped */
667  { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x02,0x41,0x01 }, 14, CODEC_ID_DVVIDEO }, /* DV 625 25mbps */
668  // sound essence container uls
669  { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x01,0x00 }, 14, CODEC_ID_PCM_S16LE }, /* BWF Frame wrapped */
670  { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x40,0x01 }, 14, CODEC_ID_MP2 }, /* MPEG-ES Frame wrapped, 0x40 ??? stream id */
671  { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x01,0x01 }, 14, CODEC_ID_PCM_S16LE }, /* D-10 Mapping 50Mbps PAL Extended Template */
672  { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, 0, CODEC_ID_NONE },
673 };
674 
676 {
677  MXFPackage *material_package = NULL;
678  MXFPackage *temp_package = NULL;
679  int i, j, k;
680 
681  av_dlog(mxf->fc, "metadata sets count %d\n", mxf->metadata_sets_count);
682  /* TODO: handle multiple material packages (OP3x) */
683  for (i = 0; i < mxf->packages_count; i++) {
684  material_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[i], MaterialPackage);
685  if (material_package) break;
686  }
687  if (!material_package) {
688  av_log(mxf->fc, AV_LOG_ERROR, "no material package found\n");
689  return AVERROR_INVALIDDATA;
690  }
691 
692  for (i = 0; i < material_package->tracks_count; i++) {
693  MXFPackage *source_package = NULL;
694  MXFTrack *material_track = NULL;
695  MXFTrack *source_track = NULL;
696  MXFTrack *temp_track = NULL;
697  MXFDescriptor *descriptor = NULL;
698  MXFStructuralComponent *component = NULL;
699  UID *essence_container_ul = NULL;
700  const MXFCodecUL *codec_ul = NULL;
701  const MXFCodecUL *container_ul = NULL;
702  AVStream *st;
703 
704  if (!(material_track = mxf_resolve_strong_ref(mxf, &material_package->tracks_refs[i], Track))) {
705  av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track strong ref\n");
706  continue;
707  }
708 
709  if (!(material_track->sequence = mxf_resolve_strong_ref(mxf, &material_track->sequence_ref, Sequence))) {
710  av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track sequence strong ref\n");
711  continue;
712  }
713 
714  /* TODO: handle multiple source clips */
715  for (j = 0; j < material_track->sequence->structural_components_count; j++) {
716  /* TODO: handle timecode component */
717  component = mxf_resolve_strong_ref(mxf, &material_track->sequence->structural_components_refs[j], SourceClip);
718  if (!component)
719  continue;
720 
721  for (k = 0; k < mxf->packages_count; k++) {
722  temp_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[k], SourcePackage);
723  if (!temp_package)
724  continue;
725  if (!memcmp(temp_package->package_uid, component->source_package_uid, 16)) {
726  source_package = temp_package;
727  break;
728  }
729  }
730  if (!source_package) {
731  av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source package found\n", material_track->track_id);
732  break;
733  }
734  for (k = 0; k < source_package->tracks_count; k++) {
735  if (!(temp_track = mxf_resolve_strong_ref(mxf, &source_package->tracks_refs[k], Track))) {
736  av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track strong ref\n");
737  return AVERROR_INVALIDDATA;
738  }
739  if (temp_track->track_id == component->source_track_id) {
740  source_track = temp_track;
741  break;
742  }
743  }
744  if (!source_track) {
745  av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source track found\n", material_track->track_id);
746  break;
747  }
748  }
749  if (!source_track)
750  continue;
751 
752  st = avformat_new_stream(mxf->fc, NULL);
753  if (!st) {
754  av_log(mxf->fc, AV_LOG_ERROR, "could not allocate stream\n");
755  return AVERROR(ENOMEM);
756  }
757  st->id = source_track->track_id;
758  st->priv_data = source_track;
759  st->duration = component->duration;
760  if (st->duration == -1)
761  st->duration = AV_NOPTS_VALUE;
762  st->start_time = component->start_position;
763  avpriv_set_pts_info(st, 64, material_track->edit_rate.num, material_track->edit_rate.den);
764 
765  if (!(source_track->sequence = mxf_resolve_strong_ref(mxf, &source_track->sequence_ref, Sequence))) {
766  av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track sequence strong ref\n");
767  return AVERROR_INVALIDDATA;
768  }
769 
770  PRINT_KEY(mxf->fc, "data definition ul", source_track->sequence->data_definition_ul);
772  st->codec->codec_type = codec_ul->id;
773 
774  source_package->descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor_ref, AnyType);
775  if (source_package->descriptor) {
776  if (source_package->descriptor->type == MultipleDescriptor) {
777  for (j = 0; j < source_package->descriptor->sub_descriptors_count; j++) {
778  MXFDescriptor *sub_descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor->sub_descriptors_refs[j], Descriptor);
779 
780  if (!sub_descriptor) {
781  av_log(mxf->fc, AV_LOG_ERROR, "could not resolve sub descriptor strong ref\n");
782  continue;
783  }
784  if (sub_descriptor->linked_track_id == source_track->track_id) {
785  descriptor = sub_descriptor;
786  break;
787  }
788  }
789  } else if (source_package->descriptor->type == Descriptor)
790  descriptor = source_package->descriptor;
791  }
792  if (!descriptor) {
793  av_log(mxf->fc, AV_LOG_INFO, "source track %d: stream %d, no descriptor found\n", source_track->track_id, st->index);
794  continue;
795  }
796  PRINT_KEY(mxf->fc, "essence codec ul", descriptor->essence_codec_ul);
797  PRINT_KEY(mxf->fc, "essence container ul", descriptor->essence_container_ul);
798  essence_container_ul = &descriptor->essence_container_ul;
799  /* HACK: replacing the original key with mxf_encrypted_essence_container
800  * is not allowed according to s429-6, try to find correct information anyway */
801  if (IS_KLV_KEY(essence_container_ul, mxf_encrypted_essence_container)) {
802  av_log(mxf->fc, AV_LOG_INFO, "broken encrypted mxf file\n");
803  for (k = 0; k < mxf->metadata_sets_count; k++) {
805  if (metadata->type == CryptoContext) {
806  essence_container_ul = &((MXFCryptoContext *)metadata)->source_container_ul;
807  break;
808  }
809  }
810  }
811  /* TODO: drop PictureEssenceCoding and SoundEssenceCompression, only check EssenceContainer */
812  codec_ul = mxf_get_codec_ul(ff_mxf_codec_uls, &descriptor->essence_codec_ul);
813  st->codec->codec_id = codec_ul->id;
814  if (descriptor->extradata) {
815  st->codec->extradata = descriptor->extradata;
816  st->codec->extradata_size = descriptor->extradata_size;
817  }
818  if (st->codec->codec_type == AVMEDIA_TYPE_VIDEO) {
819  container_ul = mxf_get_codec_ul(mxf_essence_container_uls, essence_container_ul);
820  if (st->codec->codec_id == CODEC_ID_NONE)
821  st->codec->codec_id = container_ul->id;
822  st->codec->width = descriptor->width;
823  st->codec->height = descriptor->height;
824  if (st->codec->codec_id == CODEC_ID_RAWVIDEO)
825  st->codec->pix_fmt = descriptor->pix_fmt;
827  } else if (st->codec->codec_type == AVMEDIA_TYPE_AUDIO) {
828  container_ul = mxf_get_codec_ul(mxf_essence_container_uls, essence_container_ul);
829  if (st->codec->codec_id == CODEC_ID_NONE)
830  st->codec->codec_id = container_ul->id;
831  st->codec->channels = descriptor->channels;
832  st->codec->bits_per_coded_sample = descriptor->bits_per_sample;
833  if (descriptor->sample_rate.den > 0) {
834  st->codec->sample_rate = descriptor->sample_rate.num / descriptor->sample_rate.den;
835  avpriv_set_pts_info(st, 64, descriptor->sample_rate.den, descriptor->sample_rate.num);
836  } else {
837  av_log(mxf->fc, AV_LOG_WARNING, "invalid sample rate (%d/%d) "
838  "found for stream #%d, time base forced to 1/48000\n",
839  descriptor->sample_rate.num, descriptor->sample_rate.den,
840  st->index);
841  avpriv_set_pts_info(st, 64, 1, 48000);
842  }
843 
844  /* TODO: implement CODEC_ID_RAWAUDIO */
845  if (st->codec->codec_id == CODEC_ID_PCM_S16LE) {
846  if (descriptor->bits_per_sample > 16 && descriptor->bits_per_sample <= 24)
848  else if (descriptor->bits_per_sample == 32)
850  } else if (st->codec->codec_id == CODEC_ID_PCM_S16BE) {
851  if (descriptor->bits_per_sample > 16 && descriptor->bits_per_sample <= 24)
853  else if (descriptor->bits_per_sample == 32)
855  } else if (st->codec->codec_id == CODEC_ID_MP2) {
857  }
858  }
859  if (st->codec->codec_type != AVMEDIA_TYPE_DATA && (*essence_container_ul)[15] > 0x01) {
860  av_log(mxf->fc, AV_LOG_WARNING, "only frame wrapped mappings are correctly supported\n");
862  }
863  }
864  return 0;
865 }
866 
868  { { 0x06,0x0E,0x2B,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x05,0x01,0x00 }, mxf_read_primer_pack },
869  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x18,0x00 }, mxf_read_content_storage, 0, AnyType },
870  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x37,0x00 }, mxf_read_source_package, sizeof(MXFPackage), SourcePackage },
871  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x36,0x00 }, mxf_read_material_package, sizeof(MXFPackage), MaterialPackage },
872  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x0F,0x00 }, mxf_read_sequence, sizeof(MXFSequence), Sequence },
873  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x11,0x00 }, mxf_read_source_clip, sizeof(MXFStructuralComponent), SourceClip },
874  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x44,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), MultipleDescriptor },
875  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x42,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* Generic Sound */
876  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x28,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* CDCI */
877  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x29,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* RGBA */
878  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x51,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* MPEG 2 Video */
879  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x48,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* Wave */
880  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x47,0x00 }, mxf_read_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* AES3 */
881  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3A,0x00 }, mxf_read_track, sizeof(MXFTrack), Track }, /* Static Track */
882  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3B,0x00 }, mxf_read_track, sizeof(MXFTrack), Track }, /* Generic Track */
883  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x04,0x01,0x02,0x02,0x00,0x00 }, mxf_read_cryptographic_context, sizeof(MXFCryptoContext), CryptoContext },
884  { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x10,0x01,0x00 }, mxf_read_index_table_segment, sizeof(MXFIndexTableSegment), IndexTableSegment },
885  { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, NULL, 0, AnyType },
886 };
887 
888 static int mxf_read_local_tags(MXFContext *mxf, KLVPacket *klv, MXFMetadataReadFunc *read_child, int ctx_size, enum MXFMetadataSetType type)
889 {
890  AVIOContext *pb = mxf->fc->pb;
891  MXFMetadataSet *ctx = ctx_size ? av_mallocz(ctx_size) : mxf;
892  uint64_t klv_end = avio_tell(pb) + klv->length;
893 
894  if (!ctx)
895  return AVERROR(ENOMEM);
896  while (avio_tell(pb) + 4 < klv_end) {
897  int ret;
898  int tag = avio_rb16(pb);
899  int size = avio_rb16(pb); /* KLV specified by 0x53 */
900  uint64_t next = avio_tell(pb) + size;
901  UID uid = {0};
902 
903  av_dlog(mxf->fc, "local tag %#04x size %d\n", tag, size);
904  if (!size) { /* ignore empty tag, needed for some files with empty UMID tag */
905  av_log(mxf->fc, AV_LOG_ERROR, "local tag %#04x with 0 size\n", tag);
906  continue;
907  }
908  if (tag > 0x7FFF) { /* dynamic tag */
909  int i;
910  for (i = 0; i < mxf->local_tags_count; i++) {
911  int local_tag = AV_RB16(mxf->local_tags+i*18);
912  if (local_tag == tag) {
913  memcpy(uid, mxf->local_tags+i*18+2, 16);
914  av_dlog(mxf->fc, "local tag %#04x\n", local_tag);
915  PRINT_KEY(mxf->fc, "uid", uid);
916  }
917  }
918  }
919  if (ctx_size && tag == 0x3C0A)
920  avio_read(pb, ctx->uid, 16);
921  else if ((ret = read_child(ctx, pb, tag, size, uid)) < 0)
922  return ret;
923 
924  avio_seek(pb, next, SEEK_SET);
925  }
926  if (ctx_size) ctx->type = type;
927  return ctx_size ? mxf_add_metadata_set(mxf, ctx) : 0;
928 }
929 
931 {
932  MXFContext *mxf = s->priv_data;
933  KLVPacket klv;
934 
936  av_log(s, AV_LOG_ERROR, "could not find header partition pack key\n");
937  return AVERROR_INVALIDDATA;
938  }
939  avio_seek(s->pb, -14, SEEK_CUR);
940  mxf->fc = s;
941  while (!s->pb->eof_reached) {
942  int ret;
944 
945  if ((ret = klv_read_packet(&klv, s->pb)) < 0)
946  return ret;
947  PRINT_KEY(s, "read header", klv.key);
948  av_dlog(s, "size %"PRIu64" offset %#"PRIx64"\n", klv.length, klv.offset);
951  /* FIXME avoid seek */
952  avio_seek(s->pb, klv.offset, SEEK_SET);
953  break;
954  }
955 
956  for (metadata = mxf_metadata_read_table; metadata->read; metadata++) {
957  if (IS_KLV_KEY(klv.key, metadata->key)) {
958  int res;
959  if (klv.key[5] == 0x53) {
960  res = mxf_read_local_tags(mxf, &klv, metadata->read, metadata->ctx_size, metadata->type);
961  } else
962  res = metadata->read(mxf, s->pb, 0, 0, NULL);
963  if (res < 0) {
964  av_log(s, AV_LOG_ERROR, "error reading header metadata\n");
965  return res;
966  }
967  break;
968  }
969  }
970  if (!metadata->read)
971  avio_skip(s->pb, klv.length);
972  }
973  return mxf_parse_structural_metadata(mxf);
974 }
975 
977 {
978  MXFContext *mxf = s->priv_data;
979  int i;
980 
981  av_freep(&mxf->packages_refs);
982 
983  for (i = 0; i < s->nb_streams; i++)
984  s->streams[i]->priv_data = NULL;
985 
986  for (i = 0; i < mxf->metadata_sets_count; i++) {
987  switch (mxf->metadata_sets[i]->type) {
988  case MultipleDescriptor:
989  av_freep(&((MXFDescriptor *)mxf->metadata_sets[i])->sub_descriptors_refs);
990  break;
991  case Sequence:
992  av_freep(&((MXFSequence *)mxf->metadata_sets[i])->structural_components_refs);
993  break;
994  case SourcePackage:
995  case MaterialPackage:
996  av_freep(&((MXFPackage *)mxf->metadata_sets[i])->tracks_refs);
997  break;
998  default:
999  break;
1000  }
1001  av_freep(&mxf->metadata_sets[i]);
1002  }
1003  av_freep(&mxf->metadata_sets);
1004  av_freep(&mxf->aesc);
1005  av_freep(&mxf->local_tags);
1006  return 0;
1007 }
1008 
1009 static int mxf_probe(AVProbeData *p) {
1010  uint8_t *bufp = p->buf;
1011  uint8_t *end = p->buf + p->buf_size;
1012 
1013  if (p->buf_size < sizeof(mxf_header_partition_pack_key))
1014  return 0;
1015 
1016  /* Must skip Run-In Sequence and search for MXF header partition pack key SMPTE 377M 5.5 */
1017  end -= sizeof(mxf_header_partition_pack_key);
1018  for (; bufp < end; bufp++) {
1020  return AVPROBE_SCORE_MAX;
1021  }
1022  return 0;
1023 }
1024 
1025 /* rudimentary byte seek */
1026 /* XXX: use MXF Index */
1027 static int mxf_read_seek(AVFormatContext *s, int stream_index, int64_t sample_time, int flags)
1028 {
1029  AVStream *st = s->streams[stream_index];
1030  int64_t seconds;
1031 
1032  if (!s->bit_rate)
1033  return AVERROR_INVALIDDATA;
1034  if (sample_time < 0)
1035  sample_time = 0;
1036  seconds = av_rescale(sample_time, st->time_base.num, st->time_base.den);
1037  avio_seek(s->pb, (s->bit_rate * seconds) >> 3, SEEK_SET);
1038  ff_update_cur_dts(s, st, sample_time);
1039  return 0;
1040 }
1041 
1043  .name = "mxf",
1044  .long_name = NULL_IF_CONFIG_SMALL("Material eXchange Format"),
1045  .priv_data_size = sizeof(MXFContext),
1046  .read_probe = mxf_probe,
1051 };