v0.8.17

- Made class `meico.midi.InstrumentsDirectory` public so it can be used outside of its package. - Extended method `meico.mei.Mei.makePart()`. - This addresses issue [#23](#23) where the staff label did not suffice to properly indicate which General MIDI instrument should be chosen during the MIDI export. - Thus, support for MEI element `instrDef` has been added. It should be used as follows. ```` <staffDef clef.line="2" clef.shape="G" lines="5" n="1" label="unhelpful label"> <instrDef midi.instrname="Violin" midi.instrnum="40"/> </staffDef> ```` Only one of the attributes `midi.instrnum` (prioritized) and `midi.instrname` is required. The former should have values from 0 to 127 (not 1 to 128!). A list of General MIDI instrument names and numbers can be found on [Wikipedia](https://en.wikipedia.org/wiki/General_MIDI) (here the numbers must be decreased by 1!). - Meico will add a `programChangeMap` to the MSM part during export and use this instead of the label to generate the corresponding MIDI messages during MIDI export. - The MEI Coverage Documentation has been updated accordingly and provides further information.
cemfi · Sep 18, 2020 · 6d56105 · 6d56105
1 parent 746d04b
commit 6d56105
Show file tree

Hide file tree

Showing 241 changed files with 545 additions and 478 deletions.
diff --git a/MEI_Coverage_Documentation.md b/MEI_Coverage_Documentation.md
@@ -160,7 +160,15 @@ Hairpins indicate a continuous dynamics transition. Their processing is similar
 This creates a copy of the preceding timeframe. This timeframe is `0.5 * length of one measure`.
 
 #### instrDef
-This element is deliberately ignored. Meico handles and generates MIDI-related information individually, more comprehensive and more consistent than MEI does.
+If the staff label did not suffice to properly indicate which General MIDI instrument should be chosen during the MIDI export, this element can be used to provide clarity. This element is supported only in the `staffDef` environment, i.e. as child or sub-child of a `staffDef` element such as demonstrated in the MEI Encoding Guidelines in the section on [Recording General MIDI Instrumentation](https://music-encoding.org/guidelines/v4/content/integration.html#midiInstruments). Here is another example.
+````
+<staffDef clef.line="2" clef.shape="G" lines="5" n="1" label="unhelpful label">
+    <instrDef midi.instrname="Violin" midi.instrnum="40"/>
+</staffDef>
+````
+Only one of the attributes `midi.instrnum` (prioritized) and `midi.instrname` is required. The former should have values from 0 to 127 (not 1 to 128!). A list of General MIDI instrument names and numbers can be found on [Wikipedia](https://en.wikipedia.org/wiki/General_MIDI) (here the numbers must be decreased by 1!). Meico will generate an according `programChangeMap` in the MSM export and use it instead of the staff labels to trigger the correct instruments.
+
+In the presence of multiple `instrDef` elements (maybe via `layerDef` subtrees or an `instrGrp`) meico will choose only the first of them for export. Meico does not support multiple instruments per staff as this requires a different handling of all the information in the staff MIDI-wise. This is reserved to the user who can import the MIDI data to a Digital Audio Worktation (DAW) and further produce the music.
 
 #### instrGrp
 This element is deliberately ignored. Meico handles and generates MIDI-related information individually, more comprehensive and more consistent than MEI does.

diff --git a/docs/allclasses-frame.html b/docs/allclasses-frame.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>All Classes</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>

diff --git a/docs/allclasses-noframe.html b/docs/allclasses-noframe.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>All Classes</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>

diff --git a/docs/constant-values.html b/docs/constant-values.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>Constant Field Values</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -95,7 +95,7 @@ <h2 title="meico">meico.*</h2>
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;java.lang.String</code></td>
 <td><code><a href="meico/Meico.html#version">version</a></code></td>
-<td class="colLast"><code>"0.8.15"</code></td>
+<td class="colLast"><code>"0.8.17"</code></td>
 </tr>
 </tbody>
 </table>
@@ -2259,7 +2259,7 @@ <h2 title="meico.midi">meico.midi.*</h2>
 </li>
 <li class="blockList">
 <table class="constantsSummary" border="0" cellpadding="3" cellspacing="0" summary="Constant Field Values table, listing constant fields, and values">
-<caption><span>meico.midi.meico.midi.InstrumentsDictionary</span><span class="tabEnd">&nbsp;</span></caption>
+<caption><span>meico.midi.<a href="meico/midi/InstrumentsDictionary.html" title="class in meico.midi">InstrumentsDictionary</a></span><span class="tabEnd">&nbsp;</span></caption>
 <tr>
 <th class="colFirst" scope="col">Modifier and Type</th>
 <th scope="col">Constant Field</th>

diff --git a/docs/deprecated-list.html b/docs/deprecated-list.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>Deprecated List</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>

diff --git a/docs/help-doc.html b/docs/help-doc.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>API Help</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>

diff --git a/docs/index-files/index-1.html b/docs/index-files/index-1.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>A-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-10.html b/docs/index-files/index-10.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>J-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-11.html b/docs/index-files/index-11.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>K-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-12.html b/docs/index-files/index-12.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>L-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-13.html b/docs/index-files/index-13.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>M-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-14.html b/docs/index-files/index-14.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>N-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-15.html b/docs/index-files/index-15.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>O-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-16.html b/docs/index-files/index-16.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>P-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-17.html b/docs/index-files/index-17.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>Q-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-18.html b/docs/index-files/index-18.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>R-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-19.html b/docs/index-files/index-19.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>S-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-2.html b/docs/index-files/index-2.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>B-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-20.html b/docs/index-files/index-20.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>T-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-21.html b/docs/index-files/index-21.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>U-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-22.html b/docs/index-files/index-22.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>V-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-23.html b/docs/index-files/index-23.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>W-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-24.html b/docs/index-files/index-24.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>X-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-3.html b/docs/index-files/index-3.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>C-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-4.html b/docs/index-files/index-4.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>D-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-5.html b/docs/index-files/index-5.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>E-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-6.html b/docs/index-files/index-6.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>F-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-7.html b/docs/index-files/index-7.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>G-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-8.html b/docs/index-files/index-8.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>H-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index-files/index-9.html b/docs/index-files/index-9.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>I-Index</title>
-<meta name="date" content="2020-08-24">
+<meta name="date" content="2020-09-18">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>

diff --git a/docs/index.html b/docs/index.html
@@ -2,7 +2,7 @@
 <!-- NewPage -->
 <html lang="de">
 <head>
-<!-- Generated by javadoc (1.8.0_172) on Mon Aug 24 10:25:28 CEST 2020 -->
+<!-- Generated by javadoc (1.8.0_172) on Fri Sep 18 12:51:49 CEST 2020 -->
 <title>Generated Documentation (Untitled)</title>
 <script type="text/javascript">
     tmpTargetPage = "" + window.location.search;