Deployed dffcb9a with MkDocs version: 1.5.3

howto/plotting/index.html

@@ -1628,11 +1628,11 @@ <h2 id="output">Output</h2>
   <small>
 
       Last update:
-      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:48:01+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
+      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:50:26+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
 
         <br>
         Created:
-        <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:48:01+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
+        <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:50:26+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
 
 
   </small>

library/envelope/asrenvelope/index.html

@@ -1607,14 +1607,39 @@ <h3 id="examples">Examples</h3>
 <span class="n">envelope</span> <span class="o">=</span> <span class="n">ASREnvelope</span><span class="p">(</span><span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">)</span>
 <span class="n">output</span> <span class="o">=</span> <span class="n">osc</span> <span class="o">*</span> <span class="n">envelope</span>
 <span class="n">output</span><span class="o">.</span><span class="n">play</span><span class="p">()</span>
+</code></pre></div>
+<div class="highlight"><pre><span></span><code><span class="c1">#-------------------------------------------------------------------------------</span>
+<span class="c1"># Using ASREnvelope to shape the sound of an oscillator over time.</span>
+<span class="c1"># The Line node generates a continuously-changing value which we use as the </span>
+<span class="c1"># release time.</span>
+<span class="c1">#-------------------------------------------------------------------------------</span>
+<span class="n">clock</span> <span class="o">=</span> <span class="n">Impulse</span><span class="p">(</span><span class="mf">8.0</span><span class="p">)</span>
+<span class="n">CMaj7</span> <span class="o">=</span> <span class="p">[</span> <span class="mi">60</span><span class="p">,</span> <span class="mi">64</span><span class="p">,</span> <span class="mi">67</span><span class="p">,</span> <span class="mi">71</span><span class="p">,</span> <span class="mi">74</span><span class="p">,</span> <span class="mi">76</span> <span class="p">]</span> <span class="o">*</span> <span class="mi">8</span>
+<span class="n">FMaj9</span> <span class="o">=</span> <span class="p">[</span> <span class="mi">65</span><span class="p">,</span> <span class="mi">69</span><span class="p">,</span> <span class="mi">72</span><span class="p">,</span> <span class="mi">76</span><span class="p">,</span> <span class="mi">77</span><span class="p">,</span> <span class="mi">81</span> <span class="p">]</span> <span class="o">*</span> <span class="mi">8</span>
+<span class="n">arpeggios</span> <span class="o">=</span> <span class="n">CMaj7</span> <span class="o">+</span> <span class="n">FMaj9</span>
+<span class="n">sequence</span> <span class="o">=</span> <span class="n">Sequence</span><span class="p">(</span><span class="n">arpeggios</span><span class="p">,</span> <span class="n">clock</span><span class="p">)</span>
+<span class="n">frequency</span> <span class="o">=</span> <span class="n">MidiNoteToFrequency</span><span class="p">(</span><span class="n">sequence</span><span class="p">)</span>
+
+<span class="n">oscillator</span> <span class="o">=</span> <span class="n">TriangleOscillator</span><span class="p">(</span><span class="n">frequency</span><span class="p">)</span>
+<span class="n">release</span> <span class="o">=</span> <span class="n">Line</span><span class="p">(</span><span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">,</span> <span class="mi">6</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
+<span class="n">envelope</span> <span class="o">=</span> <span class="n">ASREnvelope</span><span class="p">(</span><span class="n">attack</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span> 
+                       <span class="n">sustain</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span> 
+                       <span class="n">release</span><span class="o">=</span><span class="n">release</span><span class="p">,</span> 
+                       <span class="n">curve</span><span class="o">=</span><span class="mf">1.0</span><span class="p">,</span> 
+                       <span class="n">clock</span><span class="o">=</span><span class="n">clock</span><span class="p">)</span>
+<span class="n">voice</span> <span class="o">=</span> <span class="n">oscillator</span> <span class="o">*</span> <span class="n">envelope</span>
+
+<span class="n">pan</span> <span class="o">=</span> <span class="n">SineLFO</span><span class="p">(</span><span class="mf">0.1667</span><span class="p">,</span> <span class="o">-</span><span class="mf">1.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">)</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">StereoPanner</span><span class="p">(</span><span class="n">voice</span><span class="p">,</span> <span class="n">pan</span><span class="p">)</span>
+<span class="n">output</span><span class="o">.</span><span class="n">play</span><span class="p">()</span>
 </code></pre></div>
 
   <hr>
 <div class="md-source-file">
   <small>
 
       Last update:
-      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-01-30T18:23:06+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-01-30</span>
+      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:50:21+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
 
         <br>
         Created:

library/envelope/index.html

@@ -1604,7 +1604,7 @@ <h1 id="envelope">Envelope</h1>
 <li><strong><a href="asrenvelope/">ASREnvelope</a></strong>: Attack-sustain-release envelope.</li>
 <li><strong><a href="detectsilence/">DetectSilence</a></strong>: Detects blocks of silence below the threshold value. Used as an auto-free node to terminate a Patch after processing is complete.</li>
 <li><strong><a href="envelope/">Envelope</a></strong>: Generic envelope constructor, given an array of levels, times and curves.</li>
-<li><strong><a href="line/">Line</a></strong>: Line segment with the given start/end values and duration. If loop is true, repeats indefinitely. Retriggers on a clock signal.</li>
+<li><strong><a href="line/">Line</a></strong>: Line segment with the given start/end values, and duration (in seconds). If loop is true, repeats indefinitely. Retriggers on a clock signal.</li>
 <li><strong><a href="rectangularenvelope/">RectangularEnvelope</a></strong>: Rectangular envelope with the given sustain duration.</li>
 </ul>
 
@@ -1613,7 +1613,7 @@ <h1 id="envelope">Envelope</h1>
   <small>
 
       Last update:
-      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2023-12-03T21:03:36+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2023-12-03</span>
+      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:50:21+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
 
         <br>
         Created:

library/envelope/line/index.html

@@ -6,7 +6,7 @@
       <meta charset="utf-8">
       <meta name="viewport" content="width=device-width,initial-scale=1">
 
-        <meta name="description" content="Line: Line segment with the given start/end values and duration. If loop is true, repeats indefinitely. Retriggers on a clock signal.">
+        <meta name="description" content="Line: Line segment with the given start/end values, and duration (in seconds). If loop is true, repeats indefinitely. Retriggers on a clock signal.">
 
 
 
@@ -1598,7 +1598,7 @@
 <h1 id="line">Line</h1>
 <div class="highlight"><pre><span></span><code><span class="n">Line</span><span class="p">(</span><span class="n">start</span><span class="o">=</span><span class="mf">0.0</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="mf">1.0</span><span class="p">,</span> <span class="n">time</span><span class="o">=</span><span class="mf">1.0</span><span class="p">,</span> <span class="n">loop</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">clock</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
 </code></pre></div>
-<p>Line segment with the given start/end values and duration. If loop is true, repeats indefinitely. Retriggers on a clock signal.</p>
+<p>Line segment with the given start/end values, and duration (in seconds). If loop is true, repeats indefinitely. Retriggers on a clock signal.</p>
 <h3 id="examples">Examples</h3>
 <div class="highlight"><pre><span></span><code><span class="c1">#-------------------------------------------------------------------------------</span>
 <span class="c1"># Using a line to control the gain of an oscillator, emulating a sidechain </span>
@@ -1607,7 +1607,27 @@ <h3 id="examples">Examples</h3>
 <span class="n">clock</span> <span class="o">=</span> <span class="n">Impulse</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="mf">1.0</span><span class="p">)</span>
 <span class="n">line</span> <span class="o">=</span> <span class="n">Line</span><span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">,</span> <span class="kc">False</span><span class="p">,</span> <span class="n">clock</span><span class="p">)</span>
 <span class="n">osc</span> <span class="o">=</span> <span class="n">SawOscillator</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span>
-<span class="n">output</span> <span class="o">=</span> <span class="n">osc</span> <span class="o">*</span> <span class="n">line</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">StereoPanner</span><span class="p">(</span><span class="n">osc</span> <span class="o">*</span> <span class="n">line</span><span class="p">)</span>
+<span class="n">output</span><span class="o">.</span><span class="n">play</span><span class="p">()</span>
+</code></pre></div>
+<div class="highlight"><pre><span></span><code><span class="c1">#-------------------------------------------------------------------------------</span>
+<span class="c1"># Using Line to repeatedly alter the release value of an envelope applied to the</span>
+<span class="c1"># main synth voice, in time with the music.</span>
+<span class="c1">#-------------------------------------------------------------------------------</span>
+<span class="n">clock</span> <span class="o">=</span> <span class="n">Impulse</span><span class="p">(</span><span class="mf">8.0</span><span class="p">)</span>
+<span class="n">CMaj7</span> <span class="o">=</span> <span class="p">[</span> <span class="mi">60</span><span class="p">,</span> <span class="mi">64</span><span class="p">,</span> <span class="mi">67</span><span class="p">,</span> <span class="mi">71</span><span class="p">,</span> <span class="mi">74</span><span class="p">,</span> <span class="mi">76</span> <span class="p">]</span> <span class="o">*</span> <span class="mi">8</span>
+<span class="n">FMaj9</span> <span class="o">=</span> <span class="p">[</span> <span class="mi">65</span><span class="p">,</span> <span class="mi">69</span><span class="p">,</span> <span class="mi">72</span><span class="p">,</span> <span class="mi">76</span><span class="p">,</span> <span class="mi">77</span><span class="p">,</span> <span class="mi">81</span> <span class="p">]</span> <span class="o">*</span> <span class="mi">8</span>
+<span class="n">arpeggios</span> <span class="o">=</span> <span class="n">CMaj7</span> <span class="o">+</span> <span class="n">FMaj9</span>
+<span class="n">sequence</span> <span class="o">=</span> <span class="n">Sequence</span><span class="p">(</span><span class="n">arpeggios</span><span class="p">,</span> <span class="n">clock</span><span class="p">)</span>
+<span class="n">frequency</span> <span class="o">=</span> <span class="n">MidiNoteToFrequency</span><span class="p">(</span><span class="n">sequence</span><span class="p">)</span>
+
+<span class="n">oscillator</span> <span class="o">=</span> <span class="n">TriangleOscillator</span><span class="p">(</span><span class="n">frequency</span><span class="p">)</span>
+<span class="n">release</span> <span class="o">=</span> <span class="n">Line</span><span class="p">(</span><span class="mf">0.1</span><span class="p">,</span> <span class="mf">0.5</span><span class="p">,</span> <span class="mi">6</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
+<span class="n">envelope</span> <span class="o">=</span> <span class="n">ASREnvelope</span><span class="p">(</span><span class="mf">0.0</span><span class="p">,</span> <span class="mf">0.0</span><span class="p">,</span> <span class="n">release</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">,</span> <span class="n">clock</span><span class="p">)</span>
+<span class="n">voice</span> <span class="o">=</span> <span class="n">oscillator</span> <span class="o">*</span> <span class="n">envelope</span>
+
+<span class="n">pan</span> <span class="o">=</span> <span class="n">SineLFO</span><span class="p">(</span><span class="mf">0.1667</span><span class="p">,</span> <span class="o">-</span><span class="mf">1.0</span><span class="p">,</span> <span class="mf">1.0</span><span class="p">)</span>
+<span class="n">output</span> <span class="o">=</span> <span class="n">StereoPanner</span><span class="p">(</span><span class="n">voice</span><span class="p">,</span> <span class="n">pan</span><span class="p">)</span>
 <span class="n">output</span><span class="o">.</span><span class="n">play</span><span class="p">()</span>
 </code></pre></div>
 
@@ -1616,7 +1636,7 @@ <h3 id="examples">Examples</h3>
   <small>
 
       Last update:
-      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-02T12:47:18+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-02</span>
+      <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago"><span class="timeago" datetime="2024-02-15T23:50:21+00:00" locale="en"></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date">2024-02-15</span>
 
         <br>
         Created: