version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Chord notation
@lilypondfile[quote]{chords-headword.ly}
-Chords can be entered in chord mode, which recognizes some traditional European chord naming conventions. Chord names can also
-be displayed. In addition, figured bass notation can be displayed.
+Chords can be entered either as normal notes or in chord mode and displayed
+using a variety of traditional European chord naming conventions. Chord
+names and figured bass notation can also be displayed.
@menu
* Chord mode::
Chord mode and note mode can be mixed in sequential music:
@lilypond[verbatim,quote,ragged-right,relative=1]
-<c e g>2 < g b d >
-\chordmode { c2 f}
-< c e g > < g' b d >
-\chordmode { f g}
+<c e g>2 <g b d>
+\chordmode { c2 f }
+<c e g>2 <g' b d>
+\chordmode { f2 g }
@end lilypond
context.
@lilypond[verbatim,quote,ragged-right,relative=1]
-\chordmode { c2 f}
-< c e g > < g' b d >
+\chordmode { c2 f }
+<c e g>2 <g' b d>
@end lilypond
To avoid this behavior, explicitly create the @code{Staff} context:
@lilypond[verbatim,quote,ragged-right,relative=1]
\new Staff {
- \chordmode { c2 f}
- < c e g > < g' b d >
+ \chordmode { c2 f }
+ <c e g>2 <g' b d>
}
@end lilypond
@funindex m
The table belows shows the actions of the quality modifiers on
-triads and seventh chords.
+triads and seventh chords. A more complete table of modifier usage
+is found at @ref{Common chord modifiers}.
-@table @code
+@c @table @code
+@multitable @columnfractions .2 .4 .3
+
+@item
+@b{Modifier}
+@tab
+@b{Action}
+@tab
+@b{Example}
-@item m
+@item
+None
+@tab
+The default action; produces a major triad.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1
+}
+@end lilypond
+
+@item
+m, m7
+@tab
The minor chord. This modifier lowers the 3rd and (if present) the
7th step.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:m c:m7
+}
+@end lilypond
-@item dim
+
+@item
+dim, dim7
+@tab
The diminished chord. This modifier lowers the 3rd, 5th and (if
present) the 7th step.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:dim c:dim7
+}
+@end lilypond
-@item aug
+@item
+aug
+@tab
The augmented chord. This modifier raises the 5th step.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:aug
+}
+@end lilypond
-@item maj
+@item
+maj, maj7
+@tab
The major 7th chord. This modifier adds a raised 7th step. The
@code{7} following @code{maj} is optional. Do NOT use this modifier
to create a major triad.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:maj c:maj7
+}
+@end lilypond
-@end table
+@end multitable
-@c TODO -- perhaps add warning about c and c:maj being different, while
-@c c:maj and c:maj7 are the same
@seealso
+Notation Reference:
+@ref{Common chord modifiers}.
+
Snippets:
-@rlsr{Chords}
+@rlsr{Chords}.
@node Extended and altered chords
@unnumberedsubsubsec Extended and altered chords
@lilypond[quote,ragged-right,fragment,verbatim,relative=1]
\chordmode {
c1:2 c:3 c:4 c:5
- c:6 c:7 c:8 c:9
- c:10 c:11 c:12 c:13
- c:14
+ c1:6 c:7 c:8 c:9
+ c1:10 c:11 c:12 c:13
+ c1:14
}
@end lilypond
Added chord steps can be altered by suffixing a @code{-} or @code{+}
sign to the number. To alter a step that is automatically included
-as part of the basic chode structure, add it as an altered step.
+as part of the basic chord structure, add it as an altered step.
@lilypond[quote,verbatim,fragment,relative=1]
\chordmode {
\chordmode { c1:5.5-.5+ }
@end lilypond
-Only the first inversion can be created by adding a bass note. The
-second inversion requires changing the root of the chord.
+Only the second inversion can be created by adding a bass
+note. The first inversion requires changing the root of
+the chord.
@lilypond[quote,ragged-right,verbatim,fragment]
\chordmode {
@funindex{\chords}
@code{\chords @{ ... @}} is a shortcut notation for
-@code{\new ChordNames @{\chordmode @{ ... @}@}}.
+@code{\new ChordNames @{ \chordmode @{ ... @} @}}.
@lilypond[verbatim,quote,ragged-right, relative=1]
\chords {
Internals Reference:
@rinternals{ChordNames},
+@rinternals{ChordName},
+@rinternals{Chord_name_engraver},
@rinternals{Volta_engraver},
@rinternals{Bar_engraver}.
are also different symbols displayed for a given chord name. The
names and symbols displayed for chord names are customizable.
-@cindex Banter
@cindex jazz chords
@cindex chords, jazz
-The default chord name layout is a system for Jazz music, proposed
-by Klaus Ignatzek (see @ref{Literature list}). There are also two
-other chord name schemes implemented: an alternate Jazz chord
-notation, and a systematic scheme called Banter chords. The
-alternate Jazz notation is also shown on the chart in @ref{Chord
+The basic chord name layout is a system for Jazz music, proposed
+by Klaus Ignatzek (see @ref{Literature list}). The chord naming
+system can be modified as described below. An alternate jazz
+chord system has been developed using these modifications.
+The Ignatzek and alternate
+Jazz notation are shown on the chart in @ref{Chord
name chart}.
@c TODO -- Change this so we don't have a non-verbatim example.
@lilypondfile[ragged-right]{chord-names-languages.ly}
-If none of the default settings give the desired output, the chord
+If none of the existing settings give the desired output, the chord
name display can be tuned through the following properties.
@table @code
@item majorSevenSymbol
This property contains the markup object used to follow the output
-of @code{chordRootNamer} to dentify a major 7 chord. Predefined
+of @code{chordRootNamer} to identify a major 7 chord. Predefined
options are @code{whiteTriangleMarkup} and
@code{blackTriangleMarkup}.
This property is a list of pairs. The first item in each pair
is a set of pitches used to identify the steps present in the chord.
-The second item is a markups that will follow the @code{chordRootNamer}
+The second item is a markup that will follow the @code{chordRootNamer}
output to create the chord name.
@funindex chordPrefixSpacer
@item chordPrefixSpacer
The @q{m} for minor chords is usually printed immediately to the
-right of the root of the chord. By setting
-@code{chordPrefixSpacer}, you can fix a spacer between the root
-and @q{m}. The spacer is not used when the root is altered.
+right of the root of the chord. A spacer can be placed between
+the root and @q{m} by setting @code{chordPrefixSpacer}.
+The spacer is not used when the root is altered.
@end table
@lilypond[quote,ragged-right,verbatim]
myChords = \relative c' {
- \chordmode{ c1 c/g c/f }
- <c e g> <g c e> <f c' e g>
+ \chordmode { c1 c/g c/f }
+ <c e g>1 <g c e> <f c' e g>
}
<<
\new ChordNames { \myChords }
in @code{Staff} contexts.
@code{\figures@{ ... @}} is a shortcut notation for
-@code{\new FiguredBass @{\figuremode @{ ... @}@}}.
+@code{\new FiguredBass @{ \figuremode @{ ... @} @}}.
Although the support for figured bass may superficially resemble chord
stores the figures and the @code{FiguredBass} context prints them
as entered. There is no conversion to pitches.
+@ignore
Figures are created as markup texts. Any of the standard markup
properties can be used to modify the display of figures. For
example, the vertical spacing of the figures may be set with
@code{baseline-skip}.
+@end ignore
@seealso
+Music Glossary:
+@rglos{figured bass}.
+
Snippets:
@rlsr{Chords}
}
@end lilypond
-Augmented and diminished steps can be indicated.
+Augmented and diminished steps can be indicated:
@lilypond[verbatim,quote,ragged-right,fragment]
\figures {
@end lilypond
A backward slash through a figure (typically used for raised
-sixth steps) can be created.
+sixth steps) can be created:
@lilypond[verbatim,quote,ragged-right,fragment]
\figures {
- <6>
- <6\\>
+ <6> <6\\>
}
@end lilypond
@lilypond[verbatim,quote,ragged-right,fragment]
\figures {
- < \markup{ \tiny \number 6 \super (1)} 5 >
+ <\markup { \tiny \number 6 \super (1) } 5>
}
@end lilypond
<<
{
\clef bass
- e d c b,
- e d c b,
+ e4 d c b,
+ e4 d c b,
}
\figures {
\bassFigureExtendersOn
- <6 4> <6 3> <7 3> <7 3>
+ <6 4>4 <6 3> <7 3> <7 3>
\bassFigureExtendersOff
- <6 4> <6 3> <7 3> <7 3>
+ <6 4>4 <6 3> <7 3> <7 3>
}
>>
@end lilypond
<<
\figures {
\bassFigureExtendersOn
- <6 4> <6 4> <6\! 4\!> <6 4>
+ <6 4>4 <6 4> <6\! 4\!> <6 4>
}
{
\clef bass
- d d c c
+ d4 d c c
}
>>
@end lilypond
@tab
End of continuation line
@tab
-@lilypond[line-width=1.5\cm]
+@lilypond[line-width=4\cm]
<<
\figures {
\bassFigureExtendersOn
@c @rlearning{}.
@c Notation Reference:
-@c @ruser{}.
+@c @ref{}.
@c Application Usage:
@c @rprogram{}.
@rlsr{Chords}.
Internals Reference:
-@rinternals{NewBassFigure},
+@rinternals{BassFigure},
@rinternals{BassFigureAlignment},
@rinternals{BassFigureLine},
@rinternals{BassFigureBracket},
@end lilypond
-When added in a Staff context, figured bass can be displayed above
+When added in a @code{Staff} context, figured bass can be displayed above
or below the staff.
@lilypond[verbatim,ragged-right,fragment,quote]
@c @rlearning{}.
@c Notation Reference:
-@c @ruser{}.
+@c @ref{}.
@c Application Usage:
@c @rprogram{}.
@rlsr{Chords}.
Internals Reference:
-@rinternals{NewBassFigure},
+@rinternals{BassFigure},
@rinternals{BassFigureAlignment},
@rinternals{BassFigureLine},
@rinternals{BassFigureBracket},
<<
{
\clef bass
- \repeat unfold 4 {f16. g32} f8. es16 d8 es
+ \repeat unfold 4 { f16. g32 } f8. es16 d8 es
}
\figures {
\bassFigureExtendersOn
% The extenders are correct here, with the same rhythm as the bass
- \repeat unfold 4 {<6 4->16. <6 4->32}
+ \repeat unfold 4 { <6 4->16. <6 4->32 }
<5>8. r16 <6>8 <6\! 5->
}
>>
<<
{
\clef bass
- \repeat unfold 4 {f16. g32} f8. es16 d8 es
+ \repeat unfold 4 { f16. g32 } f8. es16 d8 es
}
\figures {
\bassFigureExtendersOn
@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
<<
- { fis g g, e' }
+ { fis4 g g, e' }
\figures {
\bassFigureExtendersOn
- <6 5> <5\! 4> < 5 _!> <6>
+ <6 5>4 <5\! 4> < 5 _!> <6>
}
>>
@end lilypond
@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
<<
- { fis g g, e' }
+ { fis4 g g, e' }
\figures {
- <6 5> <5 4>
+ <6 5>4 <5 4>
\bassFigureExtendersOn
- < 5 _!> <6>
+ < 5 _!>4 <6>
\bassFigureExtendersOff
}
>>
projects / lilypond.git / blobdiff