From 2db4eaa626cb17584585ae070ec8fdedcf986a41 Mon Sep 17 00:00:00 2001 From: terminator356 Date: Tue, 7 Jan 2014 02:20:56 -0500 Subject: Move READMEs etc back into muse2, create README link. --- muse2/README.instruments | 149 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 149 insertions(+) create mode 100644 muse2/README.instruments (limited to 'muse2/README.instruments') diff --git a/muse2/README.instruments b/muse2/README.instruments new file mode 100644 index 00000000..1bc66e7f --- /dev/null +++ b/muse2/README.instruments @@ -0,0 +1,149 @@ +================================================ + MusE loadable Midi Instrument Definitions + (valid from around MusE 0.8.1, Edited by Tim NOV.11.2012, at MusE 2.1rc1) +================================================ + + - File Extension ".idf" + - searched in Subdirectory "instruments" + (/usr/share/muse/instruments on my system) + - Can be viewed, created or edited with menu 'Midi -> Edit Instrument' + + All found instrument definitions are presented by MusE + in Config->MidiPorts in Pulldown in column "Instrument". + +------------------------------------------------- + Example of Instrument Definition File: +------------------------------------------------- + + + + + + ...MusE event list which initializes instrument + + + + + ... + + + + + + ... + + + + ... + + + +------------------------------------------------- + Notes +------------------------------------------------- + + (1) PatchGroups are not mandatory; its valid to write: + + + + + + + ... + + + (2) An "Instrument Definition File" can define more than on + Instrument, but it is recommended to use one file for + one instrument + + (3) the "prog" parameter in a "Patch" is mandatory. Missing + "hbank" or "lbank" are treated as "don't care". + Missing "drum" is treated as drum="0". + + A XG-Patch looks like: + + + (5) Prior to version 2.1: + --------------------- + A patch can be associated with a "mode" with one of + + 1 - GM + 2 - GS + 4 - XG + + Example: + + + Mode id's can be ore'd together for patches which are valid + for more than one mode: + + + + From version 2.1: + ----------------- + There is no 'mode' parameter. The selection of GM, GS, or XG instruments + or other instruments with an sysex 'Init' section, determines what 'mode' + the device is in. + + (4) example for MusE event (Sysex "XG-On"): + + + 43 10 4c 00 00 7e 00 + + + (5) ... part can be omitted + + From version 2.1: + ----------------- + This section contains initialization events to be sent to the devices + upon certain changes such as device selection, change of instrument etc. + Usually it contains a brief series of sysex commands such as (4) to set the + device to a 'mode'. + + (6) Controllers have the following properties: + + name: arbitrary unique (short) string describing the controller + + type: Controller7 regular 7-bit controller + Controller14 14-bit controller + RPN registered parameter 7-bit + NRPN non registered parameter 7-bit + RPN14 registered parameter 14-bit + NRPN14 non registered parameter 14-bit + Pitch pitch mod wheel + Program program + From version 2.1: + PolyAftertouch key pressure controller + Aftertouch channel pressure controller + + Default Controller7 if omitted. + Pitch Program PolyAftertouch and Aftertouch are convenience controllers which + wrap functionality in one controller. They translate to and from the real midi messages + which are behind the scenes such as Pitch -> midi 0xE0. Their controller numbers are + internal and cannot be changed. PolyAftertouch is really an internal per-pitch controller. + + h: controller number MSB. Default 0 if omitted. + l: controller number LSB. Default 0 if omitted. + For per-pitch controllers, 'l' can also be "pitch" indicating each 'note' or + 'drum sound' has its own controller. Some devices such as XG support this. + + min: minimum value for controller + max: maximum value for controller + init: reset value for controller; when controller value is + undefined after instrument reset, use the ''undefined'' + value 0x10000 + + The min/max/init values can be omitted + Auto-biasing feature: If min is less than zero, such as with + pan = -64 -> 63, MusE automatically displays this range, + yet uses the true range of 0-127 'behind the scenes'. + + From version 2.1: + ---------------- + showType: Combination of 1: Show controller in drum tracks. + and 2: Show controller in midi tracks. + Default is to show in both drum and midi tracks if omitted (same as "3"). + + Here is a per-pitch drum controller example from the XG instrument definition file: + + \ No newline at end of file -- cgit v1.2.3