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
48 #include "libavutil/aes.h"
49 #include "libavcodec/bytestream.h"
52 typedef uint8_t UID
[16];
54 enum MXFMetadataSetType
{
69 enum MXFMetadataSetType type
;
70 UID source_container_ul
;
75 enum MXFMetadataSetType type
;
76 UID source_package_uid
;
77 UID data_definition_ul
;
79 int64_t start_position
;
81 } MXFStructuralComponent
;
85 enum MXFMetadataSetType type
;
86 UID data_definition_ul
;
87 UID
*structural_components_refs
;
88 int structural_components_count
;
94 enum MXFMetadataSetType type
;
95 MXFSequence
*sequence
; /* mandatory, and only one */
98 uint8_t track_number
[4];
104 enum MXFMetadataSetType type
;
105 UID essence_container_ul
;
106 UID essence_codec_ul
;
107 AVRational sample_rate
;
108 AVRational aspect_ratio
;
113 UID
*sub_descriptors_refs
;
114 int sub_descriptors_count
;
122 enum MXFMetadataSetType type
;
126 MXFDescriptor
*descriptor
; /* only one */
132 enum MXFMetadataSetType type
;
138 MXFMetadataSet
**metadata_sets
;
139 int metadata_sets_count
;
143 int local_tags_count
;
152 enum MXFWrappingScheme
{
159 unsigned matching_len
;
166 } MXFDataDefinitionUL
;
172 enum MXFMetadataSetType type
;
173 } MXFMetadataReadTableEntry
;
175 /* partial keys to match */
176 static const uint8_t mxf_header_partition_pack_key
[] = { 0x06,0x0e,0x2b,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x02 };
177 static const uint8_t mxf_essence_element_key
[] = { 0x06,0x0e,0x2b,0x34,0x01,0x02,0x01,0x01,0x0d,0x01,0x03,0x01 };
178 static const uint8_t mxf_klv_key
[] = { 0x06,0x0e,0x2b,0x34 };
179 /* complete keys to match */
180 static const uint8_t mxf_crypto_source_container_ul
[] = { 0x06,0x0e,0x2b,0x34,0x01,0x01,0x01,0x09,0x06,0x01,0x01,0x02,0x02,0x00,0x00,0x00 };
181 static const uint8_t mxf_encrypted_triplet_key
[] = { 0x06,0x0e,0x2b,0x34,0x02,0x04,0x01,0x07,0x0d,0x01,0x03,0x01,0x02,0x7e,0x01,0x00 };
182 static const uint8_t mxf_encrypted_essence_container
[] = { 0x06,0x0e,0x2b,0x34,0x04,0x01,0x01,0x07,0x0d,0x01,0x03,0x01,0x02,0x0b,0x01,0x00 };
183 static const uint8_t mxf_sony_mpeg4_extradata
[] = { 0x06,0x0e,0x2b,0x34,0x04,0x01,0x01,0x01,0x0e,0x06,0x06,0x02,0x02,0x01,0x00,0x00 };
185 #define IS_KLV_KEY(x, y) (!memcmp(x, y, sizeof(y)))
187 #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, \
188 (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])
190 static int64_t klv_decode_ber_length(ByteIOContext
*pb
)
192 uint64_t size
= get_byte(pb
);
193 if (size
& 0x80) { /* long form */
194 int bytes_num
= size
& 0x7f;
195 /* SMPTE 379M 5.3.4 guarantee that bytes_num must not exceed 8 bytes */
200 size
= size
<< 8 | get_byte(pb
);
205 static int mxf_read_sync(ByteIOContext
*pb
, const uint8_t *key
, unsigned size
)
208 for (i
= 0; i
< size
&& !url_feof(pb
); i
++) {
212 else if (b
!= key
[i
])
218 static int klv_read_packet(KLVPacket
*klv
, ByteIOContext
*pb
)
220 if (!mxf_read_sync(pb
, mxf_klv_key
, 4))
222 klv
->offset
= url_ftell(pb
) - 4;
223 memcpy(klv
->key
, mxf_klv_key
, 4);
224 get_buffer(pb
, klv
->key
+ 4, 12);
225 klv
->length
= klv_decode_ber_length(pb
);
226 return klv
->length
== -1 ? -1 : 0;
229 static int mxf_get_stream_index(AVFormatContext
*s
, KLVPacket
*klv
)
233 for (i
= 0; i
< s
->nb_streams
; i
++) {
234 MXFTrack
*track
= s
->streams
[i
]->priv_data
;
236 if (!memcmp(klv
->key
+ sizeof(mxf_essence_element_key
), track
->track_number
, sizeof(track
->track_number
)))
239 /* return 0 if only one stream, for OP Atom files with 0 as track number */
240 return s
->nb_streams
== 1 ? 0 : -1;
243 /* XXX: use AVBitStreamFilter */
244 static int mxf_get_d10_aes3_packet(ByteIOContext
*pb
, AVStream
*st
, AVPacket
*pkt
, int64_t length
)
246 uint8_t buffer
[61444];
247 const uint8_t *buf_ptr
, *end_ptr
;
251 if (length
> 61444) /* worst case PAL 1920 samples 8 channels */
253 get_buffer(pb
, buffer
, length
);
254 av_new_packet(pkt
, length
);
255 data_ptr
= pkt
->data
;
256 end_ptr
= buffer
+ length
;
257 buf_ptr
= buffer
+ 4; /* skip SMPTE 331M header */
258 for (; buf_ptr
< end_ptr
; ) {
259 for (i
= 0; i
< st
->codec
->channels
; i
++) {
260 uint32_t sample
= bytestream_get_le32(&buf_ptr
);
261 if (st
->codec
->bits_per_sample
== 24)
262 bytestream_put_le24(&data_ptr
, (sample
>> 4) & 0xffffff);
264 bytestream_put_le16(&data_ptr
, (sample
>> 12) & 0xffff);
266 buf_ptr
+= 32 - st
->codec
->channels
*4; // always 8 channels stored SMPTE 331M
268 pkt
->size
= data_ptr
- pkt
->data
;
272 static int mxf_decrypt_triplet(AVFormatContext
*s
, AVPacket
*pkt
, KLVPacket
*klv
)
274 static const uint8_t checkv
[16] = {0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b, 0x43, 0x48, 0x55, 0x4b};
275 MXFContext
*mxf
= s
->priv_data
;
276 ByteIOContext
*pb
= s
->pb
;
277 offset_t end
= url_ftell(pb
) + klv
->length
;
280 uint64_t plaintext_size
;
285 if (!mxf
->aesc
&& s
->key
&& s
->keylen
== 16) {
286 mxf
->aesc
= av_malloc(av_aes_size
);
289 av_aes_init(mxf
->aesc
, s
->key
, 128, 1);
292 url_fskip(pb
, klv_decode_ber_length(pb
));
294 klv_decode_ber_length(pb
);
295 plaintext_size
= get_be64(pb
);
297 klv_decode_ber_length(pb
);
298 get_buffer(pb
, klv
->key
, 16);
299 if (!IS_KLV_KEY(klv
, mxf_essence_element_key
))
301 index
= mxf_get_stream_index(s
, klv
);
305 klv_decode_ber_length(pb
);
306 orig_size
= get_be64(pb
);
307 if (orig_size
< plaintext_size
)
310 size
= klv_decode_ber_length(pb
);
311 if (size
< 32 || size
- 32 < orig_size
)
313 get_buffer(pb
, ivec
, 16);
314 get_buffer(pb
, tmpbuf
, 16);
316 av_aes_crypt(mxf
->aesc
, tmpbuf
, tmpbuf
, 1, ivec
, 1);
317 if (memcmp(tmpbuf
, checkv
, 16))
318 av_log(s
, AV_LOG_ERROR
, "probably incorrect decryption key\n");
320 av_get_packet(pb
, pkt
, size
);
321 size
-= plaintext_size
;
323 av_aes_crypt(mxf
->aesc
, &pkt
->data
[plaintext_size
],
324 &pkt
->data
[plaintext_size
], size
>> 4, ivec
, 1);
325 pkt
->size
= orig_size
;
326 pkt
->stream_index
= index
;
327 url_fskip(pb
, end
- url_ftell(pb
));
331 static int mxf_read_packet(AVFormatContext
*s
, AVPacket
*pkt
)
335 while (!url_feof(s
->pb
)) {
336 if (klv_read_packet(&klv
, s
->pb
) < 0)
339 PRINT_KEY(s
, "read packet", klv
.key
);
341 if (IS_KLV_KEY(klv
.key
, mxf_encrypted_triplet_key
)) {
342 int res
= mxf_decrypt_triplet(s
, pkt
, &klv
);
344 av_log(s
, AV_LOG_ERROR
, "invalid encoded triplet\n");
349 if (IS_KLV_KEY(klv
.key
, mxf_essence_element_key
)) {
350 int index
= mxf_get_stream_index(s
, &klv
);
352 av_log(s
, AV_LOG_ERROR
, "error getting stream index %x\n", AV_RB32(klv
.key
+12));
355 if (s
->streams
[index
]->discard
== AVDISCARD_ALL
)
357 /* check for 8 channels AES3 element */
358 if (klv
.key
[12] == 0x06 && klv
.key
[13] == 0x01 && klv
.key
[14] == 0x10) {
359 if (mxf_get_d10_aes3_packet(s
->pb
, s
->streams
[index
], pkt
, klv
.length
) < 0) {
360 av_log(s
, AV_LOG_ERROR
, "error reading D-10 aes3 frame\n");
364 av_get_packet(s
->pb
, pkt
, klv
.length
);
365 pkt
->stream_index
= index
;
366 pkt
->pos
= klv
.offset
;
370 url_fskip(s
->pb
, klv
.length
);
375 static int mxf_read_primer_pack(MXFContext
*mxf
)
377 ByteIOContext
*pb
= mxf
->fc
->pb
;
378 int item_num
= get_be32(pb
);
379 int item_len
= get_be32(pb
);
381 if (item_len
!= 18) {
382 av_log(mxf
->fc
, AV_LOG_ERROR
, "unsupported primer pack item length\n");
385 if (item_num
> UINT_MAX
/ item_len
)
387 mxf
->local_tags_count
= item_num
;
388 mxf
->local_tags
= av_malloc(item_num
*item_len
);
389 if (!mxf
->local_tags
)
391 get_buffer(pb
, mxf
->local_tags
, item_num
*item_len
);
395 static int mxf_add_metadata_set(MXFContext
*mxf
, void *metadata_set
)
397 mxf
->metadata_sets
= av_realloc(mxf
->metadata_sets
, (mxf
->metadata_sets_count
+ 1) * sizeof(*mxf
->metadata_sets
));
398 if (!mxf
->metadata_sets
)
400 mxf
->metadata_sets
[mxf
->metadata_sets_count
] = metadata_set
;
401 mxf
->metadata_sets_count
++;
405 static int mxf_read_cryptographic_context(MXFCryptoContext
*cryptocontext
, ByteIOContext
*pb
, int tag
, int size
, UID uid
)
409 if (IS_KLV_KEY(uid
, mxf_crypto_source_container_ul
))
410 get_buffer(pb
, cryptocontext
->source_container_ul
, 16);
414 static int mxf_read_content_storage(MXFContext
*mxf
, ByteIOContext
*pb
, int tag
)
418 mxf
->packages_count
= get_be32(pb
);
419 if (mxf
->packages_count
>= UINT_MAX
/ sizeof(UID
))
421 mxf
->packages_refs
= av_malloc(mxf
->packages_count
* sizeof(UID
));
422 if (!mxf
->packages_refs
)
424 url_fskip(pb
, 4); /* useless size of objects, always 16 according to specs */
425 get_buffer(pb
, (uint8_t *)mxf
->packages_refs
, mxf
->packages_count
* sizeof(UID
));
431 static int mxf_read_source_clip(MXFStructuralComponent
*source_clip
, ByteIOContext
*pb
, int tag
)
435 source_clip
->duration
= get_be64(pb
);
438 source_clip
->start_position
= get_be64(pb
);
441 /* UMID, only get last 16 bytes */
443 get_buffer(pb
, source_clip
->source_package_uid
, 16);
446 source_clip
->source_track_id
= get_be32(pb
);
452 static int mxf_read_material_package(MXFPackage
*package
, ByteIOContext
*pb
, int tag
)
456 package
->tracks_count
= get_be32(pb
);
457 if (package
->tracks_count
>= UINT_MAX
/ sizeof(UID
))
459 package
->tracks_refs
= av_malloc(package
->tracks_count
* sizeof(UID
));
460 if (!package
->tracks_refs
)
462 url_fskip(pb
, 4); /* useless size of objects, always 16 according to specs */
463 get_buffer(pb
, (uint8_t *)package
->tracks_refs
, package
->tracks_count
* sizeof(UID
));
469 static int mxf_read_track(MXFTrack
*track
, ByteIOContext
*pb
, int tag
)
473 track
->track_id
= get_be32(pb
);
476 get_buffer(pb
, track
->track_number
, 4);
479 track
->edit_rate
.den
= get_be32(pb
);
480 track
->edit_rate
.num
= get_be32(pb
);
483 get_buffer(pb
, track
->sequence_ref
, 16);
489 static int mxf_read_sequence(MXFSequence
*sequence
, ByteIOContext
*pb
, int tag
)
493 sequence
->duration
= get_be64(pb
);
496 get_buffer(pb
, sequence
->data_definition_ul
, 16);
499 sequence
->structural_components_count
= get_be32(pb
);
500 if (sequence
->structural_components_count
>= UINT_MAX
/ sizeof(UID
))
502 sequence
->structural_components_refs
= av_malloc(sequence
->structural_components_count
* sizeof(UID
));
503 if (!sequence
->structural_components_refs
)
505 url_fskip(pb
, 4); /* useless size of objects, always 16 according to specs */
506 get_buffer(pb
, (uint8_t *)sequence
->structural_components_refs
, sequence
->structural_components_count
* sizeof(UID
));
512 static int mxf_read_source_package(MXFPackage
*package
, ByteIOContext
*pb
, int tag
)
516 package
->tracks_count
= get_be32(pb
);
517 if (package
->tracks_count
>= UINT_MAX
/ sizeof(UID
))
519 package
->tracks_refs
= av_malloc(package
->tracks_count
* sizeof(UID
));
520 if (!package
->tracks_refs
)
522 url_fskip(pb
, 4); /* useless size of objects, always 16 according to specs */
523 get_buffer(pb
, (uint8_t *)package
->tracks_refs
, package
->tracks_count
* sizeof(UID
));
526 /* UMID, only get last 16 bytes */
528 get_buffer(pb
, package
->package_uid
, 16);
531 get_buffer(pb
, package
->descriptor_ref
, 16);
537 static void mxf_read_pixel_layout(ByteIOContext
*pb
, MXFDescriptor
*descriptor
)
543 dprintf(NULL
, "pixel layout: code 0x%x\n", code
);
546 descriptor
->bits_per_sample
+= get_byte(pb
);
549 descriptor
->bits_per_sample
+= get_byte(pb
);
552 descriptor
->bits_per_sample
+= get_byte(pb
);
557 } while (code
!= 0); /* SMPTE 377M E.2.46 */
560 static int mxf_read_generic_descriptor(MXFDescriptor
*descriptor
, ByteIOContext
*pb
, int tag
, int size
, UID uid
)
564 descriptor
->sub_descriptors_count
= get_be32(pb
);
565 if (descriptor
->sub_descriptors_count
>= UINT_MAX
/ sizeof(UID
))
567 descriptor
->sub_descriptors_refs
= av_malloc(descriptor
->sub_descriptors_count
* sizeof(UID
));
568 if (!descriptor
->sub_descriptors_refs
)
570 url_fskip(pb
, 4); /* useless size of objects, always 16 according to specs */
571 get_buffer(pb
, (uint8_t *)descriptor
->sub_descriptors_refs
, descriptor
->sub_descriptors_count
* sizeof(UID
));
574 get_buffer(pb
, descriptor
->essence_container_ul
, 16);
577 descriptor
->linked_track_id
= get_be32(pb
);
579 case 0x3201: /* PictureEssenceCoding */
580 get_buffer(pb
, descriptor
->essence_codec_ul
, 16);
583 descriptor
->width
= get_be32(pb
);
586 descriptor
->height
= get_be32(pb
);
589 descriptor
->aspect_ratio
.num
= get_be32(pb
);
590 descriptor
->aspect_ratio
.den
= get_be32(pb
);
593 descriptor
->sample_rate
.num
= get_be32(pb
);
594 descriptor
->sample_rate
.den
= get_be32(pb
);
596 case 0x3D06: /* SoundEssenceCompression */
597 get_buffer(pb
, descriptor
->essence_codec_ul
, 16);
600 descriptor
->channels
= get_be32(pb
);
603 descriptor
->bits_per_sample
= get_be32(pb
);
606 mxf_read_pixel_layout(pb
, descriptor
);
609 /* Private uid used by SONY C0023S01.mxf */
610 if (IS_KLV_KEY(uid
, mxf_sony_mpeg4_extradata
)) {
611 descriptor
->extradata
= av_malloc(size
);
612 if (!descriptor
->extradata
)
614 descriptor
->extradata_size
= size
;
615 get_buffer(pb
, descriptor
->extradata
, size
);
622 /* SMPTE RP224 http://www.smpte-ra.org/mdd/index.html */
623 static const MXFDataDefinitionUL mxf_data_definition_uls
[] = {
624 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x01,0x00,0x00,0x00 }, CODEC_TYPE_VIDEO
},
625 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x01,0x03,0x02,0x02,0x02,0x00,0x00,0x00 }, CODEC_TYPE_AUDIO
},
626 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x05,0x01,0x03,0x02,0x02,0x02,0x02,0x00,0x00 }, CODEC_TYPE_AUDIO
},
627 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, CODEC_TYPE_DATA
},
630 static const MXFCodecUL mxf_codec_uls
[] = {
631 /* PictureEssenceCoding */
632 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x01,0x11,0x00 }, 14, CODEC_ID_MPEG2VIDEO
}, /* MP@ML Long GoP */
633 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x01,0x02,0x01,0x01 }, 14, CODEC_ID_MPEG2VIDEO
}, /* D-10 50Mbps PAL */
634 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x03,0x03,0x00 }, 14, CODEC_ID_MPEG2VIDEO
}, /* MP@HL Long GoP */
635 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x04,0x02,0x00 }, 14, CODEC_ID_MPEG2VIDEO
}, /* 422P@HL I-Frame */
636 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x03,0x04,0x01,0x02,0x02,0x01,0x20,0x02,0x03 }, 14, CODEC_ID_MPEG4
}, /* XDCAM proxy_pal030926.mxf */
637 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x02,0x02,0x01,0x02,0x00 }, 13, CODEC_ID_DVVIDEO
}, /* DV25 IEC PAL */
638 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x07,0x04,0x01,0x02,0x02,0x03,0x01,0x01,0x00 }, 14, CODEC_ID_JPEG2000
}, /* JPEG2000 Codestream */
639 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x01,0x02,0x01,0x7F,0x00,0x00,0x00 }, 13, CODEC_ID_RAWVIDEO
}, /* Uncompressed */
640 /* SoundEssenceCompression */
641 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x00,0x00,0x00,0x00 }, 13, CODEC_ID_PCM_S16LE
}, /* Uncompressed */
642 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x01,0x7F,0x00,0x00,0x00 }, 13, CODEC_ID_PCM_S16LE
},
643 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x07,0x04,0x02,0x02,0x01,0x7E,0x00,0x00,0x00 }, 13, CODEC_ID_PCM_S16BE
}, /* From Omneon MXF file */
644 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x04,0x04,0x02,0x02,0x02,0x03,0x01,0x01,0x00 }, 15, CODEC_ID_PCM_ALAW
}, /* XDCAM Proxy C0023S01.mxf */
645 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x01,0x00 }, 15, CODEC_ID_AC3
},
646 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x05,0x00 }, 15, CODEC_ID_MP2
}, /* MP2 or MP3 */
647 //{ { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x04,0x02,0x02,0x02,0x03,0x02,0x1C,0x00 }, 15, CODEC_ID_DOLBY_E }, /* Dolby-E */
648 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, 0, CODEC_ID_NONE
},
651 static const MXFCodecUL mxf_picture_essence_container_uls
[] = {
652 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x60,0x01 }, 14, CODEC_ID_MPEG2VIDEO
}, /* MPEG-ES Frame wrapped */
653 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x02,0x41,0x01 }, 14, CODEC_ID_DVVIDEO
}, /* DV 625 25mbps */
654 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, 0, CODEC_ID_NONE
},
657 static const MXFCodecUL mxf_sound_essence_container_uls
[] = {
658 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x06,0x01,0x00 }, 14, CODEC_ID_PCM_S16LE
}, /* BWF Frame wrapped */
659 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x02,0x0D,0x01,0x03,0x01,0x02,0x04,0x40,0x01 }, 14, CODEC_ID_MP2
}, /* MPEG-ES Frame wrapped, 0x40 ??? stream id */
660 { { 0x06,0x0E,0x2B,0x34,0x04,0x01,0x01,0x01,0x0D,0x01,0x03,0x01,0x02,0x01,0x01,0x01 }, 14, CODEC_ID_PCM_S16LE
}, /* D-10 Mapping 50Mbps PAL Extended Template */
661 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, 0, CODEC_ID_NONE
},
665 * Match an uid independently of the version byte and up to len common bytes
668 static int mxf_match_uid(const UID key
, const UID uid
, int len
)
671 for (i
= 0; i
< len
; i
++) {
672 if (i
!= 7 && key
[i
] != uid
[i
])
678 static const MXFCodecUL
*mxf_get_codec_ul(const MXFCodecUL
*uls
, UID
*uid
)
680 while (uls
->id
!= CODEC_ID_NONE
) {
681 if(mxf_match_uid(uls
->uid
, *uid
, uls
->matching_len
))
688 static enum CodecType
mxf_get_codec_type(const MXFDataDefinitionUL
*uls
, UID
*uid
)
690 while (uls
->type
!= CODEC_TYPE_DATA
) {
691 if(mxf_match_uid(uls
->uid
, *uid
, 16))
698 static void *mxf_resolve_strong_ref(MXFContext
*mxf
, UID
*strong_ref
, enum MXFMetadataSetType type
)
704 for (i
= 0; i
< mxf
->metadata_sets_count
; i
++) {
705 if (!memcmp(*strong_ref
, mxf
->metadata_sets
[i
]->uid
, 16) &&
706 (type
== AnyType
|| mxf
->metadata_sets
[i
]->type
== type
)) {
707 return mxf
->metadata_sets
[i
];
713 static int mxf_parse_structural_metadata(MXFContext
*mxf
)
715 MXFPackage
*material_package
= NULL
;
716 MXFPackage
*temp_package
= NULL
;
719 dprintf(mxf
->fc
, "metadata sets count %d\n", mxf
->metadata_sets_count
);
720 /* TODO: handle multiple material packages (OP3x) */
721 for (i
= 0; i
< mxf
->packages_count
; i
++) {
722 material_package
= mxf_resolve_strong_ref(mxf
, &mxf
->packages_refs
[i
], MaterialPackage
);
723 if (material_package
) break;
725 if (!material_package
) {
726 av_log(mxf
->fc
, AV_LOG_ERROR
, "no material package found\n");
730 for (i
= 0; i
< material_package
->tracks_count
; i
++) {
731 MXFPackage
*source_package
= NULL
;
732 MXFTrack
*material_track
= NULL
;
733 MXFTrack
*source_track
= NULL
;
734 MXFTrack
*temp_track
= NULL
;
735 MXFDescriptor
*descriptor
= NULL
;
736 MXFStructuralComponent
*component
= NULL
;
737 UID
*essence_container_ul
= NULL
;
738 const MXFCodecUL
*codec_ul
= NULL
;
739 const MXFCodecUL
*container_ul
= NULL
;
742 if (!(material_track
= mxf_resolve_strong_ref(mxf
, &material_package
->tracks_refs
[i
], Track
))) {
743 av_log(mxf
->fc
, AV_LOG_ERROR
, "could not resolve material track strong ref\n");
747 if (!(material_track
->sequence
= mxf_resolve_strong_ref(mxf
, &material_track
->sequence_ref
, Sequence
))) {
748 av_log(mxf
->fc
, AV_LOG_ERROR
, "could not resolve material track sequence strong ref\n");
752 /* TODO: handle multiple source clips */
753 for (j
= 0; j
< material_track
->sequence
->structural_components_count
; j
++) {
754 /* TODO: handle timecode component */
755 component
= mxf_resolve_strong_ref(mxf
, &material_track
->sequence
->structural_components_refs
[j
], SourceClip
);
759 for (k
= 0; k
< mxf
->packages_count
; k
++) {
760 temp_package
= mxf_resolve_strong_ref(mxf
, &mxf
->packages_refs
[k
], SourcePackage
);
763 if (!memcmp(temp_package
->package_uid
, component
->source_package_uid
, 16)) {
764 source_package
= temp_package
;
768 if (!source_package
) {
769 av_log(mxf
->fc
, AV_LOG_ERROR
, "material track %d: no corresponding source package found\n", material_track
->track_id
);
772 for (k
= 0; k
< source_package
->tracks_count
; k
++) {
773 if (!(temp_track
= mxf_resolve_strong_ref(mxf
, &source_package
->tracks_refs
[k
], Track
))) {
774 av_log(mxf
->fc
, AV_LOG_ERROR
, "could not resolve source track strong ref\n");
777 if (temp_track
->track_id
== component
->source_track_id
) {
778 source_track
= temp_track
;
783 av_log(mxf
->fc
, AV_LOG_ERROR
, "material track %d: no corresponding source track found\n", material_track
->track_id
);
790 st
= av_new_stream(mxf
->fc
, source_track
->track_id
);
792 av_log(mxf
->fc
, AV_LOG_ERROR
, "could not allocate stream\n");
795 st
->priv_data
= source_track
;
796 st
->duration
= component
->duration
;
797 if (st
->duration
== -1)
798 st
->duration
= AV_NOPTS_VALUE
;
799 st
->start_time
= component
->start_position
;
800 av_set_pts_info(st
, 64, material_track
->edit_rate
.num
, material_track
->edit_rate
.den
);
802 if (!(source_track
->sequence
= mxf_resolve_strong_ref(mxf
, &source_track
->sequence_ref
, Sequence
))) {
803 av_log(mxf
->fc
, AV_LOG_ERROR
, "could not resolve source track sequence strong ref\n");
808 PRINT_KEY(mxf
->fc
, "data definition ul", source_track
->sequence
->data_definition_ul
);
810 st
->codec
->codec_type
= mxf_get_codec_type(mxf_data_definition_uls
, &source_track
->sequence
->data_definition_ul
);
812 source_package
->descriptor
= mxf_resolve_strong_ref(mxf
, &source_package
->descriptor_ref
, AnyType
);
813 if (source_package
->descriptor
) {
814 if (source_package
->descriptor
->type
== MultipleDescriptor
) {
815 for (j
= 0; j
< source_package
->descriptor
->sub_descriptors_count
; j
++) {
816 MXFDescriptor
*sub_descriptor
= mxf_resolve_strong_ref(mxf
, &source_package
->descriptor
->sub_descriptors_refs
[j
], Descriptor
);
818 if (!sub_descriptor
) {
819 av_log(mxf
->fc
, AV_LOG_ERROR
, "could not resolve sub descriptor strong ref\n");
822 if (sub_descriptor
->linked_track_id
== source_track
->track_id
) {
823 descriptor
= sub_descriptor
;
827 } else if (source_package
->descriptor
->type
== Descriptor
)
828 descriptor
= source_package
->descriptor
;
831 av_log(mxf
->fc
, AV_LOG_INFO
, "source track %d: stream %d, no descriptor found\n", source_track
->track_id
, st
->index
);
835 PRINT_KEY(mxf
->fc
, "essence codec ul", descriptor
->essence_codec_ul
);
836 PRINT_KEY(mxf
->fc
, "essence container ul", descriptor
->essence_container_ul
);
838 essence_container_ul
= &descriptor
->essence_container_ul
;
839 /* HACK: replacing the original key with mxf_encrypted_essence_container
840 * is not allowed according to s429-6, try to find correct information anyway */
841 if (IS_KLV_KEY(essence_container_ul
, mxf_encrypted_essence_container
)) {
842 av_log(mxf
->fc
, AV_LOG_INFO
, "broken encrypted mxf file\n");
843 for (k
= 0; k
< mxf
->metadata_sets_count
; k
++) {
844 MXFMetadataSet
*metadata
= mxf
->metadata_sets
[k
];
845 if (metadata
->type
== CryptoContext
) {
846 essence_container_ul
= &((MXFCryptoContext
*)metadata
)->source_container_ul
;
851 /* TODO: drop PictureEssenceCoding and SoundEssenceCompression, only check EssenceContainer */
852 codec_ul
= mxf_get_codec_ul(mxf_codec_uls
, &descriptor
->essence_codec_ul
);
853 st
->codec
->codec_id
= codec_ul
->id
;
854 if (descriptor
->extradata
) {
855 st
->codec
->extradata
= descriptor
->extradata
;
856 st
->codec
->extradata_size
= descriptor
->extradata_size
;
858 if (st
->codec
->codec_type
== CODEC_TYPE_VIDEO
) {
859 container_ul
= mxf_get_codec_ul(mxf_picture_essence_container_uls
, essence_container_ul
);
860 if (st
->codec
->codec_id
== CODEC_ID_NONE
)
861 st
->codec
->codec_id
= container_ul
->id
;
862 st
->codec
->width
= descriptor
->width
;
863 st
->codec
->height
= descriptor
->height
;
864 st
->codec
->bits_per_sample
= descriptor
->bits_per_sample
; /* Uncompressed */
865 st
->need_parsing
= AVSTREAM_PARSE_HEADERS
;
866 } else if (st
->codec
->codec_type
== CODEC_TYPE_AUDIO
) {
867 container_ul
= mxf_get_codec_ul(mxf_sound_essence_container_uls
, essence_container_ul
);
868 if (st
->codec
->codec_id
== CODEC_ID_NONE
)
869 st
->codec
->codec_id
= container_ul
->id
;
870 st
->codec
->channels
= descriptor
->channels
;
871 st
->codec
->bits_per_sample
= descriptor
->bits_per_sample
;
872 st
->codec
->sample_rate
= descriptor
->sample_rate
.num
/ descriptor
->sample_rate
.den
;
873 /* TODO: implement CODEC_ID_RAWAUDIO */
874 if (st
->codec
->codec_id
== CODEC_ID_PCM_S16LE
) {
875 if (descriptor
->bits_per_sample
== 24)
876 st
->codec
->codec_id
= CODEC_ID_PCM_S24LE
;
877 else if (descriptor
->bits_per_sample
== 32)
878 st
->codec
->codec_id
= CODEC_ID_PCM_S32LE
;
879 } else if (st
->codec
->codec_id
== CODEC_ID_PCM_S16BE
) {
880 if (descriptor
->bits_per_sample
== 24)
881 st
->codec
->codec_id
= CODEC_ID_PCM_S24BE
;
882 else if (descriptor
->bits_per_sample
== 32)
883 st
->codec
->codec_id
= CODEC_ID_PCM_S32BE
;
884 } else if (st
->codec
->codec_id
== CODEC_ID_MP2
) {
885 st
->need_parsing
= AVSTREAM_PARSE_FULL
;
888 if (st
->codec
->codec_type
!= CODEC_TYPE_DATA
&& (*essence_container_ul
)[15] > 0x01) {
889 av_log(mxf
->fc
, AV_LOG_WARNING
, "only frame wrapped mappings are correctly supported\n");
890 st
->need_parsing
= AVSTREAM_PARSE_FULL
;
896 static const MXFMetadataReadTableEntry mxf_metadata_read_table
[] = {
897 { { 0x06,0x0E,0x2B,0x34,0x02,0x05,0x01,0x01,0x0d,0x01,0x02,0x01,0x01,0x05,0x01,0x00 }, mxf_read_primer_pack
},
898 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x18,0x00 }, mxf_read_content_storage
, 0, AnyType
},
899 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x37,0x00 }, mxf_read_source_package
, sizeof(MXFPackage
), SourcePackage
},
900 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x36,0x00 }, mxf_read_material_package
, sizeof(MXFPackage
), MaterialPackage
},
901 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x0F,0x00 }, mxf_read_sequence
, sizeof(MXFSequence
), Sequence
},
902 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x11,0x00 }, mxf_read_source_clip
, sizeof(MXFStructuralComponent
), SourceClip
},
903 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x44,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), MultipleDescriptor
},
904 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x42,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), Descriptor
}, /* Generic Sound */
905 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x28,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), Descriptor
}, /* CDCI */
906 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x29,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), Descriptor
}, /* RGBA */
907 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x51,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), Descriptor
}, /* MPEG 2 Video */
908 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x48,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), Descriptor
}, /* Wave */
909 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x47,0x00 }, mxf_read_generic_descriptor
, sizeof(MXFDescriptor
), Descriptor
}, /* AES3 */
910 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3A,0x00 }, mxf_read_track
, sizeof(MXFTrack
), Track
}, /* Static Track */
911 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x01,0x01,0x01,0x01,0x3B,0x00 }, mxf_read_track
, sizeof(MXFTrack
), Track
}, /* Generic Track */
912 { { 0x06,0x0E,0x2B,0x34,0x02,0x53,0x01,0x01,0x0d,0x01,0x04,0x01,0x02,0x02,0x00,0x00 }, mxf_read_cryptographic_context
, sizeof(MXFCryptoContext
), CryptoContext
},
913 { { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00 }, NULL
, 0, AnyType
},
916 static int mxf_read_local_tags(MXFContext
*mxf
, KLVPacket
*klv
, int (*read_child
)(), int ctx_size
, enum MXFMetadataSetType type
)
918 ByteIOContext
*pb
= mxf
->fc
->pb
;
919 MXFMetadataSet
*ctx
= ctx_size
? av_mallocz(ctx_size
) : mxf
;
920 uint64_t klv_end
= url_ftell(pb
) + klv
->length
;
924 while (url_ftell(pb
) + 4 < klv_end
) {
925 int tag
= get_be16(pb
);
926 int size
= get_be16(pb
); /* KLV specified by 0x53 */
927 uint64_t next
= url_ftell(pb
) + size
;
930 if (!size
) { /* ignore empty tag, needed for some files with empty UMID tag */
931 av_log(mxf
->fc
, AV_LOG_ERROR
, "local tag 0x%04X with 0 size\n", tag
);
934 if (tag
> 0x7FFF) { /* dynamic tag */
936 for (i
= 0; i
< mxf
->local_tags_count
; i
++) {
937 int local_tag
= AV_RB16(mxf
->local_tags
+i
*18);
938 if (local_tag
== tag
) {
939 memcpy(uid
, mxf
->local_tags
+i
*18+2, 16);
940 dprintf(mxf
->fc
, "local tag 0x%04X\n", local_tag
);
942 PRINT_KEY(mxf
->fc
, "uid", uid
);
947 if (ctx_size
&& tag
== 0x3C0A)
948 get_buffer(pb
, ctx
->uid
, 16);
949 else if (read_child(ctx
, pb
, tag
, size
, uid
) < 0)
952 url_fseek(pb
, next
, SEEK_SET
);
954 if (ctx_size
) ctx
->type
= type
;
955 return ctx_size
? mxf_add_metadata_set(mxf
, ctx
) : 0;
958 static int mxf_read_header(AVFormatContext
*s
, AVFormatParameters
*ap
)
960 MXFContext
*mxf
= s
->priv_data
;
963 if (!mxf_read_sync(s
->pb
, mxf_header_partition_pack_key
, 14)) {
964 av_log(s
, AV_LOG_ERROR
, "could not find header partition pack key\n");
967 url_fseek(s
->pb
, -14, SEEK_CUR
);
969 while (!url_feof(s
->pb
)) {
970 const MXFMetadataReadTableEntry
*metadata
;
972 if (klv_read_packet(&klv
, s
->pb
) < 0)
975 PRINT_KEY(s
, "read header", klv
.key
);
977 if (IS_KLV_KEY(klv
.key
, mxf_encrypted_triplet_key
) ||
978 IS_KLV_KEY(klv
.key
, mxf_essence_element_key
)) {
979 /* FIXME avoid seek */
980 url_fseek(s
->pb
, klv
.offset
, SEEK_SET
);
984 for (metadata
= mxf_metadata_read_table
; metadata
->read
; metadata
++) {
985 if (IS_KLV_KEY(klv
.key
, metadata
->key
)) {
986 int (*read
)() = klv
.key
[5] == 0x53 ? mxf_read_local_tags
: metadata
->read
;
987 if (read(mxf
, &klv
, metadata
->read
, metadata
->ctx_size
, metadata
->type
) < 0) {
988 av_log(s
, AV_LOG_ERROR
, "error reading header metadata\n");
995 url_fskip(s
->pb
, klv
.length
);
997 return mxf_parse_structural_metadata(mxf
);
1000 static int mxf_read_close(AVFormatContext
*s
)
1002 MXFContext
*mxf
= s
->priv_data
;
1005 av_freep(&mxf
->packages_refs
);
1006 for (i
= 0; i
< mxf
->metadata_sets_count
; i
++) {
1007 switch (mxf
->metadata_sets
[i
]->type
) {
1008 case MultipleDescriptor
:
1009 av_freep(&((MXFDescriptor
*)mxf
->metadata_sets
[i
])->sub_descriptors_refs
);
1012 av_freep(&((MXFSequence
*)mxf
->metadata_sets
[i
])->structural_components_refs
);
1015 case MaterialPackage
:
1016 av_freep(&((MXFPackage
*)mxf
->metadata_sets
[i
])->tracks_refs
);
1019 mxf
->metadata_sets
[i
] = NULL
; /* will be freed later */
1024 av_freep(&mxf
->metadata_sets
[i
]);
1026 av_freep(&mxf
->metadata_sets
);
1027 av_freep(&mxf
->aesc
);
1028 av_freep(&mxf
->local_tags
);
1032 static int mxf_probe(AVProbeData
*p
) {
1033 uint8_t *bufp
= p
->buf
;
1034 uint8_t *end
= p
->buf
+ p
->buf_size
;
1036 if (p
->buf_size
< sizeof(mxf_header_partition_pack_key
))
1039 /* Must skip Run-In Sequence and search for MXF header partition pack key SMPTE 377M 5.5 */
1040 end
-= sizeof(mxf_header_partition_pack_key
);
1041 for (; bufp
< end
; bufp
++) {
1042 if (IS_KLV_KEY(bufp
, mxf_header_partition_pack_key
))
1043 return AVPROBE_SCORE_MAX
;
1048 /* rudimentary byte seek */
1049 /* XXX: use MXF Index */
1050 static int mxf_read_seek(AVFormatContext
*s
, int stream_index
, int64_t sample_time
, int flags
)
1052 AVStream
*st
= s
->streams
[stream_index
];
1057 if (sample_time
< 0)
1059 seconds
= av_rescale(sample_time
, st
->time_base
.num
, st
->time_base
.den
);
1060 url_fseek(s
->pb
, (s
->bit_rate
* seconds
) >> 3, SEEK_SET
);
1061 av_update_cur_dts(s
, st
, sample_time
);
1065 AVInputFormat mxf_demuxer
= {
1067 NULL_IF_CONFIG_SMALL("MXF format"),