version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.61"
+@c \version "2.12.0"
@node Chord notation
Chords entered using chord mode are music elements, and can be
transposed just like chords entered using simultaneous music.
+@code{\chordmode} is absolute, as @code{\relative} has no effect
+on @code{chordmode} blocks. However, in @code{\chordmode} the
+absolute pitches are one octave higher than in note mode.
Chord mode and note mode can be mixed in sequential music:
@seealso
-
Music Glossary:
@rglos{chord}.
Snippets:
@rlsr{Chords}
+
@knownissues
When chord mode and note mode are mixed in sequential music, and
@funindex m
The table belows shows the actions of the quality modifiers on
-triads and seventh chords. A more complete table of modifier usage
+triads and seventh chords. The default seventh step added to
+chords is a minor or flatted seventh, which makes the dominant
+seventh the basic seventh chord. All alterations are relative to
+the dominant seventh. A more complete table of modifier usage
is found at @ref{Common chord modifiers}.
@c @table @code
}
@end lilypond
-@item
+@item
m, m7
@tab
-The minor chord. This modifier lowers the 3rd and (if present) the
-7th step.
+The minor chord. This modifier lowers the 3rd.
@tab
@lilypond[line-width=4\cm, noragged-right]
\chordmode {
@end lilypond
-@item
+@item
dim, dim7
@tab
The diminished chord. This modifier lowers the 3rd, 5th and (if
}
@end lilypond
-@item
+@item
aug
@tab
The augmented chord. This modifier raises the 5th step.
}
@end lilypond
-@item
+@item
maj, maj7
@tab
The major 7th chord. This modifier adds a raised 7th step. The
@seealso
-
Notation Reference:
-@ref{Common chord modifiers}.
+@ref{Common chord modifiers},
+@ref{Extended and altered chords}.
Snippets:
@rlsr{Chords}.
+@knownissues
+Only one quality modifier should be used per chord, typically on the
+highest step present in the chord. Chords with more than quality
+modifier will be parsed without an error or warning, but the results
+are unpredictable. Chords that cannot be achieved with a single
+quality modifier should be altered by individual pitches, as described
+in @ref{Extended and altered chords}.
+
+
@node Extended and altered chords
@unnumberedsubsubsec Extended and altered chords
The first number following the @code{:} is taken to be the extent
of the chord. The chord is constructed by sequentially adding
thirds to the root until the specified number has been reached.
+Note that the seventh step added as part of an extended chord will be the
+minor or flatted seventh, not the major seventh.
If the extent is not a third (e.g., 6), thirds are added up to the
highest third below the extent, and then the step of the extent is
added. The largest possible value for the extent is 13. Any
@cindex additions, in chords
Individual steps can be added to a chord. Additions follow the
-extent and are prefixed by a dot (@code{.}).
+extent and are prefixed by a dot (@code{.}). The basic seventh
+step added to a chord is the minor or flatted seventh, rather than
+the major seventh.
@lilypond[quote,verbatim,fragment,relative=1]
\chordmode {
@funindex ^
-Following any steps to be added, a series of steps to be removed
-is introduced in a modifier string with a prefix of @code{^}.
+Following any steps to be added, a series of steps to be removed
+is introduced in a modifier string with a prefix of @code{^}.
If more than one step is to be removed, the steps to be
removed are separated by @code{.} following the
-initial @code{^}.
+initial @code{^}.
@lilypond[quote,verbatim,fragment,relative=1]
\chordmode {
@end lilypond
Chord modifiers that can be used to produce a variety of
-standard chords are shown in
+standard chords are shown in
@ref{Common chord modifiers}.
-@seealso
+@seealso
Notation Reference:
@ref{Common chord modifiers}.
Snippets:
@rlsr{Chords}
+
@knownissues
Each step can only be present in a chord once. The following
>>
@end lilypond
+@cindex no chord symbol
+@cindex N.C. symbol
+@cindex indicating No Chord in ChordNames
+
+Rests passed to a @code{ChordNames} context will cause the
+@code{noChordSymbol} markup to be displayed.
+
+@lilypond[verbatim, quote, relative=1]
+<<
+ \new ChordNames \chordmode {
+ c1
+ r1
+ g1
+ c1
+ }
+ \new Score \chordmode {
+ c1
+ r1
+ g1
+ c1
+ }
+>>
+@end lilypond
+
@funindex{\chords}
@code{\chords @{ ... @}} is a shortcut notation for
@seealso
-
Music Glossary:
@rglos{chord}.
-
Notation Reference:
@ref{Writing music in parallel}.
-
Snippets:
@rlsr{Chords}.
@rinternals{Volta_engraver},
@rinternals{Bar_engraver}.
+
@knownissues
Chords containing inversions or altered bass notes are not named
@end table
-@predefined
+@predefined
@funindex major seven symbols
@code{\whiteTriangleMarkup},
@code{\blackTriangleMarkup},
@code{\italianChords},
@funindex \frenchChords
@code{\frenchChords}.
+@endpredefined
@snippets
@seealso
-
Notation Reference:
@ref{Chord name chart},
@ref{Common chord modifiers}.
@c Internals Reference:
@c @r internals{}.
+
@knownissues
Chord names are determined from both the pitches that are present
@code{baseline-skip}.
@end ignore
-@seealso
+@seealso
Music Glossary:
@rglos{figured bass}.
@end multitable
-
@predefined
@cindex figured bass extender lines
@code{\bassFigureExtendersOn},
@code{\bassFigureExtendersOff}.
+@endpredefined
@snippets
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{changing-the-positions-of-figured-bass-alterations.ly}
+
@seealso
@c Music Glossary:
@c @rglos{}.
-
+@c
@c Learning Manual:
@c @rlearning{}.
-
+@c
@c Notation Reference:
@c @ref{}.
-
+@c
@c Application Usage:
@c @rprogram{}.
-
+@c
@c Installed Files:
@c @file{}.
-
+@c
Snippets:
@rlsr{Chords}.
@rinternals{BassFigureContinuation},
@rinternals{FiguredBass}.
+
@c @knownissues
+
@node Displaying figured bass
@unnumberedsubsubsec Displaying figured bass
@code{\bassFigureStaffAlignmentDown},
@code{\bassFigureStaffAlignmentUp},
@code{\bassFigureStaffAlignmentNeutral}.
+@endpredefined
+
@c @snippets
+
@seealso
@c Music Glossary:
@c @rglos{}.
-
+@c
@c Learning Manual:
@c @rlearning{}.
-
+@c
@c Notation Reference:
@c @ref{}.
-
+@c
@c Application Usage:
@c @rprogram{}.
-
+@c
@c Installed Files:
@c @file{}.
-
+@c
Snippets:
@rlsr{Chords}.
@rinternals{BassFigureContinuation},
@rinternals{FiguredBass}.
+
@knownissues
To ensure that continuation lines work properly, it is
projects / lilypond.git / blobdiff