ffprobe: print some basic information about avframe side data
[ffmpeg.git] / doc / ffprobe.xsd
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
4     targetNamespace="http://www.ffmpeg.org/schema/ffprobe"
5     xmlns:ffprobe="http://www.ffmpeg.org/schema/ffprobe">
6
7     <xsd:element name="ffprobe" type="ffprobe:ffprobeType"/>
8
9     <xsd:complexType name="ffprobeType">
10         <xsd:sequence>
11             <xsd:element name="program_version"  type="ffprobe:programVersionType"  minOccurs="0" maxOccurs="1" />
12             <xsd:element name="library_versions" type="ffprobe:libraryVersionsType" minOccurs="0" maxOccurs="1" />
13             <xsd:element name="packets"  type="ffprobe:packetsType" minOccurs="0" maxOccurs="1" />
14             <xsd:element name="frames"   type="ffprobe:framesType"  minOccurs="0" maxOccurs="1" />
15             <xsd:element name="programs" type="ffprobe:programsType" minOccurs="0" maxOccurs="1" />
16             <xsd:element name="streams"  type="ffprobe:streamsType" minOccurs="0" maxOccurs="1" />
17             <xsd:element name="chapters" type="ffprobe:chaptersType" minOccurs="0" maxOccurs="1" />
18             <xsd:element name="format"   type="ffprobe:formatType"  minOccurs="0" maxOccurs="1" />
19             <xsd:element name="error"    type="ffprobe:errorType"   minOccurs="0" maxOccurs="1" />
20         </xsd:sequence>
21     </xsd:complexType>
22
23     <xsd:complexType name="packetsType">
24         <xsd:sequence>
25             <xsd:element name="packet" type="ffprobe:packetType" minOccurs="0" maxOccurs="unbounded"/>
26         </xsd:sequence>
27     </xsd:complexType>
28
29     <xsd:complexType name="framesType">
30         <xsd:sequence>
31             <xsd:choice minOccurs="0" maxOccurs="unbounded">
32                 <xsd:element name="frame" type="ffprobe:frameType" minOccurs="0" maxOccurs="unbounded"/>
33                 <xsd:element name="subtitle" type="ffprobe:subtitleType" minOccurs="0" maxOccurs="unbounded"/>
34             </xsd:choice>
35         </xsd:sequence>
36     </xsd:complexType>
37
38     <xsd:complexType name="packetType">
39       <xsd:attribute name="codec_type"    type="xsd:string" use="required" />
40       <xsd:attribute name="stream_index"  type="xsd:int" use="required" />
41       <xsd:attribute name="pts"           type="xsd:long"  />
42       <xsd:attribute name="pts_time"      type="xsd:float" />
43       <xsd:attribute name="dts"           type="xsd:long"  />
44       <xsd:attribute name="dts_time"      type="xsd:float" />
45       <xsd:attribute name="duration"      type="xsd:long"  />
46       <xsd:attribute name="duration_time" type="xsd:float" />
47       <xsd:attribute name="convergence_duration"      type="xsd:long"  />
48       <xsd:attribute name="convergence_duration_time" type="xsd:float" />
49       <xsd:attribute name="size"          type="xsd:long" use="required" />
50       <xsd:attribute name="pos"           type="xsd:long"  />
51       <xsd:attribute name="flags"         type="xsd:string" use="required" />
52       <xsd:attribute name="data"          type="xsd:string" />
53     </xsd:complexType>
54
55     <xsd:complexType name="frameType">
56       <xsd:sequence>
57             <xsd:element name="tag" type="ffprobe:tagType" minOccurs="0" maxOccurs="unbounded"/>
58             <xsd:element name="side_data_list" type="ffprobe:frameSideDataListType"   minOccurs="0" maxOccurs="1" />
59       </xsd:sequence>
60
61       <xsd:attribute name="media_type"    type="xsd:string" use="required"/>
62       <xsd:attribute name="key_frame"     type="xsd:int"    use="required"/>
63       <xsd:attribute name="pts"           type="xsd:long" />
64       <xsd:attribute name="pts_time"      type="xsd:float"/>
65       <xsd:attribute name="pkt_pts"       type="xsd:long" />
66       <xsd:attribute name="pkt_pts_time"  type="xsd:float"/>
67       <xsd:attribute name="pkt_dts"       type="xsd:long" />
68       <xsd:attribute name="pkt_dts_time"  type="xsd:float"/>
69       <xsd:attribute name="best_effort_timestamp"      type="xsd:long" />
70       <xsd:attribute name="best_effort_timestamp_time" type="xsd:float" />
71       <xsd:attribute name="pkt_duration"  type="xsd:long" />
72       <xsd:attribute name="pkt_duration_time" type="xsd:float"/>
73       <xsd:attribute name="pkt_pos"       type="xsd:long" />
74       <xsd:attribute name="pkt_size"      type="xsd:int" />
75
76       <!-- audio attributes -->
77       <xsd:attribute name="sample_fmt"             type="xsd:string"/>
78       <xsd:attribute name="nb_samples"             type="xsd:long"  />
79       <xsd:attribute name="channels"               type="xsd:int"   />
80       <xsd:attribute name="channel_layout"         type="xsd:string"/>
81
82       <!-- video attributes -->
83       <xsd:attribute name="width"                  type="xsd:long"  />
84       <xsd:attribute name="height"                 type="xsd:long"  />
85       <xsd:attribute name="pix_fmt"                type="xsd:string"/>
86       <xsd:attribute name="sample_aspect_ratio"    type="xsd:string"/>
87       <xsd:attribute name="pict_type"              type="xsd:string"/>
88       <xsd:attribute name="coded_picture_number"   type="xsd:long"  />
89       <xsd:attribute name="display_picture_number" type="xsd:long"  />
90       <xsd:attribute name="interlaced_frame"       type="xsd:int"   />
91       <xsd:attribute name="top_field_first"        type="xsd:int"   />
92       <xsd:attribute name="repeat_pict"            type="xsd:int"   />
93     </xsd:complexType>
94
95     <xsd:complexType name="frameSideDataListType">
96         <xsd:sequence>
97             <xsd:element name="side_data" type="ffprobe:frameSideDataType" minOccurs="1" maxOccurs="unbounded"/>
98         </xsd:sequence>
99     </xsd:complexType>
100     <xsd:complexType name="frameSideDataType">
101         <xsd:attribute name="side_data_type"              type="xsd:string"/>
102         <xsd:attribute name="side_data_size"              type="xsd:int"   />
103     </xsd:complexType>
104
105     <xsd:complexType name="subtitleType">
106       <xsd:attribute name="media_type"         type="xsd:string" fixed="subtitle" use="required"/>
107       <xsd:attribute name="pts"                type="xsd:long" />
108       <xsd:attribute name="pts_time"           type="xsd:float"/>
109       <xsd:attribute name="format"             type="xsd:int"  />
110       <xsd:attribute name="start_display_time" type="xsd:int"  />
111       <xsd:attribute name="end_display_time"   type="xsd:int"  />
112       <xsd:attribute name="num_rects"          type="xsd:int"  />
113     </xsd:complexType>
114
115     <xsd:complexType name="streamsType">
116         <xsd:sequence>
117             <xsd:element name="stream" type="ffprobe:streamType" minOccurs="0" maxOccurs="unbounded"/>
118         </xsd:sequence>
119     </xsd:complexType>
120
121     <xsd:complexType name="programsType">
122         <xsd:sequence>
123             <xsd:element name="program" type="ffprobe:programType" minOccurs="0" maxOccurs="unbounded"/>
124         </xsd:sequence>
125     </xsd:complexType>
126
127     <xsd:complexType name="streamDispositionType">
128       <xsd:attribute name="default"          type="xsd:int" use="required" />
129       <xsd:attribute name="dub"              type="xsd:int" use="required" />
130       <xsd:attribute name="original"         type="xsd:int" use="required" />
131       <xsd:attribute name="comment"          type="xsd:int" use="required" />
132       <xsd:attribute name="lyrics"           type="xsd:int" use="required" />
133       <xsd:attribute name="karaoke"          type="xsd:int" use="required" />
134       <xsd:attribute name="forced"           type="xsd:int" use="required" />
135       <xsd:attribute name="hearing_impaired" type="xsd:int" use="required" />
136       <xsd:attribute name="visual_impaired"  type="xsd:int" use="required" />
137       <xsd:attribute name="clean_effects"    type="xsd:int" use="required" />
138       <xsd:attribute name="attached_pic"     type="xsd:int" use="required" />
139     </xsd:complexType>
140
141     <xsd:complexType name="streamType">
142       <xsd:sequence>
143         <xsd:element name="disposition" type="ffprobe:streamDispositionType" minOccurs="0" maxOccurs="1"/>
144         <xsd:element name="tag" type="ffprobe:tagType" minOccurs="0" maxOccurs="unbounded"/>
145       </xsd:sequence>
146
147       <xsd:attribute name="index"            type="xsd:int" use="required"/>
148       <xsd:attribute name="codec_name"       type="xsd:string" />
149       <xsd:attribute name="codec_long_name"  type="xsd:string" />
150       <xsd:attribute name="profile"          type="xsd:string" />
151       <xsd:attribute name="codec_type"       type="xsd:string" />
152       <xsd:attribute name="codec_time_base"  type="xsd:string" use="required"/>
153       <xsd:attribute name="codec_tag"        type="xsd:string" use="required"/>
154       <xsd:attribute name="codec_tag_string" type="xsd:string" use="required"/>
155       <xsd:attribute name="extradata"        type="xsd:string" />
156
157       <!-- video attributes -->
158       <xsd:attribute name="width"                type="xsd:int"/>
159       <xsd:attribute name="height"               type="xsd:int"/>
160       <xsd:attribute name="has_b_frames"         type="xsd:int"/>
161       <xsd:attribute name="sample_aspect_ratio"  type="xsd:string"/>
162       <xsd:attribute name="display_aspect_ratio" type="xsd:string"/>
163       <xsd:attribute name="pix_fmt"              type="xsd:string"/>
164       <xsd:attribute name="level"                type="xsd:int"/>
165       <xsd:attribute name="color_range"          type="xsd:string"/>
166       <xsd:attribute name="color_space"          type="xsd:string"/>
167       <xsd:attribute name="timecode"             type="xsd:string"/>
168
169       <!-- audio attributes -->
170       <xsd:attribute name="sample_fmt"       type="xsd:string"/>
171       <xsd:attribute name="sample_rate"      type="xsd:int"/>
172       <xsd:attribute name="channels"         type="xsd:int"/>
173       <xsd:attribute name="channel_layout"   type="xsd:string"/>
174       <xsd:attribute name="bits_per_sample"  type="xsd:int"/>
175
176       <xsd:attribute name="id"               type="xsd:string"/>
177       <xsd:attribute name="r_frame_rate"     type="xsd:string" use="required"/>
178       <xsd:attribute name="avg_frame_rate"   type="xsd:string" use="required"/>
179       <xsd:attribute name="time_base"        type="xsd:string" use="required"/>
180       <xsd:attribute name="start_pts"        type="xsd:long"/>
181       <xsd:attribute name="start_time"       type="xsd:float"/>
182       <xsd:attribute name="duration_ts"      type="xsd:long"/>
183       <xsd:attribute name="duration"         type="xsd:float"/>
184       <xsd:attribute name="bit_rate"         type="xsd:int"/>
185       <xsd:attribute name="max_bit_rate"     type="xsd:int"/>
186       <xsd:attribute name="nb_frames"        type="xsd:int"/>
187       <xsd:attribute name="nb_read_frames"   type="xsd:int"/>
188       <xsd:attribute name="nb_read_packets"  type="xsd:int"/>
189     </xsd:complexType>
190
191     <xsd:complexType name="programType">
192       <xsd:sequence>
193         <xsd:element name="tag" type="ffprobe:tagType" minOccurs="0" maxOccurs="unbounded"/>
194         <xsd:element name="streams" type="ffprobe:streamsType" minOccurs="0" maxOccurs="1"/>
195       </xsd:sequence>
196
197       <xsd:attribute name="program_id"           type="xsd:int"    use="required"/>
198       <xsd:attribute name="program_num"          type="xsd:int"    use="required"/>
199       <xsd:attribute name="nb_streams"           type="xsd:int"    use="required"/>
200       <xsd:attribute name="start_time"           type="xsd:float"/>
201       <xsd:attribute name="start_pts"            type="xsd:long"/>
202       <xsd:attribute name="end_time"             type="xsd:float"/>
203       <xsd:attribute name="end_pts"              type="xsd:long"/>
204       <xsd:attribute name="pmt_pid"              type="xsd:int"    use="required"/>
205       <xsd:attribute name="pcr_pid"              type="xsd:int"    use="required"/>
206     </xsd:complexType>
207
208     <xsd:complexType name="formatType">
209       <xsd:sequence>
210         <xsd:element name="tag" type="ffprobe:tagType" minOccurs="0" maxOccurs="unbounded"/>
211       </xsd:sequence>
212
213       <xsd:attribute name="filename"         type="xsd:string" use="required"/>
214       <xsd:attribute name="nb_streams"       type="xsd:int"    use="required"/>
215       <xsd:attribute name="nb_programs"      type="xsd:int"    use="required"/>
216       <xsd:attribute name="format_name"      type="xsd:string" use="required"/>
217       <xsd:attribute name="format_long_name" type="xsd:string"/>
218       <xsd:attribute name="start_time"       type="xsd:float"/>
219       <xsd:attribute name="duration"         type="xsd:float"/>
220       <xsd:attribute name="size"             type="xsd:long"/>
221       <xsd:attribute name="bit_rate"         type="xsd:long"/>
222       <xsd:attribute name="probe_score"      type="xsd:int"/>
223     </xsd:complexType>
224
225     <xsd:complexType name="tagType">
226       <xsd:attribute name="key"   type="xsd:string" use="required"/>
227       <xsd:attribute name="value" type="xsd:string" use="required"/>
228     </xsd:complexType>
229
230     <xsd:complexType name="errorType">
231       <xsd:attribute name="code"   type="xsd:int"    use="required"/>
232       <xsd:attribute name="string" type="xsd:string" use="required"/>
233     </xsd:complexType>
234
235     <xsd:complexType name="programVersionType">
236       <xsd:attribute name="version"          type="xsd:string" use="required"/>
237       <xsd:attribute name="copyright"        type="xsd:string" use="required"/>
238       <xsd:attribute name="build_date"       type="xsd:string" use="required"/>
239       <xsd:attribute name="build_time"       type="xsd:string" use="required"/>
240       <xsd:attribute name="compiler_ident"   type="xsd:string" use="required"/>
241       <xsd:attribute name="configuration"    type="xsd:string" use="required"/>
242     </xsd:complexType>
243
244     <xsd:complexType name="chaptersType">
245       <xsd:sequence>
246         <xsd:element name="chapter" type="ffprobe:chapterType" minOccurs="0" maxOccurs="unbounded"/>
247       </xsd:sequence>
248     </xsd:complexType>
249
250     <xsd:complexType name="chapterType">
251       <xsd:sequence>
252         <xsd:element name="tag" type="ffprobe:tagType" minOccurs="0" maxOccurs="unbounded"/>
253       </xsd:sequence>
254
255       <xsd:attribute name="id"         type="xsd:int" use="required"/>
256       <xsd:attribute name="time_base"  type="xsd:string" use="required"/>
257       <xsd:attribute name="start"      type="xsd:int" use="required"/>
258       <xsd:attribute name="start_time" type="xsd:float"/>
259       <xsd:attribute name="end"        type="xsd:int" use="required"/>
260       <xsd:attribute name="end_time"   type="xsd:float" use="required"/>
261     </xsd:complexType>
262
263     <xsd:complexType name="libraryVersionType">
264       <xsd:attribute name="name"        type="xsd:string" use="required"/>
265       <xsd:attribute name="major"       type="xsd:int"    use="required"/>
266       <xsd:attribute name="minor"       type="xsd:int"    use="required"/>
267       <xsd:attribute name="micro"       type="xsd:int"    use="required"/>
268       <xsd:attribute name="version"     type="xsd:int"    use="required"/>
269       <xsd:attribute name="ident"       type="xsd:string" use="required"/>
270     </xsd:complexType>
271
272     <xsd:complexType name="libraryVersionsType">
273         <xsd:sequence>
274           <xsd:element name="library_version" type="ffprobe:libraryVersionType" minOccurs="0" maxOccurs="unbounded"/>
275         </xsd:sequence>
276     </xsd:complexType>
277 </xsd:schema>