]> git.donarmstrong.com Git - lilypond.git/blobdiff - ly/gregorian-init.ly
Doc-es: Texidoc LSR Snippets in Expressive.
[lilypond.git] / ly / gregorian-init.ly
index d8e7dcfc23ab1a8a189b65208baddfee205c10b9..3a99d82f937e362d2b3025645a44a08b9b5c8c4d 100644 (file)
@@ -1,11 +1,62 @@
-\version "2.7.32"
+%{
+  Shortcuts common for all styles of gregorian chant notation.
+  $Id$
+%}
 
-%%%%%%%%
-%%%%%%%% shortcuts common for all styles of gregorian chant notation
-%%%%%%%%
+\version "2.10.0"
 
 %
-% declare head prefix shortcuts
+% Declare memorable shortcuts for special unicode characters
+% that are used in chant notation.
+% 
+
+% unicode 0132 (latin capital ligature IJ)
+IJ = \lyricmode { IJ }
+IIJ = \lyricmode { IIJ }
+
+% unicode 0133 (latin small ligature ij)
+ij = \lyricmode { ij }
+iij = \lyricmode { iij }
+
+%
+% Given some music that represents lyrics, add a prefix to the first
+% lyric event.
+%
+% TODO: Robustify this function.  For example, this function works
+% correctly for "\versus { some lyrics }", but it barfs with a wrong type
+% argument error for e.g. "\versus some lyrics".
+%
+#(define (add-prefix-to-lyrics prefix music)
+   (make-music
+    'SequentialMusic
+    'elements (append
+              (cons
+               (let* ((elems (car (ly:music-property music 'elements)))
+                      (props (ly:music-mutable-properties elems))
+                      (events (filter (lambda (x)
+                                        (equal? (car x) 'elements))
+                                      props))
+                      (first-evt (cadar events))
+                      (first-syllable (ly:prob-property first-evt 'text))
+                      (first-duration (ly:prob-property first-evt 'duration)))
+                 (make-music
+                  'LyricEvent
+                  'duration first-duration
+                  'text (string-append prefix first-syllable)))
+               (cdr (ly:music-property music 'elements))))))
+
+% Add unicode 2123 (versicle) as prefix to lyrics.
+versus =
+#(define-music-function (parser location music) (ly:music?)
+   (add-prefix-to-lyrics "℣" music))
+
+% Add unicode 211F (response) as prefix to lyrics.
+responsum =
+#(define-music-function (parser location music) (ly:music?)
+   (add-prefix-to-lyrics "℟" music))
+
+%
+% Declare head prefix shortcuts.
 %
 virga =
   \once \override NoteHead  #'virga = ##t
@@ -35,7 +86,7 @@ cavum =
   \once \override NoteHead  #'cavum = ##t
 
 %
-% declare divisiones shortcuts
+% Declare divisiones shortcuts.
 %
 virgula = {
   \once \override BreathingSign  #'text = #(make-musicglyph-markup "scripts.rcomma")
@@ -92,18 +143,26 @@ finalis = {
 }
 
 %
-% declare articulation shortcuts
+% Declare articulation shortcuts.
 %
 accentus = #(make-articulation "accentus")
 ictus = #(make-articulation "ictus")
 semicirculus = #(make-articulation "semicirculus")
 circulus = #(make-articulation "circulus")
-episemInitium = #(make-span-event 'TextSpanEvent START)
-episemFinis = #(make-span-event 'TextSpanEvent STOP)
+episemInitium = \startTextSpan
+episemFinis = \stopTextSpan
 
 %
-% shortcut music functions for Liber Hymnarius neumes table
-% (experimental)
+% \augmentum increases the dot-count value of all note heads to which
+% it is applied by one.
+%
+augmentum =
+#(define-music-function (parser location expr) (ly:music?)
+   (shift-duration-log expr 0 1))
+
+%
+% Declare shortcut music functions for Liber Hymnarius neumes
+% table (experimental).
 %
 
 #(define (make-ligature music)
@@ -154,9 +213,79 @@ ligature = #(define-music-function
 %climacus = #(def-climacus-function startSequentialMusic stopSequentialMusic)
 
 %
-% example layout block for gregorian chant notation
+% Declare default layout; here for Vaticana style.  In case there will
+% be additional styles, we may want to create style-specific .ly files
+% for inclusion (e.g. vaticana-init.ly), move the style-dependent stuff
+% over there, leave the style-independent Gregorian stuff here, and let
+% the style-specific file (vaticana-init.ly) include this file.  The
+% user then will have to include vaticana-init.ly instead of
+% gregorian-init.ly.
 %
+\layout {
+    indent = 0.0
+    packed = ##t
+
+    %%% TODO: should raggedright be the default?
+    %ragged-right = ##t
+    ragged-last = ##t
+
+    %%% FIXME: line-thickness should be set here to a slightly
+    %%% thicker value as the default; but we can not set it here,
+    %%% since neither \staff-space nor #staff-space is yet defined
+    %%% when lily comes across the following line.
+    %line-thickness = \staff-space / 7.0
 
+    \context {
+       \VaticanaStaff
+        \override StaffSymbol #'color = #red
+        \override LedgerLineSpanner #'color = #red
+    }
+    \context {
+       \Score
+       \remove "Bar_number_engraver"
+
+       %%%
+       %%% FIXME: Musicologically seen, timing should be set to #f.
+       %%% Unfortunately, setting it to #f will result in no
+       %%% line-breakable items being created, such that the whole
+       %%% music will end up in a single line.  Therefore, we
+       %%% currently set it to #t, until the ligature code is fixed
+       %%% to automatically insert breakable items.
+       %%%
+       timing = ##t
+
+       %%%
+       %%% FIXME: Setting barAlways to #t would fix the above
+       %%% "timing = ##t" problem, but, surprisingly, it increases
+       %%% the space between ligatures.  Hence, we set it to #f.
+       %%%
+       barAlways = ##f
+
+       \override SpacingSpanner #'packed-spacing = ##t
+
+       %%%
+       %%% TODO: Play around with the following SpacingSpanner
+       %%% settings to yield better spacing between ligatures.
+       %%%
+       %%% FIXME: setting #'spacing-increment to a small value
+       %%% causes tons of "programming error: adding reverse spring,
+       %%% setting to unit" messages.
+       %%%
+       %\override SpacingSpanner #'base-shortest-duration = #(ly:make-moment 1 4)
+       %\override SpacingSpanner #'shortest-duration-space = #0
+       %\override SpacingSpanner #'average-spacing-wishes = ##f
+       %\override SpacingSpanner #'spacing-increment = #0.0
+       %\override SpacingSpanner #'uniform-stretching = ##t
+    }
+}
+
+%
+% neumeDemoLayout defines a layout block suitable for notating pure
+% Vaticana style neumes without any other notation symbols such as
+% staff lines or clefs.  This layout is useful for engraving neumes
+% tables, such as that one in the lilypond manual section on
+% Gregorian ligatures, or for educational works.
+%
 neumeDemoLayout = \layout {
     interscoreline = 1
     \context {
@@ -170,7 +299,7 @@ neumeDemoLayout = \layout {
        \override StaffSymbol #'transparent = ##t
        \remove "Time_signature_engraver"
        \remove "Bar_engraver"
-       minimumVerticalExtent = ##f
+       \override VerticalAxisGroup #'minimum-Y-extent = ##f
     }
     \context {
        \Voice
@@ -180,3 +309,7 @@ neumeDemoLayout = \layout {
        \override Stem #'transparent = ##t
     }
 }
+
+%%% Local Variables:
+%%% coding: utf-8
+%%% End: