<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>gstrtsptransport</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="GStreamer Base Plugins 0.10 Library Reference Manual">
<link rel="up" href="gstreamer-rtsp.html" title="RTSP Library">
<link rel="prev" href="gst-plugins-base-libs-gstrtsprange.html" title="gstrtsprange">
<link rel="next" href="gst-plugins-base-libs-gstrtspurl.html" title="gstrtspurl">
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gstreamer-plugins-base.html" title="Part I. GStreamer Base Plugins Libraries">
<link rel="chapter" href="gstreamer-audio.html" title="Audio Library">
<link rel="chapter" href="gstreamer-cdda.html" title="CDDA Library">
<link rel="chapter" href="gstreamer-ffft.html" title="FFT Library">
<link rel="chapter" href="gstreamer-floatcast.html" title="FloatCast Library">
<link rel="chapter" href="gstreamer-interfaces.html" title="Interfaces Library">
<link rel="chapter" href="gstreamer-netbuffer.html" title="Network Buffer Library">
<link rel="chapter" href="gstreamer-riff.html" title="Riff Media Library">
<link rel="chapter" href="gstreamer-rtp.html" title="RTP Library">
<link rel="chapter" href="gstreamer-rtsp.html" title="RTSP Library">
<link rel="chapter" href="gstreamer-sdp.html" title="SDP Library">
<link rel="chapter" href="gstreamer-tag.html" title="Tag Support Library">
<link rel="chapter" href="gstreamer-base-utils.html" title="Base Utils Library">
<link rel="chapter" href="gstreamer-video.html" title="Video Library">
<link rel="part" href="gstreamer-libs-hierarchy.html" title="Part II. Object Hierarchy">
<link rel="index" href="api-index.html" title="Index">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gst-plugins-base-libs-gstrtsprange.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="gstreamer-rtsp.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GStreamer Base Plugins 0.10 Library Reference Manual</th>
<td><a accesskey="n" href="gst-plugins-base-libs-gstrtspurl.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2704955" class="shortcut">Top</a>
 | 
<a href="#id2705202" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="gst-plugins-base-libs-gstrtsptransport"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2704955"></a><span class="refentrytitle">gstrtsptransport</span>
</h2>
<p>gstrtsptransport — dealing with RTSP transports</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gst/rtsp/gstrtsptransport.h>
enum <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode">GstRTSPTransMode</a>;
enum <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPProfile">GstRTSPProfile</a>;
enum <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPLowerTrans">GstRTSPLowerTrans</a>;
<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a>;
<a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-new">gst_rtsp_transport_new</a> (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> **transport);
<a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-init">gst_rtsp_transport_init</a> (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);
<a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-parse">gst_rtsp_transport_parse</a> (const gchar *str,
<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);
gchar* <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-as-text">gst_rtsp_transport_as_text</a> (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);
<a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-get-mime">gst_rtsp_transport_get_mime</a> (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode">GstRTSPTransMode</a> trans,
const gchar **mime);
<a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-get-manager">gst_rtsp_transport_get_manager</a> (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode">GstRTSPTransMode</a> trans,
const gchar **manager,
guint option);
<a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-free">gst_rtsp_transport_free</a> (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2705202"></a><h2>Description</h2>
<p>
</p>
<div class="refsect2" lang="en">
<a name="id2705214"></a><p>
Provides helper functions to deal with RTSP transport strings.
</p>
</div>
<p>
Last reviewed on 2007-07-25 (0.10.14)</p>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2705227"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2705238"></a><h3>
<a name="GstRTSPTransMode"></a>enum GstRTSPTransMode</h3>
<a class="indexterm" name="id2705251"></a><pre class="programlisting">typedef enum {
GST_RTSP_TRANS_UNKNOWN = 0,
GST_RTSP_TRANS_RTP = (1 << 0),
GST_RTSP_TRANS_RDT = (1 << 1)
} GstRTSPTransMode;
</pre>
<p>
The transfer mode to use.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><a name="GST-RTSP-TRANS-UNKNOWN:CAPS"></a><code class="literal">GST_RTSP_TRANS_UNKNOWN</code></span></td>
<td> invalid tansport mode
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-TRANS-RTP:CAPS"></a><code class="literal">GST_RTSP_TRANS_RTP</code></span></td>
<td> transfer RTP data
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-TRANS-RDT:CAPS"></a><code class="literal">GST_RTSP_TRANS_RDT</code></span></td>
<td> transfer RDT (RealMedia) data
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705345"></a><h3>
<a name="GstRTSPProfile"></a>enum GstRTSPProfile</h3>
<a class="indexterm" name="id2705358"></a><pre class="programlisting">typedef enum {
GST_RTSP_PROFILE_UNKNOWN = 0,
GST_RTSP_PROFILE_AVP = (1 << 0),
GST_RTSP_PROFILE_SAVP = (1 << 1)
} GstRTSPProfile;
</pre>
<p>
The transfer profile to use.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><a name="GST-RTSP-PROFILE-UNKNOWN:CAPS"></a><code class="literal">GST_RTSP_PROFILE_UNKNOWN</code></span></td>
<td> invalid profile
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-PROFILE-AVP:CAPS"></a><code class="literal">GST_RTSP_PROFILE_AVP</code></span></td>
<td> the Audio/Visual profile
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-PROFILE-SAVP:CAPS"></a><code class="literal">GST_RTSP_PROFILE_SAVP</code></span></td>
<td> the secure Audio/Visual profile
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705452"></a><h3>
<a name="GstRTSPLowerTrans"></a>enum GstRTSPLowerTrans</h3>
<a class="indexterm" name="id2705466"></a><pre class="programlisting">typedef enum {
GST_RTSP_LOWER_TRANS_UNKNOWN = 0,
GST_RTSP_LOWER_TRANS_UDP = (1 << 0),
GST_RTSP_LOWER_TRANS_UDP_MCAST = (1 << 1),
GST_RTSP_LOWER_TRANS_TCP = (1 << 2)
} GstRTSPLowerTrans;
</pre>
<p>
The different transport methods.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><a name="GST-RTSP-LOWER-TRANS-UNKNOWN:CAPS"></a><code class="literal">GST_RTSP_LOWER_TRANS_UNKNOWN</code></span></td>
<td> invalid transport flag
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-LOWER-TRANS-UDP:CAPS"></a><code class="literal">GST_RTSP_LOWER_TRANS_UDP</code></span></td>
<td> stream data over UDP
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-LOWER-TRANS-UDP-MCAST:CAPS"></a><code class="literal">GST_RTSP_LOWER_TRANS_UDP_MCAST</code></span></td>
<td> stream data over UDP multicast
</td>
</tr>
<tr>
<td><span class="term"><a name="GST-RTSP-LOWER-TRANS-TCP:CAPS"></a><code class="literal">GST_RTSP_LOWER_TRANS_TCP</code></span></td>
<td> stream data over TCP
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705589"></a><h3>
<a name="GstRTSPTransport"></a>GstRTSPTransport</h3>
<a class="indexterm" name="id2705602"></a><pre class="programlisting">typedef struct {
} GstRTSPTransport;
</pre>
<p>
A structure holding the RTSP transport values.</p>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705622"></a><h3>
<a name="gst-rtsp-transport-new"></a>gst_rtsp_transport_new ()</h3>
<a class="indexterm" name="id2705634"></a><pre class="programlisting"><a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> gst_rtsp_transport_new (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> **transport);</pre>
<p>
Allocate a new initialized <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>. Use <a href="gst-plugins-base-libs-gstrtsptransport.html#gst-rtsp-transport-free"><code class="function">gst_rtsp_transport_free()</code></a>
after usage.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>transport</code></em> :</span></td>
<td> location to hold the new <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult"><span class="type">GstRTSPResult</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705732"></a><h3>
<a name="gst-rtsp-transport-init"></a>gst_rtsp_transport_init ()</h3>
<a class="indexterm" name="id2705745"></a><pre class="programlisting"><a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> gst_rtsp_transport_init (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);</pre>
<p>
Initialize <em class="parameter"><code>transport</code></em> so that it can be used.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>transport</code></em> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705829"></a><h3>
<a name="gst-rtsp-transport-parse"></a>gst_rtsp_transport_parse ()</h3>
<a class="indexterm" name="id2705842"></a><pre class="programlisting"><a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> gst_rtsp_transport_parse (const gchar *str,
<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);</pre>
<p>
Parse the RTSP transport string <em class="parameter"><code>str</code></em> into <em class="parameter"><code>transport</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>str</code></em> :</span></td>
<td> a transport string
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>transport</code></em> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult"><span class="type">GstRTSPResult</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2705952"></a><h3>
<a name="gst-rtsp-transport-as-text"></a>gst_rtsp_transport_as_text ()</h3>
<a class="indexterm" name="id2705966"></a><pre class="programlisting">gchar* gst_rtsp_transport_as_text (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);</pre>
<p>
Convert <em class="parameter"><code>transport</code></em> into a string that can be used to signal the transport in
an RTSP SETUP response.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>transport</code></em> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a string describing the RTSP transport or <span class="type">NULL</span> when the transport
is invalid.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2706050"></a><h3>
<a name="gst-rtsp-transport-get-mime"></a>gst_rtsp_transport_get_mime ()</h3>
<a class="indexterm" name="id2706063"></a><pre class="programlisting"><a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> gst_rtsp_transport_get_mime (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode">GstRTSPTransMode</a> trans,
const gchar **mime);</pre>
<p>
Get the mime type of the transport mode <em class="parameter"><code>trans</code></em>. This mime type is typically
used to generate <span class="type">GstCaps</span> on buffers.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>trans</code></em> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>mime</code></em> :</span></td>
<td> location to hold the result
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2706177"></a><h3>
<a name="gst-rtsp-transport-get-manager"></a>gst_rtsp_transport_get_manager ()</h3>
<a class="indexterm" name="id2706191"></a><pre class="programlisting"><a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> gst_rtsp_transport_get_manager (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode">GstRTSPTransMode</a> trans,
const gchar **manager,
guint option);</pre>
<p>
Get the <span class="type">GStreamer</span> element that can handle the buffers transported over
<em class="parameter"><code>trans</code></em>.
</p>
<p>
It is possible that there are several managers available, use <em class="parameter"><code>option</code></em> to
selected one.
</p>
<p>
<em class="parameter"><code>manager</code></em> will contain an element name or <span class="type">NULL</span> when no manager is
needed/available for <em class="parameter"><code>trans</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>trans</code></em> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransMode"><span class="type">GstRTSPTransMode</span></a>
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>manager</code></em> :</span></td>
<td> location to hold the result
</td>
</tr>
<tr>
<td><span class="term"><em class="parameter"><code>option</code></em> :</span></td>
<td> option index.
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2706362"></a><h3>
<a name="gst-rtsp-transport-free"></a>gst_rtsp_transport_free ()</h3>
<a class="indexterm" name="id2706375"></a><pre class="programlisting"><a href="gst-plugins-base-libs-gstrtspdefs.html#GstRTSPResult">GstRTSPResult</a> gst_rtsp_transport_free (<a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport">GstRTSPTransport</a> *transport);</pre>
<p>
Free the memory used by <em class="parameter"><code>transport</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><span class="term"><em class="parameter"><code>transport</code></em> :</span></td>
<td> a <a href="gst-plugins-base-libs-gstrtsptransport.html#GstRTSPTransport"><span class="type">GstRTSPTransport</span></a>
</td>
</tr>
<tr>
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a href="gst-plugins-base-libs-gstrtspdefs.html#GST-RTSP-OK:CAPS"><span class="type">GST_RTSP_OK</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>
