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

7.5: update vkeybd docs

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

48
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>
@ -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