<!-- 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 program-reference: 2.1.13 Lyrics</title>
<meta name="description" content="LilyPond program-reference: 2.1.13 Lyrics">
<meta name="keywords" content="LilyPond program-reference: 2.1.13 Lyrics">
<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.fr.html#Top" rel="start" title="GNU LilyPond – Internals Reference">
<link href="Indices.fr.html#Indices" rel="index" title="A. Indices">
<link href="index_toc.fr.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="index_abt.fr.html#SEC_About" rel="help" title="About This Document">
<link href="Contexts.fr.html#Contexts" rel="up" title="2.1 Contexts">
<link href="Indices.fr.html#Indices" rel="next" title="A.2 Function index">
<link href="GregorianTranscriptionVoice.fr.html#GregorianTranscriptionVoice" rel="previous" title="2.1.12 GregorianTranscriptionVoice">
<link rel="stylesheet" type="text/css" title="Patrick McCarty's design" href="lilypond-mccarty.css">
<link rel="alternate stylesheet" type="text/css" href="lilypond.css" title="Andrew Hawryluk's design">
<link rel="alternate stylesheet" type="text/css" href="lilypond-blue.css" title="Kurt Kroon's blue design">
<!--[if lte IE 7]>
<link href="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="Lyrics"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="Translation.fr.html#Translation" title="Beginning of this chapter or previous chapter"> << Translation </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.fr.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.fr.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Indices.fr.html#Indices" title="Index" rel="index">Index</a>][<a href="index_abt.fr.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Backend.fr.html#Backend" title="Next chapter"> Backend >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="GregorianTranscriptionVoice.fr.html#GregorianTranscriptionVoice" title="Previous section in reading order" accesskey="p" rel="previous"> < GregorianTranscriptionVoice </a>]</td><td valign="middle" align="center" colspan="1">[<a href="Contexts.fr.html#Contexts" title="Up section" accesskey="u" rel="up"> Up : Contexts </a>]</td><td valign="middle" align="right" colspan="2">[<a href="MensuralStaff.fr.html#MensuralStaff" title="Next section in reading order" accesskey="n" rel="next"> MensuralStaff > </a>]</td></tr></table>
<a name="Lyrics"></a>
<h3 class="subsection">2.1.13 Lyrics</h3>
<p>Corresponds to a voice with lyrics. Handles the
printing of a single line of lyrics.
</p>
<p>This context creates the following layout object(s):
</p>
<p><a href="InstrumentName.fr.html#InstrumentName">InstrumentName</a>, <a href="LyricExtender.fr.html#LyricExtender">LyricExtender</a>, <a href="LyricHyphen.fr.html#LyricHyphen">LyricHyphen</a>, <a href="LyricSpace.fr.html#LyricSpace">LyricSpace</a>, <a href="LyricText.fr.html#LyricText">LyricText</a>, <a href="StanzaNumber.fr.html#StanzaNumber">StanzaNumber</a> and <a href="VerticalAxisGroup.fr.html#VerticalAxisGroup">VerticalAxisGroup</a>.
</p>
<p>This context sets the following properties:
</p>
<ul>
<li> Set grob-property <code>bar-size</code> in <a href="BarLine.fr.html#BarLine">BarLine</a> to <code>0.1</code>.
</li><li> Set grob-property <code>font-size</code> in <a href="InstrumentName.fr.html#InstrumentName">InstrumentName</a> to <code>1.0</code>.
</li><li> Set grob-property <code>self-alignment-Y</code> in <a href="InstrumentName.fr.html#InstrumentName">InstrumentName</a> to <code>#f</code>.
</li><li> Set grob-property <code>padding</code> in <a href="SeparationItem.fr.html#SeparationItem">SeparationItem</a> to <code>0.2</code>.
</li><li> Set grob-property <code>keep-fixed-while-stretching</code> in <a href="VerticalAxisGroup.fr.html#VerticalAxisGroup">VerticalAxisGroup</a> to <code>#t</code>.
</li><li> Set grob-property <code>remove-empty</code> in <a href="VerticalAxisGroup.fr.html#VerticalAxisGroup">VerticalAxisGroup</a> to <code>#t</code>.
</li><li> Set grob-property <code>remove-first</code> in <a href="VerticalAxisGroup.fr.html#VerticalAxisGroup">VerticalAxisGroup</a> to <code>#t</code>.
</li><li> Set translator property <code>shortInstrumentName</code> to <code>'()</code>.
</li><li> Set translator property <code>instrumentName</code> to <code>'()</code>.
</li><li> Set grob-property <code>minimum-Y-extent</code> in <a href="VerticalAxisGroup.fr.html#VerticalAxisGroup">VerticalAxisGroup</a> to <code>'(-0.75 . 2.0)</code>.
</li></ul>
<p>This context is a ‘bottom’ context; it cannot contain other contexts.
</p>
<p>This context is built from the following engraver(s):
</p><blockquote><dl compact="compact">
<dt> <code><a href="Hara_005fkiri_005fengraver.fr.html#Hara_005fkiri_005fengraver">Hara_kiri_engraver</a></code></dt>
<dd><p>Like <code>Axis_group_engraver</code>, but make a hara-kiri spanner, and add interesting items (i.e., note heads, lyric syllables, and normal rests).
</p>
<p>Properties (read)
</p><blockquote><dl compact="compact">
<dt> <code>keepAliveInterfaces</code> (list)</dt>
<dd><p>A list of symbols, signifying grob
interfaces that are worth keeping a staff with <code>remove-empty</code> set
around for.
</p></dd>
</dl>
</blockquote>
<p>This engraver creates the following layout object(s):
</p>
<p><a href="VerticalAxisGroup.fr.html#VerticalAxisGroup">VerticalAxisGroup</a>.
</p>
</dd>
<dt> <code><a href="Font_005fsize_005fengraver.fr.html#Font_005fsize_005fengraver">Font_size_engraver</a></code></dt>
<dd><p>Put <code>fontSize</code> into <code>font-size</code> grob property.
</p>
<p>Properties (read)
</p><blockquote><dl compact="compact">
<dt> <code>fontSize</code> (number)</dt>
<dd><p>The relative size of all grobs in a context.
</p></dd>
</dl>
</blockquote>
</dd>
<dt> <code><a href="Skip_005fevent_005fswallow_005ftranslator.fr.html#Skip_005fevent_005fswallow_005ftranslator">Skip_event_swallow_translator</a></code></dt>
<dd><p>Swallow <code>\skip</code>.
</p>
</dd>
<dt> <code><a href="Instrument_005fname_005fengraver.fr.html#Instrument_005fname_005fengraver">Instrument_name_engraver</a></code></dt>
<dd><p>Create a system start text for instrument or vocal names.
</p>
<p>Properties (read)
</p><blockquote><dl compact="compact">
<dt> <code>currentCommandColumn</code> (layout object)</dt>
<dd><p>Grob that is X-parent to all
current breakable (clef, key signature, etc.) items.
</p></dd>
<dt> <code>shortInstrumentName</code> (markup)</dt>
<dd><p>See <code>instrument</code>.
</p></dd>
<dt> <code>instrumentName</code> (markup)</dt>
<dd><p>The name to print left of a staff. The
<code>instrument</code> property labels the staff in the first system, and
the <code>instr</code> property labels following lines.
</p></dd>
<dt> <code>shortVocalName</code> (markup)</dt>
<dd><p>Name of a vocal line, short version.
</p></dd>
<dt> <code>vocalName</code> (markup)</dt>
<dd><p>Name of a vocal line.
</p></dd>
</dl>
</blockquote>
<p>This engraver creates the following layout object(s):
</p>
<p><a href="InstrumentName.fr.html#InstrumentName">InstrumentName</a>.
</p>
</dd>
<dt> <code><a href="Stanza_005fnumber_005fengraver.fr.html#Stanza_005fnumber_005fengraver">Stanza_number_engraver</a></code></dt>
<dd><p>Engrave stanza numbers.
</p>
<p>Properties (read)
</p><blockquote><dl compact="compact">
<dt> <code>stanza</code> (markup)</dt>
<dd><p>Stanza ‘number’ to print before the start of a
verse. Use in <code>Lyrics</code> context.
</p></dd>
</dl>
</blockquote>
<p>This engraver creates the following layout object(s):
</p>
<p><a href="StanzaNumber.fr.html#StanzaNumber">StanzaNumber</a>.
</p>
</dd>
<dt> <code><a href="Hyphen_005fengraver.fr.html#Hyphen_005fengraver">Hyphen_engraver</a></code></dt>
<dd><p>Create lyric hyphens and distance constraints between words.
</p>
<p>Music types accepted:
</p>
<p><a href="hyphen_002devent.fr.html#hyphen_002devent">hyphen-event</a>
</p>
<p>This engraver creates the following layout object(s):
</p>
<p><a href="LyricHyphen.fr.html#LyricHyphen">LyricHyphen</a> and <a href="LyricSpace.fr.html#LyricSpace">LyricSpace</a>.
</p>
</dd>
<dt> <code><a href="Extender_005fengraver.fr.html#Extender_005fengraver">Extender_engraver</a></code></dt>
<dd><p>Create lyric extenders.
</p>
<p>Music types accepted:
</p>
<p><a href="extender_002devent.fr.html#extender_002devent">extender-event</a>
</p>
<p>Properties (read)
</p><blockquote><dl compact="compact">
<dt> <code>extendersOverRests</code> (boolean)</dt>
<dd><p>Whether to continue extenders as
they cross a rest.
</p></dd>
</dl>
</blockquote>
<p>This engraver creates the following layout object(s):
</p>
<p><a href="LyricExtender.fr.html#LyricExtender">LyricExtender</a>.
</p>
</dd>
<dt> <code><a href="Lyric_005fengraver.fr.html#Lyric_005fengraver">Lyric_engraver</a></code></dt>
<dd><p>Engrave text for lyrics.
</p>
<p>Music types accepted:
</p>
<p><a href="lyric_002devent.fr.html#lyric_002devent">lyric-event</a>
</p>
<p>Properties (read)
</p><blockquote><dl compact="compact">
<dt> <code>ignoreMelismata</code> (boolean)</dt>
<dd><p>Ignore melismata for this
<a name="index-Lyrics"></a>
<a href="../lilypond-internals/Lyrics.fr.html#Lyrics">Lyrics</a> line.
</p></dd>
<dt> <code>lyricMelismaAlignment</code> (direction)</dt>
<dd><p>Alignment to use for a melisma syllable.
</p></dd>
</dl>
</blockquote>
<p>This engraver creates the following layout object(s):
</p>
<p><a href="LyricText.fr.html#LyricText">LyricText</a>.
</p>
</dd>
</dl>
</blockquote>
<hr size="6">
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="Translation.fr.html#Translation" title="Beginning of this chapter or previous chapter"> << Translation </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.fr.html#Top" title="Cover (top) of document" rel="start">Top</a>][<a href="index_toc.fr.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Indices.fr.html#Indices" title="Index" rel="index">Index</a>][<a href="index_abt.fr.html#SEC_About" title="About (help)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Backend.fr.html#Backend" title="Next chapter"> Backend >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="GregorianTranscriptionVoice.fr.html#GregorianTranscriptionVoice" title="Previous section in reading order" accesskey="p" rel="previous"> < GregorianTranscriptionVoice </a>]</td><td valign="middle" align="center" colspan="1">[<a href="Contexts.fr.html#Contexts" title="Up section" accesskey="u" rel="up"> Up : Contexts </a>]</td><td valign="middle" align="right" colspan="2">[<a href="MensuralStaff.fr.html#MensuralStaff" title="Next section in reading order" accesskey="n" rel="next"> MensuralStaff > </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.fr.html"
title="Documentation Index"><< Back to Documentation Index</a></p>
<h4 class="toc_header"> <a href="index.fr.html#Top" title="Start of the manual">Internals Reference</a></h4>
<div class="contents">
<ul class="toc">
<li><a name="toc-Music-definitions-1" href="Music-definitions.fr.html#Music-definitions">1. Music definitions</a>
<ul class="toc">
<li><a name="toc-Music-expressions-1" href="Music-expressions.fr.html#Music-expressions">1.1 Music expressions</a> </li>
<li><a name="toc-Music-classes-1" href="Music-classes.fr.html#Music-classes">1.2 Music classes</a> </li>
<li><a name="toc-Music-properties-1" href="Music-properties.fr.html#Music-properties">1.3 Music properties</a> </li>
</ul>
</li>
<li class="toc_current"><a name="toc-Translation-1" href="Translation.fr.html#Translation">2. Translation</a>
<ul class="toc">
<li class="toc_current"><a name="toc-Contexts-1" href="Contexts.fr.html#Contexts">2.1 Contexts</a>
<ul class="toc">
<li><a name="toc-ChoirStaff-1" href="ChoirStaff.fr.html#ChoirStaff">2.1.1 ChoirStaff</a> </li>
<li><a name="toc-ChordNames-1" href="ChordNames.fr.html#ChordNames">2.1.2 ChordNames</a> </li>
<li><a name="toc-CueVoice-1" href="CueVoice.fr.html#CueVoice">2.1.3 CueVoice</a> </li>
<li><a name="toc-Devnull-1" href="Devnull.fr.html#Devnull">2.1.4 Devnull</a> </li>
<li><a name="toc-DrumStaff-1" href="DrumStaff.fr.html#DrumStaff">2.1.5 DrumStaff</a> </li>
<li><a name="toc-DrumVoice-1" href="DrumVoice.fr.html#DrumVoice">2.1.6 DrumVoice</a> </li>
<li><a name="toc-FiguredBass-1" href="FiguredBass.fr.html#FiguredBass">2.1.7 FiguredBass</a> </li>
<li><a name="toc-FretBoards-1" href="FretBoards.fr.html#FretBoards">2.1.8 FretBoards</a> </li>
<li><a name="toc-Global-1" href="Global.fr.html#Global">2.1.9 Global</a> </li>
<li><a name="toc-GrandStaff-1" href="GrandStaff.fr.html#GrandStaff">2.1.10 GrandStaff</a> </li>
<li><a name="toc-GregorianTranscriptionStaff-1" href="GregorianTranscriptionStaff.fr.html#GregorianTranscriptionStaff">2.1.11 GregorianTranscriptionStaff</a> </li>
<li><a name="toc-GregorianTranscriptionVoice-1" href="GregorianTranscriptionVoice.fr.html#GregorianTranscriptionVoice">2.1.12 GregorianTranscriptionVoice</a> </li>
<li class="toc_current"><a name="toc-Lyrics-1" href="Lyrics.fr.html#Lyrics">2.1.13 Lyrics</a> </li>
<li><a name="toc-MensuralStaff-1" href="MensuralStaff.fr.html#MensuralStaff">2.1.14 MensuralStaff</a> </li>
<li><a name="toc-MensuralVoice-1" href="MensuralVoice.fr.html#MensuralVoice">2.1.15 MensuralVoice</a> </li>
<li><a name="toc-NoteNames-1" href="NoteNames.fr.html#NoteNames">2.1.16 NoteNames</a> </li>
<li><a name="toc-PianoStaff-1" href="PianoStaff.fr.html#PianoStaff">2.1.17 PianoStaff</a> </li>
<li><a name="toc-RhythmicStaff-1" href="RhythmicStaff.fr.html#RhythmicStaff">2.1.18 RhythmicStaff</a> </li>
<li><a name="toc-Score-1" href="Score.fr.html#Score">2.1.19 Score</a> </li>
<li><a name="toc-Staff-1" href="Staff.fr.html#Staff">2.1.20 Staff</a> </li>
<li><a name="toc-StaffGroup-1" href="StaffGroup.fr.html#StaffGroup">2.1.21 StaffGroup</a> </li>
<li><a name="toc-TabStaff-1" href="TabStaff.fr.html#TabStaff">2.1.22 TabStaff</a> </li>
<li><a name="toc-TabVoice-1" href="TabVoice.fr.html#TabVoice">2.1.23 TabVoice</a> </li>
<li><a name="toc-VaticanaStaff-1" href="VaticanaStaff.fr.html#VaticanaStaff">2.1.24 VaticanaStaff</a> </li>
<li><a name="toc-VaticanaVoice-1" href="VaticanaVoice.fr.html#VaticanaVoice">2.1.25 VaticanaVoice</a> </li>
<li><a name="toc-Voice-1" href="Voice.fr.html#Voice">2.1.26 Voice</a> </li>
</ul>
</li>
<li><a name="toc-Engravers-and-Performers-1" href="Engravers-and-Performers.fr.html#Engravers-and-Performers">2.2 Engravers and Performers</a> </li>
<li><a name="toc-Tunable-context-properties-1" href="Tunable-context-properties.fr.html#Tunable-context-properties">2.3 Tunable context properties</a> </li>
<li><a name="toc-Internal-context-properties-1" href="Internal-context-properties.fr.html#Internal-context-properties">2.4 Internal context properties</a> </li>
</ul>
</li>
<li><a name="toc-Backend-1" href="Backend.fr.html#Backend">3. Backend</a>
<ul class="toc">
<li><a name="toc-All-layout-objects-1" href="All-layout-objects.fr.html#All-layout-objects">3.1 All layout objects</a> </li>
<li><a name="toc-Graphical-Object-Interfaces-1" href="Graphical-Object-Interfaces.fr.html#Graphical-Object-Interfaces">3.2 Graphical Object Interfaces</a> </li>
<li><a name="toc-User-backend-properties-1" href="User-backend-properties.fr.html#User-backend-properties">3.3 User backend properties</a> </li>
<li><a name="toc-Internal-backend-properties-1" href="Internal-backend-properties.fr.html#Internal-backend-properties">3.4 Internal backend properties</a> </li>
</ul>
</li>
<li><a name="toc-Scheme-functions-1" href="Scheme-functions.fr.html#Scheme-functions">4. Scheme functions</a> </li>
<li><a name="toc-Indices-1" href="Indices.fr.html#Indices">A. Indices</a>
<ul class="toc">
<li><a name="toc-Concept-index" href="Indices.fr.html#Indices">A.1 Concept index</a> </li>
<li><a name="toc-Function-index" href="Indices.fr.html#Indices">A.2 Function index</a> </li>
</ul>
</li>
</ul>
</div>
</div>
</body>
</html>
