3 * Copyright (c) 2006 SmartJog S.A., Baptiste Coudurier <baptiste dot coudurier at smartjog dot com>.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 * SMPTE 336M KLV Data Encoding Protocol Using Key-Length-Value
23 * SMPTE 377M MXF File Format Specifications
24 * SMPTE 378M Operational Pattern 1a
25 * SMPTE 379M MXF Generic Container
26 * SMPTE 381M Mapping MPEG Streams into the MXF Generic Container
27 * SMPTE 382M Mapping AES3 and Broadcast Wave Audio into the MXF Generic Container
28 * SMPTE 383M Mapping DV-DIF Data to the MXF Generic Container
31 * Search for Track numbers which will identify essence element KLV packets.
32 * Search for SourcePackage which define tracks which contains Track numbers.
33 * Material Package contains tracks with reference to SourcePackage tracks.
34 * Search for Descriptors (Picture, Sound) which contains codec info and parameters.
35 * Assign Descriptors to correct Tracks.
37 * Metadata reading functions read Local Tags, get InstanceUID(0x3C0A) then add MetaDataSet to MXFContext.
38 * Metadata parsing resolves Strong References to objects.
40 * Simple demuxer, only OP1A supported and some files might not work at all.
41 * Only tracks with associated descriptors will be decoded. "Highly Desirable" SMPTE 377M D.1
48 typedef uint8_t UID[16];
50 enum MXFMetadataSetType {
62 typedef struct MXFStructuralComponent {
64 enum MXFMetadataSetType type;
65 UID source_package_uid;
66 UID data_definition_ul;
68 int64_t start_position;
70 } MXFStructuralComponent;
72 typedef struct MXFSequence {
74 enum MXFMetadataSetType type;
75 UID data_definition_ul;
76 UID *structural_components_refs;
77 int structural_components_count;
81 typedef struct MXFTrack {
83 enum MXFMetadataSetType type;
84 MXFSequence *sequence; /* mandatory, and only one */
87 uint8_t track_number[4];
91 typedef struct MXFDescriptor {
93 enum MXFMetadataSetType type;
94 UID essence_container_ul;
96 AVRational sample_rate;
97 AVRational aspect_ratio;
102 UID *sub_descriptors_refs;
103 int sub_descriptors_count;
109 typedef struct MXFPackage {
111 enum MXFMetadataSetType type;
115 MXFDescriptor *descriptor; /* only one */
119 typedef struct MXFEssenceContainerData {
121 enum MXFMetadataSetType type;
122 UID linked_package_uid;
123 } MXFEssenceContainerData;
127 enum MXFMetadataSetType type;
130 typedef struct MXFContext {
133 UID *essence_container_data_sets_refs;
134 int essence_container_data_sets_count;
135 UID *essence_containers_uls; /* Universal Labels SMPTE RP224 */
136 int essence_containers_uls_count;
137 UID operational_pattern_ul;
138 UID content_storage_uid;
139 MXFMetadataSet **metadata_sets;
140 int metadata_sets_count;
144 typedef struct KLVPacket {
150 enum MXFWrappingScheme {
155 typedef struct MXFCodecUL {
158 enum MXFWrappingScheme wrapping;
161 typedef struct MXFDataDefinitionUL {
164 } MXFDataDefinitionUL;
166 typedef struct MXFMetadataReadTableEntry {
168 int (*read)(MXFContext *mxf, KLVPacket *klv);
169 } MXFMetadataReadTableEntry;
171 /* partial keys to match */
172 static const uint8_t mxf_header_partition_pack_key[] = { 0x06,0x0e,0x2b,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x02 };
173 static const uint8_t mxf_essence_element_key[] = { 0x06,0x0e,0x2b,0x34,0x01,0x02,0x01,0x01,0x0d,0x01,0x03,0x01 };
175 #define IS_KLV_KEY(x, y) (!memcmp(x, y, sizeof(y)))
177 #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, \
178 (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])
180 static int64_t klv_decode_ber_length(ByteIOContext *pb)
183 uint8_t length = get_byte(pb);
184 int type = length >> 7;
186 if (type) { /* long form */
187 int bytes_num = length & 0x7f;
188 /* SMPTE 379M 5.3.4 guarantee that bytes_num must not exceed 8 bytes */
192 size = size << 8 | get_byte(pb);
194 size = length & 0x7f;
199 static int klv_read_packet(KLVPacket *klv, ByteIOContext *pb)
201 klv->offset = url_ftell(pb);
202 get_buffer(pb, klv->key, 16);
203 klv->length = klv_decode_ber_length(pb);
204 return klv->length == -1 ? -1 : 0;
207 static int mxf_get_stream_index(AVFormatContext *s, KLVPacket *klv)
211 for (i = 0; i < s->nb_streams; i++) {
212 MXFTrack *track = s->streams[i]->priv_data;
214 if (!memcmp(klv->key + sizeof(mxf_essence_element_key), track->track_number, sizeof(track->track_number)))
217 /* return 0 if only one stream, for OP Atom files with 0 as track number */
218 return s->nb_streams == 1 ? 0 : -1;
221 static int mxf_read_packet(AVFormatContext *s, AVPacket *pkt)
225 while (!url_feof(&s->pb)) {
226 if (klv_read_packet(&klv, &s->pb) < 0) {
227 av_log(s, AV_LOG_ERROR, "error reading KLV packet\n");
231 PRINT_KEY("read packet", klv.key);
233 if (IS_KLV_KEY(klv.key, mxf_essence_element_key)) {
234 av_get_packet(&s->pb, pkt, klv.length);
235 pkt->stream_index = mxf_get_stream_index(s, &klv);
236 return pkt->stream_index == -1 ? -1 : 0;
238 url_fskip(&s->pb, klv.length);
243 static int mxf_add_metadata_set(MXFContext *mxf, void *metadata_set)
245 mxf->metadata_sets = av_realloc(mxf->metadata_sets, (mxf->metadata_sets_count + 1) * sizeof(*mxf->metadata_sets));
246 mxf->metadata_sets[mxf->metadata_sets_count] = metadata_set;
247 mxf->metadata_sets_count++;
251 static int mxf_read_metadata_preface(MXFContext *mxf, KLVPacket *klv)
253 ByteIOContext *pb = &mxf->fc->pb;
256 while (bytes_read < klv->length) {
257 int tag = get_be16(pb);
258 int size = get_be16(pb); /* SMPTE 336M Table 8 KLV specified length, 0x53 */
262 get_buffer(pb, mxf->content_storage_uid, 16);
265 get_buffer(pb, mxf->operational_pattern_ul, 16);
268 mxf->essence_containers_uls_count = get_be32(pb);
269 if (mxf->essence_containers_uls_count >= UINT_MAX / sizeof(UID))
271 mxf->essence_containers_uls = av_malloc(mxf->essence_containers_uls_count * sizeof(UID));
272 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
273 get_buffer(pb, (uint8_t *)mxf->essence_containers_uls, mxf->essence_containers_uls_count * sizeof(UID));
278 bytes_read += size + 4;
283 static int mxf_read_metadata_content_storage(MXFContext *mxf, KLVPacket *klv)
285 ByteIOContext *pb = &mxf->fc->pb;
288 while (bytes_read < klv->length) {
289 int tag = get_be16(pb);
290 int size = get_be16(pb); /* SMPTE 336M Table 8 KLV specified length, 0x53 */
292 dprintf("tag 0x%04X, size %d\n", tag, size);
295 mxf->packages_count = get_be32(pb);
296 if (mxf->packages_count >= UINT_MAX / sizeof(UID))
298 mxf->packages_refs = av_malloc(mxf->packages_count * sizeof(UID));
299 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
300 get_buffer(pb, (uint8_t *)mxf->packages_refs, mxf->packages_count * sizeof(UID));
303 mxf->essence_container_data_sets_count = get_be32(pb);
304 if (mxf->essence_container_data_sets_count >= UINT_MAX / sizeof(UID))
306 mxf->essence_container_data_sets_refs = av_malloc(mxf->essence_container_data_sets_count * sizeof(UID));
307 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
308 get_buffer(pb, (uint8_t *)mxf->essence_container_data_sets_refs, mxf->essence_container_data_sets_count * sizeof(UID));
313 bytes_read += size + 4;
318 static int mxf_read_metadata_source_clip(MXFContext *mxf, KLVPacket *klv)
320 ByteIOContext *pb = &mxf->fc->pb;
321 MXFStructuralComponent *source_clip = av_mallocz(sizeof(*source_clip));
324 while (bytes_read < klv->length) {
325 int tag = get_be16(pb);
326 int size = get_be16(pb); /* SMPTE 336M Table 8 KLV specified length, 0x53 */
328 bytes_read += size + 4;
329 dprintf("tag 0x%04X, size %d\n", tag, size);
330 if (!size) /* ignore empty tag, needed for some files with empty UMID tag */
334 get_buffer(pb, source_clip->uid, 16);
337 source_clip->duration = get_be64(pb);
340 source_clip->start_position = get_be64(pb);
343 /* UMID, only get last 16 bytes */
345 get_buffer(pb, source_clip->source_package_uid, 16);
348 source_clip->source_track_id = get_be32(pb);
354 source_clip->type = SourceClip;
355 return mxf_add_metadata_set(mxf, source_clip);
358 static int mxf_read_metadata_material_package(MXFContext *mxf, KLVPacket *klv)
360 ByteIOContext *pb = &mxf->fc->pb;
361 MXFPackage *package = av_mallocz(sizeof(*package));
364 while (bytes_read < klv->length) {
365 int tag = get_be16(pb);
366 int size = get_be16(pb); /* KLV specified by 0x53 */
370 get_buffer(pb, package->uid, 16);
373 package->tracks_count = get_be32(pb);
374 if (package->tracks_count >= UINT_MAX / sizeof(UID))
376 package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
377 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
378 get_buffer(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
383 bytes_read += size + 4;
385 package->type = MaterialPackage;
386 return mxf_add_metadata_set(mxf, package);
389 static int mxf_read_metadata_track(MXFContext *mxf, KLVPacket *klv)
391 ByteIOContext *pb = &mxf->fc->pb;
392 MXFTrack *track = av_mallocz(sizeof(*track));
395 while (bytes_read < klv->length) {
396 int tag = get_be16(pb);
397 int size = get_be16(pb); /* KLV specified by 0x53 */
399 dprintf("tag 0x%04X, size %d\n", tag, size);
402 get_buffer(pb, track->uid, 16);
405 track->track_id = get_be32(pb);
408 get_buffer(pb, track->track_number, 4);
411 track->edit_rate.den = get_be32(pb);
412 track->edit_rate.num = get_be32(pb);
415 get_buffer(pb, track->sequence_ref, 16);
420 bytes_read += size + 4;
423 return mxf_add_metadata_set(mxf, track);
426 static int mxf_read_metadata_sequence(MXFContext *mxf, KLVPacket *klv)
428 ByteIOContext *pb = &mxf->fc->pb;
429 MXFSequence *sequence = av_mallocz(sizeof(*sequence));
432 while (bytes_read < klv->length) {
433 int tag = get_be16(pb);
434 int size = get_be16(pb); /* KLV specified by 0x53 */
436 dprintf("tag 0x%04X, size %d\n", tag, size);
439 get_buffer(pb, sequence->uid, 16);
442 sequence->duration = get_be64(pb);
445 get_buffer(pb, sequence->data_definition_ul, 16);
448 sequence->structural_components_count = get_be32(pb);
449 if (sequence->structural_components_count >= UINT_MAX / sizeof(UID))
451 sequence->structural_components_refs = av_malloc(sequence->structural_components_count * sizeof(UID));
452 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
453 get_buffer(pb, (uint8_t *)sequence->structural_components_refs, sequence->structural_components_count * sizeof(UID));
458 bytes_read += size + 4;
460 sequence->type = Sequence;
461 return mxf_add_metadata_set(mxf, sequence);
464 static int mxf_read_metadata_source_package(MXFContext *mxf, KLVPacket *klv)
466 ByteIOContext *pb = &mxf->fc->pb;
467 MXFPackage *package = av_mallocz(sizeof(*package));
470 while (bytes_read < klv->length) {
471 int tag = get_be16(pb);
472 int size = get_be16(pb); /* KLV specified by 0x53 */
474 dprintf("tag 0x%04X, size %d\n", tag, size);
477 get_buffer(pb, package->uid, 16);
480 package->tracks_count = get_be32(pb);
481 if (package->tracks_count >= UINT_MAX / sizeof(UID))
483 package->tracks_refs = av_malloc(package->tracks_count * sizeof(UID));
484 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
485 get_buffer(pb, (uint8_t *)package->tracks_refs, package->tracks_count * sizeof(UID));
488 /* UMID, only get last 16 bytes */
490 get_buffer(pb, package->package_uid, 16);
493 get_buffer(pb, package->descriptor_ref, 16);
498 bytes_read += size + 4;
500 package->type = SourcePackage;
501 return mxf_add_metadata_set(mxf, package);
504 static int mxf_read_metadata_multiple_descriptor(MXFContext *mxf, KLVPacket *klv)
506 ByteIOContext *pb = &mxf->fc->pb;
507 MXFDescriptor *descriptor = av_mallocz(sizeof(*descriptor));
510 while (bytes_read < klv->length) {
511 int tag = get_be16(pb);
512 int size = get_be16(pb); /* KLV specified by 0x53 */
514 dprintf("tag 0x%04X, size %d\n", tag, size);
517 get_buffer(pb, descriptor->uid, 16);
520 descriptor->sub_descriptors_count = get_be32(pb);
521 if (descriptor->sub_descriptors_count >= UINT_MAX / sizeof(UID))
523 descriptor->sub_descriptors_refs = av_malloc(descriptor->sub_descriptors_count * sizeof(UID));
524 url_fskip(pb, 4); /* useless size of objects, always 16 according to specs */
525 get_buffer(pb, (uint8_t *)descriptor->sub_descriptors_refs, descriptor->sub_descriptors_count * sizeof(UID));
530 bytes_read += size + 4;
532 descriptor->type = MultipleDescriptor;
533 return mxf_add_metadata_set(mxf, descriptor);
536 static void mxf_read_metadata_pixel_layout(ByteIOContext *pb, MXFDescriptor *descriptor)
542 dprintf("pixel layout: code 0x%x\n", code);
545 descriptor->bits_per_sample += get_byte(pb);
548 descriptor->bits_per_sample += get_byte(pb);
551 descriptor->bits_per_sample += get_byte(pb);
556 } while (code != 0); /* SMPTE 377M E.2.46 */
559 static int mxf_read_metadata_generic_descriptor(MXFContext *mxf, KLVPacket *klv)
561 ByteIOContext *pb = &mxf->fc->pb;
562 MXFDescriptor *descriptor = av_mallocz(sizeof(*descriptor));
565 while (bytes_read < klv->length) {
566 int tag = get_be16(pb);
567 int size = get_be16(pb); /* KLV specified by 0x53 */
569 dprintf("tag 0x%04X, size %d\n", tag, size);
572 get_buffer(pb, descriptor->uid, 16);
575 get_buffer(pb, descriptor->essence_container_ul, 16);
578 descriptor->linked_track_id = get_be32(pb);
580 case 0x3201: /* PictureEssenceCoding */
581 get_buffer(pb, descriptor->essence_codec_ul, 16);
584 descriptor->width = get_be32(pb);
587 descriptor->height = get_be32(pb);
590 descriptor->aspect_ratio.num = get_be32(pb);
591 descriptor->aspect_ratio.den = get_be32(pb);
594 descriptor->sample_rate.num = get_be32(pb);
595 descriptor->sample_rate.den = get_be32(pb);
597 case 0x3D06: /* SoundEssenceCompression */
598 get_buffer(pb, descriptor->essence_codec_ul, 16);
601 descriptor->channels = get_be32(pb);
604 descriptor->bits_per_sample = get_be32(pb);
607 mxf_read_metadata_pixel_layout(pb, descriptor);
609 case 0x8201: /* Private tag used by SONY C0023S01.mxf */
610 descriptor->extradata = av_malloc(size);
611 descriptor->extradata_size = size;
612 get_buffer(pb, descriptor->extradata, size);
617 bytes_read += size + 4;
619 descriptor->type = Descriptor;
620 return mxf_add_metadata_set(mxf, descriptor);
623 /* SMPTE RP224 http://www.smpte-ra.org/mdd/index.html */
624 static const MXFDataDefinitionUL mxf_data_definition_uls[] = {
625 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x01,0x00,0x00,0x00 }, CODEC_TYPE_VIDEO },
626 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x02,0x00,0x00,0x00 }, CODEC_TYPE_AUDIO },
627 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x05,0x01,0x03,0x02,0x02,0x02,0x02,0x00,0x00 }, CODEC_TYPE_AUDIO },
628 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_TYPE_DATA },
631 static const MXFCodecUL mxf_codec_uls[] = {
632 /* PictureEssenceCoding */
633 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x02,0x02,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@ML I-Frame */
634 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x04,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@HL Long GoP */
635 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x01,0x11,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MP@ML Long GoP */
636 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x02,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* 422P@ML Long GoP */
637 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x03,0x03,0x00 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MP@HL Long GoP */
638 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x03 }, CODEC_ID_MPEG4, Frame }, /* XDCAM proxy_pal030926.mxf */
639 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x04 }, CODEC_ID_MPEG4, Frame }, /* XDCAM Proxy C0023S01.mxf */
640 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x05 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 30Mbps PAL */
641 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x01 }, CODEC_ID_MPEG2VIDEO, Frame }, /* D-10 50Mbps PAL */
642 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x02,0x04,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DVCPRO50 PAL */
643 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x02,0x02,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DVCPRO25 PAL */
644 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x01,0x02,0x00 }, CODEC_ID_DVVIDEO, Frame }, /* DV25 IEC PAL */
645 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x07,0x04,0x01,0x02,0x02,0x03,0x01,0x01,0x00 }, CODEC_ID_JPEG2000, Frame }, /* JPEG2000 Codestream */
646 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x01,0x7F,0x00,0x00,0x00 }, CODEC_ID_RAWVIDEO, Frame }, /* Uncompressed */
647 /* SoundEssenceCompression */
648 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x00,0x00,0x00,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* Uncompressed */
649 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x7F,0x00,0x00,0x00 }, CODEC_ID_PCM_S16LE, Frame },
650 { { 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 */
651 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x01,0x01,0x00 }, CODEC_ID_PCM_ALAW, Frame },
652 { { 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 */
653 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x01,0x00 }, CODEC_ID_AC3, Frame },
654 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x05,0x00 }, CODEC_ID_MP2, Frame }, /* MP2 or MP3 */
655 //{ { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x1C,0x00 }, CODEC_ID_DOLBY_E, Frame }, /* Dolby-E */
656 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
659 static const MXFCodecUL mxf_picture_essence_container_uls[] = {
660 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x60,0x01 }, CODEC_ID_MPEG2VIDEO, Frame }, /* MPEG-ES Frame wrapped */
661 { { 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 */
662 { { 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 */
663 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
666 static const MXFCodecUL mxf_sound_essence_container_uls[] = {
667 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x01,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* BWF Frame wrapped */
668 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x03,0x00 }, CODEC_ID_PCM_S16LE, Frame }, /* AES Frame wrapped */
669 { { 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 */
670 { { 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 */
671 { { 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 */
672 //{ { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x05,0x01 }, CODEC_ID_PCM_AES3, Frame }, /* D-10 Mapping 30Mbps PAL Extended Template */
673 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_ID_NONE, Frame },
676 static const MXFCodecUL *mxf_get_codec_ul(const MXFCodecUL *uls, UID *uid)
678 while (uls->id != CODEC_ID_NONE) {
679 if(!memcmp(uls->uid, *uid, 16))
686 static enum CodecType mxf_get_codec_type(const MXFDataDefinitionUL *uls, UID *uid)
688 while (uls->type != CODEC_TYPE_DATA) {
689 if(!memcmp(uls->uid, *uid, 16))
696 static void *mxf_resolve_strong_ref(MXFContext *mxf, UID *strong_ref)
702 for (i = 0; i < mxf->metadata_sets_count; i++) {
703 if (!memcmp(*strong_ref, mxf->metadata_sets[i]->uid, 16)) {
704 return mxf->metadata_sets[i];
710 static int mxf_parse_structural_metadata(MXFContext *mxf)
712 MXFPackage *material_package = NULL;
713 MXFPackage *source_package = NULL;
714 MXFPackage *temp_package = NULL;
717 dprintf("metadata sets count %d\n", mxf->metadata_sets_count);
718 /* TODO: handle multiple material packages (OP3x) */
719 for (i = 0; i < mxf->packages_count; i++) {
720 if (!(temp_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[i]))) {
721 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve package strong ref\n");
724 if (temp_package->type == MaterialPackage) {
725 material_package = temp_package;
729 if (!material_package) {
730 av_log(mxf->fc, AV_LOG_ERROR, "no material package found\n");
734 for (i = 0; i < material_package->tracks_count; i++) {
735 MXFTrack *material_track = NULL;
736 MXFTrack *source_track = NULL;
737 MXFTrack *temp_track = NULL;
738 MXFDescriptor *descriptor = NULL;
739 MXFStructuralComponent *component = NULL;
740 const MXFCodecUL *codec_ul = NULL;
741 const MXFCodecUL *container_ul = NULL;
744 if (!(material_track = mxf_resolve_strong_ref(mxf, &material_package->tracks_refs[i]))) {
745 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track strong ref\n");
749 if (!(material_track->sequence = mxf_resolve_strong_ref(mxf, &material_track->sequence_ref))) {
750 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve material track sequence strong ref\n");
754 /* TODO: handle multiple source clips */
755 for (j = 0; j < material_track->sequence->structural_components_count; j++) {
756 /* TODO: handle timecode component */
757 component = mxf_resolve_strong_ref(mxf, &material_track->sequence->structural_components_refs[j]);
758 if (!component || component->type != SourceClip)
761 for (k = 0; k < mxf->packages_count; k++) {
762 if (!(temp_package = mxf_resolve_strong_ref(mxf, &mxf->packages_refs[k]))) {
763 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track strong ref\n");
766 if (!memcmp(temp_package->package_uid, component->source_package_uid, 16)) {
767 source_package = temp_package;
771 if (!source_package) {
772 av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source package found\n", material_track->track_id);
775 for (k = 0; k < source_package->tracks_count; k++) {
776 if (!(temp_track = mxf_resolve_strong_ref(mxf, &source_package->tracks_refs[k]))) {
777 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track strong ref\n");
780 if (temp_track->track_id == component->source_track_id) {
781 source_track = temp_track;
786 av_log(mxf->fc, AV_LOG_ERROR, "material track %d: no corresponding source track found\n", material_track->track_id);
793 st = av_new_stream(mxf->fc, source_track->track_id);
794 st->priv_data = source_track;
795 st->duration = component->duration;
796 if (st->duration == -1)
797 st->duration = AV_NOPTS_VALUE;
798 st->start_time = component->start_position;
799 av_set_pts_info(st, 64, material_track->edit_rate.num, material_track->edit_rate.den);
801 if (!(source_track->sequence = mxf_resolve_strong_ref(mxf, &source_track->sequence_ref))) {
802 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve source track sequence strong ref\n");
807 PRINT_KEY("data definition ul", source_track->sequence->data_definition_ul);
809 st->codec->codec_type = mxf_get_codec_type(mxf_data_definition_uls, &source_track->sequence->data_definition_ul);
811 source_package->descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor_ref);
812 if (source_package->descriptor) {
813 if (source_package->descriptor->type == MultipleDescriptor) {
814 for (j = 0; j < source_package->descriptor->sub_descriptors_count; j++) {
815 MXFDescriptor *sub_descriptor = mxf_resolve_strong_ref(mxf, &source_package->descriptor->sub_descriptors_refs[j]);
817 if (!sub_descriptor) {
818 av_log(mxf->fc, AV_LOG_ERROR, "could not resolve sub descriptor strong ref\n");
821 if (sub_descriptor->linked_track_id == source_track->track_id) {
822 descriptor = sub_descriptor;
827 descriptor = source_package->descriptor;
830 av_log(mxf->fc, AV_LOG_INFO, "source track %d: stream %d, no descriptor found\n", source_track->track_id, st->index);
834 PRINT_KEY("essence codec ul", descriptor->essence_codec_ul);
835 PRINT_KEY("essence container ul", descriptor->essence_container_ul);
837 /* TODO: drop PictureEssenceCoding and SoundEssenceCompression, only check EssenceContainer */
838 codec_ul = mxf_get_codec_ul(mxf_codec_uls, &descriptor->essence_codec_ul);
839 st->codec->codec_id = codec_ul->id;
840 if (descriptor->extradata) {
841 st->codec->extradata = descriptor->extradata;
842 st->codec->extradata_size = descriptor->extradata_size;
844 if (st->codec->codec_type == CODEC_TYPE_VIDEO) {
845 container_ul = mxf_get_codec_ul(mxf_picture_essence_container_uls, &descriptor->essence_container_ul);
846 if (st->codec->codec_id == CODEC_ID_NONE)
847 st->codec->codec_id = container_ul->id;
848 st->codec->width = descriptor->width;
849 st->codec->height = descriptor->height;
850 st->codec->bits_per_sample = descriptor->bits_per_sample; /* Uncompressed */
851 } else if (st->codec->codec_type == CODEC_TYPE_AUDIO) {
852 container_ul = mxf_get_codec_ul(mxf_sound_essence_container_uls, &descriptor->essence_container_ul);
853 if (st->codec->codec_id == CODEC_ID_NONE)
854 st->codec->codec_id = container_ul->id;
855 st->codec->channels = descriptor->channels;
856 st->codec->bits_per_sample = descriptor->bits_per_sample;
857 st->codec->sample_rate = descriptor->sample_rate.num / descriptor->sample_rate.den;
858 /* TODO: implement CODEC_ID_RAWAUDIO */
859 if (st->codec->codec_id == CODEC_ID_PCM_S16LE) {
860 if (descriptor->bits_per_sample == 24)
861 st->codec->codec_id = CODEC_ID_PCM_S24LE;
862 else if (descriptor->bits_per_sample == 32)
863 st->codec->codec_id = CODEC_ID_PCM_S32LE;
864 } else if (st->codec->codec_id == CODEC_ID_PCM_S16BE) {
865 if (descriptor->bits_per_sample == 24)
866 st->codec->codec_id = CODEC_ID_PCM_S24BE;
867 else if (descriptor->bits_per_sample == 32)
868 st->codec->codec_id = CODEC_ID_PCM_S32BE;
869 } else if (st->codec->codec_id == CODEC_ID_MP2) {
870 st->need_parsing = 1;
873 if (container_ul && container_ul->wrapping == Clip) {
874 dprintf("stream %d: clip wrapped essence\n", st->index);
875 st->need_parsing = 1;
881 static const MXFMetadataReadTableEntry mxf_metadata_read_table[] = {
882 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x2F,0x00 }, mxf_read_metadata_preface },
883 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x18,0x00 }, mxf_read_metadata_content_storage },
884 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x37,0x00 }, mxf_read_metadata_source_package },
885 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x36,0x00 }, mxf_read_metadata_material_package },
886 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x0F,0x00 }, mxf_read_metadata_sequence },
887 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x11,0x00 }, mxf_read_metadata_source_clip },
888 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x44,0x00 }, mxf_read_metadata_multiple_descriptor },
889 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x42,0x00 }, mxf_read_metadata_generic_descriptor }, /* Generic Sound */
890 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x28,0x00 }, mxf_read_metadata_generic_descriptor }, /* CDCI */
891 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x29,0x00 }, mxf_read_metadata_generic_descriptor }, /* RGBA */
892 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x51,0x00 }, mxf_read_metadata_generic_descriptor }, /* MPEG 2 Video */
893 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x48,0x00 }, mxf_read_metadata_generic_descriptor }, /* Wave */
894 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x47,0x00 }, mxf_read_metadata_generic_descriptor }, /* AES3 */
895 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3A,0x00 }, mxf_read_metadata_track }, /* Static Track */
896 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3B,0x00 }, mxf_read_metadata_track }, /* Generic Track */
897 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, NULL },
900 static int mxf_read_header(AVFormatContext *s, AVFormatParameters *ap)
902 MXFContext *mxf = s->priv_data;
906 while (!url_feof(&s->pb)) {
907 const MXFMetadataReadTableEntry *function;
909 if (klv_read_packet(&klv, &s->pb) < 0) {
910 av_log(s, AV_LOG_ERROR, "error reading KLV packet\n");
914 PRINT_KEY("read header", klv.key);
916 if (IS_KLV_KEY(klv.key, mxf_essence_element_key)) {
917 /* FIXME avoid seek */
918 url_fseek(&s->pb, klv.offset, SEEK_SET);
922 for (function = mxf_metadata_read_table; function->read; function++) {
923 if (IS_KLV_KEY(klv.key, function->key)) {
924 if (function->read(mxf, &klv) < 0) {
925 av_log(s, AV_LOG_ERROR, "error reading header metadata\n");
932 url_fskip(&s->pb, klv.length);
934 return mxf_parse_structural_metadata(mxf);
937 static int mxf_read_close(AVFormatContext *s)
939 MXFContext *mxf = s->priv_data;
942 av_freep(&mxf->packages_refs);
943 av_freep(&mxf->essence_container_data_sets_refs);
944 av_freep(&mxf->essence_containers_uls);
945 for (i = 0; i < mxf->metadata_sets_count; i++) {
946 switch (mxf->metadata_sets[i]->type) {
947 case MultipleDescriptor:
948 av_freep(&((MXFDescriptor *)mxf->metadata_sets[i])->sub_descriptors_refs);
951 av_freep(&((MXFSequence *)mxf->metadata_sets[i])->structural_components_refs);
954 case MaterialPackage:
955 av_freep(&((MXFPackage *)mxf->metadata_sets[i])->tracks_refs);
960 av_freep(&mxf->metadata_sets[i]);
962 av_freep(&mxf->metadata_sets);
966 static int mxf_probe(AVProbeData *p) {
967 uint8_t *bufp = p->buf;
968 uint8_t *end = p->buf + p->buf_size;
970 if (p->buf_size < sizeof(mxf_header_partition_pack_key))
973 /* Must skip Run-In Sequence and search for MXF header partition pack key SMPTE 377M 5.5 */
974 end -= sizeof(mxf_header_partition_pack_key);
975 for (; bufp < end; bufp++) {
976 if (IS_KLV_KEY(bufp, mxf_header_partition_pack_key))
977 return AVPROBE_SCORE_MAX;
982 /* rudimentary binary seek */
983 /* XXX: use MXF Index */
984 static int mxf_read_seek(AVFormatContext *s, int stream_index, int64_t sample_time, int flags)
986 AVStream *st = s->streams[stream_index];
987 offset_t pos = url_ftell(&s->pb);
991 if (!s->bit_rate || sample_time < 0)
993 seconds = av_rescale(sample_time, st->time_base.num, st->time_base.den);
994 url_fseek(&s->pb, (s->bit_rate * seconds) >> 3, SEEK_SET);
995 /* sync on KLV essence element */
996 for (i = 0; i < 12 && url_ftell(&s->pb) < s->file_size; i++) {
997 int b = get_byte(&s->pb);
998 if (b == mxf_essence_element_key[0])
1000 else if (b != mxf_essence_element_key[i])
1003 if (i == 12) { /* found KLV key */
1004 url_fseek(&s->pb, -12, SEEK_CUR);
1005 av_update_cur_dts(s, st, sample_time);
1008 url_fseek(&s->pb, pos, SEEK_SET);
1012 AVInputFormat mxf_demuxer = {