You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
OpenAudio_ArduinoLibrary/docs/audio_html/AudioEffectChorus.html

52 lines
2.4 KiB

<script type="text/x-red" data-help-name="AudioEffectChorus">
<h3>Summary</h3>
<div class=tooltipinfo>
<p>The chorus effect simulates the richness of several nearly-identical
sound sources (like the way a choir sounds different to a single singer).
It does this by sampling from a delay line, so each voice is actually
the same but at a slightly different point in time. This is a type of
comb filtering.</p>
</div>
<p>Chorus combines one or more samples ranging from the most recent
sample back to about 50ms ago. The additional samples are evenly spread
through the supplied delay line, and there is no modulation.</p>
<p>If the number of voices is specified as 2, then the
effect combines the current sample and the oldest sample (the last one
in the delay line). If the number of voices is 3 then the effect combines
the most recent sample, the oldest sample and the sample in the middle of
the delay line.</p>
<p>For two voices the effect can be represented as:<br/>
result = (sample(0) + sample(dt))/2<br/>
where sample(0) represents the current sample and sample(dt)
is the sample in the delay line from dt milliseconds ago.</p>
<h3>Audio Connections</h3>
<table class=doc align=center cellpadding=3>
<tr class="top"><th>Port</th><th>Purpose</th></tr>
<tr class="odd"><td align="center">In 0</td><td>Signal Input</td></tr>
<tr class="odd"><td align="center">Out 0</td><td>Chorused Output</td></tr>
</table>
<h3>Functions</h3>
<p class=func><span class=keyword>begin</span>(delayBuffer, length, n_chorus);</p>
<p class=desc>Create a chorus by specifying the address of the delayline, the
total number of samples in the delay line (often done as an integer multiple of
AUDIO_BLOCK_SAMPLES) and the number of voices in the chorus <em>including</em>
the original voice (so, 2 and up to get a chorus effect, although you can
specify 1 if you want).
</p>
<p class=func><span class=keyword>modify</span>(n_chorus);</p>
<p class=desc>Alters the number of voices in a running chorus (previously started with begin).
</p>
<h3>Examples</h3>
<p class=exam>File &gt; Examples &gt; Audio &gt; Effects &gt; Chorus
</p>
<h3>Notes</h3>
<p>The longer the length of the chorus, the more memory blocks are used.</p>
</script>
<script type="text/x-red" data-template-name="AudioEffectChorus">
<div class="form-row">
<label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
<input type="text" id="node-input-name" placeholder="Name">
</div>
</script>