<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- phonon-api.qdoc -->
<title>Qt 4.8: Path Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="phonon.html">Phonon</a></li>
<li>Path</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#related-non-members">Related Non-Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">Path Class Reference</h1>
<span class="small-subtitle">(Phonon::Path)<br/></span>
<!-- $$$Path-brief -->
<p>The Path class describes connections between media nodes. <a href="#details">More...</a></p>
<!-- @@@Path -->
<pre class="cpp"> <span class="preprocessor">#include <Phonon/Path></span></pre><p>This class was introduced in Qt 4.4.</p>
<ul>
<li><a href="phonon-path-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#Path">Path</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#Path-2">Path</a></b> ( const Path & <i>path</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#dtor.Path">~Path</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#disconnect">disconnect</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<Effect *> </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#effects">effects</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Effect * </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#insertEffect">insertEffect</a></b> ( const EffectDescription & <i>desc</i>, Effect * <i>insertBefore</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#insertEffect-2">insertEffect</a></b> ( Effect * <i>effect</i>, Effect * <i>insertBefore</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#isValid">isValid</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#reconnect">reconnect</a></b> ( MediaNode * <i>source</i>, MediaNode * <i>sink</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#removeEffect">removeEffect</a></b> ( Effect * <i>effect</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> MediaNode * </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#sink">sink</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> MediaNode * </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#source">source</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#operator-not-eq">operator!=</a></b> ( const Path & <i>p</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Path & </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#operator-eq">operator=</a></b> ( const Path & <i>p</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#operator-eq-eq">operator==</a></b> ( const Path & <i>p</i> ) const</td></tr>
</table>
<a name="related-non-members"></a>
<h2>Related Non-Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Path </td><td class="memItemRight bottomAlign"><b><a href="phonon-path.html#createPath">createPath</a></b> ( MediaNode * <i>source</i>, MediaNode * <i>sink</i> )</td></tr>
</table>
<a name="details"></a>
<!-- $$$Path-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The Path class describes connections between media nodes.</p>
<p>In a <a href="phonon-overview.html#building-graphs">media graph</a>, <a href="phonon-medianode.html">MediaNode</a>s are connected by Paths. The multimedia travels in streams over these paths.</p>
<p>You create a path between two media nodes using the static <a href="phonon-path.html#createPath">Phonon::createPath</a>() function, which takes two nodes as arguments. The first argument will send the media stream to the second. Please refer to the class description of the individual media nodes and the Phonon <a href="phonon-overview.html#phonon-overview">overview</a> to see which nodes can be connected to each other.</p>
<p>Paths are also used to insert audio <a href="phonon-effect.html">Effect</a>s between two media nodes. The effect will then alter the stream on the path. Notice that <a href="phonon-effect.html">Effect</a>s also are media nodes, but that <a href="phonon-path.html#insertEffect">insertEffect</a>() - instead of <a href="phonon-path.html#createPath">Phonon::createPath</a>() - is used to insert them into the media graph.</p>
<p>The following code example shows how to create a path between two media nodes and insert an effect on that path.</p>
<pre class="cpp"> MediaObject <span class="operator">*</span>media <span class="operator">=</span> <span class="keyword">new</span> MediaObject;
AudioOutput <span class="operator">*</span>output <span class="operator">=</span> <span class="keyword">new</span> AudioOutput(Phonon<span class="operator">::</span>MusicCategory);
Path path <span class="operator">=</span> Phonon<span class="operator">::</span>createPath(media<span class="operator">,</span> output);
Q_ASSERT(path<span class="operator">.</span>isValid()); <span class="comment">// for this simple case the path should always be</span>
<span class="comment">//valid - there are unit tests to ensure it</span>
<span class="comment">// insert an effect</span>
<span class="type"><a href="qlist.html">QList</a></span><span class="operator"><</span>EffectDescription<span class="operator">></span> effectList <span class="operator">=</span> BackendCapabilities<span class="operator">::</span>availableAudioEffects();
<span class="keyword">if</span> (<span class="operator">!</span>effectList<span class="operator">.</span>isEmpty()) {
Effect <span class="operator">*</span>effect <span class="operator">=</span> path<span class="operator">.</span>insertEffect(effectList<span class="operator">.</span>first());
}</pre>
</div>
<p><b>See also </b><a href="phonon-medianode.html">Phonon::MediaNode</a>, <a href="phonon-mediaobject.html">Phonon::MediaObject</a>, <a href="phonon-audiooutput.html">Phonon::AudioOutput</a>, <a href="phonon-videowidget.html">Phonon::VideoWidget</a>, and <a href="phonon-module.html">Phonon Module</a>.</p>
<!-- @@@Path -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$Path[overload1]$$$Path -->
<h3 class="fn"><a name="Path"></a>Path::<span class="name">Path</span> ()</h3>
<p>Creates an invalid path.</p>
<p>You can still make it a valid path by calling reconnect. It is recommended to use the <a href="phonon-path.html#createPath">Phonon::createPath</a>() function to create paths.</p>
<p><b>See also </b><a href="phonon-path.html#createPath">Phonon::createPath</a>() and <a href="phonon-path.html#isValid">isValid</a>().</p>
<!-- @@@Path -->
<!-- $$$Path$$$PathconstPath& -->
<h3 class="fn"><a name="Path-2"></a>Path::<span class="name">Path</span> ( const <span class="type">Path</span> & <i>path</i> )</h3>
<p>Constructs a copy of the other <i>path</i> specified.</p>
<p>This constructor is fast thanks to explicit sharing.</p>
<!-- @@@Path -->
<!-- $$$~Path[overload1]$$$~Path -->
<h3 class="fn"><a name="dtor.Path"></a>Path::<span class="name">~Path</span> ()</h3>
<p>Destroys this reference to the Path. If the path was valid the connection is not broken as both the source and the sink MediaNodes still keep a reference to the Path.</p>
<p><b>See also </b><a href="phonon-path.html#disconnect">disconnect</a>().</p>
<!-- @@@~Path -->
<!-- $$$disconnect[overload1]$$$disconnect -->
<h3 class="fn"><a name="disconnect"></a><span class="type">bool</span> Path::<span class="name">disconnect</span> ()</h3>
<p>Tries to disconnect the path from the MediaNodes it is connected to, returning true if successful or false if unsuccessful.</p>
<p>If successful, the path is invalidated: <a href="phonon-path.html#isValid">isValid</a>() will returns false.</p>
<!-- @@@disconnect -->
<!-- $$$effects[overload1]$$$effects -->
<h3 class="fn"><a name="effects"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="phonon-effect.html">Effect</a></span> *> Path::<span class="name">effects</span> () const</h3>
<p>Returns a list of Effect objects that are currently used as effects. The order in the list determines the order the signal is sent through the effects.</p>
<p>Returns A list with all current effects.</p>
<p><b>See also </b><a href="phonon-path.html#insertEffect">insertEffect</a>() and <a href="phonon-path.html#removeEffect">removeEffect</a>().</p>
<!-- @@@effects -->
<!-- $$$insertEffect[overload1]$$$insertEffectconstEffectDescription&Effect* -->
<h3 class="fn"><a name="insertEffect"></a><span class="type"><a href="phonon-effect.html">Effect</a></span> * Path::<span class="name">insertEffect</span> ( const <span class="type"><a href="phonon-objectdescription.html#EffectDescription-typedef">EffectDescription</a></span> & <i>desc</i>, <span class="type"><a href="phonon-effect.html">Effect</a></span> * <i>insertBefore</i> = 0 )</h3>
<p>Creates and inserts an effect into the path.</p>
<p>You may insert effects of the same class as often as you like, but if you insert the same object, the call will fail.</p>
<p><i>desc</i> is the <a href="phonon-objectdescription.html#EffectDescription-typedef">EffectDescription</a> object for the effect to be inserted.</p>
<p>If you already inserted an effect you can tell with <i>insertBefore</i> in which order the data gets processed. If this is <tt>0</tt> the effect is appended at the end of the processing list. If the effect has not been inserted before the method will do nothing and return <tt>false</tt>.</p>
<p>Returns a pointer to the effect object if it could be inserted at the specified position. If <tt>0</tt> is returned, the effect was not inserted.</p>
<p>Below is a code example for inserting an effect into a path:</p>
<pre class="cpp"> <span class="type"><a href="qlist.html">QList</a></span><span class="operator"><</span>Phonon<span class="operator">::</span>EffectDescription<span class="operator">></span> effectDescriptions <span class="operator">=</span>
Phonon<span class="operator">::</span>BackendCapabilities<span class="operator">::</span>availableAudioEffects();
Phonon<span class="operator">::</span>EffectDescription effectDescription <span class="operator">=</span> effectDescriptions<span class="operator">.</span>at(<span class="number">4</span>);
Phonon<span class="operator">::</span>Path path <span class="operator">=</span> Phonon<span class="operator">::</span>createPath(mediaObject<span class="operator">,</span> audioOutput);
Phonon<span class="operator">::</span>Effect <span class="operator">*</span>effect <span class="operator">=</span> <span class="keyword">new</span> Phonon<span class="operator">::</span>Effect(effectDescription);
path<span class="operator">.</span>insertEffect(effect);</pre>
<p><b>See also </b><a href="phonon-path.html#removeEffect">removeEffect</a>() and <a href="phonon-path.html#effects">effects</a>().</p>
<!-- @@@insertEffect -->
<!-- $$$insertEffect$$$insertEffectEffect*Effect* -->
<h3 class="fn"><a name="insertEffect-2"></a><span class="type">bool</span> Path::<span class="name">insertEffect</span> ( <span class="type"><a href="phonon-effect.html">Effect</a></span> * <i>effect</i>, <span class="type"><a href="phonon-effect.html">Effect</a></span> * <i>insertBefore</i> = 0 )</h3>
<p>Inserts the given <i>effect</i> into the path before the effect specified by <i>insertBefore</i> and returns true if successful; otherwise returns false.</p>
<p>If <i>insertBefore</i> is zero, the effect is appended to the processing list.</p>
<p>You may insert effects of the same class as often as you like, but if you insert the same object, the call will fail.</p>
<p><i>effect</i> will be inserted right before <i>insertBefore</i>. If <i>insertBefore</i> is <tt>0</tt>, the effect is appended at the end of the processing list. If the effect has not been inserted before the method will do nothing and return <tt>false</tt>.</p>
<p>Returns whether the effect could be inserted at the specified position. If <tt>false</tt> is returned the effect was not inserted.</p>
<p><b>See also </b><a href="phonon-path.html#removeEffect">removeEffect</a>() and <a href="phonon-path.html#effects">effects</a>().</p>
<!-- @@@insertEffect -->
<!-- $$$isValid[overload1]$$$isValid -->
<h3 class="fn"><a name="isValid"></a><span class="type">bool</span> Path::<span class="name">isValid</span> () const</h3>
<p>A path is considered valid if it is connected to two media nodes, in which case this function returns true. If it is connected to one or no media nodes, it is consider invalid, and this function will then return false.</p>
<!-- @@@isValid -->
<!-- $$$reconnect[overload1]$$$reconnectMediaNode*MediaNode* -->
<h3 class="fn"><a name="reconnect"></a><span class="type">bool</span> Path::<span class="name">reconnect</span> ( <span class="type"><a href="phonon-medianode.html">MediaNode</a></span> * <i>source</i>, <span class="type"><a href="phonon-medianode.html">MediaNode</a></span> * <i>sink</i> )</h3>
<p>Changes the media nodes the path is connected to by connecting the path to the <i>source</i> and <i>sink</i> nodes specified. Returns true if successful; otherwise returns false.</p>
<p>If unsuccessful, the path remains connected to the same nodes as before.</p>
<p><b>See also </b><a href="phonon-path.html#createPath">Phonon::createPath</a>() and <a href="phonon-overview.html#phonon-overview">Phonon Overview</a>.</p>
<!-- @@@reconnect -->
<!-- $$$removeEffect[overload1]$$$removeEffectEffect* -->
<h3 class="fn"><a name="removeEffect"></a><span class="type">bool</span> Path::<span class="name">removeEffect</span> ( <span class="type"><a href="phonon-effect.html">Effect</a></span> * <i>effect</i> )</h3>
<p>Removes the given <i>effect</i> from the path and returns true; otherwise returns false.</p>
<p>Removes an <i>effect</i> from the path.</p>
<p>If the effect is deleted while it is still connected, the effect will be removed automatically.</p>
<p><b>See also </b><a href="phonon-path.html#insertEffect">insertEffect</a>() and <a href="phonon-path.html#effects">effects</a>().</p>
<!-- @@@removeEffect -->
<!-- $$$sink[overload1]$$$sink -->
<h3 class="fn"><a name="sink"></a><span class="type"><a href="phonon-medianode.html">MediaNode</a></span> * Path::<span class="name">sink</span> () const</h3>
<p>Returns the sink <a href="phonon-medianode.html">MediaNode</a> used by the path.</p>
<!-- @@@sink -->
<!-- $$$source[overload1]$$$source -->
<h3 class="fn"><a name="source"></a><span class="type"><a href="phonon-medianode.html">MediaNode</a></span> * Path::<span class="name">source</span> () const</h3>
<p>Returns the source <a href="phonon-medianode.html">MediaNode</a> used by the path.</p>
<!-- @@@source -->
<!-- $$$operator!=[overload1]$$$operator!=constPath& -->
<h3 class="fn"><a name="operator-not-eq"></a><span class="type">bool</span> Path::<span class="name">operator!=</span> ( const <span class="type">Path</span> & <i>p</i> ) const</h3>
<p>Returns true if this Path is not equal to <i>p</i>; otherwise returns false.</p>
<!-- @@@operator!= -->
<!-- $$$operator=[overload1]$$$operator=constPath& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">Path</span> & Path::<span class="name">operator=</span> ( const <span class="type">Path</span> & <i>p</i> )</h3>
<p>Assigns <i>p</i> to this Path and returns a reference to this Path.</p>
<p>This operation is fast thanks to explicit sharing.</p>
<!-- @@@operator= -->
<!-- $$$operator==[overload1]$$$operator==constPath& -->
<h3 class="fn"><a name="operator-eq-eq"></a><span class="type">bool</span> Path::<span class="name">operator==</span> ( const <span class="type">Path</span> & <i>p</i> ) const</h3>
<p>Returns true if this Path is equal to <i>p</i>; otherwise returns false;</p>
<!-- @@@operator== -->
</div>
<div class="relnonmem">
<h2>Related Non-Members</h2>
<!-- $$$createPath[overload1]$$$createPathMediaNode*MediaNode* -->
<h3 class="fn"><a name="createPath"></a><span class="type">Path</span> Phonon::<span class="name">createPath</span> ( <span class="type"><a href="phonon-medianode.html">MediaNode</a></span> * <i>source</i>, <span class="type"><a href="phonon-medianode.html">MediaNode</a></span> * <i>sink</i> )</h3>
<p>Creates a new Path connecting the two MediaNodes <i>source</i> and <i>sink</i>.</p>
<p>The implementation will automatically select the right format and media type. E.g. connecting a <a href="phonon-mediaobject.html">MediaObject</a> and <a href="phonon-audiooutput.html">AudioOutput</a> will create a Path object connecting the audio. This might be represented as PCM or perhaps even AC3 depending on the <a href="phonon-audiooutput.html">AudioOutput</a> object.</p>
<p><i>source</i> The <a href="phonon-medianode.html">MediaNode</a> to connect an output from <i>sink</i> The <a href="phonon-medianode.html">MediaNode</a> to connect to.</p>
<!-- @@@createPath -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Digia, Qt and their respective logos are trademarks of Digia Plc
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
