]> git.donarmstrong.com Git - lilypond.git/blobdiff - scm/translation-functions.scm
Midi: allow alternate channel mappings: per instrument, staff, voice.
[lilypond.git] / scm / translation-functions.scm
index ece0031b78ab485b2672784ad9c8b9029a8a00f7..facabd8ab59f6c1f49756fdead347d8ce3bb7882 100644 (file)
@@ -1,6 +1,6 @@
 ;;;; This file is part of LilyPond, the GNU music typesetter.
 ;;;;
-;;;; (c) 1998--2010 Han-Wen Nienhuys <hanwen@xs4all.nl>
+;;;; (c) 1998--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
 ;;;;                Jan Nieuwenhuizen <janneke@gnu.org>
 ;;;;
 ;;;; LilyPond is free software: you can redistribute it and/or modify
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; metronome marks
 
-(define-public (format-metronome-markup text dur count context)
-  (let* ((hide-note (eq? #t (ly:context-property context 'tempoHideNote))))
+(define-public (format-metronome-markup event context)
+  (let ((hide-note (ly:context-property context 'tempoHideNote #f))
+       (text (ly:event-property event 'text))
+       (dur (ly:event-property event 'tempo-unit))
+       (count (ly:event-property event 'metronome-count)))
+
     (metronome-markup text dur count hide-note)))
 
 (define-public (metronome-markup text dur count hide-note)
                                                     (ly:duration-dot-count dur)
                                                     1))
                        #f))
-         (note-markup (if (and (not hide-note) (number? count) (> count 0) )
+        (count-markup (cond ((number? count)
+                             (if (> count 0)
+                                 (make-simple-markup (number->string count))
+                                 #f))
+                            ((pair? count)
+                             (make-concat-markup
+                              (list
+                               (make-simple-markup (number->string (car count)))
+                               (make-simple-markup " ")
+                               (make-simple-markup "–")
+                               (make-simple-markup " ")
+                               (make-simple-markup (number->string (cdr count))))))
+                            (else #f)))
+         (note-markup (if (and (not hide-note) count-markup)
                          (make-concat-markup
                           (list
                            (make-general-align-markup Y DOWN note-mark)
                            (make-simple-markup " ")
                            (make-simple-markup "=")
                            (make-simple-markup " ")
-                           (make-simple-markup (number->string count))))
+                           count-markup))
                          #f))
          (text-markup (if (not (null? text))
                          (make-bold-markup text)
     (set! (ly:grob-property grob 'dot-placement-list) placement-list)))
 
 (define-public
-  (determine-frets context notes defined-strings . rest)
+  (determine-frets context notes specified-info . rest)
   "Determine string numbers and frets for playing @var{notes}
-as a chord, given specified string numbers @var{defined-strings}.
+as a chord, given specified information @var{specified-info}.
+@var{specified-info} is a list with two list elements,
+specified strings @code{defined-strings} and
+specified fingerings @code{defined-fingers}.  Only a fingering of@tie{}0
+will affect the fret selection, as it specifies an open string.
+If @code{defined-strings} is @code{'()}, the context property
+@code{defaultStrings} will be used as a list of defined strings.
 Will look for predefined fretboards if @code{predefinedFretboardTable}
 is not @code {#f}.  If @var{rest} is present, it contains the
-FretBoard grob, and a fretboard will be
-created.  Otherwise, a list of (string fret finger) lists will
-be returned)."
+@code{FretBoard} grob, and a fretboard will be
+created.  Otherwise, a list of @code{(string fret finger)} lists will
+be returned."
 
   ;;  helper functions
 
@@ -228,9 +251,172 @@ dot placement entries."
 
   (define (placement-list->string-frets placement-list)
     "Convert @var{placement-list} to string-fret list."
-    (map (lambda (x) (cdr x))
-         (filter (lambda (l) (eq? (cdr l) 'place-fret) placement-list))))
+    (map (lambda (x) (if (eq? (car x) 'place-fret)
+                         (cdr x)
+                         (list (cadr x) 0)))
+         (filter (lambda (l) (or (eq? (car l) 'place-fret)
+                                 (eq? (car l) 'open)))
+                 placement-list)))
+
+  (define (entry-count art-list)
+    (length (filter (lambda (x) (not (null? x)))
+                    art-list)))
+
+  (define (determine-frets-and-strings
+           notes
+           defined-strings
+           defined-fingers
+           minimum-fret
+           maximum-stretch
+           tuning)
+
+    (define (calc-fret pitch string tuning)
+      (- (ly:pitch-semitones pitch) (ly:pitch-semitones (list-ref tuning (1- string)))))
+
+    (define (note-pitch a)
+      (ly:event-property a 'pitch))
+
+    (define (note-pitch>? a b)
+      (ly:pitch<? (note-pitch b)
+                 (note-pitch a)))
+
+    (define (note-finger ev)
+      (let* ((articulations (ly:event-property ev 'articulations))
+            (finger-found #f))
+
+       (map (lambda (art)
+              (let* ((num (ly:event-property art 'digit)))
+
+                (if (and (eq? 'fingering-event (ly:event-property art 'class))
+                         (number? num)
+                         (> num 0))
+                  (set! finger-found num))))
+            articulations)
+
+       finger-found))
 
+    (define (string-number event)
+      (let ((num (ly:event-property event 'string-number)))
+       (if (number? num)
+         num
+         #f)))
+
+    (define (delete-free-string string)
+      (if (number? string)
+       (set! free-strings
+         (delete string free-strings))))
+
+    (define free-strings '())
+    (define unassigned-notes '())
+    (define specified-frets '())
+
+    (define (close-enough fret)
+      (if (null? specified-frets)
+       #t
+       (reduce
+         (lambda (x y)
+           (and x y))
+         #t
+         (map (lambda (specced-fret)
+                (or (eq? 0 specced-fret)
+                    (>= maximum-stretch (abs (- fret specced-fret)))))
+              specified-frets))))
+
+    (define (string-qualifies string pitch)
+      (let* ((fret (calc-fret pitch string tuning)))
+       (and (>= fret minimum-fret)
+            (close-enough fret))))
+
+    (define (open-string string pitch)
+      (let* ((fret (calc-fret pitch string tuning)))
+       (eq? fret 0)))
+
+    (define string-fret-fingering-tuples '())
+
+    (define (set-fret note string)
+      (let ((this-fret (calc-fret (ly:event-property note 'pitch)
+                                 string
+                                 tuning)))
+       (if (< this-fret 0)
+         (ly:warning (_ "Negative fret for pitch ~a on string ~a")
+                     (note-pitch note) string))
+       (set! string-fret-fingering-tuples
+         (cons (list string
+                     this-fret
+                     (note-finger note))
+               string-fret-fingering-tuples))
+       (delete-free-string string)
+       (set! specified-frets (cons this-fret specified-frets))))
+
+    (define (pad-list target template)
+      (while (< (length target) (length template))
+            (set! target (if (null? target)
+                           '(())
+                           (append target '(()))))))
+
+    ;;; body of determine-frets-and-strings
+    (set! free-strings (map 1+ (iota (length tuning))))
+
+    ;; get defined-strings same length as notes
+    (pad-list defined-strings notes)
+
+    ;; get defined-fingers same length as notes
+    (pad-list defined-fingers notes)
+
+    ;; handle notes with strings assigned and fingering of 0
+    (for-each
+      (lambda (note string finger)
+       (let ((digit (if (null? finger)
+                      #f
+                      finger)))
+         (if (and (null? string)
+                  (not (eq? digit 0)))
+           (set! unassigned-notes (cons note unassigned-notes))
+           (if (eq? digit 0)
+             (let ((fit-string
+                     (find (lambda (string)
+                             (open-string string (note-pitch note)))
+                           free-strings)))
+               (if fit-string
+                 (begin
+                   (delete-free-string fit-string)
+                   (set-fret note fit-string))
+                 (begin
+                   (ly:warning (_ "No open string for pitch ~a")
+                               (note-pitch note))
+                   (set! unassigned-notes (cons note unassigned-notes)))))
+             (let ((this-fret (calc-fret (note-pitch note) string tuning))
+                   (handle-negative
+                     (ly:context-property context
+                                          'handleNegativeFrets
+                                          'recalculate)))
+               (cond ((or (>= this-fret 0)
+                          (eq? handle-negative 'include))
+                      (begin
+                        (delete-free-string string)
+                        (set-fret note string)))
+                     ((eq? handle-negative 'recalculate)
+                      (begin
+                        (ly:warning (_ "Requested string for pitch requires negative fret: string ~a pitch ~a") string (note-pitch note))
+                        (ly:warning (_ "Ignoring string request."))
+                        (set! unassigned-notes (cons note unassigned-notes))))))))))
+      notes defined-strings defined-fingers)
+
+    ;; handle notes without strings assigned
+    (for-each
+      (lambda (note)
+       (let ((fit-string
+               (find (lambda (string)
+                       (string-qualifies string (note-pitch note)))
+                     free-strings)))
+         (if fit-string
+           (set-fret note fit-string)
+           (ly:warning (_ "No string for pitch ~a (given frets ~a)")
+                       (note-pitch note)
+                       specified-frets))))
+      (sort unassigned-notes note-pitch>?))
+
+    string-fret-fingering-tuples) ;; end of determine-frets-and-strings
 
   (define (get-predefined-fretboard predefined-fret-table tuning pitches)
     "Search through @var{predefined-fret-table} looking for a predefined
@@ -245,6 +431,8 @@ chords.  Returns a placement-list."
            (cdr hash-handle)  ; return table entry
            '())))
 
+
+
     ;; body of get-predefined-fretboard
     (let ((test-fretboard (get-fretboard (cons tuning pitches))))
       (if (not (null? test-fretboard))
@@ -265,6 +453,21 @@ chords.  Returns a placement-list."
          (string-count (length tunings))
          (grob (if (null? rest) '() (car rest)))
         (pitches (map (lambda (x) (ly:event-property x 'pitch)) notes))
+         (defined-strings (map (lambda (x)
+                                 (if (null? x)
+                                     x
+                                     (ly:event-property x 'string-number)))
+                               (car specified-info)))
+         (defined-fingers (map (lambda (x)
+                                 (if (null? x)
+                                     x
+                                     (ly:event-property x 'digit)))
+                               (cadr specified-info)))
+         (default-strings (ly:context-property context 'defaultStrings '()))
+         (strings-used (if (and (zero? (entry-count defined-strings))
+                                (not (zero? (entry-count default-strings))))
+                           default-strings
+                           defined-strings))
          (predefined-fretboard
           (if predefined-fret-table
               (get-predefined-fretboard
@@ -272,12 +475,12 @@ chords.  Returns a placement-list."
                tunings
                pitches)
               '())))
-
      (if (null? predefined-fretboard)
          (let ((string-frets
                 (determine-frets-and-strings
                  notes
-                 defined-strings
+                 strings-used
+                 defined-fingers
                  (ly:context-property context 'minimumFret 0)
                  (ly:context-property context 'maximumFretStretch 4)
                  tunings)))
@@ -291,111 +494,6 @@ chords.  Returns a placement-list."
              (create-fretboard context grob predefined-fretboard)))))
 
 
-(define (determine-frets-and-strings
-          notes defined-strings minimum-fret maximum-stretch tuning)
-
-  (define (calc-fret pitch string tuning)
-    (- (ly:pitch-semitones pitch) (list-ref tuning (1- string))))
-
-  (define (note-pitch a)
-    (ly:event-property a 'pitch))
-
-  (define (note-pitch>? a b)
-    (ly:pitch<? (note-pitch b)
-               (note-pitch a)))
-
-  (define (note-finger ev)
-    (let* ((articulations (ly:event-property ev 'articulations))
-          (finger-found #f))
-
-      (map (lambda (art)
-            (let* ((num (ly:event-property art 'digit)))
-
-              (if (and (eq? 'fingering-event (ly:event-property art 'class))
-                       (number? num))
-                  (set! finger-found num))))
-          articulations)
-
-      finger-found))
-
-  (define (string-number event)
-    (let ((num (ly:event-property event 'string-number)))
-      (if (number? num)
-          num
-          #f)))
-
-
-  (define (delete-free-string string)
-    (if (number? string)
-       (set! free-strings
-             (delete string free-strings))))
-
-  (define free-strings '())
-  (define unassigned-notes '())
-  (define specified-frets '())
-
-  (define (close-enough fret)
-    (if (null? specified-frets)
-        #t
-        (reduce
-          (lambda (x y)
-            (and x y))
-          #t
-          (map (lambda (specced-fret)
-                 (> maximum-stretch (abs (- fret specced-fret))))
-               specified-frets))))
-
-  (define (string-qualifies string pitch)
-    (let* ((fret (calc-fret pitch string tuning)))
-      (and (>= fret minimum-fret)
-          (close-enough fret))))
-
-  (define string-fret-fingering-tuples '())
-
-  (define (set-fret note string)
-    (let ((this-fret (calc-fret (ly:event-property note 'pitch)
-                                string
-                                tuning)))
-       (set! string-fret-fingering-tuples
-             (cons (list string
-                         this-fret
-                         (note-finger note))
-                   string-fret-fingering-tuples))
-       (delete-free-string string)
-       (set! specified-frets (cons this-fret specified-frets))))
-
-  ;;; body of determine-frets-and-strings
-  (set! free-strings (map 1+ (iota (length tuning))))
-
-  ;; get defined-strings same length as notes
-  (while (< (length defined-strings) (length notes))
-         (set! defined-strings (append defined-strings '(()))))
-
-  ;; handle notes with strings assigned
-  (for-each
-    (lambda (note string)
-      (if (null? string)
-          (set! unassigned-notes (cons note unassigned-notes))
-          (let ((this-string (string-number string)))
-            (delete-free-string this-string)
-            (set-fret note this-string))))
-    notes defined-strings)
-
-  ;; handle notes without strings assigned
-  (for-each
-   (lambda (note)
-     (let* ((fit-string
-              (find (lambda (string)
-                      (string-qualifies string (note-pitch note)))
-                    free-strings)))
-        (if fit-string
-            (set-fret note fit-string)
-            (ly:warning "No string for pitch ~a (given frets ~a)"
-                        (note-pitch note)
-                        specified-frets))))
-   (sort unassigned-notes note-pitch>?))
-
-   string-fret-fingering-tuples)
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; tablature
@@ -414,10 +512,10 @@ chords.  Returns a placement-list."
     ((and (<= 0 fret-number) (< fret-number (length labels)))
      (list-ref labels fret-number))
     (else
-     (ly:warning "No label for fret ~a (on string ~a);
-only ~a fret labels provided"
-                 fret-number string-number (length labels))
-       ".")))))
+     (ly:warning (_ "No label for fret ~a (on string ~a);
+only ~a fret labels provided")
+                fret-number string-number (length labels))
+     ".")))))
 
 ;; Display the fret number as a number
 (define-public (fret-number-tablature-format