Let's release befor breaking things again.

smimram · Aug 19, 2020 · ec87184 · ec87184
1 parent 754e7b3
commit ec87184
Show file tree

Hide file tree

Showing 81 changed files with 21 additions and 380 deletions.
diff --git a/CHANGES.md b/CHANGES.md
@@ -0,0 +1,4 @@
+0.1.0 (2020-08-19)
+=====
+
+- Initial release.
diff --git a/NOTES.md b/NOTES.md
@@ -8,11 +8,16 @@ General resources
 - https://learningsynths.ableton.com/
 - http://www.music.mcgill.ca/~gary/
 
-Software synths
-===============
+Languages / APIs
+================
 
+- [SuperCollider](https://supercollider.github.io/)
 - [Web Audio API](https://www.w3.org/TR/webaudio/) (see also [MDN
   documentation](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API))
+
+Software synths
+===============
+
 - all [Arturia's emulations](https://en.wikipedia.org/wiki/Arturia)
 - many [open source synths](https://zynthian.org/engines)
 - [zynaddsubfx](https://zynaddsubfx.sourceforge.io/)

diff --git a/README.md b/README.md
@@ -298,7 +298,7 @@ to play some notes. In order to illustrate this let's detail step by step how we
 can quickly recreate the song _[better off
 alone](https://www.youtube.com/watch?v=Lj9GzcHbJ-w)_ (sort of) by detailing
 [this
-example](https://github.com/smimram/monadic-synth/blob/master/examples/better_off_alone.ml)
+example](https://github.com/smimram/monadic-synth/blob/master/examples/better_off_alone.ml).
 
 ### Playing notes
 
@@ -436,7 +436,8 @@ small "harp like" synth with
 ```
 
 If you were too lazy to try by yourself [your can hear the result
-here](https://youtu.be/F7q-wtJRgjM).
+here](https://youtu.be/F7q-wtJRgjM) (please remember that no further effects
+where applied, nor a decent mix was performed).
 
 ### Live MIDI input
 

diff --git a/docs/index.html b/docs/index.html
@@ -244,7 +244,7 @@ <h3 id="other-examples">Other examples</h3>
 <li><a href="https://github.com/smimram/monadic-synth/blob/master/examples/thx.ml">thx.ml</a>: a quick recreation of the <a href="https://www.youtube.com/watch?v=uYMpMcmpfkI">THX deep note</a> by adding many saw oscillators, whose frequency is initially between 200 and 400 Hz, and slowly evolve to the same note at various octaves.</li>
 </ul>
 <h2 id="instruments">Instruments</h2>
-<p>Unless you are making <a href="https://en.wikipedia.org/wiki/Musique_concr%C3%A8te">concrete music</a>, you certainly want to play some notes. In order to illustrate this let’s detail step by step how we can quickly recreate the song <em><a href="https://www.youtube.com/watch?v=Lj9GzcHbJ-w">better off alone</a></em> (sort of) by detailing <a href="https://github.com/smimram/monadic-synth/blob/master/examples/better_off_alone.ml">this example</a></p>
+<p>Unless you are making <a href="https://en.wikipedia.org/wiki/Musique_concr%C3%A8te">concrete music</a>, you certainly want to play some notes. In order to illustrate this let’s detail step by step how we can quickly recreate the song <em><a href="https://www.youtube.com/watch?v=Lj9GzcHbJ-w">better off alone</a></em> (sort of) by detailing <a href="https://github.com/smimram/monadic-synth/blob/master/examples/better_off_alone.ml">this example</a>.</p>
 <h3 id="playing-notes">Playing notes</h3>
 <p>We first have to learn how to play notes. A melody can be described as a <em>pattern</em> which is a list of triples consisting of</p>
 <ul>
@@ -323,7 +323,7 @@ <h3 id="arpeggiators">Arpeggiators</h3>
 <span id="cb27-8"><a href="#cb27-8" aria-hidden="true"></a>  <span class="kw">in</span></span>
 <span id="cb27-9"><a href="#cb27-9" aria-hidden="true"></a>  <span class="kw">let</span> arp = Pattern.arpeggiate `Up (Pattern.transpose <span class="dv">24</span> chords) <span class="kw">in</span></span>
 <span id="cb27-10"><a href="#cb27-10" aria-hidden="true"></a>  <span class="kw">let</span> arp = Instrument.play (Note.simple sine) (Pattern.stream ~loop:<span class="kw">true</span> tempo arp) <span class="kw">in</span></span></code></pre></div>
-<p>If you were too lazy to try by yourself <a href="https://youtu.be/F7q-wtJRgjM">your can hear the result here</a>.</p>
+<p>If you were too lazy to try by yourself <a href="https://youtu.be/F7q-wtJRgjM">your can hear the result here</a> (please remember that no further effects where applied, nor a decent mix was performed).</p>
 <h3 id="live-midi-input">Live MIDI input</h3>
 <p>An example of MIDI input (say, from a physical keyboard) in order to generates notes and values for parameters from physical controllers can be <a href="https://github.com/smimram/monadic-synth/blob/master/examples/midi.ml">found here</a>.</p>
 <p>In order to use MIDI, we should begin with using the function <code>MIDI.create</code> which provides us with a handle from which midi events can be drawn (with <code>MIDI.events</code>) as well as the value of controllers (with <code>MIDI.controller</code>). For instance, in the following example, we play the notes pressed on the keyboard with a saw instrument chained with a low pass filter whose Q parameter and cutoff frequency can be controlled by controller 0 and 1 respectively (you might have to change those numbers depending on your controller):</p>

diff --git a/docs/ocamldoc/Extlib.Complex.html b/docs/ocamldoc/Extlib.Complex.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Extlib.File.html b/docs/ocamldoc/Extlib.File.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Extlib.Float.html b/docs/ocamldoc/Extlib.Float.html
@@ -12,7 +12,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Extlib.List.html b/docs/ocamldoc/Extlib.List.html
@@ -12,7 +12,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Extlib.String.html b/docs/ocamldoc/Extlib.String.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Extlib.html b/docs/ocamldoc/Extlib.html
@@ -12,7 +12,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Instrument.html b/docs/ocamldoc/Instrument.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/MIDI.html b/docs/ocamldoc/MIDI.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Note.Drum.html b/docs/ocamldoc/Note.Drum.html
@@ -11,7 +11,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Note.html b/docs/ocamldoc/Note.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/OSC.html b/docs/ocamldoc/OSC.html
@@ -12,7 +12,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Operator.html b/docs/ocamldoc/Operator.html
diff --git a/docs/ocamldoc/Pattern.html b/docs/ocamldoc/Pattern.html
@@ -13,7 +13,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">

diff --git a/docs/ocamldoc/Stream.B.html b/docs/ocamldoc/Stream.B.html
@@ -12,7 +12,6 @@
 <link title="Index of modules" rel=Appendix href="index_modules.html">
 <link title="Extlib" rel="Chapter" href="Extlib.html">
 <link title="Stream" rel="Chapter" href="Stream.html">
-<link title="Operator" rel="Chapter" href="Operator.html">
 <link title="Visu" rel="Chapter" href="Visu.html">
 <link title="Note" rel="Chapter" href="Note.html">
 <link title="MIDI" rel="Chapter" href="MIDI.html">