X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fpitches.itely;h=15af95d1405ba6ff626fd31ee912f7581f559274;hb=041cb33a404a829a8cdeeaebce17e45f613f10d8;hp=3aa7738e2bbfcb71812369cc2edccb40207dbbb0;hpb=09ef86c87175cc6c1071eedb022ed1d01a93bcaf;p=lilypond.git diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely index 3aa7738e2b..15af95d140 100644 --- a/Documentation/notation/pitches.itely +++ b/Documentation/notation/pitches.itely @@ -7,7 +7,7 @@ Guide, node Updating translation committishes.. @end ignore -@c \version "2.19.22" +@c \version "2.19.53" @node Pitches @@ -297,6 +297,24 @@ that each interval contains. } @end lilypond +In complex situations, it is sometimes useful to get back to a +certain pitch regardless of what happened before. This can be +done using @code{\resetRelativeOctave}: + +@lilypond[verbatim,quote] +\relative { + << + { c''2 d } + \\ + { e,,2 f } + >> + \resetRelativeOctave c'' + c2 +} +@end lilypond + +@funindex \resetRelativeOctave + @seealso Music Glossary: @@ -456,7 +474,7 @@ Internals Reference: @knownissues There are no generally accepted standards for denoting -quarter-tone accidentals, so LilyPond's symbol does not conform to +quarter-tone accidentals, so LilyPond's symbols do not conform to any standard. @@ -518,7 +536,7 @@ In addition to note names, accidental suffixes may also vary depending on the language: @quotation -@multitable {@code{nederlands}} {-@code{s}/-@code{-sharp}} {-@code{ess}/-@code{es}} {-@code{ss}/-@code{x}/-@code{-sharpsharp}} {-@code{essess}/-@code{eses}} +@multitable {@code{nederlands}} {-@code{s}/-@code{-sharp}} {-@code{f}/-@code{-flat}} {-@code{ss}/-@code{x}/-@code{-sharpsharp}} {-@code{ff}/-@code{-flatflat}} @headitem Language @tab sharp @tab flat @tab double sharp @tab double flat @item @code{nederlands} @@ -841,7 +859,7 @@ relative mode within transposed music, an additional @code{\relative} must be placed inside @code{\transpose}. Triple accidentals will not be printed if using @code{\transpose}. An -@q{enharmonically equivalent} pitch will be used instead (e.g. d-flat +@q{enharmonically equivalent} pitch will be used instead (e.g., d-flat rather than e-triple-flat). @@ -903,9 +921,14 @@ music = \relative { c'8. ees16( fis8. a16 b8.) gis16 f8. d16 } @end lilypond @knownissues -Manual ties inside @code{\retrograde} will be broken and -generate warnings. Some ties can be generated automatically -by enabling @ref{Automatic note splitting}. +@code{\retrograde} is a rather simple tool. Since many events are +@q{mirrored} rather than exchanged, tweaks and directional +modifiers for opening spanners need to be added at the matching +closing spanners: @code{^(} needs to be ended by @code{^)}, every +@code{\<} or @code{\cresc} needs to be ended by @code{\!} or +@code{\endcr}, every @code{\>} or @code{\decr} needs to be ended +by @code{\enddecr}. Property-changing commands/overrides with a +lasting effect will likely cause surprises. @seealso Notation Reference: @@ -1214,6 +1237,13 @@ will be ignored. The command c'1 @end lilypond +@noindent +To be more precise, it is not the @code{\clef} command itself that +prints a clef. Instead, it sets or changes a property of the +@code{Clef_engraver}, which then decides by its own whether to +display a clef or not in the current staff. The @code{forceClef} +property overrides this decision locally to re-print a clef once. + When there is a manual clef change, the glyph of the changed clef will be smaller than normal. This behaviour can be overridden. @@ -1493,26 +1523,24 @@ playing in unison. @lilypond[verbatim,quote] \new GrandStaff << - \new Staff = "violin" { - \relative c'' { - \set Staff.instrumentName = #"Vln" - \set Staff.midiInstrument = #"violin" - % not strictly necessary, but a good reminder - \transposition c' - - \key c \major - g4( c8) r c r c4 - } + \new Staff = "violin" \with { + instrumentName = #"Vln" + midiInstrument = #"violin" } - \new Staff = "clarinet" { - \relative c'' { - \set Staff.instrumentName = \markup { Cl (B\flat) } - \set Staff.midiInstrument = #"clarinet" - \transposition bes - - \key d \major - a4( d8) r d r d4 - } + \relative c'' { + % not strictly necessary, but a good reminder + \transposition c' + \key c \major + g4( c8) r c r c4 + } + \new Staff = "clarinet" \with { + instrumentName = \markup { Cl (B\flat) } + midiInstrument = #"clarinet" + } + \relative c'' { + \transposition bes + \key d \major + a4( d8) r d r d4 } >> @end lilypond @@ -2185,6 +2213,129 @@ musicB = { @end lilypond +@item choral + +@cindex accidental style, choral +@cindex accidentals, choral +@cindex choral accidental style +@cindex choral accidentals + +@funindex choral + +This rule is a combination of the @code{modern-voice} and the @code{piano} +style. It shows all accidentals required for singers that only follow their +own voice, as well as additional accidentals for readers that follow all +voices of an entire @code{ChoirStaff} simultaneously. + +This accidental style applies to the current @code{ChoirStaff} by default. + +@lilypond[quote] +musicA = { + << + \relative { + cis''8 fis, bes4 8 f bis4 | + cis2. 4 | + } + \\ + \relative { + ais'2 cis, | + fis8 b a4 cis2 | + } + >> +} + +musicB = { + \clef bass + \new Voice { + \voiceTwo \relative { + 8[ + \change Staff = up + cis' cis + \change Staff = down + ] + \showStaffSwitch + \change Staff = up + dis'4 | + \change Staff = down + 4 gis 2 | + } + } +} + +\new ChoirStaff { + << + \context Staff = "up" { + \accidentalStyle choral + \musicA + } + \context Staff = "down" { + \musicB + } + >> +} +@end lilypond + +@item choral-cautionary + +@cindex accidentals, choral cautionary +@cindex cautionary accidentals, choral +@cindex choral cautionary accidentals +@cindex accidental style, choral cautionary +@cindex cautionary accidental style, choral +@cindex choral cautionary accidental style + +@funindex choral-cautionary + +This is the same as @code{choral} but with the extra accidentals +typeset as cautionaries. + +@lilypond[quote] +musicA = { + << + \relative { + cis''8 fis, bes4 8 f bis4 | + cis2. 4 | + } + \\ + \relative { + ais'2 cis, | + fis8 b a4 cis2 | + } + >> +} + +musicB = { + \clef bass + \new Voice { + \voiceTwo \relative { + 8[ + \change Staff = up + cis' cis + \change Staff = down + ] + \showStaffSwitch + \change Staff = up + dis'4 | + \change Staff = down + 4 gis 2 | + } + } +} + +\new ChoirStaff { + << + \context Staff = "up" { + \accidentalStyle choral-cautionary + \musicA + } + \context Staff = "down" { + \musicB + } + >> +} +@end lilypond + + @item neo-modern @cindex neo-modern accidental style