1 /*
2  * MXF
3  * Copyright (c) 2006 SmartJog S.A., Baptiste Coudurier <baptiste dot coudurier at smartjog dot com>
4  *
5  * This file is part of FFmpeg.
6  *
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.
11  *
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.
16  *
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
20  */
21 #ifndef AVFORMAT_MXF_H
22 #define AVFORMAT_MXF_H
23 
24 #include <stdint.h>
25 #include "libavutil/log.h"
26 #include "libavutil/pixfmt.h"
27 #include "libavutil/rational.h"
28 #include "libavutil/uuid.h"
29 
30 typedef AVUUID UID;
31 
32 enum MXFMetadataSetType {
33     AnyType,
34     MaterialPackage,
35     SourcePackage,
36     SourceClip,
37     TimecodeComponent,
38     PulldownComponent,
39     Sequence,
40     MultipleDescriptor,
41     Descriptor,
42     Track,
43     CryptoContext,
44     Preface,
45     Identification,
46     ContentStorage,
47     SubDescriptor,
48     IndexTableSegment,
49     EssenceContainerData,
50     EssenceGroup,
51     TaggedValue,
52     TapeDescriptor,
53     AVCSubDescriptor,
54     AudioChannelLabelSubDescriptor,
55     SoundfieldGroupLabelSubDescriptor,
56     GroupOfSoundfieldGroupsLabelSubDescriptor,
57 };
58 
59 enum MXFFrameLayout {
60     FullFrame = 0,
61     SeparateFields,
62     OneField,
63     MixedFields,
64     SegmentedFrame,
65 };
66 
67 typedef struct MXFContentPackageRate {
68     int rate;
69     AVRational tb;
70 } MXFContentPackageRate;
71 
72 typedef struct KLVPacket {
73     UID key;
74     int64_t offset;
75     uint64_t length;
76     int64_t next_klv;
77 } KLVPacket;
78 
79 typedef enum {
80     NormalWrap = 0,
81     D10D11Wrap,
82     RawAWrap,
83     RawVWrap,
84     J2KWrap
85 } MXFWrappingIndicatorType;
86 
87 typedef struct MXFLocalTagPair {
88     int local_tag;
89     UID uid;
90 } MXFLocalTagPair;
91 
92 extern const uint8_t ff_mxf_random_index_pack_key[16];
93 
94 #define FF_MXF_MasteringDisplay_PREFIX                  0x06,0x0e,0x2b,0x34,0x01,0x01,0x01,0x0e,0x04,0x20,0x04,0x01,0x01
95 #define FF_MXF_MasteringDisplayPrimaries                { FF_MXF_MasteringDisplay_PREFIX,0x01,0x00,0x00 }
96 #define FF_MXF_MasteringDisplayWhitePointChromaticity   { FF_MXF_MasteringDisplay_PREFIX,0x02,0x00,0x00 }
97 #define FF_MXF_MasteringDisplayMaximumLuminance         { FF_MXF_MasteringDisplay_PREFIX,0x03,0x00,0x00 }
98 #define FF_MXF_MasteringDisplayMinimumLuminance         { FF_MXF_MasteringDisplay_PREFIX,0x04,0x00,0x00 }
99 
100 #define FF_MXF_MASTERING_CHROMA_DEN 50000
101 #define FF_MXF_MASTERING_LUMA_DEN   10000
102 
103 typedef struct MXFCodecUL {
104     UID uid;
105     unsigned matching_len;
106     int id;
107     const char *desc;
108     unsigned wrapping_indicator_pos;
109     MXFWrappingIndicatorType wrapping_indicator_type;
110 } MXFCodecUL;
111 
112 extern const MXFCodecUL ff_mxf_data_definition_uls[];
113 extern const MXFCodecUL ff_mxf_codec_uls[];
114 extern const MXFCodecUL ff_mxf_pixel_format_uls[];
115 extern const MXFCodecUL ff_mxf_codec_tag_uls[];
116 extern const MXFCodecUL ff_mxf_color_primaries_uls[];
117 extern const MXFCodecUL ff_mxf_color_trc_uls[];
118 extern const MXFCodecUL ff_mxf_color_space_uls[];
119 
120 int ff_mxf_decode_pixel_layout(const char pixel_layout[16], enum AVPixelFormat *pix_fmt);
121 int ff_mxf_get_content_package_rate(AVRational time_base);
122 
123 
124 #define PRIxUID                             \
125     "%02x.%02x.%02x.%02x."                  \
126     "%02x.%02x.%02x.%02x."                  \
127     "%02x.%02x.%02x.%02x."                  \
128     "%02x.%02x.%02x.%02x"
129 
130 #define UID_ARG(x) \
131     (x)[0],  (x)[1],  (x)[2],  (x)[3],      \
132     (x)[4],  (x)[5],  (x)[6],  (x)[7],      \
133     (x)[8],  (x)[9],  (x)[10], (x)[11],     \
134     (x)[12], (x)[13], (x)[14], (x)[15]      \
135 
136 #ifdef DEBUG
137 #define PRINT_KEY(pc, s, x)                         \
138     av_log(pc, AV_LOG_VERBOSE,                      \
139            "%s "                                    \
140            "0x%02x,0x%02x,0x%02x,0x%02x,"           \
141            "0x%02x,0x%02x,0x%02x,0x%02x,"           \
142            "0x%02x,0x%02x,0x%02x,0x%02x,"           \
143            "0x%02x,0x%02x,0x%02x,0x%02x ",          \
144             s, UID_ARG(x));                         \
145     av_log(pc, AV_LOG_INFO,                         \
146            "%s "                                    \
147            "%02x.%02x.%02x.%02x."                   \
148            "%02x.%02x.%02x.%02x."                   \
149            "%02x.%02x.%02x.%02x."                   \
150            "%02x.%02x.%02x.%02x\n",                 \
151             s, UID_ARG(x))
152 #else
153 #define PRINT_KEY(pc, s, x) do { if(0)              \
154     av_log(pc, AV_LOG_VERBOSE,                      \
155            "%s "                                    \
156            "0x%02x,0x%02x,0x%02x,0x%02x,"           \
157            "0x%02x,0x%02x,0x%02x,0x%02x,"           \
158            "0x%02x,0x%02x,0x%02x,0x%02x,"           \
159            "0x%02x,0x%02x,0x%02x,0x%02x ",          \
160             s, UID_ARG(x));                         \
161     }while(0)
162 #endif
163 
164 #endif /* AVFORMAT_MXF_H */
165