3 * Copyright (c) 2006 SmartJog S.A., Baptiste Coudurier <baptiste dot coudurier at smartjog dot com>.
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 * 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
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.
39 * Metadata reading functions read Local Tags, get InstanceUID(0x3C0A) then add MetaDataSet to MXFContext.
40 * Metadata parsing resolves Strong References to objects.
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
50 #include "bytestream.h"
52 typedef uint8_t UID[16];
54 enum MXFMetadataSetType {
69 enum MXFMetadataSetType type;
71 UID source_container_ul;
76 enum MXFMetadataSetType type;
77 UID source_package_uid;
78 UID data_definition_ul;
80 int64_t start_position;
82 } MXFStructuralComponent;
86 enum MXFMetadataSetType type;
87 UID data_definition_ul;
88 UID *structural_components_refs;
89 int structural_components_count;
95 enum MXFMetadataSetType type;
96 MXFSequence *sequence; /* mandatory, and only one */
99 uint8_t track_number[4];
100 AVRational edit_rate;
105 enum MXFMetadataSetType type;
106 UID essence_container_ul;
107 UID essence_codec_ul;
108 AVRational sample_rate;
109 AVRational aspect_ratio;
114 UID *sub_descriptors_refs;
115 int sub_descriptors_count;
123 enum MXFMetadataSetType type;
127 MXFDescriptor *descriptor; /* only one */
133 enum MXFMetadataSetType type;
139 MXFMetadataSet **metadata_sets;
140 int metadata_sets_count;
151 enum MXFWrappingScheme {
159 enum MXFWrappingScheme wrapping;
165 } MXFDataDefinitionUL;
171 enum MXFMetadataSetType type;
172 } MXFMetadataReadTableEntry;
174 /* partial keys to match */
175 static const uint8_t mxf_header_partition_pack_key[] = { 0x06,0x0e,0x2b,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x02 };
176 static const uint8_t mxf_essence_element_key[] = { 0x06,0x0e,0x2b,0x34,0x01,0x02,0x01,0x01,0x0d,0x01,0x03,0x01 };
177 static const uint8_t mxf_klv_key[] = { 0x06,0x0e,0x2b,0x34 };
178 /* complete keys to match */
179 static const uint8_t mxf_encrypted_triplet_key[] = { 0x06,0x0e,0x2b,0x34,0x02,0x04,0x01,0x07,0x0d,0x01,0x03,0x01,0x02,0x7e,0x01,0x00 };
180 static const uint8_t mxf_encrypted_essence_container[] = { 0x06,0x0e,0x2b,0x34,0x04,0x01,0x01,0x07,0x0d,0x01,0x03,0x01,0x02,0x0b,0x01,0x00 };
182 #define IS_KLV_KEY(x, y) (!memcmp(x, y, sizeof(y)))
184 #define PRINT_KEY(pc, s, x) dprintf(pc, "%s %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X\n", s, \
185 (x)[0], (x)[1], (x)[2], (x)[3], (x)[4], (x)[5], (x)[6], (x)[7], (x)[8], (x)[9], (x)[10], (x)[11], (x)[12], (x)[13], (x)[14], (x)[15])
187 static int64_t klv_decode_ber_length(ByteIOContext *pb)
189 uint64_t size = get_byte(pb);
190 if (size & 0x80) { /* long form */
191 int bytes_num = size & 0x7f;
192 /* SMPTE 379M 5.3.4 guarantee that bytes_num must not exceed 8 bytes */
197 size = size << 8 | get_byte(pb);
202 static int mxf_read_sync(ByteIOContext *pb, const uint8_t *key, unsigned size)
205 for (i = 0; i < size && !url_feof(pb); i++) {
209 else if (b != key[i])
215 static int klv_read_packet(KLVPacket *klv, ByteIOContext *pb)
217 if (!mxf_read_sync(pb, mxf_klv_key, 4))
219 klv->offset = url_ftell(pb) - 4;
220 memcpy(klv->key, mxf_klv_key, 4);
221 get_buffer(pb, klv->key + 4, 12);
222 klv->length = klv_decode_ber_length(pb);
223 return klv->length == -1 ? -1 : 0;
226 static int mxf_get_stream_index(AVFormatContext *s, KLVPacket *klv)
230 for (i = 0; i < s->nb_streams; i++) {
231 MXFTrack *track = s->streams[i]->priv_data;
233 if (!memcmp(klv->key + sizeof(mxf_essence_element_key), track->track_number, sizeof(track->track_number)))
236 /* return 0 if only one stream, for OP Atom files with 0 as track number */
237 return s->nb_streams == 1 ? 0 : -1;
240 /* XXX: use AVBitStreamFilter */
241 static int mxf_get_d10_aes3_packet(ByteIOContext *pb, AVStream *st, AVPacket *pkt, int64_t length)
243 uint8_t buffer[61444];
244 uint8_t *buf_ptr, *end_ptr, *data_ptr;
247 if (length > 61444) /* worst case PAL 1920 samples 8 channels */
249 get_buffer(pb, buffer, length);
250 av_new_packet(pkt, length);
251 data_ptr = pkt->data;
252 end_ptr = buffer + length;
253 buf_ptr = buffer + 4; /* skip SMPTE 331M header */
254 for (; buf_ptr < end_ptr; ) {
255 for (i = 0; i < st->codec->channels; i++) {
256 uint32_t sample = bytestream_get_le32(&buf_ptr);
257 if (st->codec->bits_per_sample == 24)
258 bytestream_put_le24(&data_ptr, (sample >> 4) & 0xffffff);
260 bytestream_put_le16(&data_ptr, (sample >> 12) & 0xffff);
262 buf_ptr += 32 - st->codec->channels*4; // always 8 channels stored SMPTE 331M
264 pkt->size = data_ptr - pkt->data;
268 static int mxf_decrypt_triplet(AVFormatContext *s, AVPacket *pkt, KLVPacket *klv)
270 static const uint8_t checkv[16] = {0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b};
271 MXFContext *mxf = s->priv_data;
272 ByteIOContext *pb = s->pb;
273 offset_t end = url_ftell(pb) + klv->length;
276 uint64_t plaintext_size;
281 if (!mxf->aesc && s->key && s->keylen == 16) {
282 mxf->aesc = av_malloc(av_aes_size);
283 av_aes_init(mxf->aesc, s->key, 128, 1);
286 url_fskip(pb, klv_decode_ber_length(pb));
288 klv_decode_ber_length(pb);
289 plaintext_size = get_be64(pb);
291 klv_decode_ber_length(pb);
292 get_buffer(pb, klv->key, 16);
293 if (!IS_KLV_KEY(klv, mxf_essence_element_key))
295 index = mxf_get_stream_index(s, klv);
299 klv_decode_ber_length(pb);
300 orig_size = get_be64(pb);
301 if (orig_size < plaintext_size)
304 size = klv_decode_ber_length(pb);
305 if (size < 32 || size - 32 < orig_size)
307 get_buffer(pb, ivec, 16);
308 get_buffer(pb, tmpbuf, 16);
310 av_aes_crypt(mxf->aesc, tmpbuf, tmpbuf, 1, ivec, 1);
311 if (memcmp(tmpbuf, checkv, 16))
312 av_log(s, AV_LOG_ERROR, "probably incorrect decryption key\n");
314 av_get_packet(pb, pkt, size);
315 size -= plaintext_size;
317 av_aes_crypt(mxf->aesc, &pkt->data[plaintext_size],
318 &pkt->data[plaintext_size], size >> 4, ivec, 1);
319 pkt->size = orig_size;
320 pkt->stream_index = index;
321 url_fskip(pb, end - url_ftell(pb));
325 static int mxf_read_packet(AVFormatContext *s, AVPacket *pkt)
329 while (!url_feof(s->pb)) {
330 if (klv_read_packet(&klv, s->pb) < 0)
333 PRINT_KEY(s, "read packet", klv.key);
335 if (IS_KLV_KEY(klv.key, mxf_encrypted_triplet_key)) {
336 int res = mxf_decrypt_triplet(s, pkt, &klv);
338 av_log(s, AV_LOG_ERROR, "invalid encoded triplet\n");
343 if (IS_KLV_KEY(klv.key, mxf_essence_element_key)) {
344 int index = mxf_get_stream_index(s, &klv);
346 av_log(s, AV_LOG_ERROR, "error getting stream index\n");
347 url_fskip(s->pb, klv.length);
350 /* check for 8 channels AES3 element */
351 if (klv.key[12] == 0x06 && klv.key[13] == 0x01 && klv.key[14] == 0x10) {
352 if (mxf_get_d10_aes3_packet(s->pb, s->streams[index], pkt, klv.length) < 0) {
353 av_log(s, AV_LOG_ERROR, "error reading D-10 aes3 frame\n");
357 av_get_packet(s->pb, pkt, klv.length);
358 pkt->stream_index = index;
359 pkt->pos = klv.offset;
362 url_fskip(s->pb, klv.length);
367 static int mxf_add_metadata_set(MXFContext *mxf, void *metadata_set)
369 mxf->metadata_sets = av_realloc(mxf->metadata_sets, (mxf->metadata_sets_count + 1) * sizeof(*mxf->metadata_sets));
370 mxf->metadata_sets[mxf->metadata_sets_count] = metadata_set;
371 mxf->metadata_sets_count++;
375 static int mxf_read_metadata_cryptographic_context(MXFCryptoContext *cryptocontext, ByteIOContext *pb, int tag)
379 get_buffer(pb, cryptocontext->context_uid, 16);
382 get_buffer(pb, cryptocontext->source_container_ul, 16);
388 static int mxf_read_metadata_content_storage(MXFContext *mxf, ByteIOContext *pb, int tag)
392 mxf->packages_count = get_be32(pb);
393 if (mxf->packages_count >= UINT_MAX / sizeof(UID))
395 mxf->packages_refs = av_malloc(mxf->packages_count * sizeof(UID));
396 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
397 get_buffer(pb, (uint8_t *)mxf->packages_refs, mxf->packages_count * sizeof(UID));
403 static int mxf_read_metadata_source_clip(MXFStructuralComponent *source_clip, ByteIOContext *pb, int tag)
407 source_clip->duration = get_be64(pb);
410 source_clip->start_position = get_be64(pb);
413 /* UMID, only get last 16 bytes */
415 get_buffer(pb, source_clip->source_package_uid, 16);
418 source_clip->source_track_id = get_be32(pb);
424 static int mxf_read_metadata_material_package(MXFPackage *package, ByteIOContext *pb, int tag)
428 package->tracks_count = get_be32(pb);
429 if (package->tracks_count >= UINT_MAX / sizeof(UID))
431 package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
432 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
433 get_buffer(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
439 static int mxf_read_metadata_track(MXFTrack *track, ByteIOContext *pb, int tag)
443 track->track_id = get_be32(pb);
446 get_buffer(pb, track->track_number, 4);
449 track->edit_rate.den = get_be32(pb);
450 track->edit_rate.num = get_be32(pb);
453 get_buffer(pb, track->sequence_ref, 16);
459 static int mxf_read_metadata_sequence(MXFSequence *sequence, ByteIOContext *pb, int tag)
463 sequence->duration = get_be64(pb);
466 get_buffer(pb, sequence->data_definition_ul, 16);
469 sequence->structural_components_count = get_be32(pb);
470 if (sequence->structural_components_count >= UINT_MAX / sizeof(UID))
472 sequence->structural_components_refs = av_malloc(sequence->structural_components_count * sizeof(UID));
473 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
474 get_buffer(pb, (uint8_t *)sequence->structural_components_refs, sequence->structural_components_count * sizeof(UID));
480 static int mxf_read_metadata_source_package(MXFPackage *package, ByteIOContext *pb, int tag)
484 package->tracks_count = get_be32(pb);
485 if (package->tracks_count >= UINT_MAX / sizeof(UID))
487 package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
488 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
489 get_buffer(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
492 /* UMID, only get last 16 bytes */
494 get_buffer(pb, package->package_uid, 16);
497 get_buffer(pb, package->descriptor_ref, 16);
503 static void mxf_read_metadata_pixel_layout(ByteIOContext *pb, MXFDescriptor *descriptor)
509 dprintf(NULL, "pixel layout: code 0x%x\n", code);
512 descriptor->bits_per_sample += get_byte(pb);
515 descriptor->bits_per_sample += get_byte(pb);
518 descriptor->bits_per_sample += get_byte(pb);
523 } while (code != 0); /* SMPTE 377M E.2.46 */
526 static int mxf_read_metadata_generic_descriptor(MXFDescriptor *descriptor, ByteIOContext *pb, int tag, int size)
530 descriptor->sub_descriptors_count = get_be32(pb);
531 if (descriptor->sub_descriptors_count >= UINT_MAX / sizeof(UID))
533 descriptor->sub_descriptors_refs = av_malloc(descriptor->sub_descriptors_count * sizeof(UID));
534 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
535 get_buffer(pb, (uint8_t *)descriptor->sub_descriptors_refs, descriptor->sub_descriptors_count * sizeof(UID));
538 get_buffer(pb, descriptor->essence_container_ul, 16);
541 descriptor->linked_track_id = get_be32(pb);
543 case 0x3201: /* PictureEssenceCoding */
544 get_buffer(pb, descriptor->essence_codec_ul, 16);
547 descriptor->width = get_be32(pb);
550 descriptor->height = get_be32(pb);
553 descriptor->aspect_ratio.num = get_be32(pb);
554 descriptor->aspect_ratio.den = get_be32(pb);
557 descriptor->sample_rate.num = get_be32(pb);
558 descriptor->sample_rate.den = get_be32(pb);
560 case 0x3D06: /* SoundEssenceCompression */
561 get_buffer(pb, descriptor->essence_codec_ul, 16);
564 descriptor->channels = get_be32(pb);
567 descriptor->bits_per_sample = get_be32(pb);
570 mxf_read_metadata_pixel_layout(pb, descriptor);
572 case 0x8201: /* Private tag used by SONY C0023S01.mxf */
573 descriptor->extradata = av_malloc(size);
574 descriptor->extradata_size = size;
575 get_buffer(pb, descriptor->extradata, size);
581 /* SMPTE RP224 http://www.smpte-ra.org/mdd/index.html */
582 static const MXFDataDefinitionUL mxf_data_definition_uls[] = {
583 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x01,0x00,0x00,0x00 }, CODEC_TYPE_VIDEO },
584 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x02,0x00,0x00,0x00 }, CODEC_TYPE_AUDIO },
585 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x05,0x01,0x03,0x02,0x02,0x02,0x02,0x00,0x00 }, CODEC_TYPE_AUDIO },
586 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_TYPE_DATA },
589 static const MXFCodecUL mxf_codec_uls[] = {
590 /* PictureEssenceCoding */
591 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x01,0x11,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MP@ML Long GoP */
593 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x05 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 30Mbps PAL */
594 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x03 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 40Mbps PAL */
595 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x01 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 50Mbps PAL */
596 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x06 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 30Mbps NTSC */
597 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x04 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 40Mbps NTSC */
598 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x02 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 50Mbps NTSC */
600 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x02,0x02,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@ML I-Frame */
601 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x02,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@ML Long GoP */
603 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x03,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MP@HL Long GoP */
605 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x04,0x02,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@HL I-Frame */
606 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x04,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@HL Long GoP */
608 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x03 }, CODEC_ID_MPEG4, Frame }, /* XDCAM proxy_pal030926.mxf */
609 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x04 }, CODEC_ID_MPEG4, Frame }, /* XDCAM Proxy C0023S01.mxf */
611 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x01,0x02,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DV25 IEC PAL */
612 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x02,0x02,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DVCPRO25 PAL */
613 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x02,0x04,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DVCPRO50 PAL */
615 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x07,0x04,0x01,0x02,0x02,0x03,0x01,0x01,0x00 }, CODEC_ID_JPEG2000, Frame }, /* JPEG2000 Codestream */
617 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x01,0x7F,0x00,0x00,0x00 }, CODEC_ID_RAWVIDEO, Frame }, /* Uncompressed */
618 /* SoundEssenceCompression */
619 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x00,0x00,0x00,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* Uncompressed */
620 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x7F,0x00,0x00,0x00 }, CODEC_ID_PCM_S16LE, Frame },
621 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x07,0x04,0x02,0x02,0x01,0x7E,0x00,0x00,0x00 }, CODEC_ID_PCM_S16BE, Frame }, /* From Omneon MXF file */
622 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x04,0x04,0x02,0x02,0x02,0x03,0x01,0x01,0x00 }, CODEC_ID_PCM_ALAW, Frame }, /* XDCAM Proxy C0023S01.mxf */
623 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x01,0x00 }, CODEC_ID_AC3, Frame },
624 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x05,0x00 }, CODEC_ID_MP2, Frame }, /* MP2 or MP3 */
625 //{ { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x1C,0x00 }, CODEC_ID_DOLBY_E, Frame }, /* Dolby-E */
626 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
629 static const MXFCodecUL mxf_picture_essence_container_uls[] = {
630 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x60,0x01 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MPEG-ES Frame wrapped */
631 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0xe0,0x02 }, CODEC_ID_MPEG2VIDEO, Clip }, /* MPEG-ES Clip wrapped, 0xe0 MPV stream id */
632 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x04,0x61,0x07 }, CODEC_ID_MPEG2VIDEO, Clip }, /* MPEG-ES Custom wrapped, 0x61 ??? stream id */
633 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
636 static const MXFCodecUL mxf_sound_essence_container_uls[] = {
637 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x01,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* BWF Frame wrapped */
638 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x03,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* AES Frame wrapped */
639 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x40,0x01 }, CODEC_ID_MP2, Frame }, /* MPEG-ES Frame wrapped, 0x40 ??? stream id */
640 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0xc0,0x01 }, CODEC_ID_MP2, Frame }, /* MPEG-ES Frame wrapped, 0xc0 MPA stream id */
641 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0xc0,0x02 }, CODEC_ID_MP2, Clip }, /* MPEG-ES Clip wrapped, 0xc0 MPA stream id */
642 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x05,0x01 }, CODEC_ID_PCM_S16LE, Frame }, /* D-10 Mapping 30Mbps PAL Extended Template */
643 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x03,0x01 }, CODEC_ID_PCM_S16LE, Frame }, /* D-10 Mapping 40Mbps PAL Extended Template */
644 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x01,0x01 }, CODEC_ID_PCM_S16LE, Frame }, /* D-10 Mapping 50Mbps PAL Extended Template */
645 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x06,0x01 }, CODEC_ID_PCM_S16LE, Frame }, /* D-10 Mapping 30Mbps NTSC Extended Template */
646 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x04,0x01 }, CODEC_ID_PCM_S16LE, Frame }, /* D-10 Mapping 40Mbps NTSC Extended Template */
647 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x02,0x01 }, CODEC_ID_PCM_S16LE, Frame }, /* D-10 Mapping 50Mbps NTSC Extended Template */
648 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
652 * Match an uid independently of the version byte and up to len common bytes
655 static int mxf_match_uid(const UID key, const UID uid, int len)
658 for (i = 0; i < len; i++) {
659 if (i != 7 && key[i] != uid[i])
665 static const MXFCodecUL *mxf_get_codec_ul(const MXFCodecUL *uls, UID *uid)
667 while (uls->id != CODEC_ID_NONE) {
668 if(mxf_match_uid(uls->uid, *uid, 16))
675 static enum CodecType mxf_get_codec_type(const MXFDataDefinitionUL *uls, UID *uid)
677 while (uls->type != CODEC_TYPE_DATA) {
678 if(mxf_match_uid(uls->uid, *uid, 16))
685 static void *mxf_resolve_strong_ref(MXFContext *mxf, UID *strong_ref, enum MXFMetadataSetType type)
691 for (i = 0; i < mxf->metadata_sets_count; i++) {
692 if (!memcmp(*strong_ref, mxf->metadata_sets[i]->uid, 16) &&
693 (type == AnyType || mxf->metadata_sets[i]->type == type)) {
694 return mxf->metadata_sets[i];
700 static int mxf_parse_structural_metadata(MXFContext *mxf)
702 MXFPackage *material_package = NULL;
703 MXFPackage *temp_package = NULL;
706 dprintf(mxf->fc, "metadata sets count %d\n", mxf->metadata_sets_count);
707 /* TODO: handle multiple material packages (OP3x) */
708 for (i = 0; i < mxf->packages_count; i++) {
709 material_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[i], MaterialPackage);
710 if (material_package) break;
712 if (!material_package) {
713 av_log(mxf->fc, AV_LOG_ERROR, "no material package found\n");
717 for (i = 0; i < material_package->tracks_count; i++) {
718 MXFPackage *source_package = NULL;
719 MXFTrack *material_track = NULL;
720 MXFTrack *source_track = NULL;
721 MXFTrack *temp_track = NULL;
722 MXFDescriptor *descriptor = NULL;
723 MXFStructuralComponent *component = NULL;
724 UID *essence_container_ul = NULL;
725 const MXFCodecUL *codec_ul = NULL;
726 const MXFCodecUL *container_ul = NULL;
729 if (!(material_track = mxf_resolve_strong_ref(mxf, &material_package->tracks_refs[i], Track))) {
730 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track strong ref\n");
734 if (!(material_track->sequence = mxf_resolve_strong_ref(mxf, &material_track->sequence_ref, Sequence))) {
735 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track sequence strong ref\n");
739 /* TODO: handle multiple source clips */
740 for (j = 0; j < material_track->sequence->structural_components_count; j++) {
741 /* TODO: handle timecode component */
742 component = mxf_resolve_strong_ref(mxf, &material_track->sequence->structural_components_refs[j], SourceClip);
746 for (k = 0; k < mxf->packages_count; k++) {
747 temp_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[k], SourcePackage);
750 if (!memcmp(temp_package->package_uid, component->source_package_uid, 16)) {
751 source_package = temp_package;
755 if (!source_package) {
756 av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source package found\n", material_track->track_id);
759 for (k = 0; k < source_package->tracks_count; k++) {
760 if (!(temp_track = mxf_resolve_strong_ref(mxf, &source_package->tracks_refs[k], Track))) {
761 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track strong ref\n");
764 if (temp_track->track_id == component->source_track_id) {
765 source_track = temp_track;
770 av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source track found\n", material_track->track_id);
777 st = av_new_stream(mxf->fc, source_track->track_id);
778 st->priv_data = source_track;
779 st->duration = component->duration;
780 if (st->duration == -1)
781 st->duration = AV_NOPTS_VALUE;
782 st->start_time = component->start_position;
783 av_set_pts_info(st, 64, material_track->edit_rate.num, material_track->edit_rate.den);
785 if (!(source_track->sequence = mxf_resolve_strong_ref(mxf, &source_track->sequence_ref, Sequence))) {
786 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track sequence strong ref\n");
791 PRINT_KEY(mxf->fc, "data definition ul", source_track->sequence->data_definition_ul);
793 st->codec->codec_type = mxf_get_codec_type(mxf_data_definition_uls, &source_track->sequence->data_definition_ul);
795 source_package->descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor_ref, AnyType);
796 if (source_package->descriptor) {
797 if (source_package->descriptor->type == MultipleDescriptor) {
798 for (j = 0; j < source_package->descriptor->sub_descriptors_count; j++) {
799 MXFDescriptor *sub_descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor->sub_descriptors_refs[j], Descriptor);
801 if (!sub_descriptor) {
802 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve sub descriptor strong ref\n");
805 if (sub_descriptor->linked_track_id == source_track->track_id) {
806 descriptor = sub_descriptor;
810 } else if (source_package->descriptor->type == Descriptor)
811 descriptor = source_package->descriptor;
814 av_log(mxf->fc, AV_LOG_INFO, "source track %d: stream %d, no descriptor found\n", source_track->track_id, st->index);
818 PRINT_KEY(mxf->fc, "essence codec ul", descriptor->essence_codec_ul);
819 PRINT_KEY(mxf->fc, "essence container ul", descriptor->essence_container_ul);
821 essence_container_ul = &descriptor->essence_container_ul;
822 /* HACK: replacing the original key with mxf_encrypted_essence_container
823 * is not allowed according to s429-6, try to find correct information anyway */
824 if (IS_KLV_KEY(essence_container_ul, mxf_encrypted_essence_container)) {
825 av_log(mxf->fc, AV_LOG_INFO, "broken encrypted mxf file\n");
826 for (k = 0; k < mxf->metadata_sets_count; k++) {
827 MXFMetadataSet *metadata = mxf->metadata_sets[k];
828 if (metadata->type == CryptoContext) {
829 essence_container_ul = &((MXFCryptoContext *)metadata)->source_container_ul;
834 /* TODO: drop PictureEssenceCoding and SoundEssenceCompression, only check EssenceContainer */
835 codec_ul = mxf_get_codec_ul(mxf_codec_uls, &descriptor->essence_codec_ul);
836 st->codec->codec_id = codec_ul->id;
837 if (descriptor->extradata) {
838 st->codec->extradata = descriptor->extradata;
839 st->codec->extradata_size = descriptor->extradata_size;
841 if (st->codec->codec_type == CODEC_TYPE_VIDEO) {
842 container_ul = mxf_get_codec_ul(mxf_picture_essence_container_uls, essence_container_ul);
843 if (st->codec->codec_id == CODEC_ID_NONE)
844 st->codec->codec_id = container_ul->id;
845 st->codec->width = descriptor->width;
846 st->codec->height = descriptor->height;
847 st->codec->bits_per_sample = descriptor->bits_per_sample; /* Uncompressed */
848 st->need_parsing = AVSTREAM_PARSE_HEADERS;
849 } else if (st->codec->codec_type == CODEC_TYPE_AUDIO) {
850 container_ul = mxf_get_codec_ul(mxf_sound_essence_container_uls, essence_container_ul);
851 if (st->codec->codec_id == CODEC_ID_NONE)
852 st->codec->codec_id = container_ul->id;
853 st->codec->channels = descriptor->channels;
854 st->codec->bits_per_sample = descriptor->bits_per_sample;
855 st->codec->sample_rate = descriptor->sample_rate.num / descriptor->sample_rate.den;
856 /* TODO: implement CODEC_ID_RAWAUDIO */
857 if (st->codec->codec_id == CODEC_ID_PCM_S16LE) {
858 if (descriptor->bits_per_sample == 24)
859 st->codec->codec_id = CODEC_ID_PCM_S24LE;
860 else if (descriptor->bits_per_sample == 32)
861 st->codec->codec_id = CODEC_ID_PCM_S32LE;
862 } else if (st->codec->codec_id == CODEC_ID_PCM_S16BE) {
863 if (descriptor->bits_per_sample == 24)
864 st->codec->codec_id = CODEC_ID_PCM_S24BE;
865 else if (descriptor->bits_per_sample == 32)
866 st->codec->codec_id = CODEC_ID_PCM_S32BE;
867 } else if (st->codec->codec_id == CODEC_ID_MP2) {
868 st->need_parsing = AVSTREAM_PARSE_FULL;
871 if (container_ul && container_ul->wrapping == Clip) {
872 dprintf(mxf->fc, "stream %d: clip wrapped essence\n", st->index);
873 st->need_parsing = AVSTREAM_PARSE_FULL;
879 static const MXFMetadataReadTableEntry mxf_metadata_read_table[] = {
880 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x18,0x00 }, mxf_read_metadata_content_storage, 0, AnyType },
881 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x37,0x00 }, mxf_read_metadata_source_package, sizeof(MXFPackage), SourcePackage },
882 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x36,0x00 }, mxf_read_metadata_material_package, sizeof(MXFPackage), MaterialPackage },
883 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x0F,0x00 }, mxf_read_metadata_sequence, sizeof(MXFSequence), Sequence },
884 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x11,0x00 }, mxf_read_metadata_source_clip, sizeof(MXFStructuralComponent), SourceClip },
885 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x44,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), MultipleDescriptor },
886 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x42,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* Generic Sound */
887 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x28,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* CDCI */
888 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x29,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* RGBA */
889 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x51,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* MPEG 2 Video */
890 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x48,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* Wave */
891 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x47,0x00 }, mxf_read_metadata_generic_descriptor, sizeof(MXFDescriptor), Descriptor }, /* AES3 */
892 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3A,0x00 }, mxf_read_metadata_track, sizeof(MXFTrack), Track }, /* Static Track */
893 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3B,0x00 }, mxf_read_metadata_track, sizeof(MXFTrack), Track }, /* Generic Track */
894 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x04,0x01,0x02,0x02,0x00,0x00 }, mxf_read_metadata_cryptographic_context, sizeof(MXFCryptoContext), CryptoContext },
895 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, NULL, 0, AnyType },
898 static int mxf_read_local_tags(MXFContext *mxf, KLVPacket *klv, int (*read_child)(), int ctx_size, enum MXFMetadataSetType type)
900 ByteIOContext *pb = mxf->fc->pb;
901 MXFMetadataSet *ctx = ctx_size ? av_mallocz(ctx_size) : mxf;
902 uint64_t klv_end= url_ftell(pb) + klv->length;
904 while (url_ftell(pb) + 4 < klv_end) {
905 int tag = get_be16(pb);
906 int size = get_be16(pb); /* KLV specified by 0x53 */
907 uint64_t next= url_ftell(pb) + size;
909 if (!size) { /* ignore empty tag, needed for some files with empty UMID tag */
910 av_log(mxf->fc, AV_LOG_ERROR, "local tag 0x%04X with 0 size\n", tag);
913 if(ctx_size && tag == 0x3C0A)
914 get_buffer(pb, ctx->uid, 16);
916 read_child(ctx, pb, tag, size);
918 url_fseek(pb, next, SEEK_SET);
920 if (ctx_size) ctx->type = type;
921 return ctx_size ? mxf_add_metadata_set(mxf, ctx) : 0;
924 static int mxf_read_header(AVFormatContext *s, AVFormatParameters *ap)
926 MXFContext *mxf = s->priv_data;
929 if (!mxf_read_sync(s->pb, mxf_header_partition_pack_key, 14)) {
930 av_log(s, AV_LOG_ERROR, "could not find header partition pack key\n");
933 url_fseek(s->pb, -14, SEEK_CUR);
935 while (!url_feof(s->pb)) {
936 const MXFMetadataReadTableEntry *metadata;
938 if (klv_read_packet(&klv, s->pb) < 0)
941 PRINT_KEY(s, "read header", klv.key);
943 if (IS_KLV_KEY(klv.key, mxf_encrypted_triplet_key) ||
944 IS_KLV_KEY(klv.key, mxf_essence_element_key)) {
945 /* FIXME avoid seek */
946 url_fseek(s->pb, klv.offset, SEEK_SET);
950 for (metadata = mxf_metadata_read_table; metadata->read; metadata++) {
951 if (IS_KLV_KEY(klv.key, metadata->key)) {
952 if (mxf_read_local_tags(mxf, &klv, metadata->read, metadata->ctx_size, metadata->type) < 0) {
953 av_log(s, AV_LOG_ERROR, "error reading header metadata\n");
960 url_fskip(s->pb, klv.length);
962 return mxf_parse_structural_metadata(mxf);
965 static int mxf_read_close(AVFormatContext *s)
967 MXFContext *mxf = s->priv_data;
970 av_freep(&mxf->packages_refs);
971 for (i = 0; i < mxf->metadata_sets_count; i++) {
972 switch (mxf->metadata_sets[i]->type) {
973 case MultipleDescriptor:
974 av_freep(&((MXFDescriptor *)mxf->metadata_sets[i])->sub_descriptors_refs);
977 av_freep(&((MXFSequence *)mxf->metadata_sets[i])->structural_components_refs);
980 case MaterialPackage:
981 av_freep(&((MXFPackage *)mxf->metadata_sets[i])->tracks_refs);
986 av_freep(&mxf->metadata_sets[i]);
988 av_freep(&mxf->metadata_sets);
989 av_freep(&mxf->aesc);
993 static int mxf_probe(AVProbeData *p) {
994 uint8_t *bufp = p->buf;
995 uint8_t *end = p->buf + p->buf_size;
997 if (p->buf_size < sizeof(mxf_header_partition_pack_key))
1000 /* Must skip Run-In Sequence and search for MXF header partition pack key SMPTE 377M 5.5 */
1001 end -= sizeof(mxf_header_partition_pack_key);
1002 for (; bufp < end; bufp++) {
1003 if (IS_KLV_KEY(bufp, mxf_header_partition_pack_key))
1004 return AVPROBE_SCORE_MAX;
1009 /* rudimentary byte seek */
1010 /* XXX: use MXF Index */
1011 static int mxf_read_seek(AVFormatContext *s, int stream_index, int64_t sample_time, int flags)
1013 AVStream *st = s->streams[stream_index];
1018 if (sample_time < 0)
1020 seconds = av_rescale(sample_time, st->time_base.num, st->time_base.den);
1021 url_fseek(s->pb, (s->bit_rate * seconds) >> 3, SEEK_SET);
1022 av_update_cur_dts(s, st, sample_time);
1026 AVInputFormat mxf_demuxer = {