<!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.html#Top"> <link rel="up" href="Bars.html#Bars" title="Bars"> <link rel="prev" href="Bar-lines.html#Bar-lines" title="Bar lines"> <link rel="next" href="Bar-and-bar-number-checks.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.html#Bar-and-bar-number-checks">Bar and bar number checks</a>, Previous: <a rel="previous" accesskey="p" href="Bar-lines.html#Bar-lines">Bar lines</a>, Up: <a rel="up" accesskey="u" href="Bars.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.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.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.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.html#Bar-and-bar-number-checks">Bar and bar number checks</a>, Previous: <a rel="previous" accesskey="p" href="Bar-lines.html#Bar-lines">Bar lines</a>, Up: <a rel="up" accesskey="u" href="Bars.html#Bars">Bars</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="Bar-numbers.fr.html">français</a>, <a href="Bar-numbers.es.html">español</a>. <BR> </P> </BODY></html>