From 284f2340a3b6b346a97899573a09af998fa7def7 Mon Sep 17 00:00:00 2001
From: Ed Ward <edwsaintesprit@hotmail.com>
Date: Tue, 6 Apr 2021 18:37:01 +0200
Subject: [PATCH] Added a page about the new Virtual MIDI Keyboard

---
 include/the-window-menu.html       |   2 +-
 include/virtual-keyboard.html      | 100 +++++++++++++++++++++++++++++
 master-doc.txt                     |   7 ++
 source/images/virtual_keyboard.png | Bin 0 -> 8043 bytes
 4 files changed, 108 insertions(+), 1 deletion(-)
 create mode 100644 include/virtual-keyboard.html
 create mode 100644 source/images/virtual_keyboard.png

diff --git a/include/the-window-menu.html b/include/the-window-menu.html
index f0af1e4..6c8e4c7 100644
--- a/include/the-window-menu.html
+++ b/include/the-window-menu.html
@@ -35,7 +35,7 @@
 
 	<tr><th>&square; Keyboard Shortcuts</th><td>Opens up a <a href="@@default-keyboard-bindings">Keyboard Shortcuts window</a>, which allows for easy creation or modification of any keyboard binding</td></tr>
 	
-	<tr><th>&square; Virtual Keyboard</th><td>Opens up a virtual MIDI keyboard. If a MIDI track is selected (or many), this keyboard can be used to play, record or affect the selected track(s) or automation as an hardware device would.</td></tr>
+	<tr><th>&square; Virtual Keyboard</th><td>Opens up the <a href="@@virtual-keyboard">virtual MIDI keyboard</a>. If a MIDI track is selected (or many), this keyboard can be used as an hardware device would.</td></tr>
 	<tr><th>Midi Tracer</th><td>Opens the <kbd class="menu">MIDI Tracer</kbd> window, allowing to follow each and every MIDI message entering or leaving Ardour</td></tr>
 	<tr><th>&square; Log</th><td>Shows the <kbd class="menu">Log</kbd> window, where Ardour lists useful information, warnings and errors</td></tr>
 </table>
diff --git a/include/virtual-keyboard.html b/include/virtual-keyboard.html
new file mode 100644
index 0000000..0c9354a
--- /dev/null
+++ b/include/virtual-keyboard.html
@@ -0,0 +1,100 @@
+
+<figure class="right">
+  <img src="/images/virtual_keyboard.png" alt="The Virtual Keyboard window">
+  <figcaption class="center">
+    The Virtual Keyboard window
+  </figcaption>
+</figure>
+
+<p>
+  The <dfn>Virtual Keyboard</dfn> is a software MIDI instrument, similar to
+  <a href="https://vmpk.sourceforge.io/">VMPK</a> that can be used like an
+  hardware musical keyboard would, to emit MIDI events.
+</p>
+
+<p>
+  It can be used to test or record MIDI notes or events, as the computer 
+  keyboard can be (and is, by default) mapped to the virtual MIDI keyboard.
+  The keyboard layout can be chosen in the 
+  <a href="@@preferences#preferences-midi">MIDI Preferences</a>.
+</p>
+
+<p>
+  The lower part of the window is a piano keyboard. The current keyboard
+  mapping is overlaid on the notes, as are the different <em>C</em> notes,
+  indicating what octaves are shown.
+</p>
+
+<p>
+  The upper part comprises (from left to right):
+</p>
+
+<ul>
+	<li>
+		A channel selector to choose on which MIDI channel the events are generated
+	</li>
+	<li>
+		A pitch bend that can bend &plusmn;2 semtones up or down. The controls are:
+		<ul>
+			<li>Mousewheel up/down : persistent bend up/down</li>
+			<li>Mouse-drag up/down (by <kbd class="mouse">left</kbd>-clicking
+			anywhere in the slider) : sprung-mode bend up/down (returns to
+			&plus;0 semitone when the mouse button is released)</li>
+			<li><kbd>F1</kbd> : abruptly &minus;2 semitones</li>
+			<li><kbd>F2</kbd> : abruptly &minus;1 semitone</li>
+			<li><kbd>F3</kbd> : abruptly &plus;1 semitone</li>
+			<li><kbd>F4</kbd> : abruptly &plus;2 semitones</li>
+			<li><kbd>&darr;</kbd> : ramps to &minus;2 semitones</li>
+			<li><kbd>&uarr;</kbd> : ramps to &plus;2 semitones.</li>
+		</ul>
+	</li>
+	<li>
+		A modulator, with a modulation depth between 0 and 127, 127 being
+		a modulation of &plusmn; 1 semitone, so 2 semtones peak-to-peak.
+	</li>
+	<li>
+		Four assignable knobs. By default, they are:
+		<ul>
+			<li>CC-7 (Channel Volume)</li>
+			<li>CC-8 (Balance)</li>
+			<li>CC-91 (Reverb)</li>
+			<li>CC-7 (Chorus)</li>
+		</ul>
+		These controls can be assigned as needed by clicking the button under
+		each knob and selecting a different Control Number.
+	</li>
+	<li>
+		<em>Octave</em> : a selector to choose where on the keyboard (on which
+		octave) the keyboard view is. The chosen octave will be the second one
+		displayed, i.e. if "Octave" is set to 3, the leftmost displayed octave
+		will be 2.<br>
+		The selected octave is also where the keyboard mapping is set, so
+		if the octave is set to 3, in a QWERTY setup, the leftmost (lowest) note,
+		<kbd>Z</kbd>, is mapped to C3.<br>
+		The controls are:
+		<ul>
+			<li><kbd>&larr;</kbd> : decrease Octave by one (i.e., scroll the view to the left)</li>
+			<li><kbd>&rarr;</kbd> : increase Octave by one (i.e., scroll the view to the right)</li>
+		</ul>
+	</li>
+	<li>
+		<em>Range</em> determines how many octaves are displayed.
+	</li>
+	<li>
+		<em>Velocity</em> sets the intensity of the note, which contributes 
+		to its audio volume, and can, depending on the virtual instrument,
+		play a role in the sample selection.<br>
+		Although the drop down menu only lists a few values, scrolling the mouse
+		over the control, as with the other selectors, allows to change its
+		value with a finer in/decrement.
+	</li>
+	<li>
+		A <em>Transpose</em> selector, that shifts the notes played by its value
+		in semitones, either up or down, effectively tuning the whole keyboard.
+	</li>
+	<li>
+		A <em>Panic</em> button, to immediately stop all MIDI sound.
+	</li>
+
+</ul>
+
diff --git a/master-doc.txt b/master-doc.txt
index 797c621..63ac901 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1430,6 +1430,13 @@ uri: working-with-midi/step-entry
 part: subchapter
 ---
 
+---
+title: The Virtual MIDI Keyboard
+include: virtual-keyboard.html
+link: virtual-keyboard
+part: subchapter
+---
+
 ---
 title: MIDI Automation
 include: midi-automation.html
diff --git a/source/images/virtual_keyboard.png b/source/images/virtual_keyboard.png
new file mode 100644
index 0000000000000000000000000000000000000000..51ad45855cfad20a02e377665c28e2736ee90a90
GIT binary patch
literal 8043
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
D2~EHh

literal 0
HcmV?d00001