ardour/manual
13
0
Fork 0
Code Pull Requests Releases Activity

7.5: update vkeybd docs

Browse Source
This commit is contained in:
Alexandre Prokoudine 2023-06-25 13:57:12 +02:00
parent 71567ed188
commit 741d252c61
2 changed files with 33 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
include/virtual-keyboard.html
View File

@ -1,17 +1,18 @@
<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>
<figure class="left">
<img src="/images/virtual_keyboard.png" alt="The Virtual Keyboard window"
width="75%">
<figcaption class="left">
The Virtual Keyboard window
</figcaption>
</figure>
<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.
@ -34,18 +35,23 @@
A channel selector to choose on which MIDI channel the events are generated
</li>
<li>
A pitch bend that can bend as much as the virtual instrument allows. The controls are:
A pitch bend that can bend as much as the virtual instrument allows.
The MIDI specification defines the pitch-bend range as [0..16383].
So Ardour maps that range to whatever the synth has and sets the
neutral/middle position in the virtual keyboard to 8192. If the synth
operates in the +/- 2 semitones range, that makes 1 semitone 4096
units large. 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>
<li><kbd>F1</kbd>: abruptly all the way down</li>
<li><kbd>F2</kbd>: abruptly half the way down</li>
<li><kbd>F3</kbd>: abruptly half the way up</li>
<li><kbd>F4</kbd>: abruptly all the way up</li>
<li><kbd>&darr;</kbd>: ramps all the way down</li>
<li><kbd>&uarr;</kbd>: ramps all the way up.</li>
</ul>
</li>
<li>
@ -64,7 +70,7 @@
each knob and selecting a different Control Number.
</li>
<li>
<em>Octave</em> : a selector to choose where on the keyboard (on which
<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>
@ -73,8 +79,8 @@
<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>
<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>
@ -84,9 +90,15 @@
<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.
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.<br>
Available shortcuts are:
<ul>
<li><kbd>F5</kbd>: sets velocity to 32</li>
<li><kbd>F6</kbd>: sets velocity to 64</li>
<li><kbd>F7</kbd>: sets velocity to 96</li>
<li><kbd>F8</kbd>: sets velocity to 127</li>
</ul>
</li>
<li>
A <em>Transpose</em> selector, that shifts the notes played by its value
@ -95,6 +107,6 @@
<li>
A <em>Panic</em> button, to immediately stop all MIDI sound.
</li>
</ul>

BIN
source/images/virtual_keyboard.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 7.9 KiB

After

Width:  |  Height:  |  Size: 33 KiB