<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Customizing chord names - GNU LilyPond Notation Reference</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="description" content="GNU LilyPond Notation Reference">
<meta name="generator" content="makeinfo 4.11">
<link title="Top" rel="start" href="index.de.html#Top">
<link rel="up" href="Displaying-chords.de.html#Displaying-chords" title="Displaying chords">
<link rel="prev" href="Printing-chord-names.de.html#Printing-chord-names" title="Printing chord names">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1999--2007 by the authors
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections. A copy of the license is
included in the section entitled ``GNU Free Documentation
License''.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
hr { border:0; height:1; color: #000000; background-color: #000000; }
/* hr {
border: none;
height: 1px;
color: #666666;
background-color: #666666;
}
body {
border-left: 1px solid #666666;
border-right: 1px solid #666666;
color: #332d28;
margin-right: auto;
margin-left: auto;
width: 60em;
list-style-type: square;
font-family: Arial,Helvetica,sans-serif;
padding-right: 1em;
padding-left: 1em;
}
a {
border-bottom: 1px dashed #344242;
text-decoration: none;
color: #344242;
}
a:link {
text-decoration: none;
}
a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
a:active {
border-bottom: 1px solid #00cccc;
color: #00cccc;
}
a:hover {
border-bottom: 1px solid #1d7b85;
color: #1d7b85;
}
blockquote {
border: 1px solid #cccccc;
padding: 3px;
width: 40em;
}
.node {
border-left: 1px solid #666666;
margin: -0.5em 0px 1em;
padding: 2px 1px 0px;
font-style: italic;
}
.node a {
border: none;
text-decoration: underline;
font-style: normal;
font-weight: bold;
}
.verbatim {
font-family: "Courier New",Courier,monospace;
}
.unnumberedsubsubsec {
font-size: large;
color: #1d7b85;
}
.subsubheading {
font-size: large;
color: #3b220d;
}
.contents {
border: 1px dashed #339999;
margin: 3px 2em;
list-style-type: square;
padding-right: 1em;
width: 40em;
background-color: #fcfff9;
}
.contents a {
border-bottom: 1px dashed #423d34;
text-decoration: none;
color: #423d34;
}
.contents a:visited {
border-bottom: 1px dashed #666666;
color: #666666;
}
.contents a:active {
border-bottom: 1px solid #f0d86d;
color: #f0d86d;
}
.contents a:hover {
border-bottom: 1px solid #3b220d;
color: #3b220d;
}
.menu {
border-left: 1px dashed #339999;
margin: 3px 2em 1em;
list-style-type: square;
padding-left: 1.4em;
width: 40em;
}
.unnumbered {
}
h2 {
font-size: x-large;
color: #1d7b85;
}
*/
--></style>
</head>
<BODY BGCOLOR=WHITE TEXT=BLACK>
<div class="node">
<p>
<a name="Customizing-chord-names"></a>
Previous: <a rel="previous" accesskey="p" href="Printing-chord-names.de.html#Printing-chord-names">Printing chord names</a>,
Up: <a rel="up" accesskey="u" href="Displaying-chords.de.html#Displaying-chords">Displaying chords</a>
<hr>
</div>
<h5 class="unnumberedsubsubsec">Customizing chord names</h5>
<p><a name="index-customizing-chord-names-2175"></a>
There is no unique system for naming chords. Different musical
traditions use different names for the same set of chords. There
are also different symbols displayed for a given chord name. The
names and symbols displayed for chord names are customizable.
<p><a name="index-jazz-chords-2176"></a><a name="index-chords_002c-jazz-2177"></a>
The basic chord name layout is a system for Jazz music, proposed
by Klaus Ignatzek (see <a href="Literature-list.de.html#Literature-list">Literature list</a>). 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 <a href="Chord-name-chart.de.html#Chord-name-chart">Chord name chart</a>.
<!-- TODO - Change this so we don't have a non-verbatim example. -->
<!-- Make short example in docs, then move longer example to -->
<!-- appendix, where the length of the snippet won't matter. -->
<p>In addition to the different naming systems, different note names
are used for the root in different languages. The predefined
variables <code>\germanChords</code>, <code>\semiGermanChords</code>,
<code>\italianChords</code> and <code>\frenchChords</code> set these variables.
The effect is demonstrated here:
<p class="noindent"><p>
<a href="../71/lily-0293a7c0.ly">
<img align="middle"
border="0" src="../71/lily-0293a7c0.png" alt="[image of music]">
</a>
</p>
<p>If none of the existing settings give the desired output, the chord
name display can be tuned through the following properties.
<a name="index-chordRootNamer-2178"></a>
<a name="index-chordRootNamer-2179"></a>
<dl>
<dt><code>chordRootNamer</code><dd>
The chord name is usually printed as a letter for the root with an
optional alteration. The transformation from pitch to letter is
done by this function. Special note names (for example, the German
‘H’ for a B-chord) can be produced by storing a new function in
this property.
<p><a name="index-majorSevenSymbol-2180"></a><a name="index-majorSevenSymbol-2181"></a>
<br><dt><code>majorSevenSymbol</code><dd>
This property contains the markup object used to follow the output
of <code>chordRootNamer</code> to identify a major 7 chord. Predefined
options are <code>whiteTriangleMarkup</code> and
<code>blackTriangleMarkup</code>.
<p><a name="index-chordNoteNamer-2182"></a><a name="index-chordNoteNamer-2183"></a>
<br><dt><code>chordNoteNamer</code><dd>
When the chord name contains additional pitches other than the root
(e.g., an added bass note), this function is used to print the
additional pitch. By default the pitch is printed using
<code>chordRootNamer</code>. The <code>chordNoteNamer</code> property can be set
to a specialized function to change this behavior. For example, the
bass note can be printed in lower case.
<p><a name="index-chordNameSeparator-2184"></a><a name="index-chordNameSeparator-2185"></a>
<br><dt><code>chordNameSeparator</code><dd>
Different parts of a chord name are normally separated by a slash.
By setting <code>chordNameSeparator</code>, you can use any desired markup
for a separator.
<p><a name="index-chordNameExceptions-2186"></a><a name="index-chordNameExceptions-2187"></a>
<br><dt><code>chordNameExceptions</code><dd>
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 markup that will follow the <code>chordRootNamer</code>
output to create the chord name.
<p><a name="index-chordPrefixSpacer-2188"></a><a name="index-chordPrefixSpacer-2189"></a>
<br><dt><code>chordPrefixSpacer</code><dd>
The ‘m’ for minor chords is usually printed immediately to the
right of the root of the chord. A spacer can be placed between
the root and ‘m’ by setting <code>chordPrefixSpacer</code>.
The spacer is not used when the root is altered.
</dl>
<p class="noindent">
<h5 class="subsubheading">Predefined commands</h5>
<p><a name="index-major-seven-symbols-2190"></a><a name="index-major-seven-symbols-2191"></a>
<code>\whiteTriangleMarkup</code>,
<code>\blackTriangleMarkup</code>,
<a name="index-g_t_005cgermanChords-2192"></a><a name="index-g_t_005cgermanChords-2193"></a>
<code>\germanChords</code>,
<a name="index-g_t_005csemiGermanChords-2194"></a><a name="index-g_t_005csemiGermanChords-2195"></a>
<code>\semiGermanChords</code>,
<a name="index-g_t_005citalianChords-2196"></a><a name="index-g_t_005citalianChords-2197"></a>
<code>\italianChords</code>,
<a name="index-g_t_005cfrenchChords-2198"></a><a name="index-g_t_005cfrenchChords-2199"></a>
<code>\frenchChords</code>.
<p class="noindent">
<h5 class="subsubheading">Selected Snippets</h5>
<p><a name="index-exceptions_002c-chord-names_002e-2200"></a><em>Chord name exceptions</em>
<p>The property <code>chordNameExceptions</code> can be used to store a list of
special notations for specific chords.
<blockquote>
<pre class="verbatim">
% modify maj9 and 6(add9)
% Exception music is chords with markups
chExceptionMusic = {
<c e g b d'>1-\markup { \super "maj9" }
<c e g a d'>1-\markup { \super "6(add9)" }
}
% Convert music to list and prepend to existing exceptions.
chExceptions = #( append
( sequential-music-to-chord-exceptions chExceptionMusic #t)
ignatzekExceptions)
theMusic = \chordmode {
g1:maj9 g1:6.9
\set chordNameExceptions = #chExceptions
g1:maj9 g1:6.9
}
\layout {
ragged-right = ##t
}
<< \context ChordNames \theMusic
\context Voice \theMusic
>>
</pre>
<p>
<a href="../9b/lily-25573269.ly">
<img align="middle"
border="0" src="../9b/lily-25573269.png" alt="[image of music]">
</a>
</p>
</blockquote>
<!-- TODO - tweak snippet to use \blackTriangleMarkup as well -->
<p>The layout of the major 7 can be tuned with
<code>majorSevenSymbol</code>.
<blockquote>
<pre class="verbatim">
\version "2.11.51"
\header {
texidoc = "The layout of the major 7 can be tuned with
@code{majorSevenSymbol}."
}
\chords {
c:7+
\set majorSevenSymbol = \markup { "j7" }
c:7+
}
</pre>
<p>
<a href="../c8/lily-ed34962c.ly">
<img align="middle"
border="0" src="../c8/lily-ed34962c.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><em>Adding bar lines to ChordNames context</em>
<p>To add bar line indications in the <code>ChordNames</code> context, add the
<code>Bar_engraver</code>.
<blockquote>
<pre class="verbatim">
\new ChordNames \with {
\override BarLine #'bar-size = #4
\consists "Bar_engraver"
}
\chordmode {
f1:maj7 f:7 bes:7
}
</pre>
<p>
<a href="../c2/lily-86afae22.ly">
<img align="middle"
border="0" src="../c2/lily-86afae22.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><em>Volta under chords</em>
<p>By adding the <code>Volta_engraver</code> to the relevant
staff, volte can be put under chords.
<blockquote>
<pre class="verbatim">
\score {
<<
\chords {
c1
c1
}
\new Staff \with { \consists "Volta_engraver" } {
\repeat volta 2 { c'1 }
\alternative { c' }
}
>>
\layout {
\context {
\Score
\remove "Volta_engraver"
}
}
}
</pre>
<p>
<a href="../0f/lily-dac5e24a.ly">
<img align="middle"
border="0" src="../0f/lily-dac5e24a.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><em>Changing chord separator</em>
<p>The separator between different parts of a chord name can be set to any
markup.
<blockquote>
<pre class="verbatim">
\chords {
c:7sus4
\set chordNameSeparator
= \markup { \typewriter | }
c:7sus4
}
</pre>
<p>
<a href="../e8/lily-a37a56b7.ly">
<img align="middle"
border="0" src="../e8/lily-a37a56b7.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
<p>Notation Reference:
<a href="Chord-name-chart.de.html#Chord-name-chart">Chord name chart</a>,
<a href="Common-chord-modifiers.de.html#Common-chord-modifiers">Common chord modifiers</a>.
<p>Installed Files:
<samp><span class="file">scm/chords-ignatzek.scm</span></samp>,
<samp><span class="file">scm/chord-entry.scm</span></samp>,
<samp><span class="file">ly/chord-modifier-init.ly</span></samp>.
<p>Snippets:
<a href="../../../input/lsr/lilypond-snippets/Chords.html#Chords">Chords</a>.
<!-- Internals Reference: -->
<!-- @r internals{}. -->
<p class="noindent">
<h5 class="subsubheading">Known issues and warnings</h5>
<p>Chord names are determined from both the pitches that are present
in the chord and the information on the chord structure that may
have been entered in <code>\chordmode</code>. If the simultaneous pitches
method of entering chords is used, undesired names result from
inversions or bass notes.
<blockquote>
<pre class="verbatim">
myChords = \relative c' {
\chordmode { c1 c/g c/f }
<c e g>1 <g c e> <f c' e g>
}
<<
\new ChordNames { \myChords }
\new Staff { \myChords }
>>
</pre>
<p>
<a href="../d9/lily-b8810904.ly">
<img align="middle"
border="0" src="../d9/lily-b8810904.png" alt="[image of music]">
</a>
</p>
</blockquote>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Previous: <a rel="previous" accesskey="p" href="Printing-chord-names.de.html#Printing-chord-names">Printing chord names</a>,
Up: <a rel="up" accesskey="u" href="Displaying-chords.de.html#Displaying-chords">Displaying chords</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
Diese Seite ist für LilyPond-2.11.57 (Entwicklungszweig).
<br>
<address>
Fehler bitte an <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs</a> melden. </address>
<br>
Ihre <a href="http://lilypond.org/web/devel/participating/documentation-adding">Vorschläge für die Dokumentation</a> sind willkommen.
</font>
</p>
</div>
<P>
Andere Sprachen: <a href="Customizing-chord-names.es.html">español</a>.
<BR>
</P>
</BODY></html>
