1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
<!DOCTYPE html>
<html lang="en-US">
<head>
<title>MediaConch - Data format</title>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="qrc:/bootstrap.css">
<link rel="stylesheet" type="text/css" href="qrc:/main.css" media="screen"/>
</head>
<body id="body">
<h1>XML Reporting</h1>
<p>This document describes four XML schemas designed by MediaArea for various types of file reportage. These schemas include the MediaInfo XML, the MediaConch XML, the MediaTrace XML, and the MediaAreaXML (MAXML). Brief descriptions of structure and operation can be found below. </p>
<h4><a href="#mediainfo-xml">MediaInfo XML</a></h4>
<ul>
<li><a href="#structure-of-a-mediainfo-xml">Structure of a MediaInfo XML</a></li>
<li><a href="#generating-a-mediainfo-xml">Generating a MediaInfo XML</a></li>
</ul>
<h4><a href="#mediaconch-xml">MediaConch XML</a></h4>
<ul>
<li><a href="#structure-of-a-mediaconch-xml">Structure of a MediaConch XML</a></li>
<li><a href="#generating-a-mediaconch-xml">Generating a MediaConch XML</a></li>
</ul>
<h4><a href="#mediatrace-xml">MediaTrace XML</a></h4>
<ul>
<li><a href="#structure-of-a-mediatrace-xml">Structure of a MediaTrace XML</a></li>
<li><a href="#generating-a-mediatrace-xml">Generating a MediaTrace XML</a></li>
<li><a href="#mediatrace-xml-schema">MediaTrace XML Schema</a></li>
</ul>
<h4><a href="#mediaarea-xml">MediaArea XML</a></h4>
<ul>
<li><a href="#structure-of-a-mediaarea-xml">Structure of a MediaArea XML</a></li>
<li><a href="#generating-a-mediaarea-xml">Generating a MediaArea XML</a></li>
<li><a href="#mediaarea-xml-schema">MediaArea XML Schema</a></li>
</ul>
<h3 id="mediainfo-xml">MediaInfo XML</h3>
<p>Using MediaArea’s principal software, MediaInfo, the MediaInfo XML presents a file’s basic metadata elements in the form of easily intelligible sets of track and stream information. These track types may include but are not limited to, “General,” or general container information; “Video” track or stream information; “Audio” track or stream information; and “Timecode” or other ancillary information. Additional information on MediaInfo general reporting is available <a href="https://mediaarea.net/en/MediaInfo">here</a>.</p>
<h4 id="structure-of-a-mediainfo-xml">Structure of a MediaInfo XML</h4>
<p>The root element of the MediaInfo XML exists as <code><Mediainfo></code>. A nested <code><File></code> sub-element containing a <code>ref</code> attribute specifies the path and filename of the file reported on. A <code><track type></code> child element defines MediaInfo's track types, and within <code><track type></code> elements are various sub-child elements corresponding to associated field metadata. For example, a "General" track type element will include such sibling elements as <code><CompleteName></code>, <code><Format></code>, and <code><FileSize></code>; a "Video" track type element will include such sibling elements as <code><Width></code>, <code><Height></code>, and <code><PixelAspectRatio></code>; an "Audio" track type element will include such sibling elements as <code><Channels></code>, <code><SamplingRate></code>, and <code><SamplingCount></code>; and so on, and so forth. </p>
<p>The following is an example of a MediaInfo XML General type track element containing the sub-child elements "Format," "Format<em>profile," and "Codec</em>ID": </p>
<pre><code> <track type="General">
<Complete_name>/Users/mycomputer//files/ffv1.mkv</Complete_name>
<Format>MPEG-4</Format>
<Format_profile>QuickTime</Format_profile>
<Codec_ID>qt</Codec_ID>
</track>`
</code></pre>
<h4 id="generating-a-mediainfo-xml">Generating a MediaInfo XML</h4>
<p>A MediaInfo XML can be generated using the following tools and associated commands:</p>
<ul>
<li><p>With MediaInfo: <code>mediainfo --Output=XML file.mov</code></p></li>
<li><p>With MediaConch (CLI): <code>mediaconch -mi -fx file.mov</code></p></li>
<li><p>With MediaConch (GUI): Select View Mode in the <code>MediaInfo</code> tab from the resulting file Checker reports</p></li>
</ul>
<h3 id="mediaconch-xml">MediaConch XML</h3>
<p>The MediaConch XML is designed specifically for file conformance checking using MediaArea’s MediaConch software, and contains reportage pertaining to a user-defined policy or policies. Additional information on MediaConch is available <a href="https://mediaarea.net/MediaConch/">here</a>.</p>
<h4 id="structure-of-a-mediaconch-xml">Structure of a MediaConch XML</h4>
<p>The root element of the MediaConch XML exists as <code><MediaConch></code>, and initially contains a <code><policyChecks></code> element which encapsulates all policy rules. The <code><title></code> element denotes the title of the policy, while the <code><media></code> element contains the checked filename its associated path:</p>
<pre><code> <?xml version="1.0" encoding="UTF-8"?>
<MediaConch xmlns="https://mediaarea.net/mediaconch" xmlns:mi="https://mediaarea.net/mediainfo" version="0.1">`
<policyChecks>
<title>Preservation Master File Recommendations - Matroska/FFV1</title>
<media ref="/Users/mycomputer//files/ffv1.mkv">`
</code></pre>
<p>Within the <code><policyChecks></code> element are individual <code><policy></code> rules that contain the name of the policy rule, the associated track type and field, a user-declared value, the reported or “actual” value, and a “pass” or “fail” outcome:</p>
<pre><code> <policy title="General Format equals Matroska">
<context field="Format" value="Matroska"/>
<test tracktype="General" actual="Matroska" outcome="pass"/>
</policy>
</code></pre>
<h4 id="generating-a-mediaconch-xml">Generating a MediaConch XML</h4>
<p>A MediaConch XML can be generated using the following tools and associated commands:</p>
<p>-With MediaConch (CLI): <code>mediaconch -mc -fx file.mov</code></p>
<p>Note: The command <code>mediaconch -fx file.mov</code> will automatically default to <code>-mc</code> and produce equivalent results.</p>
<p>-With MediaConch (GUI): Select View Mode in the <code>Policy Report</code> tab from the resulting file Checker reports</p>
<h3 id="mediatrace-xml">MediaTrace XML</h3>
<p>The MediaTrace XML is a technical reporting tool that expresses the binary architecture of a file as interpreted by MediaArea’s principal software, MediaInfo. Additional information on MediaTrace is available <a href="https://mediaarea.net/mediatrace/">here</a>. A data dictionary is provided at the project’s Github repository <a href="https://github.com/MediaArea/MediaAreaXml/blob/master/DataDictionary.md">here</a>. </p>
<h3 id="structure-of-a-mediatrace-xml">Structure of a MediaTrace XML</h3>
<p>The root element of the MediaTrace XML exists as <code><MediaTrace></code>. This root element contains a <code><creatingLibrary></code> sub-element denoting the version of MediaInfo’s library used in generating the trace report:</p>
<pre><code> <MediaTrace
xmlns="https://mediaarea.net/mediatrace"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://mediaarea.net/mediatrace https://mediaarea.net/mediatrace/mediatrace_0_1.xsd"
version="0.1"
ref="/Users/mycomputer//files/ffv1.mkv">
<creatingLibrary version="0.7.78" url="https://mediaarea.net/MediaInfo">MediaInfoLib</creatingLibrary>`
</code></pre>
<p>Many audiovisual formats are based on chunk-based storage where a block of data will either contain a data payload or other blocks. In QuickTime parlance these blocks are called atoms, in AVI “chunks”, and in Matroska, “elements”. MediaTrace will attempt to parse apart each block into subdivisions and report on their contents. Whether the source format specification calls it element, atom, chunk, or another term, MediaTrace will call it a <code><block></code>. In MediaTrace the contents of the block are called <code><data></code>:</p>
<pre><code> <block offset="28" name="DocType" info="matroska" size="11">
<block offset="28" name="Header" size="3">
<data offset="28" name="Name">642</data>
<data offset="30" name="Size">8</data>
</block>
<data offset="31" name="Data">matroska</data>
</block>`
</code></pre>
<h4 id="generating-a-mediatrace-xml">Generating a MediaTrace XML</h4>
<p>A MediaTrace XML can be generated using the following tools and associated commands:</p>
<p>-With MediaInfo: <code>mediainfo --Details=1 --Output=XML file.mkv</code></p>
<p>-With MediaConch (CLI): <code>mediaconch -mt -fx file.mkv</code></p>
<p>-With MediaConch (GUI): Select Select View Mode in the <code>MediaTrace</code> tab from the resulting file Checker reports</p>
<h4 id="mediatrace-xml-schema">MediaTrace XML Schema</h4>
<p>An XML Schema for MediaTrace is available <a href="https://mediaarea.net/mediatrace/mediatrace.xsd">here</a>.</p>
<h3 id="mediaarea-xml">MediaArea XML</h3>
<p>The MediaArea XML (MAXML) is designed to bundle general reporting information from MediaInfo, binary file architecture reporting from MediaTrace, and conformance checking information from MediaConch into one condensed XML structure. </p>
<h4 id="structure-of-a-mediaarea-xml">Structure of a MediaArea XML</h4>
<p>The root element of the MediaArea XML is <code><MediaArea></code>, followed by a <code><media></code> sibling element. A <code><MediaInfo></code> child element defines a MediaInfo general report. Sibling <code><track type></code> elements offer various sub-child elements corresponding to associated field metadata. </p>
<h4 id="generating-a-mediaarea-xml">Generating a MediaArea XML</h4>
<p>A MediaTrace XML can be generated using the following tools and associated commands:</p>
<p>-With MediaInfo: <code>mediainfo --Details=1 --Output=MAXML file.mkv</code></p>
<h4 id="mediaarea-xml-schema">MediaArea XML Schema</h4>
<p>An XML Schema for MediaAreaXML is available <a href="https://mediaarea.net/mediaarea/mediaarea_0_1.xsd">here</a>.</p>
<script src="qrc:/jquery.js"></script>
<script src="qrc:/bootstrap.js"></script>
</body>
</html>
|
