]> git.donarmstrong.com Git - lilypond.git/blob - scripts/midi2ly.py
Merge branch 'master' into lilypond/translation
[lilypond.git] / scripts / midi2ly.py
1 #!@TARGET_PYTHON@
2 #
3 # midi2ly.py -- LilyPond midi import script
4
5 # This file is part of LilyPond, the GNU music typesetter.
6 #
7 # Copyright (C) 1998--2011  Han-Wen Nienhuys <hanwen@xs4all.nl>
8 #                           Jan Nieuwenhuizen <janneke@gnu.org>
9 #
10 # LilyPond is free software: you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation, either version 3 of the License, or
13 # (at your option) any later version.
14 #
15 # LilyPond is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 # GNU General Public License for more details.
19 #
20 # You should have received a copy of the GNU General Public License
21 # along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
22
23
24 '''
25 TODO:
26 '''
27
28 import os
29 import sys
30
31 """
32 @relocate-preamble@
33 """
34
35 import midi
36 import lilylib as ly
37 global _;_=ly._
38
39 ################################################################
40 ## CONSTANTS
41
42
43 LINE_BELL = 60
44 scale_steps = [0, 2, 4, 5, 7, 9, 11]
45 global_options = None
46
47 clocks_per_1 = 1536
48 clocks_per_4 = 0
49
50 time = None
51 reference_note = 0
52 start_quant_clocks = 0
53
54 duration_quant_clocks = 0
55 allowed_tuplet_clocks = []
56 bar_max = 0
57
58 ################################################################
59
60
61 program_name = sys.argv[0]
62 program_version = '@TOPLEVEL_VERSION@'
63
64 authors = ('Jan Nieuwenhuizen <janneke@gnu.org>',
65            'Han-Wen Nienhuys <hanwen@xs4all.nl>')
66
67 errorport = sys.stderr
68
69 def identify ():
70     sys.stdout.write ('%s (GNU LilyPond) %s\n' % (program_name, program_version))
71
72 def warranty ():
73     identify ()
74     ly.encoded_write (sys.stdout, '''
75 %s
76
77   %s
78
79 %s
80 %s
81 ''' % ( _ ('Copyright (c) %s by') % '1998--2011',
82         '\n  '.join (authors),
83         _ ('Distributed under terms of the GNU General Public License.'),
84         _ ('It comes with NO WARRANTY.')))
85
86 def progress (s):
87     ly.encoded_write (errorport, s + '\n')
88
89 def warning (s):
90     progress (_ ("warning: ") + s)
91
92 def error (s):
93     progress (_ ("error: ") + s)
94     raise Exception (_ ("Exiting... "))
95
96 def debug (s):
97     if global_options.debug:
98         progress ("debug: " + s)
99
100 def system (cmd, ignore_error = 0):
101     return ly.system (cmd, ignore_error=ignore_error)
102
103 def strip_extension (f, ext):
104     (p, e) = os.path.splitext (f)
105     if e == ext:
106         e = ''
107     return p + e
108
109
110 class Duration:
111     allowed_durs = (1, 2, 4, 8, 16, 32, 64, 128)
112     def __init__ (self, clocks):
113         self.clocks = clocks
114         if clocks <= 0:
115             self.clocks = duration_quant_clocks
116         (self.dur, self.num, self.den) = self.dur_num_den (clocks)
117
118     def dur_num_den (self, clocks):
119         for i in range (len (allowed_tuplet_clocks)):
120             if clocks == allowed_tuplet_clocks[i]:
121                 return global_options.allowed_tuplets[i]
122
123         dur = 0; num = 1; den = 1;
124         g = gcd (clocks, clocks_per_1)
125         if g:
126             (dur, num) = (clocks_per_1 / g, clocks / g)
127         if not dur in self.allowed_durs:
128             dur = 4; num = clocks; den = clocks_per_4
129         return (dur, num, den)
130
131     def dump (self):
132         if self.den == 1:
133             if self.num == 1:
134                 s = '%d' % self.dur
135             elif self.num == 3 and self.dur != 1:
136                 s = '%d.' % (self.dur / 2)
137             else:
138                 s = '%d*%d' % (self.dur, self.num)
139         else:
140             s = '%d*%d/%d' % (self.dur, self.num, self.den)
141
142         global reference_note
143         if reference_note: # debugging
144             reference_note.duration = self
145
146         return s
147
148     def compare (self, other):
149         return self.clocks - other.clocks
150
151 def sign (x):
152     if x >= 0:
153         return 1
154     else:
155         return -1
156
157 class Note:
158     names = (0, 0, 1, 1, 2, 3, 3, 4, 4, 5, 5, 6)
159     alterations = (0, 1, 0, 1, 0, 0, 1, 0, 1, 0, 1, 0)
160     alteration_names = ('eses', 'es', '', 'is' , 'isis')
161     def __init__ (self, clocks, pitch, velocity):
162         self.pitch = pitch
163         self.velocity = velocity
164         # hmm
165         self.clocks = clocks
166         self.duration = Duration (clocks)
167         (self.octave, self.notename, self.alteration) = self.o_n_a ()
168
169     def o_n_a (self):
170         # major scale: do-do
171         # minor scale: la-la  (= + 5) '''
172
173         n = self.names[(self.pitch) % 12]
174         a = self.alterations[(self.pitch) % 12]
175
176         key = global_options.key
177         if not key:
178             key = Key (0, 0, 0)
179
180         if a and key.flats:
181             a = - self.alterations[(self.pitch) % 12]
182             n = (n - a) % 7
183
184         #  By tradition, all scales now consist of a sequence
185         #  of 7 notes each with a distinct name, from amongst
186         #  a b c d e f g.  But, minor scales have a wide
187         #  second interval at the top - the 'leading note' is
188         #  sharped. (Why? it just works that way! Anything
189         #  else doesn't sound as good and isn't as flexible at
190         #  saying things. In medieval times, scales only had 6
191         #  notes to avoid this problem - the hexachords.)
192
193         #  So, the d minor scale is d e f g a b-flat c-sharp d
194         #  - using d-flat for the leading note would skip the
195         #  name c and duplicate the name d.  Why isn't c-sharp
196         #  put in the key signature? Tradition. (It's also
197         #  supposedly based on the Pythagorean theory of the
198         #  cycle of fifths, but that really only applies to
199         #  major scales...)  Anyway, g minor is g a b-flat c d
200         #  e-flat f-sharp g, and all the other flat minor keys
201         #  end up with a natural leading note. And there you
202         #  have it.
203
204         #  John Sankey <bf250@freenet.carleton.ca>
205         #
206         #  Let's also do a-minor: a b c d e f gis a
207         #
208         #  --jcn
209
210         o = self.pitch / 12 - 4
211
212         if key.minor:
213             # as -> gis
214             if (key.sharps == 0 and key.flats == 0
215                 and n == 5 and a == -1):
216                 n = 4; a = 1
217             # des -> cis
218             elif key.flats == 1 and n == 1 and a == -1:
219                 n = 0; a = 1
220             # ges -> fis
221             elif key.flats == 2 and n == 4 and a == -1:
222                 n = 3; a = 1
223             # g -> fisis
224             elif key.sharps == 5 and n == 4 and a == 0:
225                 n = 3; a = 2
226             # d -> cisis
227             elif key.sharps == 6 and n == 1 and a == 0:
228                 n = 0; a = 2
229             # a -> gisis
230             elif key.sharps == 7 and n == 5 and a == 0:
231                 n = 4; a = 2
232
233         # b -> ces
234         if key.flats >= 6 and n == 6 and a == 0:
235             n = 0; a = -1; o = o + 1
236         # e -> fes
237         if key.flats >= 7 and n == 2 and a == 0:
238             n = 3; a = -1
239
240         # f -> eis
241         if key.sharps >= 3 and n == 3 and a == 0:
242             n = 2; a = 1
243         # c -> bis
244         if key.sharps >= 4 and n == 0 and a == 0:
245             n = 6; a = 1; o = o - 1
246
247         return (o, n, a)
248
249     def __repr__ (self):
250         s = chr ((self.notename + 2)  % 7 + ord ('a'))
251         return 'Note(%s %s)' % (s, self.duration.dump ())
252
253     def dump (self, dump_dur=True):
254         global reference_note
255         s = chr ((self.notename + 2)  % 7 + ord ('a'))
256         s = s + self.alteration_names[self.alteration + 2]
257         if global_options.absolute_pitches:
258             commas = self.octave
259         else:
260             delta = self.pitch - reference_note.pitch
261             commas = sign (delta) * (abs (delta) / 12)
262             if (((sign (delta)
263                   * (self.notename - reference_note.notename) + 7)
264                  % 7 >= 4)
265                 or ((self.notename == reference_note.notename)
266                     and (abs (delta) > 4) and (abs (delta) < 12))):
267                 commas = commas + sign (delta)
268
269         if commas > 0:
270             s = s + "'" * commas
271         elif commas < 0:
272             s = s + "," * -commas
273
274         if ((dump_dur
275              and self.duration.compare (reference_note.duration))
276             or global_options.explicit_durations):
277             s = s + self.duration.dump ()
278
279         reference_note = self
280
281         # TODO: move space
282         return s + ' '
283
284
285 class Time:
286     def __init__ (self, num, den):
287         self.clocks = 0
288         self.num = num
289         self.den = den
290
291     def bar_clocks (self):
292         return clocks_per_1 * self.num / self.den
293
294     def __repr__ (self):
295         return 'Time(%d/%d)' % (self.num, self.den)
296
297     def dump (self):
298         global time
299         time = self
300         return '\n  ' + '\\time %d/%d ' % (self.num, self.den) + '\n  '
301
302 class Tempo:
303     def __init__ (self, seconds_per_1):
304         self.clocks = 0
305         self.seconds_per_1 = seconds_per_1
306
307     def __repr__ (self):
308         return 'Tempo(%d)' % self.bpm ()
309
310     def bpm (self):
311         return 4 * 60 / self.seconds_per_1
312
313     def dump (self):
314         return '\n  ' + '\\tempo 4 = %d ' % (self.bpm ()) + '\n  '
315
316 class Clef:
317     clefs = ('"bass_8"', 'bass', 'violin', '"violin^8"')
318     def __init__ (self, type):
319         self.type = type
320
321     def __repr__ (self):
322         return 'Clef(%s)' % self.clefs[self.type]
323
324     def dump (self):
325         return '\n  \\clef %s\n  ' % self.clefs[self.type]
326
327 class Key:
328     key_sharps = ('c', 'g', 'd', 'a', 'e', 'b', 'fis')
329     key_flats = ('BUG', 'f', 'bes', 'es', 'as', 'des', 'ges')
330
331     def __init__ (self, sharps, flats, minor):
332         self.clocks = 0
333         self.flats = flats
334         self.sharps = sharps
335         self.minor = minor
336
337     def dump (self):
338         global_options.key = self
339
340         s = ''
341         if self.sharps and self.flats:
342             pass
343         else:
344             if self.flats:
345                 k = (ord ('cfbeadg'[self.flats % 7]) - ord ('a') - 2 -2 * self.minor + 7) % 7
346             else:
347                 k = (ord ('cgdaebf'[self.sharps % 7]) - ord ('a') - 2 -2 * self.minor + 7) % 7
348
349             if not self.minor:
350                 name = chr ((k + 2) % 7 + ord ('a'))
351             else:
352                 name = chr ((k + 2) % 7 + ord ('a'))
353
354             # fis cis gis dis ais eis bis
355             sharps = (2, 4, 6, 1, 3, 5, 7)
356             # bes es as des ges ces fes
357             flats = (6, 4, 2, 7, 5, 3, 1)
358             a = 0
359             if self.flats:
360                 if flats[k] <= self.flats:
361                     a = -1
362             else:
363                 if sharps[k] <= self.sharps:
364                     a = 1
365
366             if a:
367                 name = name + Note.alteration_names[a + 2]
368
369             s = '\\key ' + name
370             if self.minor:
371                 s = s + ' \\minor'
372             else:
373                 s = s + ' \\major'
374
375         return '\n\n  ' + s + '\n  '
376
377
378 class Text:
379     text_types = (
380         'SEQUENCE_NUMBER',
381         'TEXT_EVENT',
382         'COPYRIGHT_NOTICE',
383         'SEQUENCE_TRACK_NAME',
384         'INSTRUMENT_NAME',
385         'LYRIC',
386         'MARKER',
387         'CUE_POINT',)
388
389     def __init__ (self, type, text):
390         self.clocks = 0
391         self.type = type
392         self.text = text
393
394     def dump (self):
395         # urg, we should be sure that we're in a lyrics staff
396         s = ''
397         if self.type == midi.LYRIC:
398             s = '"%s"' % self.text
399             d = Duration (self.clocks)
400             if (global_options.explicit_durations
401                 or d.compare (reference_note.duration)):
402                 s = s + Duration (self.clocks).dump ()
403             s = s + ' '
404         elif (self.text.strip ()
405               and self.type == midi.SEQUENCE_TRACK_NAME
406               and not self.text == 'control track'
407               and not self.track.lyrics_p_):
408             text = self.text.replace ('(MIDI)', '').strip ()
409             if text:
410                 s = '\n  \\set Staff.instrumentName = "%(text)s"\n  ' % locals ()
411         elif self.text.strip ():
412             s = '\n  % [' + self.text_types[self.type] + '] ' + self.text + '\n  '
413         return s
414
415     def __repr__ (self):
416         return 'Text(%d=%s)' % (self.type, self.text)
417
418 def get_voice (channel, music):
419     debug ('channel: ' + str (channel) + '\n')
420     return unthread_notes (music)
421
422 class Channel:
423     def __init__ (self, number):
424         self.number = number
425         self.events = []
426         self.music = None
427     def add (self, event):
428         self.events.append (event)
429     def get_voice (self):
430         if not self.music:
431             self.music = self.parse ()
432         return get_voice (self.number, self.music)
433     def parse (self):
434         pitches = {}
435         notes = []
436         music = []
437         last_lyric = 0
438         last_time = 0
439         for e in self.events:
440             t = e[0]
441
442             if start_quant_clocks:
443                 t = quantise_clocks (t, start_quant_clocks)
444
445             if (e[1][0] == midi.NOTE_OFF
446                 or (e[1][0] == midi.NOTE_ON and e[1][2] == 0)):
447                 debug ('%d: NOTE OFF: %s' % (t, e[1][1]))
448                 if not e[1][2]:
449                     debug ('   ...treated as OFF')
450                 end_note (pitches, notes, t, e[1][1])
451
452             elif e[1][0] == midi.NOTE_ON:
453                 if not pitches.has_key (e[1][1]):
454                     debug ('%d: NOTE ON: %s' % (t, e[1][1]))
455                     pitches[e[1][1]] = (t, e[1][2])
456                 else:
457                     debug ('...ignored')
458
459             # all include ALL_NOTES_OFF
460             elif (e[1][0] >= midi.ALL_SOUND_OFF
461               and e[1][0] <= midi.POLY_MODE_ON):
462                 for i in pitches:
463                     end_note (pitches, notes, t, i)
464
465             elif e[1][0] == midi.META_EVENT:
466                 if e[1][1] == midi.END_OF_TRACK:
467                     for i in pitches:
468                         end_note (pitches, notes, t, i)
469                     break
470
471                 elif e[1][1] == midi.SET_TEMPO:
472                     (u0, u1, u2) = map (ord, e[1][2])
473                     us_per_4 = u2 + 256 * (u1 + 256 * u0)
474                     seconds_per_1 = us_per_4 * 4 / 1e6
475                     music.append ((t, Tempo (seconds_per_1)))
476                 elif e[1][1] == midi.TIME_SIGNATURE:
477                     (num, dur, clocks4, count32) = map (ord, e[1][2])
478                     den = 2 ** dur
479                     music.append ((t, Time (num, den)))
480                 elif e[1][1] == midi.KEY_SIGNATURE:
481                     (alterations, minor) = map (ord, e[1][2])
482                     sharps = 0
483                     flats = 0
484                     if alterations < 127:
485                         sharps = alterations
486                     else:
487                         flats = 256 - alterations
488
489                     k = Key (sharps, flats, minor)
490                     if not t and global_options.key:
491                         # At t == 0, a set --key overrides us
492                         k = global_options.key
493                     music.append ((t, k))
494
495                     # ugh, must set key while parsing
496                     # because Note init uses key
497                     # Better do Note.calc () at dump time?
498                     global_options.key = k
499
500                 elif (e[1][1] == midi.LYRIC
501                       or (global_options.text_lyrics
502                           and e[1][1] == midi.TEXT_EVENT)):
503                     self.lyrics_p_ = True
504                     if last_lyric:
505                         last_lyric.clocks = t - last_time
506                         music.append ((last_time, last_lyric))
507                     last_time = t
508                     last_lyric = Text (midi.LYRIC, e[1][2])
509
510                 elif (e[1][1] >= midi.SEQUENCE_NUMBER
511                       and e[1][1] <= midi.CUE_POINT):
512                     text = Text (e[1][1], e[1][2])
513                     text.track = self
514                     music.append ((t, text))
515                     if (text.type == midi.SEQUENCE_TRACK_NAME):
516                         self.name = text.text
517                 else:
518                     if global_options.verbose:
519                         sys.stderr.write ("SKIP: %s\n" % `e`)
520             else:
521                 if global_options.verbose:
522                     sys.stderr.write ("SKIP: %s\n" % `e`)
523
524         if last_lyric:
525             # last_lyric.clocks = t - last_time
526             # hmm
527             last_lyric.clocks = clocks_per_4
528             music.append ((last_time, last_lyric))
529             last_lyric = 0
530
531         i = 0
532         while len (notes):
533             if i < len (music) and notes[0][0] >= music[i][0]:
534                 i = i + 1
535             else:
536                 music.insert (i, notes[0])
537                 del notes[0]
538         return music
539     
540 class Track (Channel):
541     def __init__ (self):
542         Channel.__init__ (self, None)
543         self.name = None
544         self.channels = {}
545         self.lyrics_p_ = False
546     def _add (self, event):
547         self.events.append (event)
548     def add (self, event, channel=None):
549         if channel == None:
550             self._add (event)
551         else:
552             self.channels[channel] = self.channels.get (channel, Channel (channel))
553             self.channels[channel].add (event)
554     def get_voices (self):
555         return ([self.get_voice ()]
556                 + [self.channels[k].get_voice ()
557                    for k in sorted (self.channels.keys ())])
558
559 def create_track (events):
560     track = Track ()
561     for e in events:
562         data = list (e[1])
563         if data[0] > 0x7f and data[0] < 0xf0:
564             channel = data[0] & 0x0f
565             e = (e[0], tuple ([data[0] & 0xf0] + data[1:]))
566             track.add (e, channel)
567         else:
568             track.add (e)
569     return track
570
571 def quantise_clocks (clocks, quant):
572     q = int (clocks / quant) * quant
573     if q != clocks:
574         for tquant in allowed_tuplet_clocks:
575             if int (clocks / tquant) * tquant == clocks:
576                 return clocks
577         if 2 * (clocks - q) > quant:
578             q = q + quant
579     return q
580
581 def end_note (pitches, notes, t, e):
582     try:
583         (lt, vel) = pitches[e]
584         del pitches[e]
585
586         i = len (notes) - 1
587         while i > 0:
588             if notes[i][0] > lt:
589                 i = i -1
590             else:
591                 break
592         d = t - lt
593         if duration_quant_clocks:
594             d = quantise_clocks (d, duration_quant_clocks)
595             if not d:
596                 d = duration_quant_clocks
597
598         notes.insert (i + 1,
599               (lt, Note (d, e, vel)))
600
601     except KeyError:
602         pass
603
604 def unthread_notes (channel):
605     threads = []
606     while channel:
607         thread = []
608         end_busy_t = 0
609         start_busy_t = 0
610         todo = []
611         for e in channel:
612             t = e[0]
613             if (e[1].__class__ == Note
614                 and ((t == start_busy_t
615                       and e[1].clocks + t == end_busy_t)
616                      or t >= end_busy_t)):
617                 thread.append (e)
618                 start_busy_t = t
619                 end_busy_t = t + e[1].clocks
620             elif (e[1].__class__ == Time
621                   or e[1].__class__ == Key
622                   or e[1].__class__ == Text
623                   or e[1].__class__ == Tempo):
624                 thread.append (e)
625             else:
626                 todo.append (e)
627         threads.append (thread)
628         channel = todo
629
630     return threads
631
632 def gcd (a,b):
633     if b == 0:
634         return a
635     c = a
636     while c:
637         c = a % b
638         a = b
639         b = c
640     return a
641
642 def dump_skip (skip, clocks):
643     return skip + Duration (clocks).dump () + ' '
644
645 def dump (d):
646     return d.dump ()
647
648 def dump_chord (ch):
649     s = ''
650     notes = []
651     for i in ch:
652         if i.__class__ == Note:
653             notes.append (i)
654         else:
655             s = s + i.dump ()
656     if len (notes) == 1:
657         s = s + dump (notes[0])
658     elif len (notes) > 1:
659         global reference_note
660         s = s + '<'
661         s = s + notes[0].dump (dump_dur=False)
662         r = reference_note
663         for i in notes[1:]:
664             s = s + i.dump (dump_dur=False)
665         s = s + '>'
666
667         s = s + notes[0].duration.dump () + ' '
668         reference_note = r
669     return s
670
671 def dump_bar_line (last_bar_t, t, bar_count):
672     s = ''
673     bar_t = time.bar_clocks ()
674     if t - last_bar_t >= bar_t:
675         bar_count = bar_count + (t - last_bar_t) / bar_t
676
677         if t - last_bar_t == bar_t:
678             s = '\n  | %% %(bar_count)d\n  ' % locals ()
679             last_bar_t = t
680         else:
681             # urg, this will barf at meter changes
682             last_bar_t = last_bar_t + (t - last_bar_t) / bar_t * bar_t
683
684     return (s, last_bar_t, bar_count)
685
686
687 def dump_voice (thread, skip):
688     global reference_note, time
689     ref = Note (0, 4*12, 0)
690     if not reference_note:
691         reference_note = ref
692     else:
693         ref.duration = reference_note.duration
694         reference_note = ref
695     last_e = None
696     chs = []
697     ch = []
698
699     for e in thread:
700         if last_e and last_e[0] == e[0]:
701             ch.append (e[1])
702         else:
703             if ch:
704                 chs.append ((last_e[0], ch))
705
706             ch = [e[1]]
707
708         last_e = e
709
710     if ch:
711         chs.append ((last_e[0], ch))
712     t = 0
713     last_t = 0
714     last_bar_t = 0
715     bar_count = 1
716
717     lines = ['']
718     for ch in chs:
719         t = ch[0]
720
721         i = lines[-1].rfind ('\n') + 1
722         if len (lines[-1][i:]) > LINE_BELL:
723             lines.append ('')
724
725         if t - last_t > 0:
726             d = t - last_t
727             if bar_max and t > time.bar_clocks () * bar_max:
728                 d = time.bar_clocks () * bar_max - last_t
729             lines[-1] = lines[-1] + dump_skip (skip, d)
730         elif t - last_t < 0:
731             errorport.write ('BUG: time skew')
732
733         (s, last_bar_t, bar_count) = dump_bar_line (last_bar_t,
734                               t, bar_count)
735
736         if bar_max and bar_count > bar_max:
737             break
738
739         lines[-1] = lines[-1] + s
740         lines[-1] = lines[-1] + dump_chord (ch[1])
741
742         clocks = 0
743         for i in ch[1]:
744             if i.clocks > clocks:
745                 clocks = i.clocks
746
747         last_t = t + clocks
748
749         (s, last_bar_t, bar_count) = dump_bar_line (last_bar_t,
750                                                     last_t, bar_count)
751         lines[-1] = lines[-1] + s
752
753     return '\n  '.join (lines) + '\n'
754
755 def number2ascii (i):
756     s = ''
757     i += 1
758     while i > 0:
759         m = (i - 1) % 26
760         s = '%c' % (m + ord ('A')) + s
761         i = (i - m)/26
762     return s
763
764 def get_track_name (i):
765     return 'track' + number2ascii (i)
766
767 def get_channel_name (i):
768     return 'channel' + number2ascii (i)
769
770 def get_voice_name (i, zero_too_p=False):
771     if i or zero_too_p:
772         return 'voice' + number2ascii (i)
773     return ''
774
775 def lst_append (lst, x):
776     lst.append (x)
777     return lst
778
779 def get_voice_layout (average_pitch):
780     d = {}
781     for i in range (len (average_pitch)):
782         d[average_pitch[i]] = lst_append (d.get (average_pitch[i], []), i)
783     s = list (reversed (sorted (average_pitch)))
784     non_empty = len (filter (lambda x: x, s))
785     names = ['One', 'Two']
786     if non_empty > 2:
787         names = ['One', 'Three', 'Four', 'Two']
788     layout = map (lambda x: '', range (len (average_pitch)))
789     for i, n in zip (s, names):
790         if i:
791             v = d[i]
792             if type (v) == list:
793                 d[i] = v[1:]
794                 v = v[0]
795             layout[v] = n
796     return layout
797
798 def dump_track (track, n):
799     s = '\n'
800     track_name = get_track_name (n)
801
802     average_pitch = track_average_pitch (track)
803     voices = len (filter (lambda x: x, average_pitch[1:]))
804     clef = get_best_clef (average_pitch[0])
805
806     c = 0
807     vv = 0
808     for channel in track:
809         v = 0
810         channel_name = get_channel_name (c)
811         c += 1
812         for voice in channel:
813             voice_name = get_voice_name (v)
814             voice_id = track_name + channel_name + voice_name
815             item = voice_first_item (voice)
816
817             if item and item.__class__ == Note:
818                 skip = 'r'
819                 if global_options.skip:
820                     skip = 's'
821                 s += '%(voice_id)s = ' % locals ()
822                 if not global_options.absolute_pitches:
823                     s += '\\relative c '
824             elif item and item.__class__ == Text:
825                 skip = '" "'
826                 s += '%(voice_id)s = \\lyricmode ' % locals ()
827             else:
828                 skip = '\\skip '
829                 s += '%(voice_id)s = ' % locals ()
830             s += '{\n'
831             if not n and not vv and global_options.key:
832                 s += global_options.key.dump ()
833             if average_pitch[vv+1] and voices > 1:
834                 s += '  \\voice' + get_voice_layout (average_pitch[1:])[vv] + '\n'
835             s += '  ' + dump_voice (voice, skip)
836             s += '}\n\n'
837             v += 1
838             vv += 1
839
840     s += '%(track_name)s = <<\n' % locals ()
841
842     if clef.type != 2:
843         s += clef.dump () + '\n'
844
845     c = 0
846     vv = 0
847     for channel in track:
848         v = 0
849         channel_name = get_channel_name (c)
850         c += 1
851         for voice in channel:
852             voice_context_name = get_voice_name (vv, zero_too_p=True)
853             voice_name = get_voice_name (v)
854             v += 1
855             vv += 1
856             voice_id = track_name + channel_name + voice_name
857             item = voice_first_item (voice)
858             context = 'Voice'
859             if item and item.__class__ == Text:
860                 context = 'Lyrics'
861             s += '  \\context %(context)s = %(voice_context_name)s \\%(voice_id)s\n' % locals ()
862     s += '>>\n\n'
863     return s
864
865 def voice_first_item (voice):
866     for event in voice:
867         if (event[1].__class__ == Note
868             or (event[1].__class__ == Text
869                 and event[1].type == midi.LYRIC)):
870             return event[1]
871     return None
872
873 def channel_first_item (channel):
874     for voice in channel:
875         first = voice_first_item (voice)
876         if first:
877             return first
878     return None
879
880 def track_first_item (track):
881     for channel in track:
882         first = channel_first_item (channel)
883         if first:
884             return first
885     return None
886
887 def track_average_pitch (track):
888     i = 0
889     p = [0]
890     v = 1
891     for channel in track:
892         for voice in channel:
893             c = 0
894             p.append (0)
895             for event in voice:
896                 if event[1].__class__ == Note:
897                     i += 1
898                     c += 1
899                     p[v] += event[1].pitch
900             if c:
901                 p[0] += p[v]
902                 p[v] = p[v] / c
903             v += 1
904     if i:
905         p[0] = p[0] / i
906     return p
907
908 def get_best_clef (average_pitch):
909     if average_pitch:
910         if average_pitch <= 3*12:
911             return Clef (0)
912         elif average_pitch <= 5*12:
913             return Clef (1)
914         elif average_pitch >= 7*12:
915             return Clef (3)
916     return Clef (2)
917
918 class Staff:
919     def __init__ (self, track):
920         self.voices = track.get_voices ()
921     def dump (self, i):
922         return dump_track (self.voices, i)
923
924 def convert_midi (in_file, out_file):
925     global clocks_per_1, clocks_per_4, key
926     global start_quant_clocks
927     global duration_quant_clocks
928     global allowed_tuplet_clocks
929     global time
930
931     str = open (in_file, 'rb').read ()
932     clocks_max = bar_max * clocks_per_1 * 2
933     midi_dump = midi.parse (str, clocks_max)
934
935     clocks_per_1 = midi_dump[0][1]
936     clocks_per_4 = clocks_per_1 / 4
937     time = Time (4, 4)
938
939     if global_options.start_quant:
940         start_quant_clocks = clocks_per_1 / global_options.start_quant
941
942     if global_options.duration_quant:
943         duration_quant_clocks = clocks_per_1 / global_options.duration_quant
944
945     allowed_tuplet_clocks = []
946     for (dur, num, den) in global_options.allowed_tuplets:
947         allowed_tuplet_clocks.append (clocks_per_1 / dur * num / den)
948
949     if global_options.verbose:
950         print 'allowed tuplet clocks:', allowed_tuplet_clocks
951
952     tracks = [create_track (t) for t in midi_dump[1]]
953     # urg, parse all global track events, such as Key first
954     # this fixes key in different voice/staff problem
955     for t in tracks:
956         t.music = t.parse ()
957     prev = None
958     staves = []
959     for t in tracks:
960         voices = t.get_voices ()
961         if ((t.name and prev and prev.name)
962             and t.name.split (':')[0] == prev.name.split (':')[0]):
963             # staves[-1].voices += voices
964             # all global track events first
965             staves[-1].voices = ([staves[-1].voices[0]]
966                                  + [voices[0]]
967                                  + staves[-1].voices[1:]
968                                  + voices[1:])
969         else:
970             staves.append (Staff (t))
971         prev = t
972
973     tag = '%% Lily was here -- automatically converted by %s from %s' % ( program_name, in_file)
974
975
976     s = tag
977     s += r'''
978 \version "2.13.53"
979 '''
980
981     s += r'''
982 \layout {
983   \context {
984     \Voice
985     \remove "Note_heads_engraver"
986     \consists "Completion_heads_engraver"
987     \remove "Rest_engraver"
988     \consists "Completion_rest_engraver"
989   }
990 }
991 '''
992
993     for i in global_options.include_header:
994         s += '\n%% included from %(i)s\n' % locals ()
995         s += open (i).read ()
996         if s[-1] != '\n':
997             s += '\n'
998         s += '% end\n'
999
1000     for i, t in enumerate (staves):
1001         s += t.dump (i)
1002
1003     s += '\n\\score {\n  <<\n'
1004
1005     i = 0
1006     for i, staff in enumerate (staves):
1007         track_name = get_track_name (i)
1008         item = track_first_item (staff.voices)
1009         staff_name = track_name
1010         context = None
1011         if not i and not item and len (staves) > 1:
1012             # control track
1013             staff_name = get_track_name (1)
1014             context = 'Staff'
1015         elif (item and item.__class__ == Note):
1016             context = 'Staff'
1017         elif item and item.__class__ == Text:
1018             context = 'Lyrics'
1019         if context:
1020             s += '    \\context %(context)s=%(staff_name)s \\%(track_name)s\n' % locals ()
1021
1022     s = s + '''  >>
1023   \layout {}
1024   \midi {}
1025 }
1026 '''
1027
1028     progress (_ ("%s output to `%s'...") % ('LY', out_file))
1029
1030     if out_file == '-':
1031         handle = sys.stdout
1032     else:
1033         handle = open (out_file, 'w')
1034
1035     handle.write (s)
1036     handle.close ()
1037
1038
1039 def get_option_parser ():
1040     p = ly.get_option_parser (usage=_ ("%s [OPTION]... FILE") % 'midi2ly',
1041                  description=_ ("Convert %s to LilyPond input.\n") % 'MIDI',
1042                  add_help_option=False)
1043
1044     p.add_option ('-a', '--absolute-pitches',
1045            action='store_true',
1046            help=_ ('print absolute pitches'))
1047     p.add_option ('-d', '--duration-quant',
1048            metavar=_ ('DUR'),
1049            help=_ ('quantise note durations on DUR'))
1050     p.add_option ('-D', '--debug',
1051                   action='store_true',
1052                   help=_ ('debug printing'))
1053     p.add_option ('-e', '--explicit-durations',
1054            action='store_true',
1055            help=_ ('print explicit durations'))
1056     p.add_option('-h', '--help',
1057                  action='help',
1058                  help=_ ('show this help and exit'))
1059     p.add_option('-i', '--include-header',
1060                  help=_ ('prepend FILE to output'),
1061                  action='append',
1062                  default=[],
1063                  metavar=_ ('FILE'))
1064     p.add_option('-k', '--key', help=_ ('set key: ALT=+sharps|-flats; MINOR=1'),
1065           metavar=_ ('ALT[:MINOR]'),
1066           default=None),
1067     p.add_option ('-o', '--output', help=_ ('write output to FILE'),
1068            metavar=_ ('FILE'),
1069            action='store')
1070     p.add_option ('-p', '--preview', help=_ ('preview of first 4 bars'),
1071            action='store_true')
1072     p.add_option ('-s', '--start-quant',help= _ ('quantise note starts on DUR'),
1073            metavar=_ ('DUR'))
1074     p.add_option ('-S', '--skip',
1075            action = "store_true",
1076            help =_ ("use s instead of r for rests"))
1077     p.add_option ('-t', '--allow-tuplet',
1078            metavar=_ ('DUR*NUM/DEN'),
1079            action = 'append',
1080            dest='allowed_tuplets',
1081            help=_ ('allow tuplet durations DUR*NUM/DEN'),
1082            default=[])
1083     p.add_option ('-V', '--verbose', help=_ ('be verbose'),
1084            action='store_true'
1085            ),
1086     p.version = 'midi2ly (LilyPond) @TOPLEVEL_VERSION@'
1087     p.add_option ('--version',
1088                  action='version',
1089                  help=_ ('show version number and exit'))
1090     p.add_option ('-w', '--warranty', help=_ ('show warranty and copyright'),
1091            action='store_true',
1092            ),
1093     p.add_option ('-x', '--text-lyrics', help=_ ('treat every text as a lyric'),
1094            action='store_true')
1095
1096     p.add_option_group (ly.display_encode (_ ('Examples')),
1097               description = r'''
1098   $ midi2ly --key=-2:1 --duration-quant=32 --allow-tuplet=4*2/3 --allow-tuplet=2*4/3 foo.midi
1099 ''')
1100     p.add_option_group ('',
1101                         description=(
1102             _ ('Report bugs via %s')
1103             % 'http://post.gmane.org/post.php'
1104             '?group=gmane.comp.gnu.lilypond.bugs') + '\n')
1105     return p
1106
1107
1108
1109 def do_options ():
1110     opt_parser = get_option_parser ()
1111     (options, args) = opt_parser.parse_args ()
1112
1113     if options.warranty:
1114         warranty ()
1115         sys.exit (0)
1116
1117     if not args or args[0] == '-':
1118         opt_parser.print_help ()
1119         ly.stderr_write ('\n%s: %s %s\n' % (program_name, _ ('error: '),
1120                          _ ('no files specified on command line.')))
1121         sys.exit (2)
1122
1123     if options.duration_quant:
1124         options.duration_quant = int (options.duration_quant)
1125
1126     if options.key:
1127         (alterations, minor) = map (int, (options.key + ':0').split (':'))[0:2]
1128         sharps = 0
1129         flats = 0
1130         if alterations >= 0:
1131             sharps = alterations
1132         else:
1133             flats = - alterations
1134         options.key = Key (sharps, flats, minor)
1135
1136     if options.start_quant:
1137         options.start_quant = int (options.start_quant)
1138
1139     global bar_max
1140     if options.preview:
1141         bar_max = 4
1142
1143     options.allowed_tuplets = [map (int, a.replace ('/','*').split ('*'))
1144                 for a in options.allowed_tuplets]
1145
1146     if options.verbose:
1147         sys.stderr.write ('Allowed tuplets: %s\n' % `options.allowed_tuplets`)
1148
1149     global global_options
1150     global_options = options
1151
1152     return args
1153
1154 def main ():
1155     files = do_options ()
1156
1157     exts = ['.midi', '.mid', '.MID']
1158     for f in files:
1159         g = f
1160         for e in exts:
1161             g = strip_extension (g, e)
1162         if not os.path.exists (f):
1163             for e in exts:
1164                 n = g + e
1165                 if os.path.exists (n):
1166                     f = n
1167                     break
1168
1169         if not global_options.output:
1170             outdir = '.'
1171             outbase = os.path.basename (g)
1172             o = outbase + '-midi.ly'
1173         elif (global_options.output[-1] == os.sep
1174               or os.path.isdir (global_options.output)):
1175             outdir = global_options.output
1176             outbase = os.path.basename (g)
1177             o = os.path.join (outdir, outbase + '-midi.ly')
1178         else:
1179             o = global_options.output
1180             (outdir, outbase) = os.path.split (o)
1181
1182         if outdir and outdir != '.' and not os.path.exists (outdir):
1183             os.mkdir (outdir, 0777)
1184
1185         convert_midi (f, o)
1186
1187 if __name__ == '__main__':
1188     main ()