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 typedef uint8_t UID[16];
52 enum MXFMetadataSetType {
64 typedef struct MXFStructuralComponent {
66 enum MXFMetadataSetType type;
67 UID source_package_uid;
68 UID data_definition_ul;
70 int64_t start_position;
72 } MXFStructuralComponent;
74 typedef struct MXFSequence {
76 enum MXFMetadataSetType type;
77 UID data_definition_ul;
78 UID *structural_components_refs;
79 int structural_components_count;
83 typedef struct MXFTrack {
85 enum MXFMetadataSetType type;
86 MXFSequence *sequence; /* mandatory, and only one */
89 uint8_t track_number[4];
93 typedef struct MXFDescriptor {
95 enum MXFMetadataSetType type;
96 UID essence_container_ul;
98 AVRational sample_rate;
99 AVRational aspect_ratio;
104 UID *sub_descriptors_refs;
105 int sub_descriptors_count;
111 typedef struct MXFPackage {
113 enum MXFMetadataSetType type;
117 MXFDescriptor *descriptor; /* only one */
121 typedef struct MXFEssenceContainerData {
123 enum MXFMetadataSetType type;
124 UID linked_package_uid;
125 } MXFEssenceContainerData;
129 enum MXFMetadataSetType type;
132 typedef struct MXFContext {
135 UID *essence_container_data_sets_refs;
136 int essence_container_data_sets_count;
137 UID *essence_containers_uls; /* Universal Labels SMPTE RP224 */
138 int essence_containers_uls_count;
139 UID operational_pattern_ul;
140 UID content_storage_uid;
141 MXFMetadataSet **metadata_sets;
142 int metadata_sets_count;
146 typedef struct KLVPacket {
152 enum MXFWrappingScheme {
157 typedef struct MXFCodecUL {
160 enum MXFWrappingScheme wrapping;
163 typedef struct MXFDataDefinitionUL {
166 } MXFDataDefinitionUL;
168 typedef struct MXFMetadataReadTableEntry {
170 int (*read)(MXFContext *mxf, KLVPacket *klv);
171 } MXFMetadataReadTableEntry;
173 /* partial keys to match */
174 static const uint8_t mxf_header_partition_pack_key[] = { 0x06,0x0e,0x2b,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x02 };
175 static const uint8_t mxf_essence_element_key[] = { 0x06,0x0e,0x2b,0x34,0x01,0x02,0x01,0x01,0x0d,0x01,0x03,0x01 };
177 #define IS_KLV_KEY(x, y) (!memcmp(x, y, sizeof(y)))
179 #define PRINT_KEY(s, x) dprintf("%s %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X\n", s, \
180 (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])
182 static int64_t klv_decode_ber_length(ByteIOContext *pb)
185 uint8_t length = get_byte(pb);
186 int type = length >> 7;
188 if (type) { /* long form */
189 int bytes_num = length & 0x7f;
190 /* SMPTE 379M 5.3.4 guarantee that bytes_num must not exceed 8 bytes */
194 size = size << 8 | get_byte(pb);
196 size = length & 0x7f;
201 static int klv_read_packet(KLVPacket *klv, ByteIOContext *pb)
203 klv->offset = url_ftell(pb);
204 get_buffer(pb, klv->key, 16);
205 klv->length = klv_decode_ber_length(pb);
206 return klv->length == -1 ? -1 : 0;
209 static int mxf_get_stream_index(AVFormatContext *s, KLVPacket *klv)
213 for (i = 0; i < s->nb_streams; i++) {
214 MXFTrack *track = s->streams[i]->priv_data;
216 if (!memcmp(klv->key + sizeof(mxf_essence_element_key), track->track_number, sizeof(track->track_number)))
219 /* return 0 if only one stream, for OP Atom files with 0 as track number */
220 return s->nb_streams == 1 ? 0 : -1;
223 /* XXX: use AVBitStreamFilter */
224 static int mxf_get_d10_aes3_packet(ByteIOContext *pb, AVStream *st, AVPacket *pkt, int64_t length)
226 uint8_t buffer[61444];
227 uint8_t *buf_ptr, *end_ptr, *data_ptr;
229 if (length > 61444) /* worst case PAL 1920 samples 8 channels */
231 get_buffer(pb, buffer, length);
232 av_new_packet(pkt, length);
233 data_ptr = pkt->data;
234 end_ptr = buffer + length;
235 buf_ptr = buffer + 4; /* skip SMPTE 331M header */
236 for (; buf_ptr < end_ptr; buf_ptr += 4) {
237 if (st->codec->bits_per_sample == 24) {
238 data_ptr[0] = (buf_ptr[2] >> 4) | ((buf_ptr[3] & 0x0f) << 4);
239 data_ptr[1] = (buf_ptr[1] >> 4) | ((buf_ptr[2] & 0x0f) << 4);
240 data_ptr[2] = (buf_ptr[0] >> 4) | ((buf_ptr[1] & 0x0f) << 4);
243 data_ptr[0] = (buf_ptr[2] >> 4) | ((buf_ptr[3] & 0x0f) << 4);
244 data_ptr[1] = (buf_ptr[1] >> 4) | ((buf_ptr[2] & 0x0f) << 4);
248 pkt->size = data_ptr - pkt->data;
252 static int mxf_read_packet(AVFormatContext *s, AVPacket *pkt)
256 while (!url_feof(&s->pb)) {
257 if (klv_read_packet(&klv, &s->pb) < 0) {
258 av_log(s, AV_LOG_ERROR, "error reading KLV packet\n");
262 PRINT_KEY("read packet", klv.key);
264 if (IS_KLV_KEY(klv.key, mxf_essence_element_key)) {
265 int index = mxf_get_stream_index(s, &klv);
267 av_log(s, AV_LOG_ERROR, "error getting stream index\n");
270 /* check for 8 channels AES3 element */
271 if (klv.key[12] == 0x06 && klv.key[13] == 0x01 && klv.key[14] == 0x10) {
272 if (mxf_get_d10_aes3_packet(&s->pb, s->streams[index], pkt, klv.length) < 0) {
273 av_log(s, AV_LOG_ERROR, "error reading D-10 aes3 frame\n");
277 av_get_packet(&s->pb, pkt, klv.length);
278 pkt->stream_index = index;
281 url_fskip(&s->pb, klv.length);
286 static int mxf_add_metadata_set(MXFContext *mxf, void *metadata_set)
288 mxf->metadata_sets = av_realloc(mxf->metadata_sets, (mxf->metadata_sets_count + 1) * sizeof(*mxf->metadata_sets));
289 mxf->metadata_sets[mxf->metadata_sets_count] = metadata_set;
290 mxf->metadata_sets_count++;
294 static int mxf_read_metadata_preface(MXFContext *mxf, KLVPacket *klv)
296 ByteIOContext *pb = &mxf->fc->pb;
299 while (bytes_read < klv->length) {
300 int tag = get_be16(pb);
301 int size = get_be16(pb); /* SMPTE 336M Table 8 KLV specified length, 0x53 */
305 get_buffer(pb, mxf->content_storage_uid, 16);
308 get_buffer(pb, mxf->operational_pattern_ul, 16);
311 mxf->essence_containers_uls_count = get_be32(pb);
312 if (mxf->essence_containers_uls_count >= UINT_MAX / sizeof(UID))
314 mxf->essence_containers_uls = av_malloc(mxf->essence_containers_uls_count * sizeof(UID));
315 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
316 get_buffer(pb, (uint8_t *)mxf->essence_containers_uls, mxf->essence_containers_uls_count * sizeof(UID));
321 bytes_read += size + 4;
326 static int mxf_read_metadata_content_storage(MXFContext *mxf, KLVPacket *klv)
328 ByteIOContext *pb = &mxf->fc->pb;
331 while (bytes_read < klv->length) {
332 int tag = get_be16(pb);
333 int size = get_be16(pb); /* SMPTE 336M Table 8 KLV specified length, 0x53 */
335 dprintf("tag 0x%04X, size %d\n", tag, size);
338 mxf->packages_count = get_be32(pb);
339 if (mxf->packages_count >= UINT_MAX / sizeof(UID))
341 mxf->packages_refs = av_malloc(mxf->packages_count * sizeof(UID));
342 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
343 get_buffer(pb, (uint8_t *)mxf->packages_refs, mxf->packages_count * sizeof(UID));
346 mxf->essence_container_data_sets_count = get_be32(pb);
347 if (mxf->essence_container_data_sets_count >= UINT_MAX / sizeof(UID))
349 mxf->essence_container_data_sets_refs = av_malloc(mxf->essence_container_data_sets_count * sizeof(UID));
350 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
351 get_buffer(pb, (uint8_t *)mxf->essence_container_data_sets_refs, mxf->essence_container_data_sets_count * sizeof(UID));
356 bytes_read += size + 4;
361 static int mxf_read_metadata_source_clip(MXFContext *mxf, KLVPacket *klv)
363 ByteIOContext *pb = &mxf->fc->pb;
364 MXFStructuralComponent *source_clip = av_mallocz(sizeof(*source_clip));
367 while (bytes_read < klv->length) {
368 int tag = get_be16(pb);
369 int size = get_be16(pb); /* SMPTE 336M Table 8 KLV specified length, 0x53 */
371 bytes_read += size + 4;
372 dprintf("tag 0x%04X, size %d\n", tag, size);
373 if (!size) /* ignore empty tag, needed for some files with empty UMID tag */
377 get_buffer(pb, source_clip->uid, 16);
380 source_clip->duration = get_be64(pb);
383 source_clip->start_position = get_be64(pb);
386 /* UMID, only get last 16 bytes */
388 get_buffer(pb, source_clip->source_package_uid, 16);
391 source_clip->source_track_id = get_be32(pb);
397 source_clip->type = SourceClip;
398 return mxf_add_metadata_set(mxf, source_clip);
401 static int mxf_read_metadata_material_package(MXFContext *mxf, KLVPacket *klv)
403 ByteIOContext *pb = &mxf->fc->pb;
404 MXFPackage *package = av_mallocz(sizeof(*package));
407 while (bytes_read < klv->length) {
408 int tag = get_be16(pb);
409 int size = get_be16(pb); /* KLV specified by 0x53 */
413 get_buffer(pb, package->uid, 16);
416 package->tracks_count = get_be32(pb);
417 if (package->tracks_count >= UINT_MAX / sizeof(UID))
419 package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
420 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
421 get_buffer(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
426 bytes_read += size + 4;
428 package->type = MaterialPackage;
429 return mxf_add_metadata_set(mxf, package);
432 static int mxf_read_metadata_track(MXFContext *mxf, KLVPacket *klv)
434 ByteIOContext *pb = &mxf->fc->pb;
435 MXFTrack *track = av_mallocz(sizeof(*track));
438 while (bytes_read < klv->length) {
439 int tag = get_be16(pb);
440 int size = get_be16(pb); /* KLV specified by 0x53 */
442 dprintf("tag 0x%04X, size %d\n", tag, size);
445 get_buffer(pb, track->uid, 16);
448 track->track_id = get_be32(pb);
451 get_buffer(pb, track->track_number, 4);
454 track->edit_rate.den = get_be32(pb);
455 track->edit_rate.num = get_be32(pb);
458 get_buffer(pb, track->sequence_ref, 16);
463 bytes_read += size + 4;
466 return mxf_add_metadata_set(mxf, track);
469 static int mxf_read_metadata_sequence(MXFContext *mxf, KLVPacket *klv)
471 ByteIOContext *pb = &mxf->fc->pb;
472 MXFSequence *sequence = av_mallocz(sizeof(*sequence));
475 while (bytes_read < klv->length) {
476 int tag = get_be16(pb);
477 int size = get_be16(pb); /* KLV specified by 0x53 */
479 dprintf("tag 0x%04X, size %d\n", tag, size);
482 get_buffer(pb, sequence->uid, 16);
485 sequence->duration = get_be64(pb);
488 get_buffer(pb, sequence->data_definition_ul, 16);
491 sequence->structural_components_count = get_be32(pb);
492 if (sequence->structural_components_count >= UINT_MAX / sizeof(UID))
494 sequence->structural_components_refs = av_malloc(sequence->structural_components_count * sizeof(UID));
495 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
496 get_buffer(pb, (uint8_t *)sequence->structural_components_refs, sequence->structural_components_count * sizeof(UID));
501 bytes_read += size + 4;
503 sequence->type = Sequence;
504 return mxf_add_metadata_set(mxf, sequence);
507 static int mxf_read_metadata_source_package(MXFContext *mxf, KLVPacket *klv)
509 ByteIOContext *pb = &mxf->fc->pb;
510 MXFPackage *package = av_mallocz(sizeof(*package));
513 while (bytes_read < klv->length) {
514 int tag = get_be16(pb);
515 int size = get_be16(pb); /* KLV specified by 0x53 */
517 dprintf("tag 0x%04X, size %d\n", tag, size);
520 get_buffer(pb, package->uid, 16);
523 package->tracks_count = get_be32(pb);
524 if (package->tracks_count >= UINT_MAX / sizeof(UID))
526 package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
527 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
528 get_buffer(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
531 /* UMID, only get last 16 bytes */
533 get_buffer(pb, package->package_uid, 16);
536 get_buffer(pb, package->descriptor_ref, 16);
541 bytes_read += size + 4;
543 package->type = SourcePackage;
544 return mxf_add_metadata_set(mxf, package);
547 static int mxf_read_metadata_multiple_descriptor(MXFContext *mxf, KLVPacket *klv)
549 ByteIOContext *pb = &mxf->fc->pb;
550 MXFDescriptor *descriptor = av_mallocz(sizeof(*descriptor));
553 while (bytes_read < klv->length) {
554 int tag = get_be16(pb);
555 int size = get_be16(pb); /* KLV specified by 0x53 */
557 dprintf("tag 0x%04X, size %d\n", tag, size);
560 get_buffer(pb, descriptor->uid, 16);
563 descriptor->sub_descriptors_count = get_be32(pb);
564 if (descriptor->sub_descriptors_count >= UINT_MAX / sizeof(UID))
566 descriptor->sub_descriptors_refs = av_malloc(descriptor->sub_descriptors_count * sizeof(UID));
567 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
568 get_buffer(pb, (uint8_t *)descriptor->sub_descriptors_refs, descriptor->sub_descriptors_count * sizeof(UID));
573 bytes_read += size + 4;
575 descriptor->type = MultipleDescriptor;
576 return mxf_add_metadata_set(mxf, descriptor);
579 static void mxf_read_metadata_pixel_layout(ByteIOContext *pb, MXFDescriptor *descriptor)
585 dprintf("pixel layout: code 0x%x\n", code);
588 descriptor->bits_per_sample += get_byte(pb);
591 descriptor->bits_per_sample += get_byte(pb);
594 descriptor->bits_per_sample += get_byte(pb);
599 } while (code != 0); /* SMPTE 377M E.2.46 */
602 static int mxf_read_metadata_generic_descriptor(MXFContext *mxf, KLVPacket *klv)
604 ByteIOContext *pb = &mxf->fc->pb;
605 MXFDescriptor *descriptor = av_mallocz(sizeof(*descriptor));
608 while (bytes_read < klv->length) {
609 int tag = get_be16(pb);
610 int size = get_be16(pb); /* KLV specified by 0x53 */
612 dprintf("tag 0x%04X, size %d\n", tag, size);
615 get_buffer(pb, descriptor->uid, 16);
618 get_buffer(pb, descriptor->essence_container_ul, 16);
621 descriptor->linked_track_id = get_be32(pb);
623 case 0x3201: /* PictureEssenceCoding */
624 get_buffer(pb, descriptor->essence_codec_ul, 16);
627 descriptor->width = get_be32(pb);
630 descriptor->height = get_be32(pb);
633 descriptor->aspect_ratio.num = get_be32(pb);
634 descriptor->aspect_ratio.den = get_be32(pb);
637 descriptor->sample_rate.num = get_be32(pb);
638 descriptor->sample_rate.den = get_be32(pb);
640 case 0x3D06: /* SoundEssenceCompression */
641 get_buffer(pb, descriptor->essence_codec_ul, 16);
644 descriptor->channels = get_be32(pb);
647 descriptor->bits_per_sample = get_be32(pb);
650 mxf_read_metadata_pixel_layout(pb, descriptor);
652 case 0x8201: /* Private tag used by SONY C0023S01.mxf */
653 descriptor->extradata = av_malloc(size);
654 descriptor->extradata_size = size;
655 get_buffer(pb, descriptor->extradata, size);
660 bytes_read += size + 4;
662 descriptor->type = Descriptor;
663 return mxf_add_metadata_set(mxf, descriptor);
666 /* SMPTE RP224 http://www.smpte-ra.org/mdd/index.html */
667 static const MXFDataDefinitionUL mxf_data_definition_uls[] = {
668 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x01,0x00,0x00,0x00 }, CODEC_TYPE_VIDEO },
669 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x02,0x00,0x00,0x00 }, CODEC_TYPE_AUDIO },
670 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x05,0x01,0x03,0x02,0x02,0x02,0x02,0x00,0x00 }, CODEC_TYPE_AUDIO },
671 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_TYPE_DATA },
674 static const MXFCodecUL mxf_codec_uls[] = {
675 /* PictureEssenceCoding */
676 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x02,0x02,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@ML I-Frame */
677 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x04,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@HL Long GoP */
678 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x01,0x11,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MP@ML Long GoP */
679 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x02,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@ML Long GoP */
680 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x03,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MP@HL Long GoP */
681 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x03 }, CODEC_ID_MPEG4, Frame }, /* XDCAM proxy_pal030926.mxf */
682 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x04 }, CODEC_ID_MPEG4, Frame }, /* XDCAM Proxy C0023S01.mxf */
683 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x05 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 30Mbps PAL */
684 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x01 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 50Mbps PAL */
685 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x02,0x04,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DVCPRO50 PAL */
686 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x02,0x02,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DVCPRO25 PAL */
687 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x01,0x02,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DV25 IEC PAL */
688 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x07,0x04,0x01,0x02,0x02,0x03,0x01,0x01,0x00 }, CODEC_ID_JPEG2000, Frame }, /* JPEG2000 Codestream */
689 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x01,0x7F,0x00,0x00,0x00 }, CODEC_ID_RAWVIDEO, Frame }, /* Uncompressed */
690 /* SoundEssenceCompression */
691 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x00,0x00,0x00,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* Uncompressed */
692 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x7F,0x00,0x00,0x00 }, CODEC_ID_PCM_S16LE, Frame },
693 { { 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 */
694 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x01,0x01,0x00 }, CODEC_ID_PCM_ALAW, Frame },
695 { { 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 */
696 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x01,0x00 }, CODEC_ID_AC3, Frame },
697 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x05,0x00 }, CODEC_ID_MP2, Frame }, /* MP2 or MP3 */
698 //{ { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x1C,0x00 }, CODEC_ID_DOLBY_E, Frame }, /* Dolby-E */
699 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
702 static const MXFCodecUL mxf_picture_essence_container_uls[] = {
703 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x60,0x01 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MPEG-ES Frame wrapped */
704 { { 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 */
705 { { 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 */
706 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
709 static const MXFCodecUL mxf_sound_essence_container_uls[] = {
710 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x01,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* BWF Frame wrapped */
711 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x03,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* AES Frame wrapped */
712 { { 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 */
713 { { 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 */
714 { { 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 */
715 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x05,0x01 }, CODEC_ID_PCM_S16BE, Frame }, /* D-10 Mapping 30Mbps PAL Extended Template */
716 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x01,0x01 }, CODEC_ID_PCM_S16BE, Frame }, /* D-10 Mapping 50Mbps PAL Extended Template */
717 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
720 static const MXFCodecUL *mxf_get_codec_ul(const MXFCodecUL *uls, UID *uid)
722 while (uls->id != CODEC_ID_NONE) {
723 if(!memcmp(uls->uid, *uid, 16))
730 static enum CodecType mxf_get_codec_type(const MXFDataDefinitionUL *uls, UID *uid)
732 while (uls->type != CODEC_TYPE_DATA) {
733 if(!memcmp(uls->uid, *uid, 16))
740 static void *mxf_resolve_strong_ref(MXFContext *mxf, UID *strong_ref)
746 for (i = 0; i < mxf->metadata_sets_count; i++) {
747 if (!memcmp(*strong_ref, mxf->metadata_sets[i]->uid, 16)) {
748 return mxf->metadata_sets[i];
754 static int mxf_parse_structural_metadata(MXFContext *mxf)
756 MXFPackage *material_package = NULL;
757 MXFPackage *source_package = NULL;
758 MXFPackage *temp_package = NULL;
761 dprintf("metadata sets count %d\n", mxf->metadata_sets_count);
762 /* TODO: handle multiple material packages (OP3x) */
763 for (i = 0; i < mxf->packages_count; i++) {
764 if (!(temp_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[i]))) {
765 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve package strong ref\n");
768 if (temp_package->type == MaterialPackage) {
769 material_package = temp_package;
773 if (!material_package) {
774 av_log(mxf->fc, AV_LOG_ERROR, "no material package found\n");
778 for (i = 0; i < material_package->tracks_count; i++) {
779 MXFTrack *material_track = NULL;
780 MXFTrack *source_track = NULL;
781 MXFTrack *temp_track = NULL;
782 MXFDescriptor *descriptor = NULL;
783 MXFStructuralComponent *component = NULL;
784 const MXFCodecUL *codec_ul = NULL;
785 const MXFCodecUL *container_ul = NULL;
788 if (!(material_track = mxf_resolve_strong_ref(mxf, &material_package->tracks_refs[i]))) {
789 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track strong ref\n");
793 if (!(material_track->sequence = mxf_resolve_strong_ref(mxf, &material_track->sequence_ref))) {
794 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track sequence strong ref\n");
798 /* TODO: handle multiple source clips */
799 for (j = 0; j < material_track->sequence->structural_components_count; j++) {
800 /* TODO: handle timecode component */
801 component = mxf_resolve_strong_ref(mxf, &material_track->sequence->structural_components_refs[j]);
802 if (!component || component->type != SourceClip)
805 for (k = 0; k < mxf->packages_count; k++) {
806 if (!(temp_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[k]))) {
807 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track strong ref\n");
810 if (!memcmp(temp_package->package_uid, component->source_package_uid, 16)) {
811 source_package = temp_package;
815 if (!source_package) {
816 av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source package found\n", material_track->track_id);
819 for (k = 0; k < source_package->tracks_count; k++) {
820 if (!(temp_track = mxf_resolve_strong_ref(mxf, &source_package->tracks_refs[k]))) {
821 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track strong ref\n");
824 if (temp_track->track_id == component->source_track_id) {
825 source_track = temp_track;
830 av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source track found\n", material_track->track_id);
837 st = av_new_stream(mxf->fc, source_track->track_id);
838 st->priv_data = source_track;
839 st->duration = component->duration;
840 if (st->duration == -1)
841 st->duration = AV_NOPTS_VALUE;
842 st->start_time = component->start_position;
843 av_set_pts_info(st, 64, material_track->edit_rate.num, material_track->edit_rate.den);
845 if (!(source_track->sequence = mxf_resolve_strong_ref(mxf, &source_track->sequence_ref))) {
846 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track sequence strong ref\n");
851 PRINT_KEY("data definition ul", source_track->sequence->data_definition_ul);
853 st->codec->codec_type = mxf_get_codec_type(mxf_data_definition_uls, &source_track->sequence->data_definition_ul);
855 source_package->descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor_ref);
856 if (source_package->descriptor) {
857 if (source_package->descriptor->type == MultipleDescriptor) {
858 for (j = 0; j < source_package->descriptor->sub_descriptors_count; j++) {
859 MXFDescriptor *sub_descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor->sub_descriptors_refs[j]);
861 if (!sub_descriptor) {
862 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve sub descriptor strong ref\n");
865 if (sub_descriptor->linked_track_id == source_track->track_id) {
866 descriptor = sub_descriptor;
871 descriptor = source_package->descriptor;
874 av_log(mxf->fc, AV_LOG_INFO, "source track %d: stream %d, no descriptor found\n", source_track->track_id, st->index);
878 PRINT_KEY("essence codec ul", descriptor->essence_codec_ul);
879 PRINT_KEY("essence container ul", descriptor->essence_container_ul);
881 /* TODO: drop PictureEssenceCoding and SoundEssenceCompression, only check EssenceContainer */
882 codec_ul = mxf_get_codec_ul(mxf_codec_uls, &descriptor->essence_codec_ul);
883 st->codec->codec_id = codec_ul->id;
884 if (descriptor->extradata) {
885 st->codec->extradata = descriptor->extradata;
886 st->codec->extradata_size = descriptor->extradata_size;
888 if (st->codec->codec_type == CODEC_TYPE_VIDEO) {
889 container_ul = mxf_get_codec_ul(mxf_picture_essence_container_uls, &descriptor->essence_container_ul);
890 if (st->codec->codec_id == CODEC_ID_NONE)
891 st->codec->codec_id = container_ul->id;
892 st->codec->width = descriptor->width;
893 st->codec->height = descriptor->height;
894 st->codec->bits_per_sample = descriptor->bits_per_sample; /* Uncompressed */
895 } else if (st->codec->codec_type == CODEC_TYPE_AUDIO) {
896 container_ul = mxf_get_codec_ul(mxf_sound_essence_container_uls, &descriptor->essence_container_ul);
897 if (st->codec->codec_id == CODEC_ID_NONE)
898 st->codec->codec_id = container_ul->id;
899 st->codec->channels = descriptor->channels;
900 st->codec->bits_per_sample = descriptor->bits_per_sample;
901 st->codec->sample_rate = descriptor->sample_rate.num / descriptor->sample_rate.den;
902 /* TODO: implement CODEC_ID_RAWAUDIO */
903 if (st->codec->codec_id == CODEC_ID_PCM_S16LE) {
904 if (descriptor->bits_per_sample == 24)
905 st->codec->codec_id = CODEC_ID_PCM_S24LE;
906 else if (descriptor->bits_per_sample == 32)
907 st->codec->codec_id = CODEC_ID_PCM_S32LE;
908 } else if (st->codec->codec_id == CODEC_ID_PCM_S16BE) {
909 if (descriptor->bits_per_sample == 24)
910 st->codec->codec_id = CODEC_ID_PCM_S24BE;
911 else if (descriptor->bits_per_sample == 32)
912 st->codec->codec_id = CODEC_ID_PCM_S32BE;
913 if (descriptor->essence_container_ul[13] == 0x01) /* D-10 Mapping */
914 st->codec->channels = 8; /* force channels to 8 */
915 } else if (st->codec->codec_id == CODEC_ID_MP2) {
916 st->need_parsing = 1;
919 if (container_ul && container_ul->wrapping == Clip) {
920 dprintf("stream %d: clip wrapped essence\n", st->index);
921 st->need_parsing = 1;
927 static const MXFMetadataReadTableEntry mxf_metadata_read_table[] = {
928 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x2F,0x00 }, mxf_read_metadata_preface },
929 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x18,0x00 }, mxf_read_metadata_content_storage },
930 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x37,0x00 }, mxf_read_metadata_source_package },
931 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x36,0x00 }, mxf_read_metadata_material_package },
932 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x0F,0x00 }, mxf_read_metadata_sequence },
933 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x11,0x00 }, mxf_read_metadata_source_clip },
934 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x44,0x00 }, mxf_read_metadata_multiple_descriptor },
935 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x42,0x00 }, mxf_read_metadata_generic_descriptor }, /* Generic Sound */
936 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x28,0x00 }, mxf_read_metadata_generic_descriptor }, /* CDCI */
937 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x29,0x00 }, mxf_read_metadata_generic_descriptor }, /* RGBA */
938 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x51,0x00 }, mxf_read_metadata_generic_descriptor }, /* MPEG 2 Video */
939 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x48,0x00 }, mxf_read_metadata_generic_descriptor }, /* Wave */
940 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x47,0x00 }, mxf_read_metadata_generic_descriptor }, /* AES3 */
941 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3A,0x00 }, mxf_read_metadata_track }, /* Static Track */
942 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3B,0x00 }, mxf_read_metadata_track }, /* Generic Track */
943 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, NULL },
946 static int mxf_read_sync(ByteIOContext *pb, const uint8_t *key, unsigned size)
949 for (i = 0; i < size && !url_feof(pb); i++) {
953 else if (b != key[i])
959 static int mxf_read_header(AVFormatContext *s, AVFormatParameters *ap)
961 MXFContext *mxf = s->priv_data;
964 if (!mxf_read_sync(&s->pb, mxf_header_partition_pack_key, 14)) {
965 av_log(s, AV_LOG_ERROR, "could not find header partition pack key\n");
968 url_fseek(&s->pb, -14, SEEK_CUR);
970 while (!url_feof(&s->pb)) {
971 const MXFMetadataReadTableEntry *function;
973 if (klv_read_packet(&klv, &s->pb) < 0) {
974 av_log(s, AV_LOG_ERROR, "error reading KLV packet\n");
978 PRINT_KEY("read header", klv.key);
980 if (IS_KLV_KEY(klv.key, mxf_essence_element_key)) {
981 /* FIXME avoid seek */
982 url_fseek(&s->pb, klv.offset, SEEK_SET);
986 for (function = mxf_metadata_read_table; function->read; function++) {
987 if (IS_KLV_KEY(klv.key, function->key)) {
988 if (function->read(mxf, &klv) < 0) {
989 av_log(s, AV_LOG_ERROR, "error reading header metadata\n");
996 url_fskip(&s->pb, klv.length);
998 return mxf_parse_structural_metadata(mxf);
1001 static int mxf_read_close(AVFormatContext *s)
1003 MXFContext *mxf = s->priv_data;
1006 av_freep(&mxf->packages_refs);
1007 av_freep(&mxf->essence_container_data_sets_refs);
1008 av_freep(&mxf->essence_containers_uls);
1009 for (i = 0; i < mxf->metadata_sets_count; i++) {
1010 switch (mxf->metadata_sets[i]->type) {
1011 case MultipleDescriptor:
1012 av_freep(&((MXFDescriptor *)mxf->metadata_sets[i])->sub_descriptors_refs);
1015 av_freep(&((MXFSequence *)mxf->metadata_sets[i])->structural_components_refs);
1018 case MaterialPackage:
1019 av_freep(&((MXFPackage *)mxf->metadata_sets[i])->tracks_refs);
1024 av_freep(&mxf->metadata_sets[i]);
1026 av_freep(&mxf->metadata_sets);
1030 static int mxf_probe(AVProbeData *p) {
1031 uint8_t *bufp = p->buf;
1032 uint8_t *end = p->buf + p->buf_size;
1034 if (p->buf_size < sizeof(mxf_header_partition_pack_key))
1037 /* Must skip Run-In Sequence and search for MXF header partition pack key SMPTE 377M 5.5 */
1038 end -= sizeof(mxf_header_partition_pack_key);
1039 for (; bufp < end; bufp++) {
1040 if (IS_KLV_KEY(bufp, mxf_header_partition_pack_key))
1041 return AVPROBE_SCORE_MAX;
1046 /* rudimentary binary seek */
1047 /* XXX: use MXF Index */
1048 static int mxf_read_seek(AVFormatContext *s, int stream_index, int64_t sample_time, int flags)
1050 AVStream *st = s->streams[stream_index];
1055 if (sample_time < 0)
1057 seconds = av_rescale(sample_time, st->time_base.num, st->time_base.den);
1058 url_fseek(&s->pb, (s->bit_rate * seconds) >> 3, SEEK_SET);
1059 if (!mxf_read_sync(&s->pb, mxf_essence_element_key, 12))
1063 url_fseek(&s->pb, -12, SEEK_CUR);
1064 av_update_cur_dts(s, st, sample_time);
1068 AVInputFormat mxf_demuxer = {