<!-- header_tag -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- Created on December 15, 2009 by texi2html 1.82
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>LilyPond snippets: Contexts and engravers</title>
<meta name="description" content="LilyPond snippets: Contexts and engravers">
<meta name="keywords" content="LilyPond snippets: Contexts and engravers">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.82">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="GNU LilyPond — Snippets List">
<link href="index_toc.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index_abt.html#SEC_About" rel="help" title="About This Document">
<link href="index.html#Top" rel="up" title="GNU LilyPond — Snippets List">
<link href="Templates.html#Single-staff-template-with-only-notes" rel="next" title="Vocal ensemble template">
<link href="World-music.html#World-music" rel="previous" title="World music">
<link rel="stylesheet" type="text/css" title="Patrick McCarty's design" href="../../../Documentation/user/lilypond-mccarty.css">
<link rel="alternate stylesheet" type="text/css" href="../../../Documentation/user/lilypond.css" title="Andrew Hawryluk's design">
<link rel="alternate stylesheet" type="text/css" href="../../../Documentation/user/lilypond-blue.css" title="Kurt Kroon's blue design">
<!--[if lte IE 7]>
<link href="../../../Documentation/user/lilypond-ie-fixes.css" rel="stylesheet" type="text/css">
<![endif]-->
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<div id="main">
<a name="Contexts-and-engravers"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="World-music.html#World-music" title="Beginning of this chapter or previous chapter"> << World music </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="World-music.html#Arabic-improvisation" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="index.html#Top" title="Up section" accesskey="u" rel="up"> Up : Top </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Contexts-and-engravers" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<a name="Contexts-and-engravers"></a>
<h1 class="unnumbered">Contexts and engravers</h1>
<p>These snippets illustrate the Notation Reference,
section <a href="../../../Documentation/user/lilypond/Changing-defaults.html#Changing-defaults">Changing defaults</a>.
</p>
<p>See also Learning Manual, section
<a href="../../../Documentation/user/lilypond-learning/Contexts-and-engravers.html#Contexts-and-engravers">Contexts and engravers</a>.
</p>
<a name="adding-a-figured-bass-above-or-below-the-notes.ly"></a>
<hr size="6">
<a name="Contexts-and-engravers"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Contexts-and-engravers" title="Previous section in reading order" accesskey="p" rel="previous"> < Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Contexts-and-engravers" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Adding a figured bass above or below the notes</h2>
<p>When writing a figured bass, here’s a way to specify if you want your
figures to be placed above or below the bass notes, by defining the
<code>BassFigureAlignmentPositioning #'direction</code> property (exclusively
in a <code>Staff</code> context). Choices are <code>#UP</code> (or <code>#1</code>),
<code>#CENTER</code> (or <code>#0</code>) and <code>#DOWN</code> (or <code>#-1</code>).
</p>
<p>As you can see here, this property can be changed as many times as you
wish. Use <code>\once \override</code> if you don’t want the tweak to apply
to the whole score.
</p>
<pre class="verbatim">bass = {
\clef bass
g4 b, c d
e d8 c d2
}
continuo = \figuremode {
<_>4 <6>8
\once \override Staff.BassFigureAlignmentPositioning #'direction = #CENTER
<5/>8 <_>4
\override Staff.BassFigureAlignmentPositioning #'direction = #UP
<_+>4 <6>
\set Staff.useBassFigureExtenders = ##t
\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
<4>4. <4>8 <_+>4
}
\score {
<<
\new Staff = bassStaff \bass
\context Staff = bassStaff \continuo
>>
}
</pre><p>
<a href="../df/lily-d5d755e5.ly">
<img align="middle"
border="0"
src="../df/lily-d5d755e5.png"
alt="[image of music]">
</a>
</p>
<a name="adding-an-extra-staff-at-a-line-break.ly"></a>
<hr size="6">
<a name="Contexts-and-engravers"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Contexts-and-engravers" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Contexts-and-engravers" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Adding an extra staff at a line break</h2>
<p>When adding a new staff at a line break, some extra space is
unfortunately added at the end of the line before the break (to fit in
a key signature change, which will never be printed anyway). The
workaround is to add a setting of
<code>Staff.explicitKeySignatureVisibility</code> as is shown in the example.
In versions 2.10 and earlier, a similar setting for the time signatures
is also required (see the example).
</p>
<pre class="verbatim">\score {
\new StaffGroup \relative c'' {
\new Staff
\key f \major
c1 c^"Unwanted extra space" \break
<< { c1 | c }
\new Staff {
\key f \major
\once \override Staff.TimeSignature #'stencil = ##f
c1 | c
}
>>
c1 | c^"Fixed here" \break
<< { c1 | c }
\new Staff {
\once \set Staff.explicitKeySignatureVisibility = #end-of-line-invisible
% The next line is not needed in 2.11.x or later:
\once \override Staff.TimeSignature #'break-visibility = #end-of-line-invisible
\key f \major
\once \override Staff.TimeSignature #'stencil = ##f
c1 | c
}
>>
}
}
</pre><p>
<a href="../c8/lily-8dc5e571.ly">
<img align="middle"
border="0"
src="../c8/lily-8dc5e571.png"
alt="[image of music]">
</a>
</p>
<a name="adding-an-extra-staff.ly"></a>
<hr size="6">
<a name="Contexts-and-engravers"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Contexts-and-engravers" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Next section in reading order" accesskey="n" rel="next"> Changing MIDI output to one channel per voice > </a>]</td></tr></table>
<h2 class="unnumberedsec">Adding an extra staff</h2>
<p>An extra staff can be added (possibly temporarily) after the start of a
piece.
</p>
<pre class="verbatim">\score {
<<
\new Staff \relative c'' { c1 | c | c | c | c }
\new StaffGroup \relative c'' {
\new Staff {
c1 | c <<
c1 \new Staff {
\once \override Staff.TimeSignature #'stencil = ##f
c1
}
>>
c1
}
}
>>
}
</pre><p>
<a href="../ce/lily-370ca09a.ly">
<img align="middle"
border="0"
src="../ce/lily-370ca09a.png"
alt="[image of music]">
</a>
</p>
<a name="changing-midi-output-to-one-channel-per-voice.ly"></a>
<hr size="6">
<a name="Changing-MIDI-output-to-one-channel-per-voice"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Contexts-and-engravers" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<a name="Changing-MIDI-output-to-one-channel-per-voice"></a>
<h2 class="unnumberedsec">Changing MIDI output to one channel per voice</h2>
<p>When outputting MIDI, the default behavior is for each staff to
represent one MIDI channel, with all the voices on a staff amalgamated.
This minimizes the risk of running out of MIDI channels, since there
are only 16 available per track.
</p>
<p>However, by moving the <code>Staff_performer</code> to the <code>Voice</code>
context, each voice on a staff can have its own MIDI channel, as is
demonstrated by the following example: despite being on the same staff,
two MIDI channels are created, each with a different
<code>midiInstrument</code>.
</p>
<pre class="verbatim">\score {
\new Staff <<
\new Voice \relative c''' {
\set midiInstrument = #"flute"
\voiceOne
\key g \major
\time 2/2
r2 g-"Flute" ~
g fis ~
fis4 g8 fis e2 ~
e4 d8 cis d2
}
\new Voice \relative c'' {
\set midiInstrument = #"clarinet"
\voiceTwo
b1-"Clarinet"
a2. b8 a
g2. fis8 e
fis2 r
}
>>
\layout { }
\midi {
\context {
\Staff
\remove "Staff_performer"
}
\context {
\Voice
\consists "Staff_performer"
}
\context {
\Score
tempoWholesPerMinute = #(ly:make-moment 72 2)
}
}
}
</pre><p>
<a href="../29/lily-a4aee98b.ly">
<img align="middle"
border="0"
src="../29/lily-a4aee98b.png"
alt="[image of music]">
</a>
</p>
<a name="changing-time-signatures-inside-a-polymetric-section-using--scaledurations.ly"></a>
<hr size="6">
<a name="Changing-MIDI-output-to-one-channel-per-voice"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Previous section in reading order" accesskey="p" rel="previous"> < Changing MIDI output to one channel per voice </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Changing time signatures inside a polymetric section using \scaleDurations</h2>
<p>The <code>measureLength</code> property, together with
<code>measurePosition</code>, determines when a bar line is needed. However,
when using <code>\scaleDurations</code>, the scaling of durations makes it
difficult to change time signatures. In this case,
<code>measureLength</code> should be set manually, using the
<code>ly:make-moment</code> callback. The second argument must be the same
as the second argument of <code>\scaleDurations</code>.
</p>
<pre class="verbatim">\layout {
\context {
\Score
\remove "Timing_translator"
\remove "Default_bar_line_engraver"
}
\context {
\Staff
\consists "Timing_translator"
\consists "Default_bar_line_engraver"
}
}
<<
\new Staff {
\scaleDurations #'(8 . 5) {
\time 6/8
\set Timing.measureLength = #(ly:make-moment 6 5)
b8 b b b b b
\time 2/4
\set Timing.measureLength = #(ly:make-moment 4 5)
b4 b
}
}
\new Staff {
\clef bass
\time 2/4
c2 d e f
}
>>
</pre><p>
<a href="../99/lily-190771d5.ly">
<img align="middle"
border="0"
src="../99/lily-190771d5.png"
alt="[image of music]">
</a>
</p>
<a name="chant-or-psalms-notation.ly"></a>
<hr size="6">
<a name="Changing-MIDI-output-to-one-channel-per-voice"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Chant or psalms notation</h2>
<p>This form of notation is used for the chant of the Psalms, where verses
aren’t always the same length.
</p>
<pre class="verbatim">stemOn = { \revert Staff.Stem #'transparent }
stemOff = { \override Staff.Stem #'transparent = ##t }
\score {
\new Staff \with { \remove "Time_signature_engraver" }
{
\key g \minor
\cadenzaOn
\stemOff a'\breve bes'4 g'4
\stemOn a'2 \bar "||"
\stemOff a'\breve g'4 a'4
\stemOn f'2 \bar "||"
\stemOff a'\breve^\markup { \italic flexe }
\stemOn g'2 \bar "||"
}
}
</pre><p>
<a href="../5b/lily-c5ec2b57.ly">
<img align="middle"
border="0"
src="../5b/lily-c5ec2b57.png"
alt="[image of music]">
</a>
</p>
<a name="creating-blank-staves.ly"></a>
<hr size="6">
<a name="Changing-MIDI-output-to-one-channel-per-voice"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Next section in reading order" accesskey="n" rel="next"> Engravers one-by-one > </a>]</td></tr></table>
<h2 class="unnumberedsec">Creating blank staves</h2>
<p>To create blank staves, generate empty measures then remove the
<code>Bar_number_engraver</code> from the <code>Score</code> context, and the
<code>Time_signature_engraver</code>, <code>Clef_engraver</code> and
<code>Bar_engraver</code> from the <code>Staff</code> context.
</p>
<pre class="verbatim">#(set-global-staff-size 20)
\score {
{
\repeat unfold 12 { s1 \break }
}
\layout {
indent = 0\in
\context {
\Staff
\remove "Time_signature_engraver"
\remove "Clef_engraver"
\remove "Bar_engraver"
}
\context {
\Score
\remove "Bar_number_engraver"
}
}
}
\paper {
#(set-paper-size "letter")
ragged-last-bottom = ##f
line-width = 7.5\in
left-margin = 0.5\in
bottom-margin = 0.25\in
top-margin = 0.25\in
}
</pre><p>
<a href="../d1/lily-160fd34d.ly">
<img align="middle"
border="0"
src="../d1/lily-160fd34d.png"
alt="[image of music]">
</a>
</p>
<a name="engravers-one-by-one.ly"></a>
<hr size="6">
<a name="Engravers-one_002dby_002done"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Changing-MIDI-output-to-one-channel-per-voice" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<a name="Engravers-one_002dby_002done"></a>
<h2 class="unnumberedsec">Engravers one-by-one</h2>
<p>The notation problem, creating a certain symbol, is handled by plugins.
Each plugin is called an Engraver. In this example, engravers are
switched on one by one, in the following order:
</p>
<p>- note heads
</p>
<p>- staff symbol,
</p>
<p>- clef,
</p>
<p>- stem,
</p>
<p>- beams, slurs, accents,
</p>
<p>- accidentals, bar lines, time signature, and key signature.
</p>
<p>Engravers are grouped. For example, note heads, slurs, beams etc. form
a Voice context. Engravers for key, accidental, bar, etc. form a Staff
context.
</p>
<p>You may only see the first example in this document; please download
this snippet and run it from your own computer.
</p>
<pre class="verbatim">%% sample music
topVoice = \relative c' {
\key d\major
es8([ g] a[ fis])
b4
b16[-. b-. b-. cis-.]
d4->
}
botVoice = \relative c' {
\key d\major
c8[( f] b[ a)]
es4
es16[-. es-. es-. fis-.]
b4->
}
hoom = \relative c {
\key d \major
\clef bass
g8-. r
r4
fis8-.
r8
r4
b'4->
}
pah = \relative c' {
r8 b-.
r4
r8 g8-.
r16 g-. r8
\clef treble
fis'4->
}
%
% setup for Request->Element conversion. Guru-only
%
MyStaff =\context {
\type "Engraver_group"
\name Staff
\description "Handles clefs, bar lines, keys, accidentals. It can contain
@code{Voice} contexts."
\consists "Output_property_engraver"
\consists "Font_size_engraver"
\consists "Volta_engraver"
\consists "Separating_line_group_engraver"
\consists "Dot_column_engraver"
\consists "Ottava_spanner_engraver"
\consists "Rest_collision_engraver"
\consists "Piano_pedal_engraver"
\consists "Piano_pedal_align_engraver"
\consists "Instrument_name_engraver"
\consists "Grob_pq_engraver"
\consists "Forbid_line_break_engraver"
\consists "Axis_group_engraver"
\consists "Pitch_squash_engraver"
\override VerticalAxisGroup #'minimum-Y-extent = #'(-6 . 6)
extraVerticalExtent = ##f
verticalExtent = ##f
localKeySignature = #'()
% explicitly set instrument, so we don't get
% weird effects when doing instrument names for
% piano staves
instrumentName = #'()
shortInstrumentName = #'()
\accepts "Voice"
}
MyVoice = \context {
\type "Engraver_group"
\name Voice
\description "
Corresponds to a voice on a staff. This context handles the
conversion of dynamic signs, stems, beams, super- and subscripts,
slurs, ties, and rests.
You have to instantiate this explicitly if you want to have
multiple voices on the same staff."
localKeySignature = #'()
\consists "Font_size_engraver"
% must come before all
\consists "Output_property_engraver"
\consists "Arpeggio_engraver"
\consists "Multi_measure_rest_engraver"
\consists "Text_spanner_engraver"
\consists "Grob_pq_engraver"
\consists "Note_head_line_engraver"
\consists "Glissando_engraver"
\consists "Ligature_bracket_engraver"
\consists "Breathing_sign_engraver"
% \consists "Rest_engraver"
\consists "Grace_beam_engraver"
\consists "New_fingering_engraver"
\consists "Chord_tremolo_engraver"
\consists "Percent_repeat_engraver"
\consists "Slash_repeat_engraver"
%{
Must come before text_engraver, but after note_column engraver.
%}
\consists "Text_engraver"
\consists "Dynamic_engraver"
\consists "Fingering_engraver"
\consists "Script_column_engraver"
\consists "Rhythmic_column_engraver"
\consists "Cluster_spanner_engraver"
\consists "Tie_engraver"
\consists "Tie_engraver"
\consists "Tuplet_engraver"
\consists "Note_heads_engraver"
\consists "Rest_engraver"
\consists "Skip_event_swallow_translator"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyStaff = \context {
\MyStaff
\consists "Staff_symbol_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyStaff = \context {
\MyStaff
\consists "Clef_engraver"
\remove "Pitch_squash_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyVoice = \context {
\MyVoice
\consists "Stem_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyVoice = \context {
\MyVoice
\consists "Beam_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyVoice= \context {
\MyVoice
\consists "Phrasing_slur_engraver"
\consists "Slur_engraver"
\consists "Script_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyStaff = \context {
\MyStaff
\consists "Bar_engraver"
\consists "Time_signature_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
MyStaff = \context {
\MyStaff
\consists "Accidental_engraver"
\consists "Key_engraver"
}
\score {
\topVoice
\layout {
\context { \MyStaff }
\context { \MyVoice }
}
}
</pre><p>
<a href="../aa/lily-5726d932.ly">
<img align="middle"
border="0"
src="../aa/lily-5726d932.png"
alt="[image of music]">
</a>
</p>
<a name="mensurstriche-layout-bar-lines-between-the-staves.ly"></a>
<hr size="6">
<a name="Engravers-one_002dby_002done"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Previous section in reading order" accesskey="p" rel="previous"> < Engravers one-by-one </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Mensurstriche layout (bar lines between the staves)</h2>
<p>The mensurstriche-layout where the bar lines do not show on the staves
but between staves can be achieved with a <code>StaffGroup</code> instead of
a <code>ChoirStaff</code>. The bar line on staves is blanked out by setting
the <code>transparent</code> property.
</p>
<pre class="verbatim">global = {
\override Staff.BarLine #'transparent = ##t
s1 s
% the final bar line is not interrupted
\revert Staff.BarLine #'transparent
\bar "|."
}
\new StaffGroup \relative c'' {
<<
\new Staff { << \global { c1 c } >> }
\new Staff { << \global { c c } >> }
>>
}
</pre><p>
<a href="../2b/lily-269072f3.ly">
<img align="middle"
border="0"
src="../2b/lily-269072f3.png"
alt="[image of music]">
</a>
</p>
<a name="nesting-staves.ly"></a>
<hr size="6">
<a name="Engravers-one_002dby_002done"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Nesting staves</h2>
<p>The property <code>systemStartDelimiterHierarchy</code> can be used to make
more complex nested staff groups. The command <code>\set
StaffGroup.systemStartDelimiterHierarchy</code> takes an alphabetical list of
the number of staves produced. Before each staff a system start
delimiter can be given. It has to be enclosed in brackets and takes as
much staves as the brackets enclose. Elements in the list can be
omitted, but the first bracket takes always the complete number of
staves. The possibilities are <code>SystemStartBar</code>,
<code>SystemStartBracket</code>, <code>SystemStartBrace</code>, and
<code>SystemStartSquare</code>.
</p>
<pre class="verbatim">\new StaffGroup
\relative c'' <<
\set StaffGroup.systemStartDelimiterHierarchy
= #'(SystemStartSquare (SystemStartBrace (SystemStartBracket a
(SystemStartSquare b) ) c ) d)
\new Staff { c1 }
\new Staff { c1 }
\new Staff { c1 }
\new Staff { c1 }
\new Staff { c1 }
>>
</pre><p>
<a href="../bb/lily-f30de31d.ly">
<img align="middle"
border="0"
src="../bb/lily-f30de31d.png"
alt="[image of music]">
</a>
</p>
<a name="removing-bar-numbers-from-a-score.ly"></a>
<hr size="6">
<a name="Engravers-one_002dby_002done"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Removing bar numbers from a score</h2>
<p>Bar numbers can be removed entirely by removing the
<code>Bar_number_engraver</code> from the <code>Score</code> context.
</p>
<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="../97/lily-3a4951f3.ly">
<img align="middle"
border="0"
src="../97/lily-3a4951f3.png"
alt="[image of music]">
</a>
</p>
<a name="use-square-bracket-at-the-start-of-a-staff-group.ly"></a>
<hr size="6">
<a name="Engravers-one_002dby_002done"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Next section in reading order" accesskey="n" rel="next"> > </a>]</td></tr></table>
<h2 class="unnumberedsec">Use square bracket at the start of a staff group</h2>
<p>The system start delimiter <code>SystemStartSquare</code> can be used by
setting it explicitly in a <code>StaffGroup</code> or <code>ChoirStaffGroup</code>
context.
</p>
<pre class="verbatim">\score {
\new StaffGroup { <<
\set StaffGroup.systemStartDelimiter = #'SystemStartSquare
\new Staff { c'4 d' e' f' }
\new Staff { c'4 d' e' f' }
>> }
}
</pre><p>
<a href="../bc/lily-1e783df1.ly">
<img align="middle"
border="0"
src="../bc/lily-1e783df1.png"
alt="[image of music]">
</a>
</p>
<a name="vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves.ly"></a>
<hr size="6">
<a name="Engravers-one_002dby_002done"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next section in reading order" accesskey="n" rel="next"> Tweaks and overrides > </a>]</td></tr></table>
<h2 class="unnumberedsec">Vocal ensemble template with lyrics aligned below and above the staves</h2>
<p>This template is basically the same as the simple "Vocal ensemble"
template, with the exception that here all the lyrics lines are placed
using <code>alignAboveContext</code> and <code>alignBelowContext</code>.
</p>
<pre class="verbatim">global = {
\key c \major
\time 4/4
}
sopMusic = \relative c'' {
c4 c c8[( b)] c4
}
sopWords = \lyricmode {
hi hi hi hi
}
altoMusic = \relative c' {
e4 f d e
}
altoWords = \lyricmode {
ha ha ha ha
}
tenorMusic = \relative c' {
g4 a f g
}
tenorWords = \lyricmode {
hu hu hu hu
}
bassMusic = \relative c {
c4 c g c
}
bassWords = \lyricmode {
ho ho ho ho
}
\score {
\new ChoirStaff <<
\new Staff = women <<
\new Voice = "sopranos" { \voiceOne << \global \sopMusic >> }
\new Voice = "altos" { \voiceTwo << \global \altoMusic >> }
>>
\new Lyrics \with { alignAboveContext = women } \lyricsto sopranos \sopWords
\new Lyrics \with { alignBelowContext = women } \lyricsto altos \altoWords
% we could remove the line about this with the line below, since we want
% the alto lyrics to be below the alto Voice anyway.
% \new Lyrics \lyricsto altos \altoWords
\new Staff = men <<
\clef bass
\new Voice = "tenors" { \voiceOne << \global \tenorMusic >> }
\new Voice = "basses" { \voiceTwo << \global \bassMusic >> }
>>
\new Lyrics \with { alignAboveContext = men } \lyricsto tenors \tenorWords
\new Lyrics \with { alignBelowContext = men } \lyricsto basses \bassWords
% again, we could replace the line above this with the line below.
% \new Lyrics \lyricsto basses \bassWords
>>
\layout {
\context {
% a little smaller so lyrics
% can be closer to the staff
\Staff
\override VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 3)
}
}
}
</pre><p>
<a href="../45/lily-b608b16a.ly">
<img align="middle"
border="0"
src="../45/lily-b608b16a.png"
alt="[image of music]">
</a>
</p>
<hr size="6">
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="#Contexts-and-engravers" title="Beginning of this chapter or previous chapter"> << Contexts and engravers </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][Index][<a href="index_abt.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next chapter"> Tweaks and overrides >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="#Engravers-one_002dby_002done" title="Previous section in reading order" accesskey="p" rel="previous"> < </a>]</td><td valign="middle" align="center" colspan="1">[<a href="#Contexts-and-engravers" title="Up section" accesskey="u" rel="up"> Up : Contexts and engravers </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Tweaks-and-overrides.html#Tweaks-and-overrides" title="Next section in reading order" accesskey="n" rel="next"> Tweaks and overrides > </a>]</td></tr></table>
<!-- footer_tag -->
<div class="footer">
<p class="footer_version">
This page is for LilyPond-2.12.3 (stable-branch).
</p>
<p class="footer_report">
Your <a href="http://lilypond.org/web/devel/participating/documentation-adding">suggestions for the documentation</a> are welcome, please report errors to our <a href="http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs">bug list</a>.
</p>
</div>
<!-- FOOTER -->
<!-- end div#main here -->
</div>
<div id="tocframe">
<p class="toc_uplink"><a href="../index.html"
title="Documentation Index"><< Back to Documentation Index</a></p>
<h4 class="toc_header"> <a href="index.html#Top" title="Start of the manual">Snippets List</a></h4>
<div class="contents">
<ul class="toc">
<li><a name="toc-Pitches-1" href="Pitches.html#Pitches">Pitches</a> </li>
<li><a name="toc-Rhythms-1" href="Rhythms.html#Rhythms">Rhythms</a> </li>
<li><a name="toc-Expressive-marks-1" href="Expressive-marks.html#Expressive-marks">Expressive marks</a> </li>
<li><a name="toc-Repeats-1" href="Repeats.html#Repeats">Repeats</a> </li>
<li><a name="toc-Simultaneous-notes-1" href="Simultaneous-notes.html#Simultaneous-notes">Simultaneous notes</a> </li>
<li><a name="toc-Staff-notation-1" href="Staff-notation.html#Staff-notation">Staff notation</a> </li>
<li><a name="toc-Editorial-annotations-1" href="Editorial-annotations.html#Editorial-annotations">Editorial annotations</a> </li>
<li><a name="toc-Text-1" href="Text.html#Text">Text</a> </li>
<li><a name="toc-Vocal-music-1" href="Vocal-music.html#Vocal-music">Vocal music</a> </li>
<li><a name="toc-Chords-1" href="Chords.html#Chords">Chords</a> </li>
<li><a name="toc-Keyboards-1" href="Keyboards.html#Keyboards">Keyboards</a> </li>
<li><a name="toc-Percussion-1" href="Percussion.html#Percussion">Percussion</a> </li>
<li><a name="toc-Fretted-strings-1" href="Fretted-strings.html#Fretted-strings">Fretted strings</a> </li>
<li><a name="toc-Unfretted-strings-1" href="Unfretted-strings.html#Unfretted-strings">Unfretted strings</a> </li>
<li><a name="toc-Winds-1" href="Winds.html#Winds">Winds</a> </li>
<li><a name="toc-Ancient-notation-1" href="Ancient-notation.html#Ancient-notation">Ancient notation</a> </li>
<li><a name="toc-World-music-1" href="World-music.html#World-music">World music</a> </li>
<li class="toc_current"><a name="toc-Contexts-and-engravers-1" href="Contexts-and-engravers.html#Contexts-and-engravers">Contexts and engravers</a>
<ul class="toc">
<li class="toc_current"><a name="toc-Adding-a-figured-bass-above-or-below-the-notes-1" href="Contexts-and-engravers.html#Contexts-and-engravers">Adding a figured bass above or below the notes</a> </li>
<li class="toc_current"><a name="toc-Adding-an-extra-staff-at-a-line-break-2" href="Contexts-and-engravers.html#Contexts-and-engravers">Adding an extra staff at a line break</a> </li>
<li class="toc_current"><a name="toc-Adding-an-extra-staff-1" href="Contexts-and-engravers.html#Contexts-and-engravers">Adding an extra staff</a> </li>
<li><a name="toc-Changing-MIDI-output-to-one-channel-per-voice-2" href="Contexts-and-engravers.html#Changing-MIDI-output-to-one-channel-per-voice">Changing MIDI output to one channel per voice</a> </li>
<li><a name="toc-Changing-time-signatures-inside-a-polymetric-section-using-_005cscaleDurations-2" href="Contexts-and-engravers.html#Changing-MIDI-output-to-one-channel-per-voice">Changing time signatures inside a polymetric section using \scaleDurations</a> </li>
<li><a name="toc-Chant-or-psalms-notation-2" href="Contexts-and-engravers.html#Changing-MIDI-output-to-one-channel-per-voice">Chant or psalms notation</a> </li>
<li><a name="toc-Creating-blank-staves-1" href="Contexts-and-engravers.html#Changing-MIDI-output-to-one-channel-per-voice">Creating blank staves</a> </li>
<li><a name="toc-Engravers-one_002dby_002done-1" href="Contexts-and-engravers.html#Engravers-one_002dby_002done">Engravers one-by-one</a> </li>
<li><a name="toc-Mensurstriche-layout-_0028bar-lines-between-the-staves_0029-4" href="Contexts-and-engravers.html#Engravers-one_002dby_002done">Mensurstriche layout (bar lines between the staves)</a> </li>
<li><a name="toc-Nesting-staves-2" href="Contexts-and-engravers.html#Engravers-one_002dby_002done">Nesting staves</a> </li>
<li><a name="toc-Removing-bar-numbers-from-a-score-1" href="Contexts-and-engravers.html#Engravers-one_002dby_002done">Removing bar numbers from a score</a> </li>
<li><a name="toc-Use-square-bracket-at-the-start-of-a-staff-group-1" href="Contexts-and-engravers.html#Engravers-one_002dby_002done">Use square bracket at the start of a staff group</a> </li>
<li><a name="toc-Vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves-2" href="Contexts-and-engravers.html#Engravers-one_002dby_002done">Vocal ensemble template with lyrics aligned below and above the staves</a> </li>
</ul>
</li>
<li><a name="toc-Tweaks-and-overrides-1" href="Tweaks-and-overrides.html#Tweaks-and-overrides">Tweaks and overrides</a> </li>
<li><a name="toc-Paper-and-layout-1" href="Paper-and-layout.html#Paper-and-layout">Paper and layout</a> </li>
<li><a name="toc-Titles-1" href="Titles.html#Titles">Titles</a> </li>
<li><a name="toc-Spacing-1" href="Spacing.html#Spacing">Spacing</a> </li>
<li><a name="toc-MIDI-1" href="MIDI.html#MIDI">MIDI</a> </li>
<li><a name="toc-Templates-1" href="Templates.html#Templates">Templates</a> </li>
</ul>
</div>
</div>
</body>
</html>
