<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Custom tablatures - 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.html#Top">
<link rel="up" href="Common-notation-for-fretted-strings.html#Common-notation-for-fretted-strings" title="Common notation for fretted strings">
<link rel="prev" href="Default-tablatures.html#Default-tablatures" title="Default tablatures">
<link rel="next" href="Fret-diagram-markups.html#Fret-diagram-markups" title="Fret diagram markups">
<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="Custom-tablatures"></a>
Next: <a rel="next" accesskey="n" href="Fret-diagram-markups.html#Fret-diagram-markups">Fret diagram markups</a>,
Previous: <a rel="previous" accesskey="p" href="Default-tablatures.html#Default-tablatures">Default tablatures</a>,
Up: <a rel="up" accesskey="u" href="Common-notation-for-fretted-strings.html#Common-notation-for-fretted-strings">Common notation for fretted strings</a>
<hr>
</div>
<h5 class="unnumberedsubsubsec">Custom tablatures</h5>
<p><a name="index-Tablatures_002c-custom-2089"></a>
LilyPond tabulature automatically calculates the fret for
a note based on the string to which the note is assigned.
In order to do this, the tuning of the strings must be
specified. The tuning of the strings is given in the
<code>StringTunings</code> property.
<p>LilyPond comes with predefined string tunings for banjo, mandolin,
guitar and bass guitar. Lilypond automatically sets the correct
transposition for predefined tunings. The following example is
for bass guitar, which sounds an octave lower than written.
<blockquote>
<pre class="verbatim">
<<
\new Staff {
\clef "bass_8"
\relative c, {
c4 d e f
}
}
\new TabStaff {
\set TabStaff.stringTunings = #bass-tuning
\relative c, {
c4 d e f
}
}
>>
</pre>
<p>
<a href="../fd/lily-2bec9abe.ly">
<img align="middle"
border="0" src="../fd/lily-2bec9abe.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>The default string tuning is <code>guitar-tuning</code>, which
is the standard EADGBE tuning. Some other predefined tunings are
<code>guitar-open-g-tuning</code>, <code>mandolin-tuning</code> and
<code>banjo-open-g-tuning</code>. The predefined string tunings
are found in <code>scm/output-lib.scm</code>.
<p>A string tuning is a Scheme list of string pitches,
one for each string, ordered by string number from 1 to N,
where string 1 is at the top of the tablature staff and
string N is at the bottom. This ordinarily results in ordering
from highest pitch to lowest pitch, but some instruments
(e.g. ukulele) do not have strings ordered by pitch.
<p>A string pitch in a string tuning list is the pitch difference
of the open string from middle C measured in semitones. The
string pitch must be an integer. Lilypond calculates the actual
pitch of the string by adding the string tuning pitch to the
actual pitch for middle C.
<p>LilyPond automatically calculates the number of strings in the
<code>TabStaff</code> as the number of elements in <code>stringTunings</code>.
<p>Any desired string tuning can be created. For example, we can
define a string tuning for a four-string instrument with pitches
of <code>a''</code>, <code>d''</code>, <code>g'</code>, and <code>c'</code>:
<blockquote>
<pre class="verbatim">
mynotes = {
c'4 e' g' c'' |
e'' g'' b'' c'''
}
<<
\new Staff {
\clef treble
\mynotes
}
\new TabStaff {
\set TabStaff.stringTunings = #'(21 14 7 0)
\mynotes
}
>>
</pre>
<p>
<a href="../bf/lily-246e9b46.ly">
<img align="middle"
border="0" src="../bf/lily-246e9b46.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
<p>Installed Files:
<samp><span class="file">scm/output-lib.scm</span></samp>.
<p>Snippets:
<a href="../../../input/lsr/lilypond-snippets/Fretted-strings.html#Fretted-strings">Fretted strings</a>.
<p>Internals Reference:
<a name="index-Tab_005fnote_005fheads_005fengraver-2090"></a><a href="../lilypond-internals/Tab_005fnote_005fheads_005fengraver.html#Tab_005fnote_005fheads_005fengraver">Tab_note_heads_engraver</a>.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Fret-diagram-markups.html#Fret-diagram-markups">Fret diagram markups</a>,
Previous: <a rel="previous" accesskey="p" href="Default-tablatures.html#Default-tablatures">Default tablatures</a>,
Up: <a rel="up" accesskey="u" href="Common-notation-for-fretted-strings.html#Common-notation-for-fretted-strings">Common notation for fretted strings</a>
</div>
<div style="background-color: #e8ffe8; padding: 2; border: #c0ffc0 1px solid;">
<p>
<font size="-1">
This page is for LilyPond-2.11.57 (development-branch).
<br>
<address>
Report errors to <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>. </address>
<br>
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome.
</font>
</p>
</div>
<P>
Other languages: <a href="Custom-tablatures.fr.html">français</a>, <a href="Custom-tablatures.es.html">español</a>, <a href="Custom-tablatures.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
