mirror of
https://github.com/thestk/stk
synced 2026-01-18 23:21:53 +00:00
Release 4.2.1 tarball
This commit is contained in:
Gary Scavone
committed by
Stephen Sinclair
Stephen Sinclair
parent
11cf5faa0a
commit
21b93795e7
@@ -8,8 +8,8 @@
|
||||
<img src="princeton.gif"> <img src="ccrma.gif"> <img src="mcgill.gif"><P>
|
||||
<a class="qindex" href="index.html">Home</a> <a class="qindex" href="information.html">Information</a> <a class="qindex" href="classes.html">Classes</a> <a class="qindex" href="download.html">Download</a> <a class="qindex" href="usage.html">Usage</a> <a class="qindex" href="maillist.html">Mail List</a> <a class="qindex" href="system.html">Requirements</a> <a class="qindex" href="links.html">Links</a> <a class="qindex" href="tutorial.html">Tutorial</a></CENTER>
|
||||
<HR>
|
||||
<!-- Generated by Doxygen 1.3.4 -->
|
||||
<h1>Filter Class Reference</h1><code>#include <<a class="el" href="Filter_8h-source.html">Filter.h</a>></code>
|
||||
<!-- Generated by Doxygen 1.4.4 -->
|
||||
<h1>Filter Class Reference</h1><!-- doxytag: class="Filter" --><!-- doxytag: inherits="Stk" --><code>#include <<a class="el" href="Filter_8h-source.html">Filter.h</a>></code>
|
||||
<p>
|
||||
<p>Inheritance diagram for Filter:
|
||||
<p><center><img src="classFilter.png" usemap="#Filter_map" border="0" alt=""></center>
|
||||
@@ -29,94 +29,87 @@
|
||||
<a href="classFilter-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
|
||||
STK filter class.
|
||||
<p>
|
||||
This class implements a generic structure which can be used to create a wide range of filters. It can function independently or be subclassed to provide more specific controls based on a particular filter type.<p>
|
||||
This class implements a generic structure that can be used to create a wide range of filters. It can function independently or be subclassed to provide more specific controls based on a particular filter type.<p>
|
||||
In particular, this class implements the standard difference equation:<p>
|
||||
a[0]*y[n] = b[0]*x[n] + ... + b[nb]*x[n-nb] - a[1]*y[n-1] - ... - a[na]*y[n-na]<p>
|
||||
If a[0] is not equal to 1, the filter coeffcients are normalized by a[0].<p>
|
||||
The <em>gain</em> parameter is applied at the filter input and does not affect the coefficient values. The default gain value is 1.0. This structure results in one extra multiply per computed sample, but allows easy control of the overall filter gain.<p>
|
||||
by Perry R. Cook and Gary P. Scavone, 1995 - 2004.
|
||||
by Perry R. Cook and Gary P. Scavone, 1995 - 2005.
|
||||
<p>
|
||||
|
||||
<p>
|
||||
Definition at line <a class="el" href="Filter_8h-source.html#l00037">37</a> of file <a class="el" href="Filter_8h-source.html">Filter.h</a>.<table border=0 cellpadding=0 cellspacing=0>
|
||||
<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><a class="anchor" name="a0" doxytag="Filter::Filter" ></a>
|
||||
</td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a0">Filter</a> (void)</td></tr>
|
||||
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a0"></a><!-- doxytag: member="Filter::Filter" ref="a0" args="(void)" -->
|
||||
</td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a0">Filter</a> (void)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Default constructor creates a zero-order pass-through "filter". <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top> </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a1">Filter</a> (std::vector< StkFloat > &bCoefficients, std::vector< StkFloat > &aCoefficients)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Default constructor creates a zero-order pass-through "filter". <br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a1">Filter</a> (std::vector< StkFloat > &bCoefficients, std::vector< StkFloat > &aCoefficients)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Overloaded constructor which takes filter coefficients. </em> <a href="#a1"></a><em><br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a2" doxytag="Filter::~Filter" ></a>
|
||||
virtual </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a2">~Filter</a> (void)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Overloaded constructor which takes filter coefficients. <a href="#a1"></a><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a2"></a><!-- doxytag: member="Filter::~Filter" ref="a2" args="(void)" -->
|
||||
virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a2">~Filter</a> (void)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Class destructor. <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a3" doxytag="Filter::clear" ></a>
|
||||
void </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a3">clear</a> (void)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Class destructor. <br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a3"></a><!-- doxytag: member="Filter::clear" ref="a3" args="(void)" -->
|
||||
void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a3">clear</a> (void)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets all internal states of the filter to zero. <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a4">setCoefficients</a> (std::vector< StkFloat > &bCoefficients, std::vector< StkFloat > &aCoefficients)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets all internal states of the filter to zero. <br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a4">setCoefficients</a> (std::vector< StkFloat > &bCoefficients, std::vector< StkFloat > &aCoefficients, bool clearState=false)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set filter coefficients. </em> <a href="#a4"></a><em><br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a5">setNumerator</a> (std::vector< StkFloat > &bCoefficients)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set filter coefficients. <a href="#a4"></a><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a5">setNumerator</a> (std::vector< StkFloat > &bCoefficients, bool clearState=false)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set numerator coefficients. </em> <a href="#a5"></a><em><br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top>void </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a6">setDenominator</a> (std::vector< StkFloat > &aCoefficients)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set numerator coefficients. <a href="#a5"></a><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a6">setDenominator</a> (std::vector< StkFloat > &aCoefficients, bool clearState=false)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set denominator coefficients. </em> <a href="#a6"></a><em><br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top>virtual void </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a7">setGain</a> (StkFloat gain)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set denominator coefficients. <a href="#a6"></a><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a7">setGain</a> (StkFloat gain)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the filter gain. </em> <a href="#a7"></a><em><br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a8" doxytag="Filter::getGain" ></a>
|
||||
virtual StkFloat </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a8">getGain</a> (void) const </td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the filter gain. <a href="#a7"></a><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a8"></a><!-- doxytag: member="Filter::getGain" ref="a8" args="(void) const " -->
|
||||
virtual StkFloat </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a8">getGain</a> (void) const </td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current filter gain. <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a9" doxytag="Filter::lastOut" ></a>
|
||||
virtual StkFloat </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a9">lastOut</a> (void) const </td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the current filter gain. <br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a9"></a><!-- doxytag: member="Filter::lastOut" ref="a9" args="(void) const " -->
|
||||
virtual StkFloat </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a9">lastOut</a> (void) const </td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the last computed output value. <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a10" doxytag="Filter::tick" ></a>
|
||||
virtual StkFloat </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a10">tick</a> (StkFloat sample)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the last computed output value. <br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="a10"></a><!-- doxytag: member="Filter::tick" ref="a10" args="(StkFloat input)" -->
|
||||
virtual StkFloat </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a10">tick</a> (StkFloat input)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Input one sample to the filter and return one output. <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top><a class="anchor" name="a11" doxytag="Filter::tick" ></a>
|
||||
virtual StkFloat * </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a11">tick</a> (StkFloat *vector, unsigned int vectorSize)</td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Input one sample to the filter and return one output. <br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual <a class="el" href="classStkFrames.html">StkFrames</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classFilter.html#a11">tick</a> (<a class="el" href="classStkFrames.html">StkFrames</a> &frames, unsigned int channel=0)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Input <em>vectorSize</em> samples to the filter and return an equal number of outputs in <em>vector</em>. <br><br></td></tr>
|
||||
<tr><td class="memItemLeft" nowrap align=right valign=top>virtual <a class="el" href="classStkFrames.html">StkFrames</a> & </td><td class="memItemRight" valign=bottom><a class="el" href="classFilter.html#a12">tick</a> (<a class="el" href="classStkFrames.html">StkFrames</a> &frames, unsigned int channel=1)</td></tr>
|
||||
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Take a channel of the <a class="el" href="classStkFrames.html">StkFrames</a> object as inputs to the filter and replace with corresponding outputs. </em> <a href="#a12"></a><em><br><br></td></tr>
|
||||
<tr><td class="mdescLeft"> </td><td class="mdescRight">Take a channel of the <a class="el" href="classStkFrames.html">StkFrames</a> object as inputs to the filter and replace with corresponding outputs. <a href="#a11"></a><br></td></tr>
|
||||
</table>
|
||||
<hr><h2>Constructor & Destructor Documentation</h2>
|
||||
<a class="anchor" name="a1" doxytag="Filter::Filter" ></a><p>
|
||||
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
||||
<a class="anchor" name="a1"></a><!-- doxytag: member="Filter::Filter" ref="a1" args="(std::vector< StkFloat > &bCoefficients, std::vector< StkFloat > &aCoefficients)" --><p>
|
||||
<table class="mdTable" cellpadding="2" cellspacing="0">
|
||||
<tr>
|
||||
<td class="mdRow">
|
||||
<table cellpadding="0" cellspacing="0" border="0">
|
||||
<tr>
|
||||
<td class="md" nowrap valign="top"> Filter::Filter </td>
|
||||
<td class="md" nowrap valign="top">Filter::Filter </td>
|
||||
<td class="md" valign="top">( </td>
|
||||
<td class="md" nowrap valign="top">std::vector< StkFloat > & </td>
|
||||
<td class="mdname" nowrap> <em>bCoefficients</em>, </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="md" nowrap align="right"></td>
|
||||
<td class="md"></td>
|
||||
<td class="md" nowrap>std::vector< StkFloat > & </td>
|
||||
<td class="mdname" nowrap> <em>aCoefficients</em></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td class="md"></td>
|
||||
<td class="md">) </td>
|
||||
<td class="md" colspan="2"></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<table cellspacing=5 cellpadding=0 border=0>
|
||||
<table cellspacing="5" cellpadding="0" border="0">
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
@@ -126,38 +119,43 @@ virtual StkFloat * </td><td class="memItemRight" valign=bottom><a class="el
|
||||
<p>
|
||||
Overloaded constructor which takes filter coefficients.
|
||||
<p>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if either of the coefficient vector sizes is zero, or if the a[0] coefficient is equal to zero. </td>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if either of the coefficient vector sizes is zero, or if the a[0] coefficient is equal to zero. </td>
|
||||
</tr>
|
||||
</table>
|
||||
<hr><h2>Member Function Documentation</h2>
|
||||
<a class="anchor" name="a4" doxytag="Filter::setCoefficients" ></a><p>
|
||||
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
||||
<a class="anchor" name="a4"></a><!-- doxytag: member="Filter::setCoefficients" ref="a4" args="(std::vector< StkFloat > &bCoefficients, std::vector< StkFloat > &aCoefficients, bool clearState=false)" --><p>
|
||||
<table class="mdTable" cellpadding="2" cellspacing="0">
|
||||
<tr>
|
||||
<td class="mdRow">
|
||||
<table cellpadding="0" cellspacing="0" border="0">
|
||||
<tr>
|
||||
<td class="md" nowrap valign="top"> void Filter::setCoefficients </td>
|
||||
<td class="md" nowrap valign="top">void Filter::setCoefficients </td>
|
||||
<td class="md" valign="top">( </td>
|
||||
<td class="md" nowrap valign="top">std::vector< StkFloat > & </td>
|
||||
<td class="mdname" nowrap> <em>bCoefficients</em>, </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="md" nowrap align="right"></td>
|
||||
<td class="md"></td>
|
||||
<td class="md" nowrap>std::vector< StkFloat > & </td>
|
||||
<td class="mdname" nowrap> <em>aCoefficients</em></td>
|
||||
<td class="mdname" nowrap> <em>aCoefficients</em>, </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td class="md" nowrap align="right"></td>
|
||||
<td class="md"></td>
|
||||
<td class="md" nowrap>bool </td>
|
||||
<td class="mdname" nowrap> <em>clearState</em> = <code>false</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="md"></td>
|
||||
<td class="md">) </td>
|
||||
<td class="md" colspan="2"></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<table cellspacing=5 cellpadding=0 border=0>
|
||||
<table cellspacing="5" cellpadding="0" border="0">
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
@@ -167,28 +165,36 @@ An <a class="el" href="classStkError.html">StkError</a> can be thrown if either
|
||||
<p>
|
||||
Set filter coefficients.
|
||||
<p>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if either of the coefficient vector sizes is zero, or if the a[0] coefficient is equal to zero. If a[0] is not equal to 1, the filter coeffcients are normalized by a[0]. The internal state of the filter is cleared. </td>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if either of the coefficient vector sizes is zero, or if the a[0] coefficient is equal to zero. If a[0] is not equal to 1, the filter coeffcients are normalized by a[0]. The internal state of the filter is not cleared unless the <em>clearState</em> flag is <code>true</code>. </td>
|
||||
</tr>
|
||||
</table>
|
||||
<a class="anchor" name="a5" doxytag="Filter::setNumerator" ></a><p>
|
||||
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
||||
<a class="anchor" name="a5"></a><!-- doxytag: member="Filter::setNumerator" ref="a5" args="(std::vector< StkFloat > &bCoefficients, bool clearState=false)" --><p>
|
||||
<table class="mdTable" cellpadding="2" cellspacing="0">
|
||||
<tr>
|
||||
<td class="mdRow">
|
||||
<table cellpadding="0" cellspacing="0" border="0">
|
||||
<tr>
|
||||
<td class="md" nowrap valign="top"> void Filter::setNumerator </td>
|
||||
<td class="md" nowrap valign="top">void Filter::setNumerator </td>
|
||||
<td class="md" valign="top">( </td>
|
||||
<td class="md" nowrap valign="top">std::vector< StkFloat > & </td>
|
||||
<td class="mdname1" valign="top" nowrap> <em>bCoefficients</em> </td>
|
||||
<td class="md" valign="top"> ) </td>
|
||||
<td class="md" nowrap></td>
|
||||
<td class="mdname" nowrap> <em>bCoefficients</em>, </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="md" nowrap align="right"></td>
|
||||
<td class="md"></td>
|
||||
<td class="md" nowrap>bool </td>
|
||||
<td class="mdname" nowrap> <em>clearState</em> = <code>false</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="md"></td>
|
||||
<td class="md">) </td>
|
||||
<td class="md" colspan="2"></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<table cellspacing=5 cellpadding=0 border=0>
|
||||
<table cellspacing="5" cellpadding="0" border="0">
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
@@ -198,28 +204,36 @@ An <a class="el" href="classStkError.html">StkError</a> can be thrown if either
|
||||
<p>
|
||||
Set numerator coefficients.
|
||||
<p>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if coefficient vector is empty. Any previously set denominator coefficients are left unaffected. Note that the default constructor sets the single denominator coefficient a[0] to 1.0. The internal state of the filter is cleared. </td>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if coefficient vector is empty. Any previously set denominator coefficients are left unaffected. Note that the default constructor sets the single denominator coefficient a[0] to 1.0. The internal state of the filter is not cleared unless the <em>clearState</em> flag is <code>true</code>. </td>
|
||||
</tr>
|
||||
</table>
|
||||
<a class="anchor" name="a6" doxytag="Filter::setDenominator" ></a><p>
|
||||
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
||||
<a class="anchor" name="a6"></a><!-- doxytag: member="Filter::setDenominator" ref="a6" args="(std::vector< StkFloat > &aCoefficients, bool clearState=false)" --><p>
|
||||
<table class="mdTable" cellpadding="2" cellspacing="0">
|
||||
<tr>
|
||||
<td class="mdRow">
|
||||
<table cellpadding="0" cellspacing="0" border="0">
|
||||
<tr>
|
||||
<td class="md" nowrap valign="top"> void Filter::setDenominator </td>
|
||||
<td class="md" nowrap valign="top">void Filter::setDenominator </td>
|
||||
<td class="md" valign="top">( </td>
|
||||
<td class="md" nowrap valign="top">std::vector< StkFloat > & </td>
|
||||
<td class="mdname1" valign="top" nowrap> <em>aCoefficients</em> </td>
|
||||
<td class="md" valign="top"> ) </td>
|
||||
<td class="md" nowrap></td>
|
||||
<td class="mdname" nowrap> <em>aCoefficients</em>, </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="md" nowrap align="right"></td>
|
||||
<td class="md"></td>
|
||||
<td class="md" nowrap>bool </td>
|
||||
<td class="mdname" nowrap> <em>clearState</em> = <code>false</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="md"></td>
|
||||
<td class="md">) </td>
|
||||
<td class="md" colspan="2"></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<table cellspacing=5 cellpadding=0 border=0>
|
||||
<table cellspacing="5" cellpadding="0" border="0">
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
@@ -229,28 +243,27 @@ An <a class="el" href="classStkError.html">StkError</a> can be thrown if coeffic
|
||||
<p>
|
||||
Set denominator coefficients.
|
||||
<p>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if the coefficient vector is empty or if the a[0] coefficient is equal to zero. Previously set numerator coefficients are unaffected unless a[0] is not equal to 1, in which case all coeffcients are normalized by a[0]. Note that the default constructor sets the single numerator coefficient b[0] to 1.0. The internal state of the filter is cleared. </td>
|
||||
An <a class="el" href="classStkError.html">StkError</a> can be thrown if the coefficient vector is empty or if the a[0] coefficient is equal to zero. Previously set numerator coefficients are unaffected unless a[0] is not equal to 1, in which case all coeffcients are normalized by a[0]. Note that the default constructor sets the single numerator coefficient b[0] to 1.0. The internal state of the filter is not cleared unless the <em>clearState</em> flag is <code>true</code>. </td>
|
||||
</tr>
|
||||
</table>
|
||||
<a class="anchor" name="a7" doxytag="Filter::setGain" ></a><p>
|
||||
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
||||
<a class="anchor" name="a7"></a><!-- doxytag: member="Filter::setGain" ref="a7" args="(StkFloat gain)" --><p>
|
||||
<table class="mdTable" cellpadding="2" cellspacing="0">
|
||||
<tr>
|
||||
<td class="mdRow">
|
||||
<table cellpadding="0" cellspacing="0" border="0">
|
||||
<tr>
|
||||
<td class="md" nowrap valign="top"> virtual void Filter::setGain </td>
|
||||
<td class="md" nowrap valign="top">virtual void Filter::setGain </td>
|
||||
<td class="md" valign="top">( </td>
|
||||
<td class="md" nowrap valign="top">StkFloat </td>
|
||||
<td class="mdname1" valign="top" nowrap> <em>gain</em> </td>
|
||||
<td class="md" valign="top"> ) </td>
|
||||
<td class="md" nowrap><code> [virtual]</code></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<table cellspacing=5 cellpadding=0 border=0>
|
||||
<table cellspacing="5" cellpadding="0" border="0">
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
@@ -260,39 +273,38 @@ An <a class="el" href="classStkError.html">StkError</a> can be thrown if the coe
|
||||
<p>
|
||||
Set the filter gain.
|
||||
<p>
|
||||
The gain is applied at the filter input and does not affect the coefficient values. The default gain value is 1.0.
|
||||
The gain is applied at the filter input and does not affect the coefficient values. The default gain value is 1.0.
|
||||
<p>
|
||||
Reimplemented in <a class="el" href="classBiQuad.html#a11">BiQuad</a>, <a class="el" href="classOnePole.html#a7">OnePole</a>, <a class="el" href="classOneZero.html#a7">OneZero</a>, <a class="el" href="classPoleZero.html#a8">PoleZero</a>, <a class="el" href="classTwoPole.html#a7">TwoPole</a>, and <a class="el" href="classTwoZero.html#a7">TwoZero</a>. </td>
|
||||
</tr>
|
||||
</table>
|
||||
<a class="anchor" name="a12" doxytag="Filter::tick" ></a><p>
|
||||
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
|
||||
<a class="anchor" name="a11"></a><!-- doxytag: member="Filter::tick" ref="a11" args="(StkFrames &frames, unsigned int channel=0)" --><p>
|
||||
<table class="mdTable" cellpadding="2" cellspacing="0">
|
||||
<tr>
|
||||
<td class="mdRow">
|
||||
<table cellpadding="0" cellspacing="0" border="0">
|
||||
<tr>
|
||||
<td class="md" nowrap valign="top"> virtual <a class="el" href="classStkFrames.html">StkFrames</a>& Filter::tick </td>
|
||||
<td class="md" nowrap valign="top">virtual <a class="el" href="classStkFrames.html">StkFrames</a>& Filter::tick </td>
|
||||
<td class="md" valign="top">( </td>
|
||||
<td class="md" nowrap valign="top"><a class="el" href="classStkFrames.html">StkFrames</a> & </td>
|
||||
<td class="mdname" nowrap> <em>frames</em>, </td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td class="md" nowrap align="right"></td>
|
||||
<td class="md"></td>
|
||||
<td class="md" nowrap>unsigned int </td>
|
||||
<td class="mdname" nowrap> <em>channel</em> = 1</td>
|
||||
<td class="mdname" nowrap> <em>channel</em> = <code>0</code></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td></td>
|
||||
<td class="md"></td>
|
||||
<td class="md">) </td>
|
||||
<td class="md" colspan="2"><code> [virtual]</code></td>
|
||||
</tr>
|
||||
|
||||
</table>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<table cellspacing=5 cellpadding=0 border=0>
|
||||
<table cellspacing="5" cellpadding="0" border="0">
|
||||
<tr>
|
||||
<td>
|
||||
|
||||
@@ -302,9 +314,9 @@ Reimplemented in <a class="el" href="classBiQuad.html#a11">BiQuad</a>, <a class=
|
||||
<p>
|
||||
Take a channel of the <a class="el" href="classStkFrames.html">StkFrames</a> object as inputs to the filter and replace with corresponding outputs.
|
||||
<p>
|
||||
The <code>channel</code> argument should be one or greater (the first channel is specified by 1). An <a class="el" href="classStkError.html">StkError</a> will be thrown if the <code>channel</code> argument is zero or it is greater than the number of channels in the <a class="el" href="classStkFrames.html">StkFrames</a> object.
|
||||
The <code>channel</code> argument should be zero or greater (the first channel is specified by 0). An <a class="el" href="classStkError.html">StkError</a> will be thrown if the <code>channel</code> argument is equal to or greater than the number of channels in the <a class="el" href="classStkFrames.html">StkFrames</a> object.
|
||||
<p>
|
||||
Reimplemented in <a class="el" href="classBiQuad.html#a16">BiQuad</a>, <a class="el" href="classDelay.html#a13">Delay</a>, <a class="el" href="classDelayA.html#a9">DelayA</a>, <a class="el" href="classDelayL.html#a8">DelayL</a>, <a class="el" href="classFormSwep.html#a9">FormSwep</a>, <a class="el" href="classOnePole.html#a12">OnePole</a>, <a class="el" href="classOneZero.html#a12">OneZero</a>, <a class="el" href="classPoleZero.html#a13">PoleZero</a>, <a class="el" href="classTwoPole.html#a12">TwoPole</a>, and <a class="el" href="classTwoZero.html#a12">TwoZero</a>. </td>
|
||||
Reimplemented in <a class="el" href="classBiQuad.html#a15">BiQuad</a>, <a class="el" href="classDelay.html#a12">Delay</a>, <a class="el" href="classOnePole.html#a11">OnePole</a>, <a class="el" href="classOneZero.html#a11">OneZero</a>, <a class="el" href="classPoleZero.html#a12">PoleZero</a>, <a class="el" href="classTwoPole.html#a11">TwoPole</a>, and <a class="el" href="classTwoZero.html#a11">TwoZero</a>. </td>
|
||||
</tr>
|
||||
</table>
|
||||
<hr>The documentation for this class was generated from the following file:<ul>
|
||||
@@ -313,7 +325,7 @@ Reimplemented in <a class="el" href="classBiQuad.html#a16">BiQuad</a>, <a class=
|
||||
|
||||
<table>
|
||||
<tr><td><A HREF="http://ccrma.stanford.edu/software/stk/"><I>The Synthesis ToolKit in C++ (STK)</I></A></td></tr>
|
||||
<tr><td>©1995-2004 Perry R. Cook and Gary P. Scavone. All Rights Reserved.</td></tr>
|
||||
<tr><td>©1995-2005 Perry R. Cook and Gary P. Scavone. All Rights Reserved.</td></tr>
|
||||
</table>
|
||||
|
||||
</BODY>
|
||||
|
||||
Reference in New Issue
Block a user