<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>libqtpod: IPod Class Reference</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> <link href="tabs.css" rel="stylesheet" type="text/css"> </head><body> <!-- Generated by Doxygen 1.5.0 --> <div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li id="current"><a href="annotated.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> <li><a href="dirs.html"><span>Directories</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="examples.html"><span>Examples</span></a></li> </ul></div> <div class="tabs"> <ul> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul></div> <h1>IPod Class Reference</h1><!-- doxytag: class="IPod" --><code>#include <<a class="el" href="ipod_8h-source.html">ipod.h</a>></code> <p> <a href="classIPod-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0"> <tr><td></td></tr> <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#944cb57e977d63739c0a9a2c16fd91e2">IPod</a> (const QString &ipodBase)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new <a class="el" href="classIPod.html">IPod</a> instance for an iPod at the given path. Does not actually read the contents - you need to open it with <code><a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open()</a></code>. <a href="#944cb57e977d63739c0a9a2c16fd91e2"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#60499c52af5d2b4f0b76b160016849d9">~IPod</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The destructor. <a href="#60499c52af5d2b4f0b76b160016849d9"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Tries to open an ipod. <a href="#6d6612bc70103af89dbc27edd34edf64"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#6ac470ca94bb9df5a5c6a3dffada1d6a">initialize</a> (const QString &title)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Initializes this ipod by creating the nessessary directories and files. <a href="#6ac470ca94bb9df5a5c6a3dffada1d6a"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#2f70e5ff3b4bb22e4a21b5f76251ad03">isOpen</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if <a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open()</a> was called successfully for this instance. <a href="#2f70e5ff3b4bb22e4a21b5f76251ad03"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#3fc1b2019e66e3d41acef40d70687c21">isStillConnected</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the ipod represented by this instance is still connected to the system. <a href="#3fc1b2019e66e3d41acef40d70687c21"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#3b77722dac51de6d95a5695b0997fff3">close</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Clears all data we got from this instance whether or not it was changed. <a href="#3b77722dac51de6d95a5695b0997fff3"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#e6e6df531b006e41e16cdd0aba67c6d6">getName</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the name of the iPod. <a href="#e6e6df531b006e41e16cdd0aba67c6d6"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#3dea1b9dad993200a08eb539a00dd935">setName</a> (const QString &name)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the name of the iPod. <a href="#3dea1b9dad993200a08eb539a00dd935"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">const QString & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#88b80013d943d6e6d938dfb23b96fb92">getItunesDBError</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the error occured during read or write. <a href="#88b80013d943d6e6d938dfb23b96fb92"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#f6177c16a95f20e7a84ec42139e45b9a">getSysInfo</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> for this <a class="el" href="classIPod.html">IPod</a> instance (const). <a href="#f6177c16a95f20e7a84ec42139e45b9a"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#03d158b1ad0ce81b10e7daed3277ab59">getSysInfo</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> for this <a class="el" href="classIPod.html">IPod</a> instance. <a href="#03d158b1ad0ce81b10e7daed3277ab59"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classITunesDB.html">ITunesDB</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#ee70fa59f2afc0d4639750820180347a">getITunesDB</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classITunesDB.html">ITunesDB</a> for this iPod (const). <a href="#ee70fa59f2afc0d4639750820180347a"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classITunesDB.html">ITunesDB</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#22bca31b67cf1a37547767006662e483">getITunesDB</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classITunesDB.html">ITunesDB</a> for this iPod. <a href="#22bca31b67cf1a37547767006662e483"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#7c087e156b40e2bb2faee7460f29673e">synchronize</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Writes back all the changed data to the device. <a href="#7c087e156b40e2bb2faee7460f29673e"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#c019f428dc3818caf1db1fd3a4b7bb50">isDirty</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if this instances data differ somehow from the original. <a href="#c019f428dc3818caf1db1fd3a4b7bb50"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#f75f7dddcd33cc793fede045d63d5a7d">lock</a> (bool write_lock)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Lock control functions to prevent concurrent access to the iPod from different programs. <a href="#f75f7dddcd33cc793fede045d63d5a7d"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#ab5bc7cbb787e2f9736e1c2b180aa86c">isLocked</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns true if the iPod got locked. <a href="#ab5bc7cbb787e2f9736e1c2b180aa86c"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#e7ac2c3b199628315f492f3242d6b0e1">unlock</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">unlock an iPod previously locked <a href="#e7ac2c3b199628315f492f3242d6b0e1"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">const QString & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#69a728fd6ce3667c9a7a744d1a061205">getBasePath</a> () const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the base path of the iPod. <a href="#69a728fd6ce3667c9a7a744d1a061205"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="50c4805a17417934c6fdc1eb6de14c73"></a><!-- doxytag: member="IPod::hasPodcasts" ref="50c4805a17417934c6fdc1eb6de14c73" args="()" --> bool </td><td class="memItemRight" valign="bottom"><b>hasPodcasts</b> ()</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#62502bdaedf04cdb9176a1b7e63852bd">findNewTrackPathInfo</a> (Q_UINT32 id, const QString &fileExtension=QString::null)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#4dfc83e205af13e4c823b4af062c712b">getFileForPathInfo</a> (QString pathinfo) const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the fully qualified path for the given ipod path information. <a href="#4dfc83e205af13e4c823b4af062c712b"></a><br></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">QStringList & </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#9eeb00f938946a95f30efbeb3fda2d83">findUnreferencedMusicFiles</a> (QStringList &list) const</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Finds all the files in the Music folders that don't have a track record. <a href="#9eeb00f938946a95f30efbeb3fda2d83"></a><br></td></tr> <tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">static QString </td><td class="memItemRight" valign="bottom"><a class="el" href="classIPod.html#630d7616c80b5ab01501a046858bb60e">createDistinctIPodName</a> (const <a class="el" href="classIPod.html">IPod</a> &ipod) __attribute__((deprecated))</td></tr> <tr><td colspan="2"><br><h2>Protected Attributes</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="957f4590310e42d2570d319c5f8a3020"></a><!-- doxytag: member="IPod::m_ipodBase" ref="957f4590310e42d2570d319c5f8a3020" args="" --> QString </td><td class="memItemRight" valign="bottom"><b>m_ipodBase</b></td></tr> </table> <hr><a name="_details"></a><h2>Detailed Description</h2> This class represents all functionalities to access and modify information about the iPod/itunesDB<p> <dl class="author" compact><dt><b>Author:</b></dt><dd>Michael Schulze </dd></dl> <dl compact><dt><b>Examples: </b></dt><dd> <p> <a class="el" href="listtests_8cpp-example.html#_a28">listtests.cpp</a>, and <a class="el" href="listtrackstest_8cpp-example.html#_a0">listtrackstest.cpp</a>.</dl> <p> <hr><h2>Constructor & Destructor Documentation</h2> <a class="anchor" name="944cb57e977d63739c0a9a2c16fd91e2"></a><!-- doxytag: member="IPod::IPod" ref="944cb57e977d63739c0a9a2c16fd91e2" args="(const QString &ipodBase)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">IPod::IPod </td> <td>(</td> <td class="paramtype">const QString & </td> <td class="paramname"> <em>ipodBase</em> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Constructs a new <a class="el" href="classIPod.html">IPod</a> instance for an iPod at the given path. Does not actually read the contents - you need to open it with <code><a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open()</a></code>. <p> </div> </div><p> <a class="anchor" name="60499c52af5d2b4f0b76b160016849d9"></a><!-- doxytag: member="IPod::~IPod" ref="60499c52af5d2b4f0b76b160016849d9" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">IPod::~IPod </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"><code> [virtual]</code></td> </tr> </table> </div> <div class="memdoc"> <p> The destructor. <p> </div> </div><p> <hr><h2>Member Function Documentation</h2> <a class="anchor" name="6d6612bc70103af89dbc27edd34edf64"></a><!-- doxytag: member="IPod::open" ref="6d6612bc70103af89dbc27edd34edf64" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool IPod::open </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Tries to open an ipod. <p> That means reading all important information from the device. <dl class="return" compact><dt><b>Returns:</b></dt><dd>true if successful, otherwise false </dd></dl> </div> </div><p> <a class="anchor" name="6ac470ca94bb9df5a5c6a3dffada1d6a"></a><!-- doxytag: member="IPod::initialize" ref="6ac470ca94bb9df5a5c6a3dffada1d6a" args="(const QString &title)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void IPod::initialize </td> <td>(</td> <td class="paramtype">const QString & </td> <td class="paramname"> <em>title</em> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Initializes this ipod by creating the nessessary directories and files. <p> This <a class="el" href="classIPod.html">IPod</a> instance then contains the information about the initialized ipod - no need to call <a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open()</a> afterwards. </div> </div><p> <a class="anchor" name="2f70e5ff3b4bb22e4a21b5f76251ad03"></a><!-- doxytag: member="IPod::isOpen" ref="2f70e5ff3b4bb22e4a21b5f76251ad03" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool IPod::isOpen </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Returns true if <a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open()</a> was called successfully for this instance. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>true if <a class="el" href="classIPod.html#6d6612bc70103af89dbc27edd34edf64">open()</a> was called successfully for this instance. </dd></dl> </div> </div><p> <a class="anchor" name="3fc1b2019e66e3d41acef40d70687c21"></a><!-- doxytag: member="IPod::isStillConnected" ref="3fc1b2019e66e3d41acef40d70687c21" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool IPod::isStillConnected </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Returns true if the ipod represented by this instance is still connected to the system. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the ipod represented by this instance is still connected to the system false otherwise </dd></dl> </div> </div><p> <a class="anchor" name="3b77722dac51de6d95a5695b0997fff3"></a><!-- doxytag: member="IPod::close" ref="3b77722dac51de6d95a5695b0997fff3" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void IPod::close </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Clears all data we got from this instance whether or not it was changed. <p> Resets the state of this instance. <dl compact><dt><b>Examples: </b></dt><dd> <a class="el" href="listtests_8cpp-example.html#a33">listtests.cpp</a>, and <a class="el" href="listtrackstest_8cpp-example.html#a9">listtrackstest.cpp</a>.</dl> </div> </div><p> <a class="anchor" name="e6e6df531b006e41e16cdd0aba67c6d6"></a><!-- doxytag: member="IPod::getName" ref="e6e6df531b006e41e16cdd0aba67c6d6" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">QString IPod::getName </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Returns the name of the iPod. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the name of the iPod as set in the device details </dd></dl> <dl compact><dt><b>Examples: </b></dt><dd> <a class="el" href="listtests_8cpp-example.html#a30">listtests.cpp</a>.</dl> </div> </div><p> <a class="anchor" name="3dea1b9dad993200a08eb539a00dd935"></a><!-- doxytag: member="IPod::setName" ref="3dea1b9dad993200a08eb539a00dd935" args="(const QString &name)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void IPod::setName </td> <td>(</td> <td class="paramtype">const QString & </td> <td class="paramname"> <em>name</em> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Sets the name of the iPod. <p> When the iPod is not opened (<a class="el" href="classIPod.html#2f70e5ff3b4bb22e4a21b5f76251ad03">isOpen()</a> == false) nothing is changed <dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>the new name for the iPod </td></tr> </table> </dl> </div> </div><p> <a class="anchor" name="88b80013d943d6e6d938dfb23b96fb92"></a><!-- doxytag: member="IPod::getItunesDBError" ref="88b80013d943d6e6d938dfb23b96fb92" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const QString & IPod::getItunesDBError </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Returns the error occured during read or write. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the error occured during read or write </dd></dl> </div> </div><p> <a class="anchor" name="f6177c16a95f20e7a84ec42139e45b9a"></a><!-- doxytag: member="IPod::getSysInfo" ref="f6177c16a95f20e7a84ec42139e45b9a" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> & IPod::getSysInfo </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Returns the <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> for this <a class="el" href="classIPod.html">IPod</a> instance (const). <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> for this <a class="el" href="classIPod.html">IPod</a> instance. </dd></dl> </div> </div><p> <a class="anchor" name="03d158b1ad0ce81b10e7daed3277ab59"></a><!-- doxytag: member="IPod::getSysInfo" ref="03d158b1ad0ce81b10e7daed3277ab59" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> & IPod::getSysInfo </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Returns the <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> for this <a class="el" href="classIPod.html">IPod</a> instance. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classIPodSysInfo.html">IPodSysInfo</a> for this <a class="el" href="classIPod.html">IPod</a> instance. </dd></dl> </div> </div><p> <a class="anchor" name="ee70fa59f2afc0d4639750820180347a"></a><!-- doxytag: member="IPod::getITunesDB" ref="ee70fa59f2afc0d4639750820180347a" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const <a class="el" href="classITunesDB.html">ITunesDB</a> & IPod::getITunesDB </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Returns the <a class="el" href="classITunesDB.html">ITunesDB</a> for this iPod (const). <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classITunesDB.html">ITunesDB</a> for this iPod. </dd></dl> <dl compact><dt><b>Examples: </b></dt><dd> <a class="el" href="listtests_8cpp-example.html#a29">listtests.cpp</a>, and <a class="el" href="listtrackstest_8cpp-example.html#a2">listtrackstest.cpp</a>.</dl> </div> </div><p> <a class="anchor" name="22bca31b67cf1a37547767006662e483"></a><!-- doxytag: member="IPod::getITunesDB" ref="22bca31b67cf1a37547767006662e483" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classITunesDB.html">ITunesDB</a> & IPod::getITunesDB </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Returns the <a class="el" href="classITunesDB.html">ITunesDB</a> for this iPod. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the <a class="el" href="classITunesDB.html">ITunesDB</a> for this iPod. </dd></dl> </div> </div><p> <a class="anchor" name="7c087e156b40e2bb2faee7460f29673e"></a><!-- doxytag: member="IPod::synchronize" ref="7c087e156b40e2bb2faee7460f29673e" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void IPod::synchronize </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Writes back all the changed data to the device. <p> This only includes control structures like the iTunesDB and DeviceInfo data. </div> </div><p> <a class="anchor" name="c019f428dc3818caf1db1fd3a4b7bb50"></a><!-- doxytag: member="IPod::isDirty" ref="c019f428dc3818caf1db1fd3a4b7bb50" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool IPod::isDirty </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const<code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Returns true if this instances data differ somehow from the original. <p> data from the iPod and need to be synchronized. <dl compact><dt><b>Examples: </b></dt><dd> <a class="el" href="listtests_8cpp-example.html#a31">listtests.cpp</a>.</dl> </div> </div><p> <a class="anchor" name="f75f7dddcd33cc793fede045d63d5a7d"></a><!-- doxytag: member="IPod::lock" ref="f75f7dddcd33cc793fede045d63d5a7d" args="(bool write_lock)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void IPod::lock </td> <td>(</td> <td class="paramtype">bool </td> <td class="paramname"> <em>write_lock</em> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Lock control functions to prevent concurrent access to the iPod from different programs. <p> locks the iPod <dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>write_lock</em> </td><td>if true the ipod will be locked exclusively </td></tr> </table> </dl> <dl class="attention" compact><dt><b>Attention:</b></dt><dd>not implemented for win32 </dd></dl> </div> </div><p> <a class="anchor" name="ab5bc7cbb787e2f9736e1c2b180aa86c"></a><!-- doxytag: member="IPod::isLocked" ref="ab5bc7cbb787e2f9736e1c2b180aa86c" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool IPod::isLocked </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> Returns true if the iPod got locked. <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the iPod got locked </dd></dl> </div> </div><p> <a class="anchor" name="e7ac2c3b199628315f492f3242d6b0e1"></a><!-- doxytag: member="IPod::unlock" ref="e7ac2c3b199628315f492f3242d6b0e1" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void IPod::unlock </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"></td> </tr> </table> </div> <div class="memdoc"> <p> unlock an iPod previously locked <p> </div> </div><p> <a class="anchor" name="69a728fd6ce3667c9a7a744d1a061205"></a><!-- doxytag: member="IPod::getBasePath" ref="69a728fd6ce3667c9a7a744d1a061205" args="() const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const QString& IPod::getBasePath </td> <td>(</td> <td class="paramname"> </td> <td> ) </td> <td width="100%"> const<code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p> Returns the base path of the iPod. <p> (i.e. "/media/ipod" on linux or "E:" on a windows machine) <dl class="return" compact><dt><b>Returns:</b></dt><dd>the base path of the iPod </dd></dl> </div> </div><p> <a class="anchor" name="630d7616c80b5ab01501a046858bb60e"></a><!-- doxytag: member="IPod::createDistinctIPodName" ref="630d7616c80b5ab01501a046858bb60e" args="(const IPod &ipod) __attribute__((deprecated))" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">QString IPod::createDistinctIPodName </td> <td>(</td> <td class="paramtype">const <a class="el" href="classIPod.html">IPod</a> & </td> <td class="paramname"> <em>ipod</em> </td> <td> ) </td> <td width="100%"><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p> This method creates a string containing the ipod base path encoded being distinct between different iPods simultanously connected to the system. Most users wont need this method - it's here as a relict from the old ipodslave code and may go away in the future <dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000001">Deprecated:</a></b></dt><dd>this method doesn't belong here </dd></dl> </div> </div><p> <a class="anchor" name="62502bdaedf04cdb9176a1b7e63852bd"></a><!-- doxytag: member="IPod::findNewTrackPathInfo" ref="62502bdaedf04cdb9176a1b7e63852bd" args="(Q_UINT32 id, const QString &fileExtension=QString::null)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">QString IPod::findNewTrackPathInfo </td> <td>(</td> <td class="paramtype">Q_UINT32 </td> <td class="paramname"> <em>id</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const QString & </td> <td class="paramname"> <em>fileExtension</em> = <code>QString::null</code></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td width="100%"><code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p> finds the first track filename for the given trackid. the track filename will be formed like<br> kpod[decimal encoded ID]<br> the file extension needs to be added later </div> </div><p> <a class="anchor" name="4dfc83e205af13e4c823b4af062c712b"></a><!-- doxytag: member="IPod::getFileForPathInfo" ref="4dfc83e205af13e4c823b4af062c712b" args="(QString pathinfo) const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">QString IPod::getFileForPathInfo </td> <td>(</td> <td class="paramtype">QString </td> <td class="paramname"> <em>pathinfo</em> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Returns the fully qualified path for the given ipod path information. <p> Translates the pathinfo stored on the ipod to a real path info and adds the ipodBase path so we can access the real file. The caller needs to check if the file actually exists. <dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>pathinfo</em> </td><td>the path property in database items </td></tr> </table> </dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the path pointing to the file. </dd></dl> </div> </div><p> <a class="anchor" name="9eeb00f938946a95f30efbeb3fda2d83"></a><!-- doxytag: member="IPod::findUnreferencedMusicFiles" ref="9eeb00f938946a95f30efbeb3fda2d83" args="(QStringList &list) const" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">QStringList & IPod::findUnreferencedMusicFiles </td> <td>(</td> <td class="paramtype">QStringList & </td> <td class="paramname"> <em>list</em> </td> <td> ) </td> <td width="100%"> const</td> </tr> </table> </div> <div class="memdoc"> <p> Finds all the files in the Music folders that don't have a track record. <p> The fully qualified pathes will be added to the given list. <dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>list</em> </td><td>the list to add the unreferences files to </td></tr> </table> </dl> <dl class="return" compact><dt><b>Returns:</b></dt><dd>the reference to the given list </dd></dl> </div> </div><p> <hr>The documentation for this class was generated from the following files:<ul> <li>libqtpod/src/<a class="el" href="ipod_8h-source.html">ipod.h</a><li>libqtpod/src/ipod.cpp</ul> <hr size="1"><address style="align: right;"><small>Generated on Wed Dec 19 00:15:19 2007 for libqtpod by <a href="http://www.doxygen.org/index.html"> <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.0 </small></address> </body> </html>