Guide, node Updating translation committishes..
@end ignore
-@c \version "2.19.22"
+@c \version "2.19.53"
@node Pitches
}
@end lilypond
-@funindex fixed
@funindex \fixed
Common octave marks can be entered just once on a reference pitch
after @code{\fixed} placed before the music. Pitches inside
@cindex relative octave specification
@cindex octave specification, relative
-@funindex relative
@funindex \relative
Absolute octave entry requires specifying the octave for every
}
@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:
@cindex transposition and relative octave entry
@funindex \transpose
-@funindex transpose
@funindex \chordmode
-@funindex chordmode
@funindex \relative
-@funindex relative
@node Accidentals
@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.
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}
@funindex =
@funindex \octaveCheck
-@funindex octaveCheck
@funindex controlpitch
In relative mode, it is easy to forget an octave changing mark.
@cindex notes, transposition of
@funindex \transpose
-@funindex transpose
A music expression can be transposed with @code{\transpose}. The
syntax is
@rinternals{TransposedMusic}.
@funindex \transpose
-@funindex transpose
@funindex \chordmode
-@funindex chordmode
@funindex \relative
-@funindex relative
@knownissues
The relative conversion will not affect @code{\transpose},
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).
@cindex transformation, retrograde
@cindex operation, retrograde
@funindex \retrograde
-@funindex retrograde
A music expression can be reversed to produce its retrograde:
@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:
@cindex transposition, modal
@cindex operation, transposition
@funindex \modalTranspose
-@funindex modalTranspose
A motif can be transposed within a given scale with:
@cindex inversion, modal
@cindex operation, modal inversion
@funindex \modalInversion
-@funindex modalInversion
A motif can be inverted within a given scale around a given pivot
note and transposed in a single operation with:
@funindex \clef
-@funindex clef
Without any explicit command, the default clef for LilyPond is the
treble (or @emph{G}) clef.
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.
@cindex key signature
@funindex \key
-@funindex key
@c duplicated in Key signature and Accidentals
@warning{New users are sometimes confused about accidentals and
@end example
@funindex \major
-@funindex major
@funindex \minor
-@funindex minor
@funindex \ionian
-@funindex ionian
@funindex \locrian
-@funindex locrian
@funindex \aeolian
-@funindex aeolian
@funindex \mixolydian
-@funindex mixolydian
@funindex \lydian
-@funindex lydian
@funindex \phrygian
-@funindex phrygian
@funindex \dorian
-@funindex dorian
@cindex church modes
@cindex modes
@funindex set-octavation
@funindex \ottava
-@funindex ottava
@notation{Ottava brackets} introduce an extra transposition of an
octave for the staff:
@cindex MIDI transposition
@funindex \transposition
-@funindex transposition
When typesetting scores that involve transposing instruments, some
parts can be typeset in a different pitch than the
@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
@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 <a cis>8 f bis4 |
+ cis2. <c, g'>4 |
+ }
+ \\
+ \relative {
+ ais'2 cis, |
+ fis8 b a4 cis2 |
+ }
+ >>
+}
+
+musicB = {
+ \clef bass
+ \new Voice {
+ \voiceTwo \relative {
+ <fis a cis>8[ <fis a cis>
+ \change Staff = up
+ cis' cis
+ \change Staff = down
+ <fis, a> <fis a>]
+ \showStaffSwitch
+ \change Staff = up
+ dis'4 |
+ \change Staff = down
+ <fis, a cis>4 gis <f a d>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 <a cis>8 f bis4 |
+ cis2. <c, g'>4 |
+ }
+ \\
+ \relative {
+ ais'2 cis, |
+ fis8 b a4 cis2 |
+ }
+ >>
+}
+
+musicB = {
+ \clef bass
+ \new Voice {
+ \voiceTwo \relative {
+ <fis a cis>8[ <fis a cis>
+ \change Staff = up
+ cis' cis
+ \change Staff = down
+ <fis, a> <fis a>]
+ \showStaffSwitch
+ \change Staff = up
+ dis'4 |
+ \change Staff = down
+ <fis, a cis>4 gis <f a d>2 |
+ }
+ }
+}
+
+\new ChoirStaff {
+ <<
+ \context Staff = "up" {
+ \accidentalStyle choral-cautionary
+ \musicA
+ }
+ \context Staff = "down" {
+ \musicB
+ }
+ >>
+}
+@end lilypond
+
+
@item neo-modern
@cindex neo-modern accidental style
@cindex note heads, easy play
@funindex \easyHeadsOn
-@funindex easyHeadsOn
@funindex \easyHeadsOff
-@funindex easyHeadsOff
The @q{easy play} note head includes a note name inside the head.
It is used in music for beginners. To make the letters readable,
@cindex note heads, Walker
@funindex \aikenHeads
-@funindex aikenHeads
@funindex \sacredHarpHeads
-@funindex sacredHarpHeads
@funindex \southernHarmonyHeads
-@funindex southernHarmonyHeads
@funindex \funkHeads
-@funindex funkHeads
@funindex \walkerHeads
-@funindex walkerHeads
In shape note head notation, the shape of the note head
corresponds to the harmonic function of a note in the scale. This
@end lilypond
@funindex \key
-@funindex key
@funindex \aikenHeadsMinor
-@funindex aikenHeadsMinor
@funindex \sacredHarpHeadsMinor
-@funindex sacredHarpHeadsMinor
@funindex \southernHarmonyHeadsMinor
-@funindex southernHarmonyHeadsMinor
@funindex \funkHeadsMinor
-@funindex funkHeadsMinor
@funindex \walkerHeadsMinor
-@funindex walkerHeadsMinor
Shapes are typeset according to the step in the scale, where the base
of the scale is determined by the @code{\key} command. When writing
@cindex note heads, slashed
@funindex \improvisationOn
-@funindex improvisationOn
@funindex \improvisationOff
-@funindex improvisationOff
Improvisation is sometimes denoted with slashed note heads, where
the performer may choose any pitch but should play the specified