tizen 2.3 release
[framework/multimedia/gst-plugins-base0.10.git] / docs / libs / html / gst-plugins-base-libs-gstrtppayloads.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>gstrtppayloads</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="GStreamer Base Plugins 0.10 Library Reference Manual">
8 <link rel="up" href="gstreamer-rtp.html" title="RTP Library">
9 <link rel="prev" href="gst-plugins-base-libs-gstrtcpbuffer.html" title="gstrtcpbuffer">
10 <link rel="next" href="gstreamer-rtsp.html" title="RTSP Library">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="gst-plugins-base-libs-gstrtcpbuffer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="gstreamer-rtp.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GStreamer Base Plugins 0.10 Library Reference Manual</th>
21 <td><a accesskey="n" href="gstreamer-rtsp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#gst-plugins-base-libs-gstrtppayloads.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#gst-plugins-base-libs-gstrtppayloads.description" class="shortcut">Description</a>
27 </td></tr>
28 </table>
29 <div class="refentry">
30 <a name="gst-plugins-base-libs-gstrtppayloads"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
32 <td valign="top">
33 <h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gstrtppayloads.top_of_page"></a>gstrtppayloads</span></h2>
34 <p>gstrtppayloads — Helper methods for dealing with RTP payloads</p>
35 </td>
36 <td valign="top" align="right"></td>
37 </tr></table></div>
38 <div class="refsynopsisdiv">
39 <a name="gst-plugins-base-libs-gstrtppayloads.synopsis"></a><h2>Synopsis</h2>
40 <pre class="synopsis">
41 #include &lt;gst/rtp/gstrtppayload.h&gt;
42
43 enum                <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayload" title="enum GstRTPPayload">GstRTPPayload</a>;
44 #define             <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GST-RTP-PAYLOAD-IS-DYNAMIC:CAPS" title="GST_RTP_PAYLOAD_IS_DYNAMIC()">GST_RTP_PAYLOAD_IS_DYNAMIC</a>          (pt)
45 struct              <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo">GstRTPPayloadInfo</a>;
46 const <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="returnvalue">GstRTPPayloadInfo</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#gst-rtp-payload-info-for-name" title="gst_rtp_payload_info_for_name ()">gst_rtp_payload_info_for_name</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *media</code></em>,
47                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *encoding_name</code></em>);
48 const <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="returnvalue">GstRTPPayloadInfo</span></a> * <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#gst-rtp-payload-info-for-pt" title="gst_rtp_payload_info_for_pt ()">gst_rtp_payload_info_for_pt</a>   (<em class="parameter"><code><span class="type">guint8</span> payload_type</code></em>);
49 </pre>
50 </div>
51 <div class="refsect1">
52 <a name="gst-plugins-base-libs-gstrtppayloads.description"></a><h2>Description</h2>
53 <p>
54 </p>
55 <div class="refsect2">
56 <a name="idp8311104"></a><p>
57 The GstRTPPayloads helper functions makes it easy to deal with static and dynamic
58 payloads. Its main purpose is to retrieve properties such as the default clock-rate 
59 and get session bandwidth information.
60 </p>
61 </div>
62 <p>
63 </p>
64 <p>
65 Last reviewed on 2007-10-01 (0.10.15)
66 </p>
67 </div>
68 <div class="refsect1">
69 <a name="gst-plugins-base-libs-gstrtppayloads.details"></a><h2>Details</h2>
70 <div class="refsect2">
71 <a name="GstRTPPayload"></a><h3>enum GstRTPPayload</h3>
72 <pre class="programlisting">typedef enum {
73   /* Audio: */
74   GST_RTP_PAYLOAD_PCMU = 0,
75   GST_RTP_PAYLOAD_1016 = 1, /* RFC 3551 says reserved */
76   GST_RTP_PAYLOAD_G721 = 2, /* RFC 3551 says reserved */
77   GST_RTP_PAYLOAD_GSM = 3,
78   GST_RTP_PAYLOAD_G723 = 4,
79   GST_RTP_PAYLOAD_DVI4_8000 = 5,
80   GST_RTP_PAYLOAD_DVI4_16000 = 6,
81   GST_RTP_PAYLOAD_LPC = 7,
82   GST_RTP_PAYLOAD_PCMA = 8,
83   GST_RTP_PAYLOAD_G722 = 9,
84   GST_RTP_PAYLOAD_L16_STEREO = 10,
85   GST_RTP_PAYLOAD_L16_MONO = 11,
86   GST_RTP_PAYLOAD_QCELP = 12,
87   GST_RTP_PAYLOAD_CN = 13,
88   GST_RTP_PAYLOAD_MPA = 14,
89   GST_RTP_PAYLOAD_G728 = 15,
90   GST_RTP_PAYLOAD_DVI4_11025 = 16,
91   GST_RTP_PAYLOAD_DVI4_22050 = 17,
92   GST_RTP_PAYLOAD_G729 = 18,   
93
94   /* Video: */
95
96   GST_RTP_PAYLOAD_CELLB = 25,
97   GST_RTP_PAYLOAD_JPEG = 26,
98   GST_RTP_PAYLOAD_NV = 28,
99   GST_RTP_PAYLOAD_H261 = 31,
100   GST_RTP_PAYLOAD_MPV = 32,
101   GST_RTP_PAYLOAD_MP2T = 33,
102   GST_RTP_PAYLOAD_H263 = 34,
103
104   /* BOTH */
105 } GstRTPPayload;
106 </pre>
107 <p>
108 Standard predefined fixed payload types.
109 </p>
110 <p>
111 The official list is at:
112 http://www.iana.org/assignments/rtp-parameters
113 </p>
114 <p>
115 Audio:
116 reserved: 19
117 unassigned: 20-23, 
118 </p>
119 <p>
120 Video:
121 unassigned: 24, 27, 29, 30, 35-71, 77-95
122 Reserved for RTCP conflict avoidance: 72-76
123 </p>
124 <div class="variablelist"><table border="0">
125 <col align="left" valign="top">
126 <tbody>
127 <tr>
128 <td><p><a name="GST-RTP-PAYLOAD-PCMU:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_PCMU</code></span></p></td>
129 <td>ITU-T G.711. mu-law audio (RFC 3551)
130 </td>
131 </tr>
132 <tr>
133 <td><p><a name="GST-RTP-PAYLOAD-1016:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_1016</code></span></p></td>
134 <td>RFC 3551 says reserved
135 </td>
136 </tr>
137 <tr>
138 <td><p><a name="GST-RTP-PAYLOAD-G721:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_G721</code></span></p></td>
139 <td>RFC 3551 says reserved
140 </td>
141 </tr>
142 <tr>
143 <td><p><a name="GST-RTP-PAYLOAD-GSM:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_GSM</code></span></p></td>
144 <td>GSM audio
145 </td>
146 </tr>
147 <tr>
148 <td><p><a name="GST-RTP-PAYLOAD-G723:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_G723</code></span></p></td>
149 <td>ITU G.723.1 audio
150 </td>
151 </tr>
152 <tr>
153 <td><p><a name="GST-RTP-PAYLOAD-DVI4-8000:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_DVI4_8000</code></span></p></td>
154 <td>IMA ADPCM wave type (RFC 3551)
155 </td>
156 </tr>
157 <tr>
158 <td><p><a name="GST-RTP-PAYLOAD-DVI4-16000:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_DVI4_16000</code></span></p></td>
159 <td>IMA ADPCM wave type (RFC 3551)
160 </td>
161 </tr>
162 <tr>
163 <td><p><a name="GST-RTP-PAYLOAD-LPC:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_LPC</code></span></p></td>
164 <td>experimental linear predictive encoding
165 </td>
166 </tr>
167 <tr>
168 <td><p><a name="GST-RTP-PAYLOAD-PCMA:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_PCMA</code></span></p></td>
169 <td>ITU-T G.711 A-law audio (RFC 3551)
170 </td>
171 </tr>
172 <tr>
173 <td><p><a name="GST-RTP-PAYLOAD-G722:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_G722</code></span></p></td>
174 <td>ITU-T G.722 (RFC 3551)
175 </td>
176 </tr>
177 <tr>
178 <td><p><a name="GST-RTP-PAYLOAD-L16-STEREO:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_L16_STEREO</code></span></p></td>
179 <td>stereo PCM
180 </td>
181 </tr>
182 <tr>
183 <td><p><a name="GST-RTP-PAYLOAD-L16-MONO:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_L16_MONO</code></span></p></td>
184 <td>mono PCM
185 </td>
186 </tr>
187 <tr>
188 <td><p><a name="GST-RTP-PAYLOAD-QCELP:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_QCELP</code></span></p></td>
189 <td>EIA &amp; TIA standard IS-733
190 </td>
191 </tr>
192 <tr>
193 <td><p><a name="GST-RTP-PAYLOAD-CN:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_CN</code></span></p></td>
194 <td>Comfort Noise (RFC 3389)
195 </td>
196 </tr>
197 <tr>
198 <td><p><a name="GST-RTP-PAYLOAD-MPA:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_MPA</code></span></p></td>
199 <td>Audio MPEG 1-3.
200 </td>
201 </tr>
202 <tr>
203 <td><p><a name="GST-RTP-PAYLOAD-G728:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_G728</code></span></p></td>
204 <td>ITU-T G.728 Speech coder (RFC 3551)
205 </td>
206 </tr>
207 <tr>
208 <td><p><a name="GST-RTP-PAYLOAD-DVI4-11025:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_DVI4_11025</code></span></p></td>
209 <td>IMA ADPCM wave type (RFC 3551)
210 </td>
211 </tr>
212 <tr>
213 <td><p><a name="GST-RTP-PAYLOAD-DVI4-22050:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_DVI4_22050</code></span></p></td>
214 <td>IMA ADPCM wave type (RFC 3551)
215 </td>
216 </tr>
217 <tr>
218 <td><p><a name="GST-RTP-PAYLOAD-G729:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_G729</code></span></p></td>
219 <td>ITU-T G.729 Speech coder (RFC 3551)
220 </td>
221 </tr>
222 <tr>
223 <td><p><a name="GST-RTP-PAYLOAD-CELLB:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_CELLB</code></span></p></td>
224 <td>See RFC 2029
225 </td>
226 </tr>
227 <tr>
228 <td><p><a name="GST-RTP-PAYLOAD-JPEG:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_JPEG</code></span></p></td>
229 <td>ISO Standards 10918-1 and 10918-2 (RFC 2435)
230 </td>
231 </tr>
232 <tr>
233 <td><p><a name="GST-RTP-PAYLOAD-NV:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_NV</code></span></p></td>
234 <td>nv encoding by Ron Frederick
235 </td>
236 </tr>
237 <tr>
238 <td><p><a name="GST-RTP-PAYLOAD-H261:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_H261</code></span></p></td>
239 <td>ITU-T Recommendation H.261 (RFC 2032)
240 </td>
241 </tr>
242 <tr>
243 <td><p><a name="GST-RTP-PAYLOAD-MPV:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_MPV</code></span></p></td>
244 <td>Video MPEG 1 &amp; 2 (RFC 2250)
245 </td>
246 </tr>
247 <tr>
248 <td><p><a name="GST-RTP-PAYLOAD-MP2T:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_MP2T</code></span></p></td>
249 <td>MPEG-2 transport stream (RFC 2250)
250 </td>
251 </tr>
252 <tr>
253 <td><p><a name="GST-RTP-PAYLOAD-H263:CAPS"></a><span class="term"><code class="literal">GST_RTP_PAYLOAD_H263</code></span></p></td>
254 <td>Video H263 (RFC 2190)
255 </td>
256 </tr>
257 </tbody>
258 </table></div>
259 </div>
260 <hr>
261 <div class="refsect2">
262 <a name="GST-RTP-PAYLOAD-IS-DYNAMIC:CAPS"></a><h3>GST_RTP_PAYLOAD_IS_DYNAMIC()</h3>
263 <pre class="programlisting">#define GST_RTP_PAYLOAD_IS_DYNAMIC(pt) ((pt) &gt;= 96 &amp;&amp; (pt) &lt;= 127)
264 </pre>
265 <p>
266 Check if <em class="parameter"><code>pt</code></em> is a dynamic payload type.
267 </p>
268 <div class="variablelist"><table border="0">
269 <col align="left" valign="top">
270 <tbody><tr>
271 <td><p><span class="term"><em class="parameter"><code>pt</code></em> :</span></p></td>
272 <td>a payload type</td>
273 </tr></tbody>
274 </table></div>
275 </div>
276 <hr>
277 <div class="refsect2">
278 <a name="GstRTPPayloadInfo"></a><h3>struct GstRTPPayloadInfo</h3>
279 <pre class="programlisting">struct GstRTPPayloadInfo {
280   guint8       payload_type;
281   const gchar *media;
282   const gchar *encoding_name;
283   guint        clock_rate;
284   const gchar *encoding_parameters;
285   guint        bitrate;
286 };
287 </pre>
288 <p>
289 Structure holding default payload type information.
290 </p>
291 <div class="variablelist"><table border="0">
292 <col align="left" valign="top">
293 <tbody>
294 <tr>
295 <td><p><span class="term"><span class="type">guint8</span> <em class="structfield"><code><a name="GstRTPPayloadInfo.payload-type"></a>payload_type</code></em>;</span></p></td>
296 <td>payload type, -1 means dynamic</td>
297 </tr>
298 <tr>
299 <td><p><span class="term">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTPPayloadInfo.media"></a>media</code></em>;</span></p></td>
300 <td>the media type(s), usually "audio", "video", "application", "text",
301 "message".</td>
302 </tr>
303 <tr>
304 <td><p><span class="term">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTPPayloadInfo.encoding-name"></a>encoding_name</code></em>;</span></p></td>
305 <td>the encoding name of <em class="parameter"><code>pt</code></em>
306 </td>
307 </tr>
308 <tr>
309 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GstRTPPayloadInfo.clock-rate"></a>clock_rate</code></em>;</span></p></td>
310 <td>default clock rate, 0 = unknown/variable</td>
311 </tr>
312 <tr>
313 <td><p><span class="term">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GstRTPPayloadInfo.encoding-parameters"></a>encoding_parameters</code></em>;</span></p></td>
314 <td>encoding parameters. For audio this is the number of
315 channels. NULL = not applicable.</td>
316 </tr>
317 <tr>
318 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GstRTPPayloadInfo.bitrate"></a>bitrate</code></em>;</span></p></td>
319 <td>the bitrate of the media. 0 = unknown/variable.</td>
320 </tr>
321 </tbody>
322 </table></div>
323 </div>
324 <hr>
325 <div class="refsect2">
326 <a name="gst-rtp-payload-info-for-name"></a><h3>gst_rtp_payload_info_for_name ()</h3>
327 <pre class="programlisting">const <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="returnvalue">GstRTPPayloadInfo</span></a> * gst_rtp_payload_info_for_name (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *media</code></em>,
328                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *encoding_name</code></em>);</pre>
329 <p>
330 Get the <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="type">GstRTPPayloadInfo</span></a> for <em class="parameter"><code>media</code></em> and <em class="parameter"><code>encoding_name</code></em>. This function is
331 mostly used to get the default clock-rate and bandwidth for dynamic payload
332 types specified with <em class="parameter"><code>media</code></em> and <em class="parameter"><code>encoding</code></em> name.
333 </p>
334 <p>
335 The search for <em class="parameter"><code>encoding_name</code></em> will be performed in a case insensitve way.
336 </p>
337 <div class="variablelist"><table border="0">
338 <col align="left" valign="top">
339 <tbody>
340 <tr>
341 <td><p><span class="term"><em class="parameter"><code>media</code></em> :</span></p></td>
342 <td>the media to find</td>
343 </tr>
344 <tr>
345 <td><p><span class="term"><em class="parameter"><code>encoding_name</code></em> :</span></p></td>
346 <td>the encoding name to find</td>
347 </tr>
348 <tr>
349 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
350 <td>a <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="type">GstRTPPayloadInfo</span></a> or NULL when no info could be found.</td>
351 </tr>
352 </tbody>
353 </table></div>
354 </div>
355 <hr>
356 <div class="refsect2">
357 <a name="gst-rtp-payload-info-for-pt"></a><h3>gst_rtp_payload_info_for_pt ()</h3>
358 <pre class="programlisting">const <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="returnvalue">GstRTPPayloadInfo</span></a> * gst_rtp_payload_info_for_pt   (<em class="parameter"><code><span class="type">guint8</span> payload_type</code></em>);</pre>
359 <p>
360 Get the <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="type">GstRTPPayloadInfo</span></a> for <em class="parameter"><code>payload_type</code></em>. This function is
361 mostly used to get the default clock-rate and bandwidth for static payload
362 types specified with <em class="parameter"><code>payload_type</code></em>.
363 </p>
364 <div class="variablelist"><table border="0">
365 <col align="left" valign="top">
366 <tbody>
367 <tr>
368 <td><p><span class="term"><em class="parameter"><code>payload_type</code></em> :</span></p></td>
369 <td>the payload_type to find</td>
370 </tr>
371 <tr>
372 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
373 <td>a <a class="link" href="gst-plugins-base-libs-gstrtppayloads.html#GstRTPPayloadInfo" title="struct GstRTPPayloadInfo"><span class="type">GstRTPPayloadInfo</span></a> or NULL when no info could be found.</td>
374 </tr>
375 </tbody>
376 </table></div>
377 </div>
378 </div>
379 <div class="refsect1">
380 <a name="gst-plugins-base-libs-gstrtppayloads.see-also"></a><h2>See Also</h2>
381 gstrtpbuffer
382 </div>
383 </div>
384 <div class="footer">
385 <hr>
386           Generated by GTK-Doc V1.18</div>
387 </body>
388 </html>