<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Bar numbers - 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="Bars.de.html#Bars" title="Bars">
<link rel="prev" href="Bar-lines.de.html#Bar-lines" title="Bar lines">
<link rel="next" href="Bar-and-bar-number-checks.de.html#Bar-and-bar-number-checks" title="Bar and bar number checks">
<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="Bar-numbers"></a>
Next: <a rel="next" accesskey="n" href="Bar-and-bar-number-checks.de.html#Bar-and-bar-number-checks">Bar and bar number checks</a>,
Previous: <a rel="previous" accesskey="p" href="Bar-lines.de.html#Bar-lines">Bar lines</a>,
Up: <a rel="up" accesskey="u" href="Bars.de.html#Bars">Bars</a>
<hr>
</div>
<h5 class="subsubsection">1.2.5.2 Bar numbers</h5>
<p><a name="index-bar-numbers-655"></a><a name="index-measure-numbers-656"></a><a name="index-currentBarNumber-657"></a><a name="index-currentBarNumber-658"></a>
<p>Bar numbers are typeset by default at the start of every line except
the first line. The number itself is stored in the
<code>currentBarNumber</code> property, which is normally updated
automatically for every measure. It may also be set manually:
<blockquote>
<pre class="verbatim">
c1 c c c
\break
\set Score.currentBarNumber = #50
c1 c c c
</pre>
<p>
<a href="../5f/lily-6442364d.ly">
<img align="middle"
border="0" src="../5f/lily-6442364d.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">Selected Snippets</h5>
<p><a name="index-barNumberVisibility-659"></a><a name="index-barNumberVisibility-660"></a>
<a name="index-bar-numbers_002c-regular-spacing-661"></a>
Bar numbers can be typeset at regular intervals instead of just at
the beginning of every line. To do this the default behavior
must be overridden to permit bar numbers to be printed at places
other than the start of a line. This is controlled by the
<code>break-visibility</code> property of <code>BarNumber</code>. This takes
three values which may be set to <code>#t</code> or <code>#f</code> to specify
whether the corresponding bar number is visible or not. The order
of the three values is <code>end of line visible</code>, <code>middle of
line visible</code>, <code>beginning of line visible</code>. In the following
example bar numbers are printed at all possible places:
<blockquote>
<pre class="verbatim">
\override Score.BarNumber #'break-visibility = #'#(#t #t #t)
\set Score.currentBarNumber = #11
\bar "" % Permit first bar number to be printed
c1 c c c
\break
c c c c
</pre>
<p>
<a href="../50/lily-2fdff7d8.ly">
<img align="middle"
border="0" src="../50/lily-2fdff7d8.png" alt="[image of music]">
</a>
</p>
</blockquote>
<!-- All the rest of these examples will be added to LSR -->
<!-- and moved into the Snippets. -gp -->
<p class="noindent">and here the bar numbers are printed every two measures
except at the end of the line:
<blockquote>
<pre class="verbatim">
\override Score.BarNumber #'break-visibility = #'#(#f #t #t)
\set Score.currentBarNumber = #11
\bar "" % Permit first bar number to be printed
% Print a bar number every second measure
\set Score.barNumberVisibility = #(every-nth-bar-number-visible 2)
c1 c c c c
\break
c c c c c
</pre>
<p>
<a href="../9e/lily-68cacd2a.ly">
<img align="middle"
border="0" src="../9e/lily-68cacd2a.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><a name="index-measure-number_002c-format-662"></a><a name="index-bar-number_002c-format-663"></a>
The size of the bar number may be changed. This is illustrated
in the following example, which also shows how to enclose bar
numbers in boxes and circles, and shows an alternative way
of specifying <code>#(#f #t #t)</code> for <code>break-visibility</code>.
<blockquote>
<pre class="verbatim">
% Prevent bar numbers at the end of a line and permit them elsewhere
\override Score.BarNumber #'break-visibility
= #end-of-line-invisible
% Increase the size of the bar number by 2
\override Score.BarNumber #'font-size = #2
\repeat unfold 3 { c1 } \bar "|"
% Draw a box round the following bar number(s)
\override Score.BarNumber #'stencil
= #(make-stencil-boxer 0.1 0.25 ly:text-interface::print)
\repeat unfold 3 { c1 } \bar "|"
% Draw a circle round the following bar number(s)
\override Score.BarNumber #'stencil
= #(make-stencil-circler 0.1 0.25 ly:text-interface::print)
\repeat unfold 4 { c1 } \bar "|."
</pre>
<p>
<a href="../0e/lily-0c7bf867.ly">
<img align="middle"
border="0" src="../0e/lily-0c7bf867.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p><a name="index-bar-number-alignment-664"></a>
Bar numbers by default are left-aligned to their parent object.
This is usually the left edge of a line or, if numbers are printed
within a line, the left bar line of the measure. The numbers may also
be positioned directly on the bar line or right-aligned to the
bar line:
<blockquote>
<pre class="verbatim">
\set Score.currentBarNumber = #111
\override Score.BarNumber #'break-visibility = #'#(#t #t #t)
% Increase the size of the bar number by 2
\override Score.BarNumber #'font-size = #2
% Print a bar number every second measure
\set Score.barNumberVisibility = #(every-nth-bar-number-visible 2)
c1 c1
% Center-align bar numbers
\override Score.BarNumber #'self-alignment-X = #0
c1 c1
% Right-align bar numbers
\override Score.BarNumber #'self-alignment-X = #-1
c1 c1
</pre>
<p>
<a href="../dd/lily-84d6895d.ly">
<img align="middle"
border="0" src="../dd/lily-84d6895d.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>Bar numbers can be removed entirely by removing the
<code>Bar_number_engraver</code> from the <code>Score</code> context.
<blockquote>
<pre class="verbatim">
\layout {
\context {
\Score
\remove "Bar_number_engraver"
}
}
\relative c''{
c4 c c c \break
c4 c c c
}
</pre>
<p>
<a href="../79/lily-79b094e2.ly">
<img align="middle"
border="0" src="../79/lily-79b094e2.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p class="noindent">
<h5 class="subsubheading">See also</h5>
<p class="indent">
<p>Snippets:
<a href="../../../input/lsr/lilypond-snippets/Rhythms.html#Rhythms">Rhythms</a>.
<p>Internals Reference: <a name="index-BarNumber-665"></a><a href="../lilypond-internals/BarNumber.de.html#BarNumber">BarNumber</a>.
<p class="noindent">
<h5 class="subsubheading">Known issues and warnings</h5>
<p>Bar numbers may collide with the top of the
<a name="index-StaffGroup-666"></a><a href="../lilypond-internals/StaffGroup.de.html#StaffGroup">StaffGroup</a> bracket, if there is one. To solve
this, the <code>padding</code> property of <a name="index-BarNumber-667"></a><a href="../lilypond-internals/BarNumber.de.html#BarNumber">BarNumber</a> can
be used to position the number correctly.
<p>Bar numbers may only be printed at bar lines; to print a bar
number at the beginning of a piece, an empty bar line must be
inserted there, and a value other than <code>1</code> must be placed
in <code>currentBarNumber</code>:
<blockquote>
<pre class="verbatim">
\set Score.currentBarNumber = #50
\bar ""
c1 c c c
c1 c c c
\break
</pre>
<p>
<a href="../6c/lily-59ec6afe.ly">
<img align="middle"
border="0" src="../6c/lily-59ec6afe.png" alt="[image of music]">
</a>
</p>
</blockquote>
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Bar-and-bar-number-checks.de.html#Bar-and-bar-number-checks">Bar and bar number checks</a>,
Previous: <a rel="previous" accesskey="p" href="Bar-lines.de.html#Bar-lines">Bar lines</a>,
Up: <a rel="up" accesskey="u" href="Bars.de.html#Bars">Bars</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="Bar-numbers.fr.html">français</a>, <a href="Bar-numbers.es.html">español</a>.
<BR>
</P>
</BODY></html>
