]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/ancient.itely
Merge remote-tracking branch 'origin/master' into translation
[lilypond.git] / Documentation / notation / ancient.itely
index 8444d62dd048ac062ef867a7e72435b7f0224d84..e4ded2fa4f88b7a93582d05e085085e49e6b43d0 100644 (file)
@@ -8,7 +8,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.17.11"
+@c \version "2.17.30"
 
 
 @node Ancient notation
@@ -376,7 +376,7 @@ entering the chant, as the following excerpt demonstrates:
 \score {
   <<
     \new MensuralVoice = "discantus" \relative c'' {
-      \override Score.BarNumber.transparent = ##t {
+      \hide Score.BarNumber {
         c1\melisma bes a g\melismaEnd
         f\breve
         \[ f1\melisma a c\breve d\melismaEnd \]
@@ -556,34 +556,35 @@ to particular time fractions.  In other words, to get a particular mensuration s
 {
   \set Score.timing = ##f
   \set Score.barAlways = ##t
-  s_\markup { "\\time 4/4" }^\markup { "       " \musicglyph
+  \textLengthOn
+  s^\markup { "\\time 4/4" }_\markup { "       " \musicglyph
 #"timesig.neomensural44" }
   s
-  s_\markup { "\\time 2/2" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 2/2" }_\markup { "       " \musicglyph
 #"timesig.neomensural22" }
   s
-  s_\markup { "\\time 6/4" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 6/4" }_\markup { "       " \musicglyph
 #"timesig.neomensural64" }
   s
-  s_\markup { "\\time 6/8" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 6/8" }_\markup { "       " \musicglyph
 #"timesig.neomensural68" }
   \break
-  s_\markup { "\\time 3/2" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 3/2" }_\markup { "       " \musicglyph
 #"timesig.neomensural32" }
   s
-  s_\markup { "\\time 3/4" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 3/4" }_\markup { "       " \musicglyph
 #"timesig.neomensural34" }
   s
-  s_\markup { "\\time 9/4" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 9/4" }_\markup { "       " \musicglyph
 #"timesig.neomensural94" }
   s
-  s_\markup { "\\time 9/8" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 9/8" }_\markup { "       " \musicglyph
 #"timesig.neomensural98" }
   \break
-  s_\markup { "\\time 4/8" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 4/8" }_\markup { "       " \musicglyph
 #"timesig.neomensural48" }
   s
-  s_\markup { "\\time 2/4" }^\markup { "       " \musicglyph
+  s^\markup { "\\time 2/4" }_\markup { "       " \musicglyph
 #"timesig.neomensural24" }
 }
 @end lilypond
@@ -727,22 +728,19 @@ Use the @code{flag-style} property of grob @code{Stem} to
 select ancient flags.  Besides the @code{default} flag style,
 only the @code{mensural} style is supported.
 
-@lilypond[quote,fragment,ragged-right,verbatim]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
 \override Flag.style = #'mensural
 \override Stem.thickness = #1.0
 \override NoteHead.style = #'mensural
 \autoBeamOff
-c'8 d'8 e'8 f'8 c'16 d'16 e'16 f'16 c'32 d'32 e'32 f'32 s8
-c''8 d''8 e''8 f''8 c''16 d''16 e''16 f''16 c''32 d''32 e''32 f''32
+c8 d e f c16 d e f c32 d e f s8
+c'8 d e f c16 d e f c32 d e f
 @end lilypond
 
-Note that the innermost flare of each mensural flag always is
+Note that the innermost flare of each mensural flag is
 vertically aligned with a staff line.
 
 There is no particular flag style for neo-mensural or Petrucci notation.
-@c Hence,
-@c when typesetting the incipit of a transcribed piece of mensural
-@c music, the default flag style should be used.
 There are no flags in Gregorian chant notation.
 
 @seealso
@@ -751,11 +749,8 @@ Music Glossary:
 @rglos{flag}.
 
 @knownissues
-The attachment of ancient flags to stems is slightly off.
-@c due to a change in early 2.3.x.
-
 Vertically aligning each flag with a staff line assumes that stems
-always end either exactly on or exactly in the middle between two
+always end either exactly on or exactly in the middle of two
 staff lines.  This may not always be true when using advanced layout
 features of classical notation (which however are typically out of
 scope for mensural notation).
@@ -1111,8 +1106,7 @@ Editio Vaticana style do clef
   \override Staff.StaffSymbol.line-count = #4
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'vaticana.punctum
   \clef "vaticana-do2"
   c
@@ -1127,8 +1121,7 @@ Editio Vaticana style fa clef
   \override Staff.StaffSymbol.line-count = #4
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'vaticana.punctum
   \clef "vaticana-fa2"
   c
@@ -1144,8 +1137,7 @@ Editio Medicaea style do clef
   \override Staff.StaffSymbol.line-count = #4
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'medicaea.punctum
   \clef "medicaea-do2"
   c
@@ -1160,8 +1152,7 @@ Editio Medicaea style fa clef
   \override Staff.StaffSymbol.line-count = #4
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'medicaea.punctum
   \clef "medicaea-fa2"
   c
@@ -1177,8 +1168,7 @@ hufnagel style do clef
   \override Staff.StaffSymbol.line-count = #4
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'hufnagel.punctum
   \clef "hufnagel-do2"
   c
@@ -1193,8 +1183,7 @@ hufnagel style fa clef
   \override Staff.StaffSymbol.line-count = #4
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'hufnagel.punctum
   \clef "hufnagel-fa2"
   c
@@ -1208,8 +1197,7 @@ hufnagel style combined do/fa clef
 @lilypond[relative=1,notime]
   \override Staff.StaffSymbol.color = #red
   \override Staff.LedgerLineSpanner.color = #red
-  \override Voice.Stem.transparent = ##t
-  \override Voice.Flag.transparent = ##t
+  \hide Voice.Stem
   \override NoteHead.style = #'hufnagel.punctum
   \clef "hufnagel-do-fa"
   c
@@ -2711,15 +2699,6 @@ the @code{Stem_engraver} from the Voice context:
 @}
 @end example
 
-However, in some transcription styles, stems are used
-occasionally, for example to indicate the transition from a
-single-tone recitative to a fixed melodic gesture.  In these cases,
-one can use either @code{\override Stem.transparent = ##t} or
-@code{\override Stem.length = #0} instead, and restore the stem
-when needed with the corresponding @code{\once \override Stem.transparent = ##f} (see example below).  When using stems that
-carry flags, make sure to set @code{\override Flag.transparent
-= ##t} as well.
-
 @b{Timing.} For unmetered chant, there are several alternatives.
 
 The Time_signature_engraver can be removed from the Staff context
@@ -2728,12 +2707,12 @@ transparent, will leave an empty space in the score, since the
 invisible signature will still take up space.
 
 In many cases, @code{\set Score.timing = ##f} will give good
-results.  Another alternative is to use @code{\CadenzaOn} and
-@code{\CadenzaOff}.
+results.  Another alternative is to use @code{\cadenzaOn} and
+@code{\cadenzaOff}.
 
 To remove the bar lines, the radical approach is to @code{\remove}
 the Bar_engraver from the Staff context.  Again, one may want to
-use @code{\override BarLine.transparent = ##t} instead, if an
+use @code{\hide BarLine} instead, if an
 occasional barline is wanted.
 
 A common type of transcription is recitativic chant where the
@@ -2765,8 +2744,10 @@ verba = \lyricmode {
       \Staff
       \remove "Time_signature_engraver"
       \remove "Bar_engraver"
-      \override Stem.transparent = ##t
-      \override Flag.transparent = ##t
+    }
+    \context {
+      \Voice
+      \remove "Stem_engraver"
     }
   }
 }
@@ -2774,21 +2755,28 @@ verba = \lyricmode {
 
 This works fine, as long as the text doesn't span a line break.  If
 that is the case, an alternative is to add hidden notes to the
-score, here in combination with changing stem visibility:
+score, as below.
 
+In some transcription styles, stems are used
+occasionally, for example to indicate the transition from a
+single-tone recitative to a fixed melodic gesture.  In these cases,
+one can use either @code{\hide Stem} or
+@code{\override Stem.length = #0} instead of @code{\remove}-ing
+the @code{Stem_engraver} and restore the stem
+when needed with the corresponding @code{\undo \hide Stem}.
 
 @lilypond[verbatim,ragged-right]
 \include "gregorian.ly"
 chant = \relative c' {
   \clef "G_8"
   \set Score.timing = ##f
-  c\breve \override NoteHead.transparent = ##t  c c c c c
-  \revert NoteHead.transparent
-  \override Stem.transparent = ##f \stemUp c4 b4 a
-  \override Stem.transparent = ##t
-  \override Flag.transparent = ##t c2 c4  \divisioMaior
-  c\breve \override NoteHead.transparent = ##t c c c c c c c
-  \revert NoteHead.transparent c4 c f, f \finalis
+  \hide Stem
+  c\breve \hide NoteHead  c c c c c
+  \undo \hide NoteHead
+  \undo \hide Stem \stemUp c4 b4 a
+  \hide Stem c2 c4  \divisioMaior
+  c\breve \hide NoteHead c c c c c c c
+  \undo \hide NoteHead c4 c f, f \finalis
 }
 
 verba = \lyricmode {
@@ -2805,9 +2793,7 @@ verba = \lyricmode {
     \context {
       \Staff
       \remove "Time_signature_engraver"
-      \override BarLine.transparent = ##t
-      \override Stem.transparent = ##t
-      \override Flag.transparent = ##t
+      \hide BarLine
     }
   }
 }
@@ -2857,11 +2843,10 @@ spirLyr = \lyricmode {
       \Staff
       \remove "Time_signature_engraver"
       \override BarLine.X-extent = #'(-1 . 1)
-      \override Stem.transparent = ##t
-      \override Flag.transparent = ##t
-      \override Beam.transparent = ##t
-      \override BarLine.transparent = ##t
-      \override TupletNumber.transparent = ##t
+      \hide Stem
+      \hide Beam
+      \hide BarLine
+      \hide TupletNumber
     }
   }
 }
@@ -2895,7 +2880,7 @@ TBC
 @c try Till Rettig
 @c Add example of white note heads:
 @c In the french baroque some composers used white note heads in slow pieces,
-@c mainly in 3/2-time.  A quarter looks there like a eighth with a white
+@c mainly in 3/2-time.  A quarter looks there like an eighth with a white
 @c note head.  (Franz-Rudolf Kuhnen)
 
 @c TODO Add example of this: