<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Clef - 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="Displaying-pitches.html#Displaying-pitches" title="Displaying pitches">
<link rel="next" href="Key-signature.html#Key-signature" title="Key signature">
<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="Clef"></a>
Next: <a rel="next" accesskey="n" href="Key-signature.html#Key-signature">Key signature</a>,
Up: <a rel="up" accesskey="u" href="Displaying-pitches.html#Displaying-pitches">Displaying pitches</a>
<hr>
</div>
<h5 class="unnumberedsubsubsec">Clef</h5>
<p><a name="index-g_t_005cclef-113"></a><a name="index-g_t_005cclef-114"></a>
<a name="index-G-clef-115"></a><a name="index-C-clef-116"></a><a name="index-F-clef-117"></a><a name="index-treble-clef-118"></a><a name="index-violin-clef-119"></a><a name="index-alto-clef-120"></a><a name="index-tenor-clef-121"></a><a name="index-bass-clef-122"></a><a name="index-french-clef-123"></a><a name="index-soprano-clef-124"></a><a name="index-mezzosoprano-clef-125"></a><a name="index-baritone-clef-126"></a><a name="index-varbaritone-clef-127"></a><a name="index-subbass-clef-128"></a><a name="index-clef-129"></a><a name="index-ancient-clef-130"></a><a name="index-clef_002c-ancient-131"></a><a name="index-clef_002c-G-132"></a><a name="index-clef_002c-C-133"></a><a name="index-clef_002c-F-134"></a><a name="index-clef_002c-treble-135"></a><a name="index-clef_002c-violin-136"></a><a name="index-clef_002c-alto-137"></a><a name="index-clef_002c-tenor-138"></a><a name="index-clef_002c-bass-139"></a><a name="index-clef_002c-french-140"></a><a name="index-clef_002c-soprano-141"></a><a name="index-clef_002c-mezzosoprano-142"></a><a name="index-clef_002c-baritone-143"></a><a name="index-clef_002c-varbaritone-144"></a><a name="index-subbass-clef_002c-subbass-145"></a>
The clef may be altered. Middle C is shown in every example.
<blockquote>
<pre class="verbatim">
\clef treble
c2 c
\clef alto
c2 c
\clef tenor
c2 c
\clef bass
c2 c
</pre>
<p>
<a href="../86/lily-352f27aa.ly">
<img align="middle"
border="0" src="../86/lily-352f27aa.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Other clefs include:
<blockquote>
<pre class="verbatim">
\clef french
c2 c
\clef soprano
c2 c
\clef mezzosoprano
c2 c
\clef baritone
c2 c
\break
\clef varbaritone
c2 c
\clef subbass
c2 c
\clef percussion
c2 c
\clef tab
c2 c
</pre>
<p>
<a href="../e1/lily-5fe1112c.ly">
<img align="middle"
border="0" src="../e1/lily-5fe1112c.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Further supported clefs are described under <a href="Ancient-clefs.html#Ancient-clefs">Ancient clefs</a>.
<p><a name="index-transposing-clefs-146"></a><a name="index-clef_002c-transposing-147"></a><a name="index-octave-transposition-148"></a><a name="index-choral-tenor-clef-149"></a>
By adding <code>_8</code> or <code>^8</code> to the clef name, the
clef is transposed one octave down or up, respectively,
and <code>_15</code> and <code>^15</code> transpose by two octaves.
The clef name must be enclosed in quotes when it contains
underscores or digits.
<blockquote>
<pre class="verbatim">
\clef treble
c2 c
\clef "treble_8"
c2 c
\clef "bass^15"
c2 c
</pre>
<p>
<a href="../55/lily-c74e800e.ly">
<img align="middle"
border="0" src="../55/lily-c74e800e.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">Selected Snippets</h5>
<p><em>Tweaking clef properties</em>
<p>The command <code>\clef "treble_8"</code> is equivalent to setting
<code>clefGlyph</code>, <code>clefPosition</code> (which controls the vertical
position of the clef), <code>middleCPosition</code> and
<code>clefOctavation</code>. A clef is printed when any of the properties
except <code>middleCPosition</code> are changed.
<p>Note that changing the glyph, the position of the clef, or the
octavation does not in itself change the position of subsequent notes
on the staff: the position of middle C must also be specified to do
this. The positional parameters are relative to the staff center line,
positive numbers displacing upwards, counting one for each line and
space. The <code>clefOctavation</code> value would normally be set to 7, -7,
15 or -15, but other values are valid.
<p>When a clef change takes place at a line break the new clef symbol is
printed at both the end of the previous line and the beginning of the
new line by default. If the warning clef at the end of the previous
line is not required it can be suppressed by setting the <code>Staff</code>
property <code>explicitClefVisibility</code> to the value
<code>end-of-line-invisible</code>. The default behavior can be recovered
with <code>\unset Staff.explicitClefVisibility</code>.
<p>The following examples show the possibilities when setting these
properties manually. On the first line, the manual changes preserve the
standard relative positioning of clefs and notes, whereas on the second
line, they do not.
<blockquote>
<pre class="verbatim">
{
% The default treble clef
c'1
% The standard bass clef
\set Staff.clefGlyph = #"clefs.F"
\set Staff.clefPosition = #2
\set Staff.middleCPosition = #6
c'1
% The baritone clef
\set Staff.clefGlyph = #"clefs.C"
\set Staff.clefPosition = #4
\set Staff.middleCPosition = #4
c'1
% The standard choral tenor clef
\set Staff.clefGlyph = #"clefs.G"
\set Staff.clefPosition = #-2
\set Staff.clefOctavation = #-7
\set Staff.middleCPosition = #1
c'1
% A non-standard clef
\set Staff.clefPosition = #0
\set Staff.clefOctavation = #0
\set Staff.middleCPosition = #-4
c'1 \break
% The following clef changes do not preserve
% the normal relationship between notes and clefs:
\set Staff.clefGlyph = #"clefs.F"
\set Staff.clefPosition = #2
c'1
\set Staff.clefGlyph = #"clefs.G"
c'1
\set Staff.clefGlyph = #"clefs.C"
c'1
\set Staff.clefOctavation = #7
c'1
\set Staff.clefOctavation = #0
\set Staff.clefPosition = #0
c'1
% Here we go back to the normal clef:
\set Staff.middleCPosition = #0
c'1
}
</pre>
<p>
<a href="../a6/lily-e7c73989.ly">
<img align="middle"
border="0" src="../a6/lily-e7c73989.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="Ancient-clefs.html#Ancient-clefs">Ancient clefs</a>.
<p>Snippets:
<a href="../../../input/lsr/lilypond-snippets/Pitches.html#Pitches">Pitches</a>.
<p>Internals Reference:
<a name="index-Clef_005fengraver-150"></a><a href="../lilypond-internals/Clef_005fengraver.html#Clef_005fengraver">Clef_engraver</a>,
<a name="index-Clef-151"></a><a href="../lilypond-internals/Clef.html#Clef">Clef</a>,
<a name="index-OctavateEight-152"></a><a href="../lilypond-internals/OctavateEight.html#OctavateEight">OctavateEight</a>,
<a name="index-clef_002dinterface-153"></a><a href="../lilypond-internals/clef_002dinterface.html#clef_002dinterface">clef-interface</a>.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Key-signature.html#Key-signature">Key signature</a>,
Up: <a rel="up" accesskey="u" href="Displaying-pitches.html#Displaying-pitches">Displaying pitches</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="Clef.fr.html">français</a>, <a href="Clef.es.html">español</a>, <a href="Clef.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
