2 Copyright (c) 2006-2018, John Hurst
5 Redistribution and use in source and binary forms, with or without
6 modification, are permitted provided that the following conditions
8 1. Redistributions of source code must retain the above copyright
9 notice, this list of conditions and the following disclaimer.
10 2. Redistributions in binary form must reproduce the above copyright
11 notice, this list of conditions and the following disclaimer in the
12 documentation and/or other materials provided with the distribution.
13 3. The name of the author may not be used to endorse or promote products
14 derived from this software without specific prior written permission.
16 THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 //------------------------------------------------------------------------------------------
40 // The composite dict is the union of the SMPTE and Interop dicts
42 static ASDCP::Dictionary s_CompositeDict;
43 static Kumu::Mutex s_CompositeDictLock;
44 static bool s_CompositeDictInit = false;
47 const ASDCP::Dictionary&
48 ASDCP::DefaultCompositeDict()
50 if ( ! s_CompositeDictInit )
52 Kumu::AutoMutex AL(s_CompositeDictLock);
54 if ( ! s_CompositeDictInit )
56 s_CompositeDict.Init();
57 s_CompositeDictInit = true;
61 return s_CompositeDict;
66 static ASDCP::Dictionary s_InteropDict;
67 static Kumu::Mutex s_InteropDictLock;
68 static bool s_InteropDictInit = false;
71 const ASDCP::Dictionary&
72 ASDCP::DefaultInteropDict()
74 if ( ! s_InteropDictInit )
76 Kumu::AutoMutex AL(s_InteropDictLock);
78 if ( ! s_InteropDictInit )
82 s_InteropDict.DeleteEntry(MDD_MXFInterop_OPAtom);
83 s_InteropDict.DeleteEntry(MDD_MXFInterop_CryptEssence);
84 s_InteropDict.DeleteEntry(MDD_MXFInterop_GenericDescriptor_SubDescriptors);
86 s_InteropDict.AddEntry(s_MDD_Table[MDD_MXFInterop_OPAtom], MDD_OPAtom);
87 s_InteropDict.AddEntry(s_MDD_Table[MDD_MXFInterop_CryptEssence], MDD_CryptEssence);
88 s_InteropDict.AddEntry(s_MDD_Table[MDD_MXFInterop_GenericDescriptor_SubDescriptors],
89 MDD_GenericDescriptor_SubDescriptors);
91 s_InteropDictInit = true;
100 static ASDCP::Dictionary s_SMPTEDict;
101 static Kumu::Mutex s_SMPTEDictLock;
102 static bool s_SMPTEDictInit = false;
105 const ASDCP::Dictionary&
106 ASDCP::DefaultSMPTEDict()
108 if ( ! s_SMPTEDictInit )
110 Kumu::AutoMutex AL(s_SMPTEDictLock);
112 if ( ! s_SMPTEDictInit )
116 s_SMPTEDict.DeleteEntry(MDD_MXFInterop_OPAtom);
117 s_SMPTEDict.DeleteEntry(MDD_MXFInterop_CryptEssence);
118 s_SMPTEDict.DeleteEntry(MDD_MXFInterop_GenericDescriptor_SubDescriptors);
120 s_SMPTEDictInit = true;
128 const ASDCP::MDDEntry&
129 ASDCP::MXFInterop_OPAtom_Entry() {
130 return s_MDD_Table[MDD_MXFInterop_OPAtom];
134 const ASDCP::MDDEntry&
135 ASDCP::SMPTE_390_OPAtom_Entry() {
136 return s_MDD_Table[MDD_OPAtom];
141 static ASDCP::Dictionary s_AtmosSMPTEDict;
142 static Kumu::Mutex s_AtmosSMPTEDictLock;
143 static bool s_AtmosSMPTEDictInit = false;
146 const ASDCP::Dictionary&
147 ASDCP::AtmosSMPTEDict()
149 if ( ! s_AtmosSMPTEDictInit )
151 Kumu::AutoMutex AL(s_AtmosSMPTEDictLock);
153 if ( ! s_AtmosSMPTEDictInit )
155 s_AtmosSMPTEDict.Init();
157 s_AtmosSMPTEDict.DeleteEntry(MDD_MXFInterop_OPAtom);
158 s_AtmosSMPTEDict.DeleteEntry(MDD_MXFInterop_CryptEssence);
159 s_AtmosSMPTEDict.DeleteEntry(MDD_MXFInterop_GenericDescriptor_SubDescriptors);
161 // legacy Atmos files have the wrong version byte
162 assert(s_AtmosSMPTEDict.Type(MDD_GenericDataEssenceDescriptor_DataEssenceCoding).ul[7] == 0x03);
163 s_AtmosSMPTEDict.MutableType(MDD_GenericDataEssenceDescriptor_DataEssenceCoding).ul[7] = 0x05;
165 s_AtmosSMPTEDictInit = true;
169 return s_AtmosSMPTEDict;
172 //------------------------------------------------------------------------------------------
175 ASDCP::Dictionary::Dictionary() {}
176 ASDCP::Dictionary::~Dictionary() {}
180 ASDCP::Dictionary::Init()
183 memset(m_MDD_Table, 0, sizeof(m_MDD_Table));
185 for ( ui32_t x = 0; x < (ui32_t)ASDCP::MDD_Max; ++x )
187 if ( x == MDD_PartitionMetadata_IndexSID_DEPRECATED // 30
188 || x == MDD_PartitionMetadata_BodySID_DEPRECATED // 32
189 || x == MDD_PartitionMetadata_OperationalPattern_DEPRECATED // 33
190 || x == MDD_PartitionMetadata_EssenceContainers_DEPRECATED // 34
191 || x == MDD_IndexTableSegmentBase_IndexSID_DEPRECATED // 56
192 || x == MDD_IndexTableSegmentBase_BodySID_DEPRECATED // 57
193 || x == MDD_PartitionArray_RandomIndexMetadata_BodySID_DEPRECATED // 73
194 || x == MDD_Preface_OperationalPattern_DEPRECATED // 84
195 || x == MDD_Preface_EssenceContainers_DEPRECATED // 85
196 || x == MDD_EssenceContainerData_IndexSID_DEPRECATED // 103
197 || x == MDD_EssenceContainerData_BodySID_DEPRECATED // 104
198 || x == MDD_TimedTextResourceSubDescriptor_EssenceStreamID_DEPRECATED // 264
199 || x == MDD_DMSegment_DataDefinition_DEPRECATED // 266
200 || x == MDD_DMSegment_Duration_DEPRECATED // 267
204 AddEntry(s_MDD_Table[x], x);
210 ASDCP::Dictionary::AddEntry(const MDDEntry& Entry, ui32_t index)
212 if ( index >= (ui32_t)MDD_Max )
214 Kumu::DefaultLogSink().Warn("UL Dictionary: index exceeds maximum: %d\n", index);
219 // is this index already there?
220 std::map<ui32_t, ASDCP::UL>::iterator rii = m_md_rev_lookup.find(index);
222 if ( rii != m_md_rev_lookup.end() )
230 #define MDD_AUTHORING_MODE
231 #ifdef MDD_AUTHORING_MODE
233 std::map<ASDCP::UL, ui32_t>::iterator ii = m_md_lookup.find(TmpUL);
234 if ( ii != m_md_lookup.end() )
236 Kumu::DefaultLogSink().Warn("Duplicate Dictionary item: %s (%02x, %02x) %s | (%02x, %02x) %s\n",
237 TmpUL.EncodeString(buf, 64),
238 m_MDD_Table[ii->second].tag.a, m_MDD_Table[ii->second].tag.b,
239 m_MDD_Table[ii->second].name,
240 Entry.tag.a, Entry.tag.b, Entry.name);
244 m_md_lookup.insert(std::map<UL, ui32_t>::value_type(TmpUL, index));
245 m_md_rev_lookup.insert(std::map<ui32_t, UL>::value_type(index, TmpUL));
246 m_md_sym_lookup.insert(std::map<std::string, ui32_t>::value_type(Entry.name, index));
247 m_MDD_Table[index] = Entry;
254 ASDCP::Dictionary::DeleteEntry(ui32_t index)
256 std::map<ui32_t, ASDCP::UL>::iterator rii = m_md_rev_lookup.find(index);
257 if ( rii != m_md_rev_lookup.end() )
259 std::map<ASDCP::UL, ui32_t>::iterator ii = m_md_lookup.find(rii->second);
260 assert(ii != m_md_lookup.end());
263 memset(&NilEntry, 0, sizeof(NilEntry));
265 m_md_lookup.erase(ii);
266 m_md_rev_lookup.erase(rii);
267 m_MDD_Table[index] = NilEntry;
275 const ASDCP::MDDEntry&
276 ASDCP::Dictionary::Type(MDD_t type_id) const
278 assert(m_MDD_Table[0].name[0]);
279 std::map<ui32_t, ASDCP::UL>::const_iterator rii = m_md_rev_lookup.find(type_id);
281 if ( rii == m_md_rev_lookup.end() )
282 Kumu::DefaultLogSink().Warn("UL Dictionary: unknown UL type_id: %d\n", type_id);
284 return m_MDD_Table[type_id];
289 ASDCP::Dictionary::MutableType(MDD_t type_id)
291 assert(m_MDD_Table[0].name[0]);
292 std::map<ui32_t, ASDCP::UL>::iterator rii = m_md_rev_lookup.find(type_id);
294 if ( rii == m_md_rev_lookup.end() )
295 Kumu::DefaultLogSink().Warn("UL Dictionary: unknown UL type_id: %d\n", type_id);
297 return m_MDD_Table[type_id];
301 const ASDCP::MDDEntry*
302 ASDCP::Dictionary::FindULAnyVersion(const byte_t* ul_buf) const
304 assert(m_MDD_Table[0].name[0]);
305 byte_t search_ul[SMPTE_UL_LENGTH];
306 memcpy(search_ul, ul_buf, SMPTE_UL_LENGTH);
307 memset(search_ul+7, 0, SMPTE_UL_LENGTH-7);
310 const ASDCP::MDDEntry *found_entry = 0;
312 std::map<UL, ui32_t>::const_iterator lower = m_md_lookup.lower_bound(UL(search_ul));
314 for ( ; lower != m_md_lookup.end(); ++lower )
316 if ( lower->first.MatchExact(target) )
318 found_entry = &m_MDD_Table[lower->second];
321 else if ( found_entry == 0 && lower->first.MatchIgnoreStream(target) )
323 found_entry = &m_MDD_Table[lower->second];
325 else if ( found_entry != 0 && ! lower->first.MatchIgnoreStream(target) )
331 if ( found_entry == 0 )
334 Kumu::DefaultLogSink().Warn("UL Dictionary: unknown UL: %s\n", target.EncodeString(buf, 64));
341 const ASDCP::MDDEntry*
342 ASDCP::Dictionary::FindULExact(const byte_t* ul_buf) const
344 assert(m_MDD_Table[0].name[0]);
345 std::map<UL, ui32_t>::const_iterator i = m_md_lookup.find(UL(ul_buf));
347 if ( i == m_md_lookup.end() )
351 Kumu::DefaultLogSink().Warn("UL Dictionary: unknown UL: %s\n", tmp_ul.EncodeString(buf, 64));
355 return &m_MDD_Table[i->second];
359 const ASDCP::MDDEntry*
360 ASDCP::Dictionary::FindSymbol(const std::string& str) const
362 assert(m_MDD_Table[0].name[0]);
363 std::map<std::string, ui32_t>::const_iterator i = m_md_sym_lookup.find(str);
365 if ( i == m_md_sym_lookup.end() )
367 Kumu::DefaultLogSink().Warn("UL Dictionary: unknown symbol: %s\n", str.c_str());
371 return &m_MDD_Table[i->second];
376 ASDCP::Dictionary::Dump(FILE* stream) const
384 while ( di < MDD_Max )
386 if ( m_MDD_Table[di].name != 0 )
388 UL TmpUL(m_MDD_Table[di].ul);
389 fprintf(stream, "%s: %s\n", TmpUL.EncodeString(str_buf, 64), m_MDD_Table[di].name);
392 di = (MDD_t)(di + 1);