<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Ambitus - 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-pitches.de.html#Displaying-pitches" title="Displaying pitches">
<link rel="prev" href="Automatic-accidentals.de.html#Automatic-accidentals" title="Automatic accidentals">
<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="Ambitus"></a>
Previous: <a rel="previous" accesskey="p" href="Automatic-accidentals.de.html#Automatic-accidentals">Automatic accidentals</a>,
Up: <a rel="up" accesskey="u" href="Displaying-pitches.de.html#Displaying-pitches">Displaying pitches</a>
<hr>
</div>
<h5 class="unnumberedsubsubsec">Ambitus</h5>
<p><a name="index-ambitus-299"></a><a name="index-range-of-pitches-300"></a><a name="index-pitch-range-301"></a>
The term <var>ambitus</var> (pl. ambitus) denotes a range of
pitches for a given voice in a part of music. It may also denote
the pitch range that a musical instrument is capable of playing.
Ambitus are printed on vocal parts so that performers can easily
determine if it matches their capabilities.
<p>Ambitus are denoted at the beginning of a piece near the initial
clef. The range is graphically specified by two note heads that
represent the lowest and highest pitches. Accidentals are only
printed if they are not part of the key signature.
<blockquote>
<pre class="verbatim">
\layout {
\context {
\Voice
\consists "Ambitus_engraver"
}
}
\relative c'' {
aes c e2
cis,1
}
</pre>
<p>
<a href="../af/lily-d0eebfa0.ly">
<img align="middle"
border="0" src="../af/lily-d0eebfa0.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">Selected Snippets</h5>
<p><em>Adding ambitus per voice</em>
<p>Ambitus can be added per voice. In this case, the ambitus must be moved
manually to prevent collisions.
<blockquote>
<pre class="verbatim">
\new Staff <<
\new Voice \with {
\consists "Ambitus_engraver"
} \relative c'' {
\override Ambitus #'X-offset = #2.0
\voiceOne
c4 a d e
f1
}
\new Voice \with {
\consists "Ambitus_engraver"
} \relative c' {
\voiceTwo
es4 f g as
b1
}
>>
</pre>
<p>
<a href="../40/lily-e92589d3.ly">
<img align="middle"
border="0" src="../40/lily-e92589d3.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><em>Ambitus with multiple voices</em>
<p>Adding the <code>Ambitus_engraver</code> to the <code>Staff</code> context creates
a single ambitus per staff, even in the case of staves with multiple
voices.
<blockquote>
<pre class="verbatim">
\new Staff \with {
\consists "Ambitus_engraver"
}
<<
\new Voice \relative c'' {
\voiceOne
c4 a d e
f1
}
\new Voice \relative c' {
\voiceTwo
es4 f g as
b1
}
>>
</pre>
<p>
<a href="../a5/lily-e229c0f1.ly">
<img align="middle"
border="0" src="../a5/lily-e229c0f1.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
<p>Music Glossary:
<a name="index-ambitus-302"></a><a href="../music-glossary/ambitus.de.html#ambitus">ambitus</a>.
<p>Snippets:
<a href="../../../input/lsr/lilypond-snippets/Pitches.html#Pitches">Pitches</a>.
<p>Internals Reference:
<a name="index-Ambitus_005fengraver-303"></a><a href="../lilypond-internals/Ambitus_005fengraver.de.html#Ambitus_005fengraver">Ambitus_engraver</a>,
<a name="index-Voice-304"></a><a href="../lilypond-internals/Voice.de.html#Voice">Voice</a>,
<a name="index-Staff-305"></a><a href="../lilypond-internals/Staff.de.html#Staff">Staff</a>,
<a name="index-Ambitus-306"></a><a href="../lilypond-internals/Ambitus.de.html#Ambitus">Ambitus</a>,
<a name="index-AmbitusAccidental-307"></a><a href="../lilypond-internals/AmbitusAccidental.de.html#AmbitusAccidental">AmbitusAccidental</a>,
<a name="index-AmbitusLine-308"></a><a href="../lilypond-internals/AmbitusLine.de.html#AmbitusLine">AmbitusLine</a>,
<a name="index-AmbitusNoteHead-309"></a><a href="../lilypond-internals/AmbitusNoteHead.de.html#AmbitusNoteHead">AmbitusNoteHead</a>,
<a name="index-ambitus_002dinterface-310"></a><a href="../lilypond-internals/ambitus_002dinterface.de.html#ambitus_002dinterface">ambitus-interface</a>.
<p class="noindent">
<h5 class="subsubheading">Known issues and warnings</h5>
<p>There is no collision handling in the case of multiple per-voice
ambitus.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Previous: <a rel="previous" accesskey="p" href="Automatic-accidentals.de.html#Automatic-accidentals">Automatic accidentals</a>,
Up: <a rel="up" accesskey="u" href="Displaying-pitches.de.html#Displaying-pitches">Displaying pitches</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="Ambitus.fr.html">français</a>, <a href="Ambitus.es.html">español</a>.
<BR>
</P>
</BODY></html>
