/apidocs/echonest.audio.AudioRenderable-class.html

http://echo-nest-remix.googlecode.com/ · HTML · 327 lines · 283 code · 21 blank · 23 comment · 0 complexity · 7809c221517a1c8424d90a874cbcca83 MD5 · raw file

  1. <?xml version="1.0" encoding="ascii"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3. "DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  5. <head>
  6. <title>echonest.audio.AudioRenderable</title>
  7. <link rel="stylesheet" href="epydoc.css" type="text/css" />
  8. <script type="text/javascript" src="epydoc.js"></script>
  9. </head>
  10. <body bgcolor="white" text="black" link="blue" vlink="#204080"
  11. alink="#204080">
  12. <!-- ==================== NAVIGATION BAR ==================== -->
  13. <table class="navbar" border="0" width="100%" cellpadding="0"
  14. bgcolor="#a0c0ff" cellspacing="0">
  15. <tr valign="middle">
  16. <!-- Tree link -->
  17. <th>&nbsp;&nbsp;&nbsp;<a
  18. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  19. <!-- Index link -->
  20. <th>&nbsp;&nbsp;&nbsp;<a
  21. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  22. <!-- Help link -->
  23. <th>&nbsp;&nbsp;&nbsp;<a
  24. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  25. <!-- Project homepage -->
  26. <th class="navbar" align="right" width="100%">
  27. <table border="0" cellpadding="0" cellspacing="0">
  28. <tr><th class="navbar" align="center"
  29. ><a class="navbar" target="_top" href="http://code.google.com/p/echo-nest-remix/">Project Homepage</a></th>
  30. </tr></table></th>
  31. </tr>
  32. </table>
  33. <table width="100%" cellpadding="0" cellspacing="0">
  34. <tr valign="top">
  35. <td width="100%">
  36. <span class="breadcrumbs">
  37. <a href="echonest-module.html">Package&nbsp;echonest</a> ::
  38. <a href="echonest.audio-module.html">Module&nbsp;audio</a> ::
  39. Class&nbsp;AudioRenderable
  40. </span>
  41. </td>
  42. <td>
  43. <table cellpadding="0" cellspacing="0">
  44. <!-- hide/show private -->
  45. <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
  46. onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
  47. <tr><td align="right"><span class="options"
  48. >[<a href="frames.html" target="_top">frames</a
  49. >]&nbsp;|&nbsp;<a href="echonest.audio.AudioRenderable-class.html"
  50. target="_top">no&nbsp;frames</a>]</span></td></tr>
  51. </table>
  52. </td>
  53. </tr>
  54. </table>
  55. <!-- ==================== CLASS DESCRIPTION ==================== -->
  56. <h1 class="epydoc">Class AudioRenderable</h1><p class="nomargin-top"><span class="codelink"><a href="echonest.audio-pysrc.html#AudioRenderable">source&nbsp;code</a></span></p>
  57. <center>
  58. </center>
  59. <hr />
  60. <p>An object that gives an <a href="echonest.audio.AudioData-class.html" class="link">AudioData</a> in response to a call to its <code class="link">render</code>()
  61. method.
  62. Intended to be an abstract class that helps enforce the <a href="echonest.audio.AudioRenderable-class.html" class="link">AudioRenderable</a>
  63. protocol. Picked up a couple of convenience methods common to many descendants.</p>
  64. <p>Every <a href="echonest.audio.AudioRenderable-class.html" class="link">AudioRenderable</a> must provide three things:</p>
  65. <dl class="rst-docutils">
  66. <dt>render()</dt>
  67. <dd>A method returning the <a href="echonest.audio.AudioData-class.html" class="link">AudioData</a> for the object. The rhythmic duration (point
  68. at which any following audio is appended) is signified by the <code class="link">endindex</code> accessor,
  69. measured in samples.</dd>
  70. <dt>source</dt>
  71. <dd>An accessor pointing to the <a href="echonest.audio.AudioData-class.html" class="link">AudioData</a> that contains the original sample data of
  72. (a superset of) this audio object.</dd>
  73. <dt>duration</dt>
  74. <dd>An accessor returning the rhythmic duration (in seconds) of the audio object.</dd>
  75. </dl>
  76. <!-- ==================== INSTANCE METHODS ==================== -->
  77. <a name="section-InstanceMethods"></a>
  78. <table class="summary" border="1" cellpadding="3"
  79. cellspacing="0" width="100%" bgcolor="white">
  80. <tr bgcolor="#70b0f0" class="table-header">
  81. <td colspan="2" class="table-header">
  82. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  83. <tr valign="top">
  84. <td align="left"><span class="table-header">Instance Methods</span></td>
  85. <td align="right" valign="top"
  86. ><span class="options">[<a href="#section-InstanceMethods"
  87. class="privatelink" onclick="toggle_private();"
  88. >hide private</a>]</span></td>
  89. </tr>
  90. </table>
  91. </td>
  92. </tr>
  93. <tr>
  94. <td width="15%" align="right" valign="top" class="summary">
  95. <span class="summary-type">&nbsp;</span>
  96. </td><td class="summary">
  97. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  98. <tr>
  99. <td><span class="summary-sig"><a href="echonest.audio.AudioRenderable-class.html#resolve_source" class="summary-sig-name">resolve_source</a>(<span class="summary-sig-arg">self</span>,
  100. <span class="summary-sig-arg">alt</span>)</span><br />
  101. Given an alternative, fallback <code class="link">alt</code> source, return either <code class="link">self</code>'s
  102. source or the alternative.</td>
  103. <td align="right" valign="top">
  104. <span class="codelink"><a href="echonest.audio-pysrc.html#AudioRenderable.resolve_source">source&nbsp;code</a></span>
  105. </td>
  106. </tr>
  107. </table>
  108. </td>
  109. </tr>
  110. <tr>
  111. <td width="15%" align="right" valign="top" class="summary">
  112. <span class="summary-type">&nbsp;</span>
  113. </td><td class="summary">
  114. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  115. <tr>
  116. <td><span class="summary-sig"><a name="sources"></a><span class="summary-sig-name">sources</span>(<span class="summary-sig-arg">self</span>)</span></td>
  117. <td align="right" valign="top">
  118. <span class="codelink"><a href="echonest.audio-pysrc.html#AudioRenderable.sources">source&nbsp;code</a></span>
  119. </td>
  120. </tr>
  121. </table>
  122. </td>
  123. </tr>
  124. <tr>
  125. <td width="15%" align="right" valign="top" class="summary">
  126. <span class="summary-type">&nbsp;</span>
  127. </td><td class="summary">
  128. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  129. <tr>
  130. <td><span class="summary-sig"><a name="encode"></a><span class="summary-sig-name">encode</span>(<span class="summary-sig-arg">self</span>,
  131. <span class="summary-sig-arg">filename</span>)</span><br />
  132. Shortcut function that takes care of the need to obtain an <a href="echonest.audio.AudioData-class.html" class="link">AudioData</a>
  133. object first, through <code class="link">render</code>.</td>
  134. <td align="right" valign="top">
  135. <span class="codelink"><a href="echonest.audio-pysrc.html#AudioRenderable.encode">source&nbsp;code</a></span>
  136. </td>
  137. </tr>
  138. </table>
  139. </td>
  140. </tr>
  141. <tr>
  142. <td colspan="2" class="summary">
  143. <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
  144. <code>__delattr__</code>,
  145. <code>__format__</code>,
  146. <code>__getattribute__</code>,
  147. <code>__hash__</code>,
  148. <code>__init__</code>,
  149. <code>__new__</code>,
  150. <code>__reduce__</code>,
  151. <code>__reduce_ex__</code>,
  152. <code>__repr__</code>,
  153. <code>__setattr__</code>,
  154. <code>__sizeof__</code>,
  155. <code>__str__</code>,
  156. <code>__subclasshook__</code>
  157. </p>
  158. </td>
  159. </tr>
  160. </table>
  161. <!-- ==================== STATIC METHODS ==================== -->
  162. <a name="section-StaticMethods"></a>
  163. <table class="summary" border="1" cellpadding="3"
  164. cellspacing="0" width="100%" bgcolor="white">
  165. <tr bgcolor="#70b0f0" class="table-header">
  166. <td colspan="2" class="table-header">
  167. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  168. <tr valign="top">
  169. <td align="left"><span class="table-header">Static Methods</span></td>
  170. <td align="right" valign="top"
  171. ><span class="options">[<a href="#section-StaticMethods"
  172. class="privatelink" onclick="toggle_private();"
  173. >hide private</a>]</span></td>
  174. </tr>
  175. </table>
  176. </td>
  177. </tr>
  178. <tr>
  179. <td width="15%" align="right" valign="top" class="summary">
  180. <span class="summary-type">&nbsp;</span>
  181. </td><td class="summary">
  182. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  183. <tr>
  184. <td><span class="summary-sig"><a name="init_audio_data"></a><span class="summary-sig-name">init_audio_data</span>(<span class="summary-sig-arg">source</span>,
  185. <span class="summary-sig-arg">num_samples</span>)</span><br />
  186. Convenience function for rendering: return a pre-allocated, zeroed
  187. <a href="echonest.audio.AudioData-class.html" class="link">AudioData</a>.</td>
  188. <td align="right" valign="top">
  189. <span class="codelink"><a href="echonest.audio-pysrc.html#AudioRenderable.init_audio_data">source&nbsp;code</a></span>
  190. </td>
  191. </tr>
  192. </table>
  193. </td>
  194. </tr>
  195. </table>
  196. <!-- ==================== PROPERTIES ==================== -->
  197. <a name="section-Properties"></a>
  198. <table class="summary" border="1" cellpadding="3"
  199. cellspacing="0" width="100%" bgcolor="white">
  200. <tr bgcolor="#70b0f0" class="table-header">
  201. <td colspan="2" class="table-header">
  202. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  203. <tr valign="top">
  204. <td align="left"><span class="table-header">Properties</span></td>
  205. <td align="right" valign="top"
  206. ><span class="options">[<a href="#section-Properties"
  207. class="privatelink" onclick="toggle_private();"
  208. >hide private</a>]</span></td>
  209. </tr>
  210. </table>
  211. </td>
  212. </tr>
  213. <tr>
  214. <td colspan="2" class="summary">
  215. <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
  216. <code>__class__</code>
  217. </p>
  218. </td>
  219. </tr>
  220. </table>
  221. <!-- ==================== METHOD DETAILS ==================== -->
  222. <a name="section-MethodDetails"></a>
  223. <table class="details" border="1" cellpadding="3"
  224. cellspacing="0" width="100%" bgcolor="white">
  225. <tr bgcolor="#70b0f0" class="table-header">
  226. <td colspan="2" class="table-header">
  227. <table border="0" cellpadding="0" cellspacing="0" width="100%">
  228. <tr valign="top">
  229. <td align="left"><span class="table-header">Method Details</span></td>
  230. <td align="right" valign="top"
  231. ><span class="options">[<a href="#section-MethodDetails"
  232. class="privatelink" onclick="toggle_private();"
  233. >hide private</a>]</span></td>
  234. </tr>
  235. </table>
  236. </td>
  237. </tr>
  238. </table>
  239. <a name="resolve_source"></a>
  240. <div>
  241. <table class="details" border="1" cellpadding="3"
  242. cellspacing="0" width="100%" bgcolor="white">
  243. <tr><td>
  244. <table width="100%" cellpadding="0" cellspacing="0" border="0">
  245. <tr valign="top"><td>
  246. <h3 class="epydoc"><span class="sig"><span class="sig-name">resolve_source</span>(<span class="sig-arg">self</span>,
  247. <span class="sig-arg">alt</span>)</span>
  248. </h3>
  249. </td><td align="right" valign="top"
  250. ><span class="codelink"><a href="echonest.audio-pysrc.html#AudioRenderable.resolve_source">source&nbsp;code</a></span>&nbsp;
  251. </td>
  252. </tr></table>
  253. <p>Given an alternative, fallback <code class="link">alt</code> source, return either <code class="link">self</code>'s
  254. source or the alternative. Throw an informative error if no source
  255. is found.</p>
  256. <p>Utility code that ended up being replicated in several places, so
  257. it ended up here. Not necessary for use in the RenderableAudioObject
  258. protocol.</p>
  259. <dl class="fields">
  260. </dl>
  261. </td></tr></table>
  262. </div>
  263. <br />
  264. <!-- ==================== NAVIGATION BAR ==================== -->
  265. <table class="navbar" border="0" width="100%" cellpadding="0"
  266. bgcolor="#a0c0ff" cellspacing="0">
  267. <tr valign="middle">
  268. <!-- Tree link -->
  269. <th>&nbsp;&nbsp;&nbsp;<a
  270. href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  271. <!-- Index link -->
  272. <th>&nbsp;&nbsp;&nbsp;<a
  273. href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  274. <!-- Help link -->
  275. <th>&nbsp;&nbsp;&nbsp;<a
  276. href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  277. <!-- Project homepage -->
  278. <th class="navbar" align="right" width="100%">
  279. <table border="0" cellpadding="0" cellspacing="0">
  280. <tr><th class="navbar" align="center"
  281. ><a class="navbar" target="_top" href="http://code.google.com/p/echo-nest-remix/">Project Homepage</a></th>
  282. </tr></table></th>
  283. </tr>
  284. </table>
  285. <table border="0" cellpadding="0" cellspacing="0" width="100%%">
  286. <tr>
  287. <td align="left" class="footer">
  288. Generated by Epydoc 3.0.1 on Wed Sep 1 16:08:58 2010
  289. </td>
  290. <td align="right" class="footer">
  291. <a target="mainFrame" href="http://epydoc.sourceforge.net"
  292. >http://epydoc.sourceforge.net</a>
  293. </td>
  294. </tr>
  295. </table>
  296. <script type="text/javascript">
  297. <!--
  298. // Private objects are initially displayed (because if
  299. // javascript is turned off then we want them to be
  300. // visible); but by default, we want to hide them. So hide
  301. // them unless we have a cookie that says to show them.
  302. checkCookie();
  303. // -->
  304. </script>
  305. </body>
  306. </html>