<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- header_tag -->
<html lang="en">
<head>
<title>Bar and bar number checks - 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-numbers.html#Bar-numbers" title="Bar numbers">
<link rel="next" href="Rehearsal-marks.html#Rehearsal-marks" title="Rehearsal marks">
<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-and-bar-number-checks"></a>
Next: <a rel="next" accesskey="n" href="Rehearsal-marks.html#Rehearsal-marks">Rehearsal marks</a>,
Previous: <a rel="previous" accesskey="p" href="Bar-numbers.html#Bar-numbers">Bar numbers</a>,
Up: <a rel="up" accesskey="u" href="Bars.html#Bars">Bars</a>
<hr>
</div>
<h5 class="subsubsection">1.2.5.3 Bar and bar number checks</h5>
<p><a name="index-bar-check-668"></a><a name="index-barCheckSynchronize-669"></a><a name="index-barCheckSynchronize-670"></a>
<a name="index-g_t_007c-671"></a><a name="index-g_t_007c-672"></a>
<p>Bar checks help detect errors in the entered durations.
A bar check may be entered using the bar symbol, <code>|</code>,
at any place where a bar line is expected to fall.
If bar check lines are encountered at other places,
a list of warnings is printed in the log file,
showing the line numbers and lines
in which the bar checks failed. In the next
example, the second bar check will signal an error.
<pre class="example">\time 3/4 c2 e4 | g2 |
</pre>
<p>Bar checks can also be used in lyrics, for example
<pre class="example">\lyricmode {
\time 2/4
Twin -- kle | Twin -- kle |
}
</pre>
<p>An incorrect duration can result in a completely garbled score,
especially if the score is polyphonic, so a good place to start
correcting input is by scanning for failed bar checks and
incorrect durations.
<p>If successive bar checks are off by the same musical interval,
only the first warning message is displayed. This allows the
warning to focus on the source of the timing error.
<p><a name="index-g_t_007c-673"></a><a name="index-g_t_007c-674"></a>
<a name="index-pipeSymbol-675"></a><a name="index-pipeSymbol-676"></a>
<p>It is also possible to redefine the action taken when a bar check
or pipe symbol, <code>|</code>, is encountered in the input, so that
it does something other than a bar check. This is done by
assigning a music expression to <code>pipeSymbol</code>.
In the following example <code>|</code> is set to insert a double bar
line wherever it appears in the input, rather than checking
for end of bar.
<blockquote>
<pre class="verbatim">
pipeSymbol = \bar "||"
{
c'2 c'2 |
c'2 c'2
c'2 | c'2
c'2 c'2
}
</pre>
<p>
<a href="../f9/lily-0d833528.ly">
<img align="middle"
border="0" src="../f9/lily-0d833528.png" alt="[image of music]">
</a>
</p>
</blockquote>
<p>When copying large pieces of music, it can be helpful to check
that the LilyPond bar number corresponds to the original that you
are entering from. This can be checked with
<code>\barNumberCheck</code>, for example,
<pre class="verbatim">
\barNumberCheck #123
</pre>
<p class="noindent">will print a warning if the <code>currentBarNumber</code> is not 123
when it is processed.
<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>.
<!-- footer_tag --><br><hr>
<div class="node">
<p>
Next: <a rel="next" accesskey="n" href="Rehearsal-marks.html#Rehearsal-marks">Rehearsal marks</a>,
Previous: <a rel="previous" accesskey="p" href="Bar-numbers.html#Bar-numbers">Bar numbers</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-and-bar-number-checks.fr.html">français</a>, <a href="Bar-and-bar-number-checks.es.html">español</a>, <a href="Bar-and-bar-number-checks.de.html">deutsch</a>.
<BR>
</P>
</BODY></html>
