view code-doc/vamp_8h-source.html @ 34:4b4db9230e94 website

* wiki configuration and pages in svn
author cannam
date Wed, 23 Sep 2009 15:09:53 +0000
parents cc0be37dc9d3
children 0976232e353b
line wrap: on
line source
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>VampPluginSDK: vamp.h Source File</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.6 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="dirs.html"><span>Directories</span></a></li>
    </ul>
  </div>
  <div class="navpath"><a class="el" href="dir_b086eb10f854304ab96fb3af468374a7.html">vamp</a>
  </div>
</div>
<div class="contents">
<h1>vamp.h</h1><a href="vamp_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */</span>
<a name="l00002"></a>00002 
<a name="l00003"></a>00003 <span class="comment">/*</span>
<a name="l00004"></a>00004 <span class="comment">    Vamp</span>
<a name="l00005"></a>00005 <span class="comment"></span>
<a name="l00006"></a>00006 <span class="comment">    An API for audio analysis and feature extraction plugins.</span>
<a name="l00007"></a>00007 <span class="comment"></span>
<a name="l00008"></a>00008 <span class="comment">    Centre for Digital Music, Queen Mary, University of London.</span>
<a name="l00009"></a>00009 <span class="comment">    Copyright 2006 Chris Cannam.</span>
<a name="l00010"></a>00010 <span class="comment">  </span>
<a name="l00011"></a>00011 <span class="comment">    Permission is hereby granted, free of charge, to any person</span>
<a name="l00012"></a>00012 <span class="comment">    obtaining a copy of this software and associated documentation</span>
<a name="l00013"></a>00013 <span class="comment">    files (the "Software"), to deal in the Software without</span>
<a name="l00014"></a>00014 <span class="comment">    restriction, including without limitation the rights to use, copy,</span>
<a name="l00015"></a>00015 <span class="comment">    modify, merge, publish, distribute, sublicense, and/or sell copies</span>
<a name="l00016"></a>00016 <span class="comment">    of the Software, and to permit persons to whom the Software is</span>
<a name="l00017"></a>00017 <span class="comment">    furnished to do so, subject to the following conditions:</span>
<a name="l00018"></a>00018 <span class="comment"></span>
<a name="l00019"></a>00019 <span class="comment">    The above copyright notice and this permission notice shall be</span>
<a name="l00020"></a>00020 <span class="comment">    included in all copies or substantial portions of the Software.</span>
<a name="l00021"></a>00021 <span class="comment"></span>
<a name="l00022"></a>00022 <span class="comment">    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,</span>
<a name="l00023"></a>00023 <span class="comment">    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF</span>
<a name="l00024"></a>00024 <span class="comment">    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND</span>
<a name="l00025"></a>00025 <span class="comment">    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR</span>
<a name="l00026"></a>00026 <span class="comment">    ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF</span>
<a name="l00027"></a>00027 <span class="comment">    CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION</span>
<a name="l00028"></a>00028 <span class="comment">    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</span>
<a name="l00029"></a>00029 <span class="comment"></span>
<a name="l00030"></a>00030 <span class="comment">    Except as contained in this notice, the names of the Centre for</span>
<a name="l00031"></a>00031 <span class="comment">    Digital Music; Queen Mary, University of London; and Chris Cannam</span>
<a name="l00032"></a>00032 <span class="comment">    shall not be used in advertising or otherwise to promote the sale,</span>
<a name="l00033"></a>00033 <span class="comment">    use or other dealings in this Software without prior written</span>
<a name="l00034"></a>00034 <span class="comment">    authorization.</span>
<a name="l00035"></a>00035 <span class="comment">*/</span>
<a name="l00036"></a>00036 
<a name="l00037"></a>00037 <span class="preprocessor">#ifndef VAMP_HEADER_INCLUDED</span>
<a name="l00038"></a>00038 <span class="preprocessor"></span><span class="preprocessor">#define VAMP_HEADER_INCLUDED</span>
<a name="l00039"></a>00039 <span class="preprocessor"></span>
<a name="l00040"></a>00040 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00041"></a>00041 <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {
<a name="l00042"></a>00042 <span class="preprocessor">#endif</span>
<a name="l00043"></a>00043 <span class="preprocessor"></span>
<a name="l00053"></a><a class="code" href="vamp_8h.html#6d6c8c755dbabf161f72712e0e2143c7">00053</a> <span class="preprocessor">#define VAMP_API_VERSION 2</span>
<a name="l00054"></a>00054 <span class="preprocessor"></span>
<a name="l00071"></a><a class="code" href="struct__VampParameterDescriptor.html">00071</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="struct__VampParameterDescriptor.html" title="C language API for Vamp plugins.">_VampParameterDescriptor</a>
<a name="l00072"></a>00072 {
<a name="l00074"></a><a class="code" href="struct__VampParameterDescriptor.html#26d74afd6a3341a673f15955031845ab">00074</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampParameterDescriptor.html#26d74afd6a3341a673f15955031845ab" title="Computer-usable name of the parameter.">identifier</a>;
<a name="l00075"></a>00075 
<a name="l00077"></a><a class="code" href="struct__VampParameterDescriptor.html#bba810bce9656f6002777f6c3f655957">00077</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampParameterDescriptor.html#bba810bce9656f6002777f6c3f655957" title="Human-readable name of the parameter.">name</a>;
<a name="l00078"></a>00078 
<a name="l00080"></a><a class="code" href="struct__VampParameterDescriptor.html#95489272d6cf5a5b487e949da8e4fac6">00080</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampParameterDescriptor.html#95489272d6cf5a5b487e949da8e4fac6" title="Human-readable short text about the parameter.">description</a>;
<a name="l00081"></a>00081 
<a name="l00083"></a><a class="code" href="struct__VampParameterDescriptor.html#8ca235f816b56dc99125e010eee08fc7">00083</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampParameterDescriptor.html#8ca235f816b56dc99125e010eee08fc7" title="Human-readable unit of the parameter.">unit</a>;
<a name="l00084"></a>00084 
<a name="l00086"></a><a class="code" href="struct__VampParameterDescriptor.html#b59c84f0bbe0d4d0c578d893c087b0db">00086</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampParameterDescriptor.html#b59c84f0bbe0d4d0c578d893c087b0db" title="Minimum value.">minValue</a>;
<a name="l00087"></a>00087 
<a name="l00089"></a><a class="code" href="struct__VampParameterDescriptor.html#6e7646babdb265c4abfc107ba4350d80">00089</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampParameterDescriptor.html#6e7646babdb265c4abfc107ba4350d80" title="Maximum value.">maxValue</a>;
<a name="l00090"></a>00090 
<a name="l00092"></a><a class="code" href="struct__VampParameterDescriptor.html#3d37f986ee152ab55feb9902b35f7aca">00092</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampParameterDescriptor.html#3d37f986ee152ab55feb9902b35f7aca" title="Default value.">defaultValue</a>;
<a name="l00093"></a>00093 
<a name="l00095"></a><a class="code" href="struct__VampParameterDescriptor.html#3f41e3b6b69c7a95ff0ce8625794f83a">00095</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampParameterDescriptor.html#3f41e3b6b69c7a95ff0ce8625794f83a" title="1 if parameter values are quantized to a particular resolution.">isQuantized</a>;
<a name="l00096"></a>00096 
<a name="l00098"></a><a class="code" href="struct__VampParameterDescriptor.html#68c91fd3fc0b0b3617c2d343fe32d0e5">00098</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampParameterDescriptor.html#68c91fd3fc0b0b3617c2d343fe32d0e5" title="Quantization resolution, if isQuantized.">quantizeStep</a>;
<a name="l00099"></a>00099 
<a name="l00101"></a><a class="code" href="struct__VampParameterDescriptor.html#188883325ab1e4a898e3dc53a8f88f9d">00101</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> **<a class="code" href="struct__VampParameterDescriptor.html#188883325ab1e4a898e3dc53a8f88f9d" title="Human-readable names of the values, if isQuantized.">valueNames</a>;
<a name="l00102"></a>00102 
<a name="l00103"></a>00103 } <a class="code" href="struct__VampParameterDescriptor.html" title="C language API for Vamp plugins.">VampParameterDescriptor</a>;
<a name="l00104"></a>00104 
<a name="l00105"></a><a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821">00105</a> <span class="keyword">typedef</span> <span class="keyword">enum</span>
<a name="l00106"></a>00106 {
<a name="l00108"></a><a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821b546deafd57f175fb1e7f9cbea1c5113">00108</a>     <a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821b546deafd57f175fb1e7f9cbea1c5113" title="Each process call returns results aligned with call&amp;#39;s block start.">vampOneSamplePerStep</a>,
<a name="l00109"></a>00109 
<a name="l00111"></a><a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821afc8a05f722bc83ecce227e12e838cf8">00111</a>     <a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821afc8a05f722bc83ecce227e12e838cf8" title="Returned results are evenly spaced at samplerate specified below.">vampFixedSampleRate</a>,
<a name="l00112"></a>00112 
<a name="l00114"></a><a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821bae8a21a9e30eb73e16d6abc6c7415e8">00114</a>     <a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821bae8a21a9e30eb73e16d6abc6c7415e8" title="Returned results have their own individual timestamps.">vampVariableSampleRate</a>
<a name="l00115"></a>00115 
<a name="l00116"></a>00116 } <a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821">VampSampleType</a>;
<a name="l00117"></a>00117 
<a name="l00118"></a><a class="code" href="struct__VampOutputDescriptor.html">00118</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="struct__VampOutputDescriptor.html">_VampOutputDescriptor</a>
<a name="l00119"></a>00119 {
<a name="l00121"></a><a class="code" href="struct__VampOutputDescriptor.html#461161b2010370176115967e4f58a5f5">00121</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampOutputDescriptor.html#461161b2010370176115967e4f58a5f5" title="Computer-usable name of the output.">identifier</a>;
<a name="l00122"></a>00122 
<a name="l00124"></a><a class="code" href="struct__VampOutputDescriptor.html#f4fca576bd47167fd2bf9b43d588815f">00124</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampOutputDescriptor.html#f4fca576bd47167fd2bf9b43d588815f" title="Human-readable name of the output.">name</a>;
<a name="l00125"></a>00125 
<a name="l00127"></a><a class="code" href="struct__VampOutputDescriptor.html#bfa911b138cfb80cf63e8f2e0fa0fb89">00127</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampOutputDescriptor.html#bfa911b138cfb80cf63e8f2e0fa0fb89" title="Human-readable short text about the output.">description</a>;
<a name="l00128"></a>00128 
<a name="l00130"></a><a class="code" href="struct__VampOutputDescriptor.html#d038caa8e596dfd037035637202f1d63">00130</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampOutputDescriptor.html#d038caa8e596dfd037035637202f1d63" title="Human-readable name of the unit of the output.">unit</a>;
<a name="l00131"></a>00131 
<a name="l00133"></a><a class="code" href="struct__VampOutputDescriptor.html#e8571f5a2bc740738af0cb7dda0c4749">00133</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampOutputDescriptor.html#e8571f5a2bc740738af0cb7dda0c4749" title="1 if output has equal number of values for each returned result.">hasFixedBinCount</a>;
<a name="l00134"></a>00134 
<a name="l00136"></a><a class="code" href="struct__VampOutputDescriptor.html#652ee422092720e44d23d98bdb68f978">00136</a>     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="struct__VampOutputDescriptor.html#652ee422092720e44d23d98bdb68f978" title="Number of values per result, if hasFixedBinCount.">binCount</a>;
<a name="l00137"></a>00137 
<a name="l00139"></a><a class="code" href="struct__VampOutputDescriptor.html#10fffaa32bd894843ff7592240dfe447">00139</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> **<a class="code" href="struct__VampOutputDescriptor.html#10fffaa32bd894843ff7592240dfe447" title="Names of returned value bins, if hasFixedBinCount.">binNames</a>;
<a name="l00140"></a>00140 
<a name="l00142"></a><a class="code" href="struct__VampOutputDescriptor.html#f6b512d772023b4e852216689c1c4465">00142</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampOutputDescriptor.html#f6b512d772023b4e852216689c1c4465" title="1 if each returned value falls within the same fixed min/max range.">hasKnownExtents</a>;
<a name="l00143"></a>00143     
<a name="l00145"></a><a class="code" href="struct__VampOutputDescriptor.html#9a28180989e3d028c12a98517479dc46">00145</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampOutputDescriptor.html#9a28180989e3d028c12a98517479dc46" title="Minimum value for a returned result in any bin, if hasKnownExtents.">minValue</a>;
<a name="l00146"></a>00146 
<a name="l00148"></a><a class="code" href="struct__VampOutputDescriptor.html#4cbe540a247df60f85b00b2aa16461ee">00148</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampOutputDescriptor.html#4cbe540a247df60f85b00b2aa16461ee" title="Maximum value for a returned result in any bin, if hasKnownExtents.">maxValue</a>;
<a name="l00149"></a>00149 
<a name="l00151"></a><a class="code" href="struct__VampOutputDescriptor.html#b56cf0bbb17136819024574d5cc65e30">00151</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampOutputDescriptor.html#b56cf0bbb17136819024574d5cc65e30" title="1 if returned results are quantized to a particular resolution.">isQuantized</a>;
<a name="l00152"></a>00152 
<a name="l00154"></a><a class="code" href="struct__VampOutputDescriptor.html#71aa40222dda4321030cccd0bb655fe3">00154</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampOutputDescriptor.html#71aa40222dda4321030cccd0bb655fe3" title="Quantization resolution for returned results, if isQuantized.">quantizeStep</a>;
<a name="l00155"></a>00155 
<a name="l00157"></a><a class="code" href="struct__VampOutputDescriptor.html#5da1d27cc99badc214640e859b882072">00157</a>     <a class="code" href="vamp_8h.html#a24a8cee023d8b7659d25cbe0584b821">VampSampleType</a> <a class="code" href="struct__VampOutputDescriptor.html#5da1d27cc99badc214640e859b882072" title="Time positioning method for returned results (see VampSampleType).">sampleType</a>;
<a name="l00158"></a>00158 
<a name="l00161"></a><a class="code" href="struct__VampOutputDescriptor.html#1ccf193317b2b9c2eb0dbd8dcf61d26e">00161</a>     <span class="keywordtype">float</span> <a class="code" href="struct__VampOutputDescriptor.html#1ccf193317b2b9c2eb0dbd8dcf61d26e" title="Sample rate of returned results, if sampleType is vampFixedSampleRate.">sampleRate</a>;
<a name="l00162"></a>00162 
<a name="l00170"></a><a class="code" href="struct__VampOutputDescriptor.html#f792a96dbf292ec966b9b68250febd99">00170</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampOutputDescriptor.html#f792a96dbf292ec966b9b68250febd99" title="1 if the returned results for this output are known to have a duration field.">hasDuration</a>;
<a name="l00171"></a>00171 
<a name="l00172"></a>00172 } <a class="code" href="struct__VampOutputDescriptor.html">VampOutputDescriptor</a>;
<a name="l00173"></a>00173 
<a name="l00174"></a><a class="code" href="struct__VampFeature.html">00174</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="struct__VampFeature.html">_VampFeature</a>
<a name="l00175"></a>00175 {
<a name="l00177"></a><a class="code" href="struct__VampFeature.html#be6aa7a08185beeb9deca2d08d99859f">00177</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampFeature.html#be6aa7a08185beeb9deca2d08d99859f" title="1 if the feature has a timestamp (i.e.">hasTimestamp</a>;
<a name="l00178"></a>00178 
<a name="l00180"></a><a class="code" href="struct__VampFeature.html#31f0b57050e33d082692536097953d9c">00180</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampFeature.html#31f0b57050e33d082692536097953d9c" title="Seconds component of timestamp.">sec</a>;
<a name="l00181"></a>00181 
<a name="l00183"></a><a class="code" href="struct__VampFeature.html#8874cb23600c6b10ca6e8a40920d999e">00183</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampFeature.html#8874cb23600c6b10ca6e8a40920d999e" title="Nanoseconds component of timestamp.">nsec</a>;
<a name="l00184"></a>00184 
<a name="l00186"></a><a class="code" href="struct__VampFeature.html#b1ce7c8a2b489e9b0694a967497a29fd">00186</a>     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="struct__VampFeature.html#b1ce7c8a2b489e9b0694a967497a29fd" title="Number of values.">valueCount</a>;
<a name="l00187"></a>00187 
<a name="l00189"></a><a class="code" href="struct__VampFeature.html#e4030f941ddb2bab8bc147b88e1f1c15">00189</a>     <span class="keywordtype">float</span> *<a class="code" href="struct__VampFeature.html#e4030f941ddb2bab8bc147b88e1f1c15" title="Values for this returned sample.">values</a>;
<a name="l00190"></a>00190 
<a name="l00192"></a><a class="code" href="struct__VampFeature.html#6662b7489a7890cae713bf4e8f6d52cd">00192</a>     <span class="keywordtype">char</span> *<a class="code" href="struct__VampFeature.html#6662b7489a7890cae713bf4e8f6d52cd" title="Label for this returned sample.">label</a>;
<a name="l00193"></a>00193 
<a name="l00194"></a>00194 } <a class="code" href="struct__VampFeature.html">VampFeature</a>;
<a name="l00195"></a>00195 
<a name="l00196"></a><a class="code" href="struct__VampFeatureV2.html">00196</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="struct__VampFeatureV2.html">_VampFeatureV2</a>
<a name="l00197"></a>00197 {
<a name="l00199"></a><a class="code" href="struct__VampFeatureV2.html#44d9c57f1ae197d3fec1a48c650cce81">00199</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampFeatureV2.html#44d9c57f1ae197d3fec1a48c650cce81" title="1 if the feature has a duration.">hasDuration</a>;
<a name="l00200"></a>00200 
<a name="l00202"></a><a class="code" href="struct__VampFeatureV2.html#bc95aac3a2efdef6ef0b17e7b6bd3daf">00202</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampFeatureV2.html#bc95aac3a2efdef6ef0b17e7b6bd3daf" title="Seconds component of duratiion.">durationSec</a>;
<a name="l00203"></a>00203 
<a name="l00205"></a><a class="code" href="struct__VampFeatureV2.html#f71693d907f69048d602d28edbce679e">00205</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampFeatureV2.html#f71693d907f69048d602d28edbce679e" title="Nanoseconds component of duration.">durationNsec</a>;
<a name="l00206"></a>00206 
<a name="l00207"></a>00207 } <a class="code" href="struct__VampFeatureV2.html">VampFeatureV2</a>;
<a name="l00208"></a>00208 
<a name="l00209"></a><a class="code" href="union__VampFeatureUnion.html">00209</a> <span class="keyword">typedef</span> <span class="keyword">union </span><a class="code" href="union__VampFeatureUnion.html">_VampFeatureUnion</a>
<a name="l00210"></a>00210 {
<a name="l00211"></a>00211     <span class="comment">// sizeof(featureV1) &gt;= sizeof(featureV2) for backward compatibility</span>
<a name="l00212"></a><a class="code" href="union__VampFeatureUnion.html#4a32a2ce141ec3cd36b8be54cd9c3369">00212</a>     <a class="code" href="struct__VampFeature.html">VampFeature</a>   <a class="code" href="union__VampFeatureUnion.html#4a32a2ce141ec3cd36b8be54cd9c3369">v1</a>;
<a name="l00213"></a><a class="code" href="union__VampFeatureUnion.html#87e508e37e02cce11c3c4ddf087a627a">00213</a>     <a class="code" href="struct__VampFeatureV2.html">VampFeatureV2</a> <a class="code" href="union__VampFeatureUnion.html#87e508e37e02cce11c3c4ddf087a627a">v2</a>;
<a name="l00214"></a>00214 
<a name="l00215"></a>00215 } <a class="code" href="union__VampFeatureUnion.html">VampFeatureUnion</a>;
<a name="l00216"></a>00216 
<a name="l00217"></a><a class="code" href="struct__VampFeatureList.html">00217</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="struct__VampFeatureList.html">_VampFeatureList</a>
<a name="l00218"></a>00218 {
<a name="l00220"></a><a class="code" href="struct__VampFeatureList.html#01db33a31ae5e04a4bd097f4b6aa75f1">00220</a>     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="struct__VampFeatureList.html#01db33a31ae5e04a4bd097f4b6aa75f1" title="Number of features in this feature list.">featureCount</a>;
<a name="l00221"></a>00221 
<a name="l00235"></a><a class="code" href="struct__VampFeatureList.html#103c817094643ac5ff4410768f4f92a7">00235</a>     <a class="code" href="union__VampFeatureUnion.html">VampFeatureUnion</a> *<a class="code" href="struct__VampFeatureList.html#103c817094643ac5ff4410768f4f92a7" title="Features in this feature list.">features</a>;
<a name="l00236"></a>00236 
<a name="l00237"></a>00237 } <a class="code" href="struct__VampFeatureList.html">VampFeatureList</a>;
<a name="l00238"></a>00238 
<a name="l00239"></a><a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765">00239</a> <span class="keyword">typedef</span> <span class="keyword">enum</span>
<a name="l00240"></a>00240 {
<a name="l00241"></a><a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765e3dbb77ff3e8f292966fd3748888e1a1">00241</a>     <a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765e3dbb77ff3e8f292966fd3748888e1a1">vampTimeDomain</a>,
<a name="l00242"></a><a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765ee0c1c0d429276f071b8c0730b7bd87d">00242</a>     <a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765ee0c1c0d429276f071b8c0730b7bd87d">vampFrequencyDomain</a>
<a name="l00243"></a>00243 
<a name="l00244"></a>00244 } <a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765">VampInputDomain</a>;
<a name="l00245"></a>00245 
<a name="l00246"></a><a class="code" href="vamp_8h.html#d3be2952b1f4ad7d775940a6db75c79b">00246</a> <span class="keyword">typedef</span> <span class="keywordtype">void</span> *<a class="code" href="vamp_8h.html#d3be2952b1f4ad7d775940a6db75c79b">VampPluginHandle</a>;
<a name="l00247"></a>00247 
<a name="l00248"></a><a class="code" href="struct__VampPluginDescriptor.html">00248</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="struct__VampPluginDescriptor.html">_VampPluginDescriptor</a>
<a name="l00249"></a>00249 {
<a name="l00251"></a><a class="code" href="struct__VampPluginDescriptor.html#b6c87760e87ddaa9ac3491bccaaa28c2">00251</a>     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="struct__VampPluginDescriptor.html#b6c87760e87ddaa9ac3491bccaaa28c2" title="API version with which this descriptor is compatible.">vampApiVersion</a>;
<a name="l00252"></a>00252 
<a name="l00254"></a><a class="code" href="struct__VampPluginDescriptor.html#4915ec8276749cb505c01d25a6d02219">00254</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampPluginDescriptor.html#4915ec8276749cb505c01d25a6d02219" title="Computer-usable name of the plugin.">identifier</a>;
<a name="l00255"></a>00255 
<a name="l00257"></a><a class="code" href="struct__VampPluginDescriptor.html#9dd5a0190e4d453ff36b5acb7000b150">00257</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampPluginDescriptor.html#9dd5a0190e4d453ff36b5acb7000b150" title="Human-readable name of the plugin.">name</a>;
<a name="l00258"></a>00258 
<a name="l00260"></a><a class="code" href="struct__VampPluginDescriptor.html#9ff8050f92f1a04a68bb34a9d368295e">00260</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampPluginDescriptor.html#9ff8050f92f1a04a68bb34a9d368295e" title="Human-readable short text about the plugin.">description</a>;
<a name="l00261"></a>00261 
<a name="l00263"></a><a class="code" href="struct__VampPluginDescriptor.html#4dca3d57331802964716edfa80580c9b">00263</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampPluginDescriptor.html#4dca3d57331802964716edfa80580c9b" title="Human-readable name of plugin&amp;#39;s author or vendor.">maker</a>;
<a name="l00264"></a>00264 
<a name="l00266"></a><a class="code" href="struct__VampPluginDescriptor.html#04427c420d9252c7796c0bf5101345ae">00266</a>     <span class="keywordtype">int</span> <a class="code" href="struct__VampPluginDescriptor.html#04427c420d9252c7796c0bf5101345ae" title="Version number of the plugin.">pluginVersion</a>;
<a name="l00267"></a>00267 
<a name="l00269"></a><a class="code" href="struct__VampPluginDescriptor.html#e704bba384af0de056a26da1b13ee521">00269</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="struct__VampPluginDescriptor.html#e704bba384af0de056a26da1b13ee521" title="Human-readable summary of copyright or licensing for plugin.">copyright</a>;
<a name="l00270"></a>00270 
<a name="l00272"></a><a class="code" href="struct__VampPluginDescriptor.html#e6271dc3ea0cea959c84a64185492cab">00272</a>     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="struct__VampPluginDescriptor.html#e6271dc3ea0cea959c84a64185492cab" title="Number of parameter inputs.">parameterCount</a>;
<a name="l00273"></a>00273 
<a name="l00275"></a><a class="code" href="struct__VampPluginDescriptor.html#64d614862604c31d6b84c49005f51913">00275</a>     <span class="keyword">const</span> <a class="code" href="struct__VampParameterDescriptor.html" title="C language API for Vamp plugins.">VampParameterDescriptor</a> **<a class="code" href="struct__VampPluginDescriptor.html#64d614862604c31d6b84c49005f51913" title="Fixed descriptors for parameter inputs.">parameters</a>;
<a name="l00276"></a>00276 
<a name="l00278"></a><a class="code" href="struct__VampPluginDescriptor.html#1962666aa173e7a9a2c30dc82e4b2e00">00278</a>     <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="struct__VampPluginDescriptor.html#1962666aa173e7a9a2c30dc82e4b2e00" title="Number of programs.">programCount</a>;
<a name="l00279"></a>00279 
<a name="l00281"></a><a class="code" href="struct__VampPluginDescriptor.html#d488470c582d8472d86455889d71c5ec">00281</a>     <span class="keyword">const</span> <span class="keywordtype">char</span> **<a class="code" href="struct__VampPluginDescriptor.html#d488470c582d8472d86455889d71c5ec" title="Fixed names for programs.">programs</a>;
<a name="l00282"></a>00282 
<a name="l00284"></a><a class="code" href="struct__VampPluginDescriptor.html#ffc4d1796da7ced2c0cbb2cc2c4a22f4">00284</a>     <a class="code" href="vamp_8h.html#b107386a5f042feddf6446bea23bb765">VampInputDomain</a> <a class="code" href="struct__VampPluginDescriptor.html#ffc4d1796da7ced2c0cbb2cc2c4a22f4" title="Preferred input domain for audio input (time or frequency).">inputDomain</a>;
<a name="l00285"></a>00285 
<a name="l00287"></a>00287     <a class="code" href="vamp_8h.html#d3be2952b1f4ad7d775940a6db75c79b">VampPluginHandle</a> (*<a class="code" href="struct__VampPluginDescriptor.html#19c4ce36fdeb88eeedb539efc544b8ee" title="Create and return a new instance of this plugin.">instantiate</a>)(<span class="keyword">const</span> <span class="keyword">struct </span><a class="code" href="struct__VampPluginDescriptor.html">_VampPluginDescriptor</a> *,
<a name="l00288"></a>00288                                    <span class="keywordtype">float</span> inputSampleRate);
<a name="l00289"></a>00289 
<a name="l00291"></a>00291     void (*<a class="code" href="struct__VampPluginDescriptor.html#0e4522c33e59c3c518b9262f2477bc27" title="Destroy an instance of this plugin.">cleanup</a>)(VampPluginHandle);
<a name="l00292"></a>00292 
<a name="l00294"></a>00294     int (*<a class="code" href="struct__VampPluginDescriptor.html#d0978f17a5e568079470a1978a9aad22" title="Initialise an instance following parameter configuration.">initialise</a>)(VampPluginHandle,
<a name="l00295"></a>00295                       <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> inputChannels,
<a name="l00296"></a>00296                       <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> stepSize, 
<a name="l00297"></a>00297                       <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> blockSize);
<a name="l00298"></a>00298 
<a name="l00300"></a>00300     void (*<a class="code" href="struct__VampPluginDescriptor.html#12267f6b506aeda3792ff7c982b02336" title="Reset an instance, ready to use again on new input data.">reset</a>)(VampPluginHandle);
<a name="l00301"></a>00301 
<a name="l00303"></a>00303     float (*<a class="code" href="struct__VampPluginDescriptor.html#07174981875b55ee2ec7521a7f4fc395" title="Get a parameter value.">getParameter</a>)(VampPluginHandle, int);
<a name="l00304"></a>00304 
<a name="l00306"></a>00306     void  (*<a class="code" href="struct__VampPluginDescriptor.html#ad3cfc7a3b432df40bd9db13eee6a481" title="Set a parameter value.">setParameter</a>)(VampPluginHandle, int, float);
<a name="l00307"></a>00307 
<a name="l00309"></a>00309     <span class="keywordtype">unsigned</span> int (*<a class="code" href="struct__VampPluginDescriptor.html#861a77525a95d424cb846820b018af53" title="Get the current program (if programCount &amp;gt; 0).">getCurrentProgram</a>)(VampPluginHandle);
<a name="l00310"></a>00310 
<a name="l00312"></a>00312     void  (*<a class="code" href="struct__VampPluginDescriptor.html#d9af40cb165ca187e49250964af5f5cf" title="Set the current program.">selectProgram</a>)(VampPluginHandle, <span class="keywordtype">unsigned</span> int);
<a name="l00313"></a>00313     
<a name="l00315"></a>00315     <span class="keywordtype">unsigned</span> int (*<a class="code" href="struct__VampPluginDescriptor.html#2beddf2ce156c05dd24477ac663adcbb" title="Get the plugin&amp;#39;s preferred processing window increment in samples.">getPreferredStepSize</a>)(VampPluginHandle);
<a name="l00316"></a>00316 
<a name="l00318"></a>00318     <span class="keywordtype">unsigned</span> int (*<a class="code" href="struct__VampPluginDescriptor.html#c626e42554ab1532c8d8b5132a0faee8" title="Get the plugin&amp;#39;s preferred processing window size in samples.">getPreferredBlockSize</a>)(VampPluginHandle);
<a name="l00319"></a>00319 
<a name="l00321"></a>00321     <span class="keywordtype">unsigned</span> int (*<a class="code" href="struct__VampPluginDescriptor.html#f175ca17716db5a7545b61b01caabd92" title="Get the minimum number of input channels this plugin can handle.">getMinChannelCount</a>)(VampPluginHandle);
<a name="l00322"></a>00322 
<a name="l00324"></a>00324     <span class="keywordtype">unsigned</span> int (*<a class="code" href="struct__VampPluginDescriptor.html#d1600203418d9646332f5b917284261b" title="Get the maximum number of input channels this plugin can handle.">getMaxChannelCount</a>)(VampPluginHandle);
<a name="l00325"></a>00325 
<a name="l00327"></a>00327     <span class="keywordtype">unsigned</span> int (*<a class="code" href="struct__VampPluginDescriptor.html#a8fc88da704e24b2b5f674821dd380c1" title="Get the number of feature outputs (distinct sets of results).">getOutputCount</a>)(VampPluginHandle);
<a name="l00328"></a>00328 
<a name="l00333"></a>00333     <a class="code" href="struct__VampOutputDescriptor.html">VampOutputDescriptor</a> *(*getOutputDescriptor)(VampPluginHandle,
<a name="l00334"></a>00334                                                  <span class="keywordtype">unsigned</span> int);
<a name="l00335"></a>00335 
<a name="l00337"></a>00337     void (*<a class="code" href="struct__VampPluginDescriptor.html#8cc38edc921616e67e551aa03397ec79" title="Destroy a descriptor for a feature output.">releaseOutputDescriptor</a>)(<a class="code" href="struct__VampOutputDescriptor.html">VampOutputDescriptor</a> *);
<a name="l00338"></a>00338 
<a name="l00344"></a>00344     <a class="code" href="struct__VampFeatureList.html">VampFeatureList</a> *(*process)(VampPluginHandle,
<a name="l00345"></a>00345                                 <span class="keyword">const</span> <span class="keywordtype">float</span> *<span class="keyword">const</span> *inputBuffers,
<a name="l00346"></a>00346                                 <span class="keywordtype">int</span> sec,
<a name="l00347"></a>00347                                 <span class="keywordtype">int</span> nsec);
<a name="l00348"></a>00348 
<a name="l00350"></a>00350     <a class="code" href="struct__VampFeatureList.html">VampFeatureList</a> *(*getRemainingFeatures)(VampPluginHandle);
<a name="l00351"></a>00351 
<a name="l00353"></a>00353     void (*<a class="code" href="struct__VampPluginDescriptor.html#c4bafe8ad2734d21a433d745b18e7d63" title="Release a feature set returned from process or getRemainingFeatures.">releaseFeatureSet</a>)(<a class="code" href="struct__VampFeatureList.html">VampFeatureList</a> *);
<a name="l00354"></a>00354 
<a name="l00355"></a>00355 } <a class="code" href="struct__VampPluginDescriptor.html">VampPluginDescriptor</a>;
<a name="l00356"></a>00356 
<a name="l00357"></a>00357 
<a name="l00376"></a>00376 <span class="keyword">const</span> <a class="code" href="struct__VampPluginDescriptor.html">VampPluginDescriptor</a> *<a class="code" href="vamp_8h.html#50cf6f17d0718f02093be6c7f63fcf30" title="Get the descriptor for a given plugin index in this library.">vampGetPluginDescriptor</a>
<a name="l00377"></a>00377     (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> hostApiVersion, <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> index);
<a name="l00378"></a>00378 
<a name="l00379"></a>00379 
<a name="l00381"></a>00381 <span class="keyword">typedef</span> <span class="keyword">const</span> <a class="code" href="struct__VampPluginDescriptor.html">VampPluginDescriptor</a> *(*VampGetPluginDescriptorFunction)
<a name="l00382"></a><a class="code" href="vamp_8h.html#551bb7e0d8c970c2202be5f881817478">00382</a>     (<span class="keywordtype">unsigned</span> int, <span class="keywordtype">unsigned</span> int);
<a name="l00383"></a>00383 
<a name="l00384"></a>00384 <span class="preprocessor">#ifdef __cplusplus</span>
<a name="l00385"></a>00385 <span class="preprocessor"></span>}
<a name="l00386"></a>00386 <span class="preprocessor">#endif</span>
<a name="l00387"></a>00387 <span class="preprocessor"></span>
<a name="l00388"></a>00388 <span class="preprocessor">#endif</span>
</pre></div></div>
<hr size="1"><address style="text-align: right;"><small>Generated on Mon Dec 8 14:37:18 2008 for VampPluginSDK by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
</body>
</html>