More info regarding UI, Makefile updated, tutorial headers moved to b…

…lock titles

IntroTutorial-HiHatSynthesis.adoc

@@ -12,32 +12,32 @@ When you're finished with this project you'll know to:
 .Prerequisites
 WARNING: This tutorial assumes that you have completed <<tut2, Project 2: Snare Drum Synthesis>>
 
-==== Open your previous Ardour session
+.Open your previous Ardour session
 Launch the Ardour session you used for <<tut2, snare drum tutorial>>.
 
-==== Add a new MIDI track
+.Add a new MIDI track
 * Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N`
 ** *Name:* HiHat
 ** *Instrument:* ZynAddSubFX
 ** Click `Add and Close`
 
-==== Open the piano roll
+.Open the piano roll
 Expand the track itself by clicking on the lower edge and dragging it down until you see the "piano roll" similar to the picture below.
 
-==== Draw your MIDI area
+.Draw your MIDI area
 Enable draw mode by clicking on the pencil icon.
 
 - Draw a MIDI area that is 1 *beat* / 4 *measures* long (it should be the same length as your existing kick and snare MIDI areas).
 
-==== Draw your MIDI pattern
+.Draw your MIDI pattern
 I'm just going to place a simple 4/4 pattern. You can do anything you like, but don't get too crazy yet, it's going to be repeating behind you while you sculpt the sound.
 
 image::screenshots/ardour-midi-4-4-with-snare-and-hihat.png[]
 
 .Info
 NOTE: This tutorial uses note C4 as our starting note.
 
-==== Loop your MIDI pattern
+.Loop your MIDI pattern
 Now we're going to tell Ardour to loop this specific region whenever we tell it to play. Right click on your MIDI area, select "play", and "loop region".
 
 You should now here your pattern being played with your kick drum and the default Addsynth sound.
@@ -47,16 +47,16 @@ NOTE: You can listen to any track in _solo_ mode by clicking on the `S` button o
 
 image::screenshots/ardour-solo-track.png[]
 
-==== Launch Zyn-Fusion
+.Launch Zyn-Fusion
 * Select your `Synth` track and then *double-click* on the ZynAddSubFX button (circled in red below)
 
-==== Launch ADDsynth
+.Launch ADDsynth
 Launch the ADDsynth by selecting the `ADD` button.
 
 .What Key am I in?
 NOTE: We use note `C4` as our starting point.
 
-==== Change the Oscillator type
+.Change the Oscillator type
 Up to this point we've been using the default sine wave oscillator to generate our tones, but Zyn-Fusion is capable of generating many different types of waves. Each type has unique sound characteristics that we'll dig into later.
 
 For this project we're going to use a *Pulse* wave.
@@ -67,7 +67,7 @@ For this project we're going to use a *Pulse* wave.
 
 image::screenshots/osc-base-function-pulse.png[]
 
-==== Adjust the Modulation
+.Adjust the Modulation
 Now we're going to adjust how the signal is *modulated*. It's ok if you don't know what that means yet, for now think of "modulation" as "changing" a wave.
 
 One of the unique characteristics of cymbals is the "rattle" or "crash" that can often sound like multiple clanging sounds overlapping. We're going to accomplish this goal by increasing the *unison*.
@@ -92,14 +92,14 @@ Now let's disable the default *vibrato* settings.
 
 image::screenshots/mod-unison.png[]
 
-==== Modify the global frequency
+.Modify the global frequency
 Let's detune the frequency a bit again, this time at the global level.
 
 * Navigate to `Global >> Frequency >> General`
 ** Adjust `BW >> 90`
 *** How does the sound change when you adjust the frequency?
 
-==== Modify the global filter
+.Modify the global filter
 Now it's time to play with filters where we will adjust, well, how the sound is filtered.
 
 For starters, let's change from the default lowpass filter to a high-pass filter.
@@ -116,7 +116,7 @@ Now let's adjust the cutoff frequency.
 ** `Filter >> Cutoff >> 14300 Hz`
 *** 14300 is an approximate number, anything close should be fine.
 
-==== Modify the amplitude envelope
+.Modify the amplitude envelope
 Listen to that! Believe it or not, we're almost finished. Let's try minimizing the sustain value to shorten the length of our note, I feel like it's dragging on far too long.
 
 * Navigate to `Global >> Amplitude >> Envelope`
@@ -130,15 +130,15 @@ That's an interesting sound now, isn't it? What happens if we modify the *decay*
 .Tip
 NOTE: If the hi-hat seems hard to hear when playing with your kick and snare, try increasing the `GLOBAL >> AMPLITUDE >> VOL` of the hi-hat.
 
-==== Save your instrument
+.Save your instrument
 Congratulations, you've crafted a hi-hat cymbal - starting with a single sin wave and using additive synthesis!
 
 Now would be a great time to save your Zyn-fusion instrument and Ardour session.
 
 * Navigate to `File >> Save instrument`
 * Choose a directory and name your file before selecting `Enter`
 
-==== Save your Ardour session
+.Save your Ardour session
 
 * Navigate to your Ardour window
 * `Ctrl + S`

IntroTutorial-KickDrumSynthesis.adoc

@@ -9,24 +9,24 @@ When you're finished with this project you'll know how to:
 .Prerequisites
 WARNING: This tutorial assumes that you have completed the Quick Start guide _or understand the content presented within it_.
 
-==== Open your previous Ardour session
+.Open your previous Ardour session
 // Links to Introduction.adoc:Quick start
 Launch the Ardour session you created for the <<quick-start, Quick start guide>>.
 
-==== Add a new MIDI track
+.Add a new MIDI track
 * Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N`
 ** *Name:* Kick
 ** *Instrument:* ZynAddSubFX
 ** Click `Add and Close`
 
 image::screenshots/ardour-new-track.png[]
 
-==== Open the piano roll
+.Open the piano roll
 Expand the track itself by clicking on the lower edge and dragging it down until you see the "piano roll" similar to the picture below.
 
 image::screenshots/ardour-open-piano-roll.png[]
 
-==== Draw your MIDI area
+.Draw your MIDI area
 - Enable draw mode.
 
 image::screenshots/ardour-enable-draw-mode.png[]
@@ -35,7 +35,7 @@ image::screenshots/ardour-enable-draw-mode.png[]
 
 image::screenshots/ardour-draw-midi-area.png[]
 
-==== Draw your MIDI pattern
+.Draw your MIDI pattern
 I'm just going to place a simple 4/4 pattern. You can do anything you like, but don't get too crazy yet, it's going to be repeating behind you while you sculpt the sound.
 
 image::screenshots/ardour-midi-4-4-pattern.png[]
@@ -46,27 +46,27 @@ You can press the `Y` key on your QWERTY keyboard to hear it.
 
 NOTE: If you are not using a QWERTY keyboard, you can set the keyboard layout by going to the "Edit" dropdown menu and selecting "Preferences" > "MIDI" > "Virtual Keyboard Layout".
 
-==== Loop your MIDI pattern
+.Loop your MIDI pattern
 Now we're going to tell Ardour to loop this specific region whenever we tell it to play. Right click on your midi area, select "play", and "loop region".
 
 image::screenshots/ardour-loop-region.png[]
 
 You should now hear your pattern being played using the default Zyn-fusion synthesizer. Let's transform it into a kick drum.
 
-==== Launch Zyn-Fusion
+.Launch Zyn-Fusion
 * Select your `Synth` track and then *double-click* on the ZynAddSubFX button (circled in red below)
 
 image::screenshots/ardour-launch-zyn-fusion.png[]
 
-==== Launch ADDsynth
+.Launch ADDsynth
 Launch the ADDsynth by selecting the `ADD` button.
 
 image::screenshots/launch-ADDsynth.png[]
 
 .What Key am I in?
 NOTE: We use note `A4` as our starting point. You can press the `Y` key on your QWERTY keyboard to hear this note.
 
-==== Lower the octave
+.Lower the octave
 If you recall from the <<_draw_your_midi_pattern,"Draw your MIDI pattern" section>>, we're in the fourth octave.
 Let's drop it a bit and get it closer to the sound we're looking for.
 
@@ -79,7 +79,7 @@ image::screenshots/global-freq.png[]
 
 _Note that the image above shows a different octave but is for demonstration purposes only; set it to the `-3` value described in these steps._
 
-==== Modify your amplitude envelope
+.Modify your amplitude envelope
 Very briefly, envelopes allow us to define how a note behaves over its lifetime. We use an acronymn full of jargon when discussing this behavior - *ADSR*.
 
 NOTE: ADSR stands for Attack, Decay, Sustain, Release.
@@ -99,7 +99,7 @@ By now it should be resembling something approaching the sound of a kick drum.
 .TIP
 NOTE: Notice the area outlined in yellow below, it will display the value of the knobs/dials you manipulate.
 
-==== Modify your frequency envelope
+.Modify your frequency envelope
 Now lets adjust the frequency of our sound a bit to give it a bit more "bounce" by adjusting the *Attack Value*.
 
 * Adjust `A.VAL` to `107`
@@ -130,7 +130,7 @@ Ah, now that's starting to sound like a decent kick drum!
 .TIP
 NOTE: The volume of your kick may seem a bit low after dropping the octave to -4. You can always increase it a bit using the `Global >> Amplitude >> Vol` knob.
 
-==== Make the sound more dynamic by adding a second voice
+.Make the sound more dynamic by adding a second voice
 You can think of each *voice* as another layer that gets applied when crafting you sound. More layers result in more complexity but the potential of a richer fuller sound with more natural harmonics.
 
 Let's try adding a second voice and see how it affects our kick drum.
@@ -145,7 +145,7 @@ image::screenshots/navigate-vce2.png[]
 
 image::screenshots/enable-vce2.png[]
 
-==== Add some noise
+.Add some noise
 One thing you may have noticed by now is that every single hit sounds _identical_. This isn't necessarily a bad thing, but it can lead to boring sounds.
 
 Let's try adding some *noise* to this voice so that every hit will include a bit of randomness.
@@ -156,7 +156,7 @@ Let's try adding some *noise* to this voice so that every hit will include a bit
 
 image::screenshots/mod-pink-noise.png[]
 
-==== Apply a filter
+.Apply a filter
 Now we have too much noise drowing out our primary kick sound.
 
 We can use *filters* to filter out specific frequency ranges. In this case, let's use the default *lowpass* filter (lp2) to remove most of the high pitched sound that is drowing out our kick drum.
@@ -184,7 +184,7 @@ image::screenshots/vce2-filter-q.png[]
 .TIP
 NOTE: You can temporarily disable `VCE 1` so that you can listen to `VCE 2` in isolation to get a clearer picture of what it's adding. To disable a voice you can simply use the `+/-` button to navigate to the voice and then click the power button so that it's greyed out. (The opposite of how you added `VCE 2` above)
 
-==== Save your instrument
+.Save your instrument
 Congratulations, you've crafted a kick drum - starting with a single sin wave and using additive synthesis!
 
 Now would be a great time to save your Zyn-fusion instrument and Ardour session.
@@ -194,7 +194,7 @@ Now would be a great time to save your Zyn-fusion instrument and Ardour session.
 
 image::screenshots/save-instrument.png[]
 
-==== Save your Ardour session
+.Save your Ardour session
 
 * Navigate to your Ardour window
 * `Ctrl + S`

IntroTutorial-SnareDrumSynthesis.adoc

@@ -10,34 +10,34 @@ synthesize a custom snare drum using ADDsynth and *envelopes* and *filters*.
 .Prerequisites
 WARNING: This tutorial assumes that you have completed <<tut1, Project 1: Kick Drum Synthesis>>
 
-==== Open your previous Ardour session
+.Open your previous Ardour session
 Launch the Ardour session you used for the <<tut1, kick drum tutorial>>.
 
-==== Add a new MIDI track
+.Add a new MIDI track
 * Create a new Zyn-Fusion MIDI track for our synthesizer, using `Shift + Ctrl + N`
 ** *Name:* Snare
 ** *Instrument:* ZynAddSubFX
 ** Click `Add and Close`
 
-==== Open the piano roll
+.Open the piano roll
 Expand the track itself by clicking on the lower edge and dragging it down until you see the "piano roll" similar to the picture below.
 
-==== Draw your MIDI area
+.Draw your MIDI area
 Enable draw mode by clicking on the pencil icon.
 
 - Draw a MIDI area that is 1 *beat* / 4 *measures* long. Don't worry if you don't know what that means, you can just draw from the `1` to the `2` following the `Bars:Beats` bar.
 // See the image below.
 // TODO: No image here!
 
-==== Draw your MIDI pattern
+.Draw your MIDI pattern
 I'm just going to place a simple 4/4 pattern. You can do anything you like, but don't get too crazy yet, it's going to be repeating behind you while you sculpt the sound.
 
 image::screenshots/ardour-midi-4-4-with-snare.png[]
 
 .Info
 NOTE: This tutorial uses note C4 as our starting note.
 
-==== Loop your MIDI pattern
+.Loop your MIDI pattern
 Now we're going to tell Ardour to loop this specific region whenever we tell it to play. Right click on your MIDI area, select "play", and "loop region".
 
 You should now here your pattern being played with your kick drum and the default Addsynth sound.
@@ -47,42 +47,42 @@ NOTE: You can mute the kick drum at any time by selecting the `M` button on the
 
 image::screenshots/ardour-mute-kick-track.png[]
 
-==== Launch Zyn-Fusion
+.Launch Zyn-Fusion
 * Select your `Synth` track and then *double-click* on the ZynAddSubFX button (circled in red below)
 
-==== Launch ADDsynth
+.Launch ADDsynth
 Launch the ADDsynth by selecting the `ADD` button.
 
 .What Key am I in?
 NOTE: We use note `C4` as our starting point.
 
-==== Raise the volume
+.Raise the volume
 Snares are meant to be heard, let's turn ours all the way up.
 
 * Navigate to `Global >> Amplitude`
 ** Adjust `Volume` to 100%
 
-==== Open up the global filter
+.Open up the global filter
 A snare generates a wide range of frequncies so let's open the global filter all the way up to let all frequencies through.
 
 * Navigate to `Global >> Filter`
 ** Adjust the `General >> Cutoff` to 100%
 
-==== Modify your amplitude envelope
+.Modify your amplitude envelope
 We're going to shorten the *Release*, *Sustain*, and *Decay* of the amplitude envelope for voice 1, or in simpler terms, let's make the note  have a "shorter" more percussive sound.
 
 * Navigate to `VCE1 >> Voice >> Amplitude >> Envelope`
 ** Enable it by pressing the grayed out power button until it lights up.
 ** Adjust `R.DT` and `S.DT` to `0`.
 ** Adjust the `D.DT` to `32`
 
-==== Lower the octave
+.Lower the octave
 Now that we have a short percussive sound, let's lower the octave of `VCE 1` so that it's something closer to the hit of a snare drum.
 
 * Navigate to `VCE1 >> Voice >> Frequency`
 ** Adjust the `Octave` to `-2`
 
-==== Modify your frequency envelope
+.Modify your frequency envelope
 Now lets adjust the frequency of our sound a bit to give it a bit more "bounce" by adjusting the *Attack Value*.
 
 * Navigate to `VCE1 >> Voice >> Amplitude >> Envelope`
@@ -93,13 +93,13 @@ Let's add a little more length to the sound by extending the *Attack Decay* time
 * Navigate to `VCE1 >> Voice >> Amplitude >> Envelope`
 ** Adjust `A.DT` to `25`
 
-==== Use a second voice to add the snare "sizzle"
+.Use a second voice to add the snare "sizzle"
 Now that we've got a basic _thwacking_ percussive sound that is similar to a snare drum it's time to add the _sizzle_ that is created by the metallic snare wires.
 
 * Navigate to `VCE 2` by clicking the `+` beside `VCE 1`
 * Enable `VCE 2` by clicking on the power button.
 
-==== Enable noise modulation
+.Enable noise modulation
 We're going to add some noise much like we did when creating our kick drum previously, only this time we're going to use `white` noise instead of `pink`.
 
 .Tip
@@ -115,23 +115,23 @@ Now you may notice that the noise is too loud compared to the smack of our drum.
 ** Adjust `Vol` to `100`
 *** Note that this means the actual value of 100, not 100%.
 
-==== Enable amplitude envelope
+.Enable amplitude envelope
 Now that we've set a decent volume between the _thwack_ and the _sizzle_ of the sound, let's adjust the amplitude of the noise generated by VC2 to match that of VCE1.
 
 * Navigate to `VCE1 >> Voice >> Amplitude >> Envelope`
 ** Enable it by pressing the grayed out power button until it lights up.
 ** Adjust `R.DT` and `S.DT` to `0`.
 ** Adjust the `D.DT` to `32`
 
-==== Save your instrument
+.Save your instrument
 Congratulations, you've crafted a snare drum - starting with a single sin wave and using additive synthesis!
 
 Now would be a great time to save your Zyn-fusion instrument and Ardour session.
 
 * Navigate to `File >> Save instrument`
 * Choose a directory and name your file before selecting `Enter`
 
-==== Save your Ardour session
+.Save your Ardour session
 
 * Navigate to your Ardour window
 * `Ctrl + S`

Makefile

@@ -2,4 +2,7 @@
 C=asciidoctor
 
 html:
-	$(C) -a toc Manual.adoc
+	$(C) \
+		-a toc \
+		-a toclevels=4 \
+		Manual.adoc