From cc550da6023361ec49b3f6ba4ca9aa3568161137 Mon Sep 17 00:00:00 2001 From: Paul Davis Date: Wed, 5 Oct 2022 12:54:23 -0600 Subject: [PATCH] add a new subsection on controlling MIDI note range --- include/controlling-midi-range.html | 36 ++++++++++++++++++++++++++++ include/edit-midi.html | 22 +++++++---------- master-doc.txt | 8 +++++++ source/images/midi-scroomer.png | Bin 0 -> 2436 bytes 4 files changed, 53 insertions(+), 13 deletions(-) create mode 100644 include/controlling-midi-range.html create mode 100644 source/images/midi-scroomer.png diff --git a/include/controlling-midi-range.html b/include/controlling-midi-range.html new file mode 100644 index 00000000..9c099901 --- /dev/null +++ b/include/controlling-midi-range.html @@ -0,0 +1,36 @@ + +

+ The visible note range in a MIDI track can be controlled in two + principle ways: the note scroomer, or the scroll wheel of your + mouse. +

+ +

Using the scroomer

+ +

+ The scroomer offers two kinds of control. You can "grab" it in the + middle and move it up or down - this adjusts the absolute note range + displayed up or down. Alternatively you can "grab" the top or bottom + handle of the scroomer, and move that up or down - this adjusts the + extent of the note range displayed. + +

+MIDI scroomer +
MIDI scroomer
+
+ +

Using your scroll wheel

+ + +

+ Several scroll operations can be used to control the visible note + range: +

  • In internal edit mode, with no notes selected, unmodified + scrolling will move the visible range up and down.
    • +
  • scroll will increase and decrease the + visible range (zoom out and in)
    • +
  • scroll will expand either the top or + bottom of the visible note range (depending on scroll + direction). Think of this as "show me higher pitches" or "show me + lower pitches". +

    diff --git a/include/edit-midi.html b/include/edit-midi.html index 5dc4592c..683d11c2 100644 --- a/include/edit-midi.html +++ b/include/edit-midi.html @@ -14,17 +14,11 @@ window or pane. Notes are edited right where they appear.
  • - Editing note information in Ardour occurs in only a single region. There is - no way currently to edit note data for multiple regions at the same time; - so, for example, notes cannot be selected in several regions and then all - deleted, nor can they be copied and pasted from one region to another. - Regions, however, can be copied and pasted just as with audio. -
    • -
  • - When using jackd as the audio server for Ardour, all MIDI I/O is done - via JACK for sample accurate timing and maximal efficiency when communicating - with external software synthesizers. Otherwise, Ardour connects to midi - via the existing OS MIDI system. + Editing note information in Ardour occurs in only a single + region. There is no way currently to edit note data for multiple + regions at the same time; so, for example, notes cannot be + selected in several regions at once and then all deleted. However + they can they be copied and pasted from one region to another.
  • Every MIDI track has its own MIDI port for input; it may have an @@ -44,9 +38,11 @@ There is a Normal and a Percussive mode for note data editing.
  • - The vertical dimension of the region window is controlled by a + The visible note range is controlled by a scroomer widget, which is a combination scroll/zoom tool for - altering the zoom level and range of visible MIDI data. + altering the zoom level and range of visible MIDI data. When in + internal edit mode, you can also use scroll operations to adjust + the visible range in various ways.
    • diff --git a/master-doc.txt b/master-doc.txt index 90e20259..33c61b8b 100644 --- a/master-doc.txt +++ b/master-doc.txt @@ -1378,6 +1378,14 @@ uri: working-with-midi part: chapter --- +--- +title: Adding New Notes +include: controlling-midi-range.html +link: controlling-midi-range +uri: working-with-midi/controlling-midi-range +part: subchapter +--- + --- title: Adding New Notes include: add-new-notes.html diff --git a/source/images/midi-scroomer.png b/source/images/midi-scroomer.png new file mode 100644 index 0000000000000000000000000000000000000000..14202c5f334958832dacc031cd559d91c3d71d07 GIT binary patch literal 2436 zcmV-~348X5P){fl_0fkqdy6=6Ys!$O@OTF44l)|ckA|R_EmTeOVCxpU6B_i|sAmv`9hbDK7Sn*4tM;lqc!y1G;?`}+Fs z-o4w?`x5|M@49j5(4i2(f%lto;vdIiG18G7$8j7Nf8E*H`RLIjRTxPk?D_NOBnv?h z^7HfKug{-9Zppd}K-pF7m61~ysbdoHvx?oe&dm=0^FAt?fijJTDr@ou#sZ*^} zQ`1^3E4`JTit?m4^})XQ;_v5fghCUEcTC^UN=iyd7Kz7BG#KLGP#s1Yr1CtUlY`?&>celW zE69Nl_himN+S>k=4R6#aoH&R^Eu}b!2&42|{7zj~R)*E0I!vb)VCr`4mxr^{IS!Wv zyp>?D1+c=vWtg25P4X+Ce7!O(5{Zx+wpy(=n@#>su)D3}-w(pS{iwRWa(pBb`?B@V zpX9kcRbQVU3IxOll;5n4y}g@oW|NbX$)CKCAP92U%;#Y%C@K){hvp}O$$p?4R$E`oIadrld<4;F000Y-&Ql#j&+Suz z;Nu&YZ{FtI%XMM^UfBJb8Ou5!wr7t zRL8TCi6GR!`R?!YY{^#x5k|Q^rryLilv?UO-OxX?p??Mn^I#tj96(8dWBXs<8k~Yy z3_f;3mC|KLWE2+{>pDLdz?*geyYvnRPzg{;4RV=xD3>`{Q`37H9fRm|{aw3urNh$) z8yp-8Fh_4M@UvIhXa|J&x~zZijm{xOLBkxBiT+Tn0uh0)Zb1(ej9UYWF0 zGZ>acZ=^i#VLf(AFhLNoT2zNo2B}u7)o!IWM$5%4EG&=?qkKdW%f&F5 zeyQKjuu{1PKHMY1&YU@;YMo{n{OtD^CD*U6u2wV(hr@wDAl}=w+{^$VwL1gAd?X~n zu3fvPc;xZp$B!I2qJ^OCnDi6{xSZQC|Q zi=m;RzP>(W*y+=!6)h02Am;T(23vYC$@P~lTehgAEQKaCij|47(1dAV(rvIPg;U;kP|0PkdCaYtCL6J(}{zKu$h?|(vfp>bE>Ut zlu7%UsbSeD(P(UJBpqg;J_G1+keZqr11(ZiRaKQb=~2C(Su7Uh*^rbgh_P^zqRi|1 z43@s6dJuHAx3?!&@`~R}rKu{EXKKXtfYhS}axK9)h<34h5C&T`iQahq`gM{;Sy|bN z6)P}d-QC?J3!l%21vBq&#$YHCy|JRAf@D!pkUUd4UD(c@JF!|+hh<=bqO@!nB`SwC zBGx@!R(l*oQHxR!BG>CNUDothkp27jlPnO|0}^3avjXWd?{CIn3`UjM&#qp*O0w{H zJS$hO#Dv|sbBAQXaU2%Rq`w)fNlgeR7efi#%Ck&3xfn`7I!Q~WCRIGMbLY;HEUK!i z>g($W$oIQJ1%KG82G^W=x4zd_x%Z8Z&W@H0~ zbYa>zU@$Be2T6$4q|#x!Heg5>rgsB|v|u_#*un(>0A?R{L<6Ia+HDs1a%I@W!~_sz zv)PiSRFk%F0f4z+-`D=$@#xG4?&(!2VPFwPe^imfC|kGyME`T)hHYg%-1(nkJG#F{ z$`&qTw>!s|Z>pXiAgxTQ`wF7Cg-b2~%#2+8adP`++LRaFXQsS`3+KGmHR$AG;Y;5| z28ID3(EZ;Di00R>ksph;g^RmkgQw};XItKmEPn$4#(lq=tX`9JtnM=-ZQ;TLc&#wn zb8Fyn1YmXEt^4@}0#v-@{UR*Mx#dcoiJ-WJOI&m7*80}1^#K4t>Mjc+jFcN8DRm2% zxRwD>mgvgH{mg6|E5F)XxUia3nXp{hpGBilk_FH6 zSa%r_76=4L7A&~=O2INZEI1=yK3$8_Nsk1B!EBU?Qr5qbFFucx9?>4+Mo5pao!uBr zS*9-&Mc>(tmL6G*o!wY^guz}}Sf>OmKt=aHAjp@fs