Guide, node Updating translation committishes..
@end ignore
-@c \version "2.15.20"
+@c \version "2.17.6"
@node Pitches
@cindex operation, inversion
@funindex \inversion
-A music expression can be inverted with:
+A music expression can be inverted and transposed in a single
+operation with:
@example
-\inversion @var{from-pitch} @var{to-pitch} @var{musicexpr}
+\inversion @var{around-pitch} @var{to-pitch} @var{musicexpr}
@end example
-The @code{@var{musicexpr}} is inverted interval-by-interval,
-and then transposed so that @code{@var{from-pitch}} is mapped
-to @code{@var{to-pitch}}.
+The @code{@var{musicexpr}} is inverted interval-by-interval around
+@code{@var{around-pitch}}, and then transposed so that
+@code{@var{around-pitch}} is mapped to @code{@var{to-pitch}}.
@lilypond[verbatim,quote]
music = \relative c' { c d e f }
}
@end lilypond
+@warning{Motifs to be inverted should be expressed in absolute form
+or be first converted to absolute form by enclosing them in a
+@code{\relative} block.}
+
@seealso
Notation Reference:
@ref{Modal transformations},
@warning{Any note that does not lie within the given scale will be
left untransformed.}
-@subsubheading Modal transposition
+@subsubsubheading Modal transposition
@cindex modal transposition
@cindex transposition, modal
}
@end lilypond
-@subsubheading Modal inversion
+@subsubsubheading Modal inversion
@cindex modal inversion
@cindex inversion, modal
@rinternals{OctavateEight},
@rinternals{clef-interface}.
+@knownissues
+Ottavation numbers attached to clefs are treated as separate grobs. So
+any @code{\override} done to the @var{Clef} will also need to be
+applied, as a separate @code{\override}, to the @var{OctavateEight}
+grob.
+
+@lilypond[fragment,quote,relative=1]
+\new Staff \with {
+ \override OctavateEight #'color = #red
+ \override Clef #'color = #blue
+}
+
+\clef "treble_8" c4
+@end lilypond
+
@node Key signature
@unnumberedsubsubsec Key signature
fis
@end lilypond
+Additional modes can be defined, by listing the alterations
+for each scale step when the mode starts on C.
+
+@lilypond[verbatim,quote]
+freygish = #`((0 . ,NATURAL) (1 . ,FLAT) (2 . ,NATURAL)
+ (3 . ,NATURAL) (4 . ,NATURAL) (5 . ,FLAT) (6 . ,FLAT))
+
+\relative c' {
+ \key c\freygish c4 des e f
+ \bar "||" \key d\freygish d es fis g
+}
+@end lilypond
+
+Accidentals in the key signature may be printed in octaves other
+than their traditional positions, or in multiple octaves, by
+using the @code{flat-positions} and @code{sharp-positions}
+properties of @code{KeySignature}. Entries in these properties
+specify the range of staff-positions where accidentals will be
+printed. If a single position is specified in an entry, the
+accidentals are placed within the octave ending at that staff
+position.
+
+@lilypond[verbatim, quote,relative=0]
+\override Staff.KeySignature #'flat-positions = #'((-5 . 5))
+\override Staff.KeyCancellation #'flat-positions = #'((-5 . 5))
+\clef bass \key es\major es g bes d
+\clef treble \bar "||" \key es\major es g bes d
+
+\override Staff.KeySignature #'sharp-positions = #'(2)
+\bar "||" \key b\major b fis b2
+@end lilypond
@snippets
@rinternals{Key_performer},
@rinternals{KeyCancellation},
@rinternals{KeySignature},
-@rinternals{key-cancellation-interface},
@rinternals{key-signature-interface}.
\transposition a
c d e f
\textLengthOn
-s1*0^\markup { Switch to B\flat clarinet }
+<>^\markup { Switch to B\flat clarinet }
R1
\key bes \major
@example
\new Staff <<
- \accidentalStyle "voice"
+ \accidentalStyle voice
@{ @dots{} @}
>>
@end example
style in all staves of the current @code{StaffGroup}, use:
@example
-\accidentalStyle #'StaffGroup "voice"
+\accidentalStyle StaffGroup.voice
@end example
The following accidental styles are supported. To demonstrate
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "default"
+ \accidentalStyle default
\musicA
}
\context Staff = "down" {
- \accidentalStyle "default"
+ \accidentalStyle default
\musicB
}
>>
<<
\context Staff = "up" @{
%%% change the next line as desired:
- \accidentalStyle #'Score "default"
+ \accidentalStyle Score.default
\musicA
@}
\context Staff = "down" @{
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "default"
+ \accidentalStyle default
\musicA
}
\context Staff = "down" {
- \accidentalStyle "default"
+ \accidentalStyle default
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "voice"
+ \accidentalStyle voice
\musicA
}
\context Staff = "down" {
- \accidentalStyle "voice"
+ \accidentalStyle voice
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "modern"
+ \accidentalStyle modern
\musicA
}
\context Staff = "down" {
- \accidentalStyle "modern"
+ \accidentalStyle modern
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "modern-cautionary"
+ \accidentalStyle modern-cautionary
\musicA
}
\context Staff = "down" {
- \accidentalStyle "modern-cautionary"
+ \accidentalStyle modern-cautionary
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "modern-voice"
+ \accidentalStyle modern-voice
\musicA
}
\context Staff = "down" {
- \accidentalStyle "modern-voice"
+ \accidentalStyle modern-voice
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "modern-voice-cautionary"
+ \accidentalStyle modern-voice-cautionary
\musicA
}
\context Staff = "down" {
- \accidentalStyle "modern-voice-cautionary"
+ \accidentalStyle modern-voice-cautionary
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "piano"
+ \accidentalStyle piano
\musicA
}
\context Staff = "down" {
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "piano-cautionary"
+ \accidentalStyle piano-cautionary
\musicA
}
\context Staff = "down" {
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "neo-modern"
+ \accidentalStyle neo-modern
\musicA
}
\context Staff = "down" {
- \accidentalStyle "neo-modern"
+ \accidentalStyle neo-modern
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "neo-modern-cautionary"
+ \accidentalStyle neo-modern-cautionary
\musicA
}
\context Staff = "down" {
- \accidentalStyle "neo-modern-cautionary"
+ \accidentalStyle neo-modern-cautionary
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "neo-modern-voice"
+ \accidentalStyle neo-modern-voice
\musicA
}
\context Staff = "down" {
- \accidentalStyle "neo-modern-voice"
+ \accidentalStyle neo-modern-voice
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "neo-modern-voice-cautionary"
+ \accidentalStyle neo-modern-voice-cautionary
\musicA
}
\context Staff = "down" {
- \accidentalStyle "neo-modern-voice-cautionary"
+ \accidentalStyle neo-modern-voice-cautionary
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "dodecaphonic"
+ \accidentalStyle dodecaphonic
\musicA
}
\context Staff = "down" {
- \accidentalStyle "dodecaphonic"
+ \accidentalStyle dodecaphonic
\musicB
}
>>
accidentals are added for all sharp or flat tones specified by the
key signature, except if the note is immediately repeated.
-@lilypond[quote]
+@lilypond[quote,staffsize=18]
musicA = {
<<
\relative c' {
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
<<
\context Staff = "up" {
\key fis \minor
- \accidentalStyle "teaching"
+ \accidentalStyle teaching
\musicA
}
\context Staff = "down" {
\key fis \minor
- \accidentalStyle "teaching"
+ \accidentalStyle teaching
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "no-reset"
+ \accidentalStyle no-reset
\musicA
}
\context Staff = "down" {
- \accidentalStyle "no-reset"
+ \accidentalStyle no-reset
\musicB
}
>>
\clef bass
\new Voice {
\voiceTwo \relative c' {
- <fis, a cis>8 <fis a cis>
+ <fis, a cis>8[ <fis a cis>
\change Staff = up
cis' cis
\change Staff = down
- <fis, a> <fis a>
+ <fis, a> <fis a>]
\showStaffSwitch
\change Staff = up
dis'4 |
\new PianoStaff {
<<
\context Staff = "up" {
- \accidentalStyle "forget"
+ \accidentalStyle forget
\musicA
}
\context Staff = "down" {
- \accidentalStyle "forget"
+ \accidentalStyle forget
\musicB
}
>>
@lilypond[quote]
{
- \accidentalStyle "modern"
+ \accidentalStyle modern
\time 2/4
\repeat volta 2 {
c'2
@lilypond[verbatim,quote]
forget = #(define-music-function (parser location music) (ly:music?) #{
- \accidentalStyle "forget"
- $music
- \accidentalStyle "modern"
+ \accidentalStyle forget
+ #music
+ \accidentalStyle modern
#})
{
- \accidentalStyle "modern"
+ \accidentalStyle modern
\time 2/4
\repeat volta 2 {
c'2