X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fpatch-change.html;h=005bafc2e875a6d394afd9ef3501dbf52b8cb5db;hb=e74c09802c2ca4038144d051c425a65661bde3ea;hp=ce0a2dbd9f468e4902192c32ceacc7013b7bef9e;hpb=74d343ee53e0087454e4cd8ec88006f02edfc6d0;p=ardour-manual diff --git a/include/patch-change.html b/include/patch-change.html index ce0a2db..005bafc 100644 --- a/include/patch-change.html +++ b/include/patch-change.html @@ -53,27 +53,27 @@

Names for Patch Numbers: MIDNAM files

- MIDNAM files assign human-redable names to the "coordinates" (MSB, LSB, pc) of - instruments and controls of MIDI-devices. Quite some files already come pre-bundled + MIDNAM files assign human-redable names to the "coordinates" (MSB, LSB, pc) of + instruments and controls of MIDI-devices. A number of MIDNAM files come already pre-bundled with Ardour. Should this not be the case for your device, you can add your own (see below).

Selecting a device

- For the proper names to show up in the "Patch Selector"-dialog, you have to assign a - device to your current track. To do so, hover the lower border of the tracks header - (the mouse-cursor will change to a "resize-cursor") and expand it. + For the proper names to show up in the "Patch Selector"-dialog, you have to assign a + device to your current track. To do so, hover the lower border of the tracks header + (the mouse-cursor will change to a "resize-cursor") and expand it. You'll see dropdown menus. Select your device in the menu.

Adding a custom MIDNAM-file

- MIDNAM-files are XML-Files. You can edit them using your favorite text-editor. When + MIDNAM-files are XML-Files. You can edit them using your favorite text-editor. When doing so, please ensure to change the "Model" of the device, as Ardour will only load each model once (i.e. it will skip files, if there are clashes).

- After you have done modifications to a file, it's a good idea to validate it. This can + After you have done modifications to a file, it is a good idea to validate it. This can be done using the tool xmllint as shown below:


@@ -82,16 +82,18 @@ $ wget http://www.midi.org/dtds/MIDINameDocument10.dtd
 $ xmllint --dtdvalid MIDINameDocument10.dtd myfile.midnam
 

- Once you are satisfied with your file, you have to put it at a location where Ardour - picks it up. The best place would be the (hidden) directory - .config/ardour5/patchfiles/ - in your home-folder. Should the sub-directory patchfiles not exist yet, just - create it. The path and file-names are case-sensitive. The file should end with + Once you are satisfied with your file, you have to put it at a location where Ardour + picks it up. The best place would be the (hidden) directory + Ardour configuration directory + subdirectory patchfiles. + in your home-folder. Should the sub-directory patchfiles not exist yet, just + create it. The path and file-names are case-sensitive. The file should end with ".midnam".

After restarting Ardour, hit the small Log-button in the upper right corner of the - main window. It should say something like: + main window. It should say something like + (this is Linux, Macos or Windows will be different):

[INFO]: Loading 3 MIDI patches from /home/username/.config/ardour5/patchfiles

@@ -99,7 +101,7 @@ $ xmllint --dtdvalid MIDINameDocument10.dtd myfile.midnam

Should the MIDNAM-file be useful for the general public, it would be nice to share it: - Fork the Ardour-project on gitHub by + Fork the Ardour-project on gitHub by hitting the "Fork"-Button. Go to the patchfiles-directory (and read the README).