<!-- header_tag -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- Copyright C 1999-2009 por los autores
La traducción de la siguiente nota de copyright se ofrece como
cortesía para las personas de habla no inglesa, pero únicamente la
nota en inglés tiene validez legal.
The translation of the following copyright notice is provided
for courtesy to non-English speakers, but only the notice in English
legally counts.
Se otorga permiso para copiar, distribuir y/o modificar este documento
bajo los términos de la Licencia de Documentación Libre de GNU, versión 1.1
o cualquier versión posterior publicada por la Free Software Foundation;
sin ninguna de las secciones invariantes.
Se incluye una copia de esta licencia dentro de la sección titulada "Licencia
de Documentación Libre de GNU".
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".
-->
<!-- Created on el 15 diciembre 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>Referencia de la notación de GNU LilyPond: B.8.2 Align</title>
<meta name="description" content="Referencia de la notación de GNU LilyPond: B.8.2 Align">
<meta name="keywords" content="Referencia de la notación de GNU LilyPond: B.8.2 Align">
<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.es.html#index" rel="start" title="GNU LilyPond: Manual de referencia de la notación">
<link href="LilyPond-command-index.es.html#LilyPond-command-index" rel="index" title="E. LilyPond command index">
<link href="index_toc.es.html#SEC_Contents" rel="contents" title="Índice General">
<link href="index_abt.es.html#SEC_About" rel="help" title="Acerca de este documento">
<link href="Text-markup-commands.es.html#Text-markup-commands" rel="up" title="B.8 Text markup commands">
<link href="LilyPond-index.es.html#LilyPond-index" rel="next" title="F. LilyPond index">
<link href="Font.es.html#Font" rel="previous" title="B.8.1 Font">
<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="es" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<div id="main">
<a name="Align"></a>
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="Notation-manual-tables.es.html#Notation-manual-tables" title="Inicio de este capítulo o capítulo anterior"> << Notation manual tables </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#index" title="Portada del documento" rel="start">Arriba</a>][<a href="index_toc.es.html#SEC_Contents" title="Índice general" rel="contents">Índice general</a>][<a href="LilyPond-command-index.es.html#LilyPond-command-index" title="Índice" rel="index">Índice</a>][<a href="index_abt.es.html#SEC_About" title="Acerca de (página de ayuda)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Cheat-sheet.es.html#Cheat-sheet" title="Capítulo siguiente"> Cheat sheet >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="Font.es.html#Font" title="Sección anterior en orden de lectura" accesskey="p" rel="previous"> < Font </a>]</td><td valign="middle" align="center" colspan="1">[<a href="Text-markup-commands.es.html#Text-markup-commands" title="Subir sección" accesskey="u" rel="up"> Subir : Text markup commands </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Graphic.es.html#Graphic" title="Sección siguiente en orden de lectura" accesskey="n" rel="next"> Graphic > </a>]</td></tr></table>
<a name="Align"></a>
<h3 class="appendixsubsec">B.8.2 Align</h3>
<dl compact="compact">
<dt> <code>\center-align</code> <var>arg</var> (markup)</dt>
<dd><a name="index-_005ccenter_002dalign-2"></a>
<a name="index-_005ccenter_002dalign-3"></a>
<a name="index-_005ccenter_002dalign-4"></a>
<a name="index-horizontally-centering-text"></a>
<p>Align <code>arg</code> to its X center.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
one
\center-align
two
three
}
}
</pre><p>
<a href="../40/lily-60089ebd.ly">
<img align="middle"
border="0"
src="../40/lily-60089ebd.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\center-column</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005ccenter_002dcolumn-2"></a>
<a name="index-_005ccenter_002dcolumn-3"></a>
<a name="index-_005ccenter_002dcolumn-4"></a>
<a name="index-centering-a-column-of-text"></a>
<p>Put <code>args</code> in a centered column.
</p>
<blockquote><pre class="verbatim">\markup {
\center-column {
one
two
three
}
}
</pre><p>
<a href="../9d/lily-1df6cd9f.ly">
<img align="middle"
border="0"
src="../9d/lily-1df6cd9f.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\column</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005ccolumn-2"></a>
<a name="index-_005ccolumn-3"></a>
<a name="index-_005ccolumn-4"></a>
<a name="index-stacking-text-in-a-column"></a>
<p>Stack the markups in <var>args</var> vertically. The property
<code>baseline-skip</code> determines the space between markups
in <var>args</var>.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
one
two
three
}
}
</pre><p>
<a href="../20/lily-5ed7c4fb.ly">
<img align="middle"
border="0"
src="../20/lily-5ed7c4fb.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\combine</code> <var>arg1</var> (markup) <var>arg2</var> (markup)</dt>
<dd><a name="index-_005ccombine-2"></a>
<a name="index-_005ccombine-3"></a>
<a name="index-_005ccombine-4"></a>
<a name="index-merging-text"></a>
<p>Print two markups on top of each other.
</p>
<p>Note: <code>\combine</code> cannot take a list of markups enclosed in
curly braces as an argument; the follow example will not compile:
</p>
<blockquote><pre class="example">\combine { a list }
</pre></blockquote>
<blockquote><pre class="verbatim">\markup {
\fontsize #5
\override #'(thickness . 2)
\combine
\draw-line #'(0 . 4)
\arrow-head #Y #DOWN ##f
}
</pre><p>
<a href="../11/lily-e13ed5c7.ly">
<img align="middle"
border="0"
src="../11/lily-e13ed5c7.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\concat</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cconcat"></a>
<a name="index-_005cconcat-1"></a>
<a name="index-_005cconcat-2"></a>
<a name="index-concatenating-text"></a>
<a name="index-ligatures-in-text"></a>
<p>Concatenate <var>args</var> in a horizontal line, without spaces in between.
Strings and simple markups are concatenated on the input level, allowing
ligatures. For example, <code>\concat { "f" \simple #"i" }</code> is
equivalent to <code>"fi"</code>.
</p>
<blockquote><pre class="verbatim">\markup {
\concat {
one
two
three
}
}
</pre><p>
<a href="../2a/lily-26e5d61e.ly">
<img align="middle"
border="0"
src="../2a/lily-26e5d61e.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\dir-column</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cdir_002dcolumn"></a>
<a name="index-_005cdir_002dcolumn-1"></a>
<a name="index-_005cdir_002dcolumn-2"></a>
<a name="index-changing-direction-of-text-columns"></a>
<p>Make a column of <var>args</var>, going up or down, depending on the
setting of the <code>direction</code> layout property.
</p>
<blockquote><pre class="verbatim">\markup {
\override #`(direction . ,UP) {
\dir-column {
going up
}
}
\hspace #1
\dir-column {
going down
}
\hspace #1
\override #'(direction . 1) {
\dir-column {
going up
}
}
}
</pre><p>
<a href="../52/lily-87293db5.ly">
<img align="middle"
border="0"
src="../52/lily-87293db5.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>baseline-skip</code>
</li><li> <code>direction</code>
</li></ul>
</dd>
<dt> <code>\fill-line</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cfill_002dline-2"></a>
<a name="index-_005cfill_002dline-3"></a>
<a name="index-_005cfill_002dline-4"></a>
<p>Put <var>markups</var> in a horizontal line of width <var>line-width</var>.
The markups are spaced or flushed to fill the entire line.
If there are no arguments, return an empty stencil.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
\fill-line {
Words evenly spaced across the page
}
\null
\fill-line {
\line { Text markups }
\line {
\italic { evenly spaced }
}
\line { across the page }
}
}
}
</pre><p>
<a href="../32/lily-a5ce0a94.ly">
<img align="middle"
border="0"
src="../32/lily-a5ce0a94.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>line-width</code> (#f)
</li><li> <code>word-space</code> (1)
</li><li> <code>text-direction</code> (1)
</li></ul>
</dd>
<dt> <code>\general-align</code> <var>axis</var> (integer) <var>dir</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005cgeneral_002dalign-2"></a>
<a name="index-_005cgeneral_002dalign-3"></a>
<a name="index-_005cgeneral_002dalign-4"></a>
<a name="index-controlling-general-text-alignment"></a>
<p>Align <var>arg</var> in <var>axis</var> direction to the <var>dir</var> side.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
one
\general-align #X #LEFT
two
three
\null
one
\general-align #X #CENTER
two
three
\null
\line {
one
\general-align #Y #UP
two
three
}
\null
\line {
one
\general-align #Y #3.2
two
three
}
}
}
</pre><p>
<a href="../2a/lily-f5a5a364.ly">
<img align="middle"
border="0"
src="../2a/lily-f5a5a364.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\halign</code> <var>dir</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005chalign-2"></a>
<a name="index-_005chalign-3"></a>
<a name="index-_005chalign-4"></a>
<a name="index-setting-horizontal-text-alignment"></a>
<p>Set horizontal alignment. If <var>dir</var> is <code>-1</code>, then it is
left-aligned, while <code>+1</code> is right. Values in between interpolate
alignment accordingly.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
one
\halign #LEFT
two
three
\null
one
\halign #CENTER
two
three
\null
one
\halign #RIGHT
two
three
\null
one
\halign #-5
two
three
}
}
</pre><p>
<a href="../d5/lily-70a621ec.ly">
<img align="middle"
border="0"
src="../d5/lily-70a621ec.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\hcenter-in</code> <var>length</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005chcenter_002din"></a>
<a name="index-_005chcenter_002din-1"></a>
<a name="index-_005chcenter_002din-2"></a>
<p>Center <var>arg</var> horizontally within a box of extending
<var>length</var>/2 to the left and right.
</p>
<blockquote><pre class="verbatim">\new StaffGroup <<
\new Staff {
\set Staff.instrumentName = \markup {
\hcenter-in #12
Oboe
}
c''1
}
\new Staff {
\set Staff.instrumentName = \markup {
\hcenter-in #12
Bassoon
}
\clef tenor
c'1
}
>>
</pre><p>
<a href="../91/lily-6ec351e5.ly">
<img align="middle"
border="0"
src="../91/lily-6ec351e5.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\hspace</code> <var>amount</var> (number)</dt>
<dd><a name="index-_005chspace"></a>
<a name="index-_005chspace-1"></a>
<a name="index-_005chspace-2"></a>
<a name="index-creating-horizontal-spaces-in-text"></a>
<p>Create an invisible object taking up horizontal space <var>amount</var>.
</p>
<blockquote><pre class="verbatim">\markup {
one
\hspace #2
two
\hspace #8
three
}
</pre><p>
<a href="../8c/lily-8fe60290.ly">
<img align="middle"
border="0"
src="../8c/lily-8fe60290.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\justify-field</code> <var>symbol</var> (symbol)</dt>
<dd><a name="index-_005cjustify_002dfield"></a>
<a name="index-_005cjustify_002dfield-1"></a>
<a name="index-_005cjustify_002dfield-2"></a>
<p>Justify the data which has been assigned to <var>symbol</var>.
</p>
<blockquote><pre class="verbatim">\header {
title = "My title"
description = "Lorem ipsum dolor sit amet, consectetur adipisicing
elit, sed do eiusmod tempor incididunt ut labore et dolore magna
aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat."
}
\paper {
bookTitleMarkup = \markup {
\column {
\fill-line { \fromproperty #'header:title }
\null
\justify-field #'header:description
}
}
}
\markup {
\null
}
</pre><p>
<a href="../80/lily-3793a0ea.ly">
<img align="middle"
border="0"
src="../80/lily-3793a0ea.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\justify</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cjustify-2"></a>
<a name="index-_005cjustify-3"></a>
<a name="index-_005cjustify-4"></a>
<a name="index-justifying-text"></a>
<p>Like <code>\wordwrap</code>, but with lines stretched to justify the margins.
Use <code>\override #'(line-width . <var>X</var>)</code> to set the line width;
<var>X</var> is the number of staff spaces.
</p>
<blockquote><pre class="verbatim">\markup {
\justify {
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed
do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
}
}
</pre><p>
<a href="../6b/lily-68dd64d6.ly">
<img align="middle"
border="0"
src="../6b/lily-68dd64d6.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>text-direction</code> (1)
</li><li> <code>word-space</code>
</li><li> <code>line-width</code> (#f)
</li><li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\justify-string</code> <var>arg</var> (string)</dt>
<dd><a name="index-_005cjustify_002dstring"></a>
<a name="index-_005cjustify_002dstring-1"></a>
<a name="index-_005cjustify_002dstring-2"></a>
<p>Justify a string. Paragraphs may be separated with double newlines
</p>
<blockquote><pre class="verbatim">\markup {
\override #'(line-width . 40)
\justify-string #"Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor incididunt ut labore
et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Excepteur sint occaecat cupidatat non proident, sunt in culpa
qui officia deserunt mollit anim id est laborum"
}
</pre><p>
<a href="../07/lily-c0b8af43.ly">
<img align="middle"
border="0"
src="../07/lily-c0b8af43.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>text-direction</code> (1)
</li><li> <code>word-space</code>
</li><li> <code>line-width</code>
</li><li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\left-align</code> <var>arg</var> (markup)</dt>
<dd><a name="index-_005cleft_002dalign-2"></a>
<a name="index-_005cleft_002dalign-3"></a>
<a name="index-_005cleft_002dalign-4"></a>
<a name="index-left-aligning-text"></a>
<p>Align <var>arg</var> on its left edge.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
one
\left-align
two
three
}
}
</pre><p>
<a href="../bd/lily-7f597807.ly">
<img align="middle"
border="0"
src="../bd/lily-7f597807.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\left-column</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cleft_002dcolumn"></a>
<a name="index-_005cleft_002dcolumn-1"></a>
<a name="index-_005cleft_002dcolumn-2"></a>
<a name="index-text-columns_002c-left_002daligned"></a>
<p>Put <code>args</code> in a left-aligned column.
</p>
<blockquote><pre class="verbatim">\markup {
\left-column {
one
two
three
}
}
</pre><p>
<a href="../3b/lily-cbd5aaf5.ly">
<img align="middle"
border="0"
src="../3b/lily-cbd5aaf5.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\line</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cline"></a>
<a name="index-_005cline-1"></a>
<a name="index-_005cline-2"></a>
<p>Put <var>args</var> in a horizontal line. The property <code>word-space</code>
determines the space between markups in <var>args</var>.
</p>
<blockquote><pre class="verbatim">\markup {
\line {
one two three
}
}
</pre><p>
<a href="../f8/lily-d528fac6.ly">
<img align="middle"
border="0"
src="../f8/lily-d528fac6.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>text-direction</code> (1)
</li><li> <code>word-space</code>
</li></ul>
</dd>
<dt> <code>\lower</code> <var>amount</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005clower-2"></a>
<a name="index-_005clower-3"></a>
<a name="index-_005clower-4"></a>
<a name="index-lowering-text"></a>
<p>Lower <var>arg</var> by the distance <var>amount</var>.
A negative <var>amount</var> indicates raising; see also <code>\raise</code>.
</p>
<blockquote><pre class="verbatim">\markup {
one
\lower #3
two
three
}
</pre><p>
<a href="../86/lily-4ef11740.ly">
<img align="middle"
border="0"
src="../86/lily-4ef11740.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\pad-around</code> <var>amount</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005cpad_002daround-2"></a>
<a name="index-_005cpad_002daround-3"></a>
<a name="index-_005cpad_002daround-4"></a>
<p>Add padding <var>amount</var> all around <var>arg</var>.
</p>
<blockquote><pre class="verbatim">\markup {
\box {
default
}
\hspace #2
\box {
\pad-around #0.5 {
padded
}
}
}
</pre><p>
<a href="../11/lily-ff783b67.ly">
<img align="middle"
border="0"
src="../11/lily-ff783b67.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\pad-markup</code> <var>amount</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005cpad_002dmarkup-2"></a>
<a name="index-_005cpad_002dmarkup-3"></a>
<a name="index-_005cpad_002dmarkup-4"></a>
<a name="index-padding-text"></a>
<a name="index-putting-space-around-text"></a>
<p>Add space around a markup object.
</p>
<blockquote><pre class="verbatim">\markup {
\box {
default
}
\hspace #2
\box {
\pad-markup #1 {
padded
}
}
}
</pre><p>
<a href="../8a/lily-3da99978.ly">
<img align="middle"
border="0"
src="../8a/lily-3da99978.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\pad-to-box</code> <var>x-ext</var> (pair of numbers) <var>y-ext</var> (pair of numbers) <var>arg</var> (markup)</dt>
<dd><a name="index-_005cpad_002dto_002dbox-2"></a>
<a name="index-_005cpad_002dto_002dbox-3"></a>
<a name="index-_005cpad_002dto_002dbox-4"></a>
<p>Make <var>arg</var> take at least <var>x-ext</var>, <var>y-ext</var> space.
</p>
<blockquote><pre class="verbatim">\markup {
\box {
default
}
\hspace #4
\box {
\pad-to-box #'(0 . 10) #'(0 . 3) {
padded
}
}
}
</pre><p>
<a href="../a3/lily-18cf562e.ly">
<img align="middle"
border="0"
src="../a3/lily-18cf562e.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\pad-x</code> <var>amount</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005cpad_002dx-2"></a>
<a name="index-_005cpad_002dx-3"></a>
<a name="index-_005cpad_002dx-4"></a>
<a name="index-padding-text-horizontally"></a>
<p>Add padding <var>amount</var> around <var>arg</var> in the X direction.
</p>
<blockquote><pre class="verbatim">\markup {
\box {
default
}
\hspace #4
\box {
\pad-x #2 {
padded
}
}
}
</pre><p>
<a href="../3a/lily-842daf17.ly">
<img align="middle"
border="0"
src="../3a/lily-842daf17.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\put-adjacent</code> <var>axis</var> (integer) <var>dir</var> (direction) <var>arg1</var> (markup) <var>arg2</var> (markup)</dt>
<dd><a name="index-_005cput_002dadjacent"></a>
<a name="index-_005cput_002dadjacent-1"></a>
<a name="index-_005cput_002dadjacent-2"></a>
<p>Put <var>arg2</var> next to <var>arg1</var>, without moving <var>arg1</var>.
</p>
</dd>
<dt> <code>\raise</code> <var>amount</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005craise-2"></a>
<a name="index-_005craise-3"></a>
<a name="index-_005craise-4"></a>
<a name="index-raising-text"></a>
<p>Raise <var>arg</var> by the distance <var>amount</var>.
A negative <var>amount</var> indicates lowering, see also <code>\lower</code>.
</p>
<p>The argument to <code>\raise</code> is the vertical displacement amount,
measured in (global) staff spaces. <code>\raise</code> and <code>\super</code>
raise objects in relation to their surrounding markups.
</p>
<p>If the text object itself is positioned above or below the staff, then
<code>\raise</code> cannot be used to move it, since the mechanism that
positions it next to the staff cancels any shift made with
<code>\raise</code>. For vertical positioning, use the <code>padding</code>
and/or <code>extra-offset</code> properties.
</p>
<blockquote><pre class="verbatim">\markup {
C
\small
\bold
\raise #1.0
9/7+
}
</pre><p>
<a href="../05/lily-c6f7f6d9.ly">
<img align="middle"
border="0"
src="../05/lily-c6f7f6d9.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\right-align</code> <var>arg</var> (markup)</dt>
<dd><a name="index-_005cright_002dalign-2"></a>
<a name="index-_005cright_002dalign-3"></a>
<a name="index-_005cright_002dalign-4"></a>
<a name="index-right-aligning-text"></a>
<p>Align <var>arg</var> on its right edge.
</p>
<blockquote><pre class="verbatim">\markup {
\column {
one
\right-align
two
three
}
}
</pre><p>
<a href="../a8/lily-1805b952.ly">
<img align="middle"
border="0"
src="../a8/lily-1805b952.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\right-column</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cright_002dcolumn"></a>
<a name="index-_005cright_002dcolumn-1"></a>
<a name="index-_005cright_002dcolumn-2"></a>
<a name="index-text-columns_002c-right_002daligned"></a>
<p>Put <code>args</code> in a right-aligned column.
</p>
<blockquote><pre class="verbatim">\markup {
\right-column {
one
two
three
}
}
</pre><p>
<a href="../1f/lily-f6214c7e.ly">
<img align="middle"
border="0"
src="../1f/lily-f6214c7e.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\rotate</code> <var>ang</var> (number) <var>arg</var> (markup)</dt>
<dd><a name="index-_005crotate"></a>
<a name="index-_005crotate-1"></a>
<a name="index-_005crotate-2"></a>
<a name="index-rotating-text"></a>
<p>Rotate object with <var>ang</var> degrees around its center.
</p>
<blockquote><pre class="verbatim">\markup {
default
\hspace #2
\rotate #45
\line {
rotated 45°
}
}
</pre><p>
<a href="../f3/lily-c8c4ad2a.ly">
<img align="middle"
border="0"
src="../f3/lily-c8c4ad2a.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\translate</code> <var>offset</var> (pair of numbers) <var>arg</var> (markup)</dt>
<dd><a name="index-_005ctranslate-2"></a>
<a name="index-_005ctranslate-3"></a>
<a name="index-_005ctranslate-4"></a>
<a name="index-translating-text"></a>
<p>Translate <var>arg</var> relative to its surroundings. <var>offset</var>
is a pair of numbers representing the displacement in the X and Y axis.
</p>
<blockquote><pre class="verbatim">\markup {
*
\translate #'(2 . 3)
\line { translated two spaces right, three up }
}
</pre><p>
<a href="../e2/lily-764df497.ly">
<img align="middle"
border="0"
src="../e2/lily-764df497.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\translate-scaled</code> <var>offset</var> (pair of numbers) <var>arg</var> (markup)</dt>
<dd><a name="index-_005ctranslate_002dscaled-2"></a>
<a name="index-_005ctranslate_002dscaled-3"></a>
<a name="index-_005ctranslate_002dscaled-4"></a>
<a name="index-translating-text-1"></a>
<a name="index-scaling-text"></a>
<p>Translate <var>arg</var> by <var>offset</var>, scaling the offset by the
<code>font-size</code>.
</p>
<blockquote><pre class="verbatim">\markup {
\fontsize #5 {
* \translate #'(2 . 3) translate
\hspace #2
* \translate-scaled #'(2 . 3) translate-scaled
}
}
</pre><p>
<a href="../e6/lily-3e9f654a.ly">
<img align="middle"
border="0"
src="../e6/lily-3e9f654a.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>font-size</code> (0)
</li></ul>
</dd>
<dt> <code>\vcenter</code> <var>arg</var> (markup)</dt>
<dd><a name="index-_005cvcenter"></a>
<a name="index-_005cvcenter-1"></a>
<a name="index-_005cvcenter-2"></a>
<a name="index-vertically-centering-text"></a>
<p>Align <code>arg</code> to its Y center.
</p>
<blockquote><pre class="verbatim">\markup {
one
\vcenter
two
three
}
</pre><p>
<a href="../d1/lily-eb2d6559.ly">
<img align="middle"
border="0"
src="../d1/lily-eb2d6559.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\wordwrap-field</code> <var>symbol</var> (symbol)</dt>
<dd><a name="index-_005cwordwrap_002dfield"></a>
<a name="index-_005cwordwrap_002dfield-1"></a>
<a name="index-_005cwordwrap_002dfield-2"></a>
<p>Wordwrap the data which has been assigned to <var>symbol</var>.
</p>
<blockquote><pre class="verbatim">\header {
title = "My title"
description = "Lorem ipsum dolor sit amet, consectetur adipisicing
elit, sed do eiusmod tempor incididunt ut labore et dolore magna
aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat."
}
\paper {
bookTitleMarkup = \markup {
\column {
\fill-line { \fromproperty #'header:title }
\null
\wordwrap-field #'header:descr
}
}
}
\markup {
\null
}
</pre><p>
<a href="../12/lily-4226c9bf.ly">
<img align="middle"
border="0"
src="../12/lily-4226c9bf.png"
alt="[image of music]">
</a>
</p>
</blockquote>
</dd>
<dt> <code>\wordwrap</code> <var>args</var> (list of markups)</dt>
<dd><a name="index-_005cwordwrap-2"></a>
<a name="index-_005cwordwrap-3"></a>
<a name="index-_005cwordwrap-4"></a>
<p>Simple wordwrap. Use <code>\override #'(line-width . <var>X</var>)</code> to set
the line width, where <var>X</var> is the number of staff spaces.
</p>
<blockquote><pre class="verbatim">\markup {
\wordwrap {
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed
do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
}
}
</pre><p>
<a href="../f6/lily-500cce55.ly">
<img align="middle"
border="0"
src="../f6/lily-500cce55.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>text-direction</code> (1)
</li><li> <code>word-space</code>
</li><li> <code>line-width</code> (#f)
</li><li> <code>baseline-skip</code>
</li></ul>
</dd>
<dt> <code>\wordwrap-string</code> <var>arg</var> (string)</dt>
<dd><a name="index-_005cwordwrap_002dstring"></a>
<a name="index-_005cwordwrap_002dstring-1"></a>
<a name="index-_005cwordwrap_002dstring-2"></a>
<p>Wordwrap a string. Paragraphs may be separated with double newlines.
</p>
<blockquote><pre class="verbatim">\markup {
\override #'(line-width . 40)
\wordwrap-string #"Lorem ipsum dolor sit amet, consectetur
adipisicing elit, sed do eiusmod tempor incididunt ut labore
et dolore magna aliqua.
Ut enim ad minim veniam, quis nostrud exercitation ullamco
laboris nisi ut aliquip ex ea commodo consequat.
Excepteur sint occaecat cupidatat non proident, sunt in culpa
qui officia deserunt mollit anim id est laborum"
}
</pre><p>
<a href="../e6/lily-f91fc895.ly">
<img align="middle"
border="0"
src="../e6/lily-f91fc895.png"
alt="[image of music]">
</a>
</p>
</blockquote>
<p>Used properties:
</p><ul>
<li> <code>text-direction</code> (1)
</li><li> <code>word-space</code>
</li><li> <code>line-width</code>
</li><li> <code>baseline-skip</code>
</li></ul>
</dd>
</dl>
<hr size="6">
<table class="nav_table">
<tr><td valign="middle" align="left" colspan="1">[<a href="Notation-manual-tables.es.html#Notation-manual-tables" title="Inicio de este capítulo o capítulo anterior"> << Notation manual tables </a>]</td><td valign="middle" align="center" colspan="3">[<a href="index.es.html#index" title="Portada del documento" rel="start">Arriba</a>][<a href="index_toc.es.html#SEC_Contents" title="Índice general" rel="contents">Índice general</a>][<a href="LilyPond-command-index.es.html#LilyPond-command-index" title="Índice" rel="index">Índice</a>][<a href="index_abt.es.html#SEC_About" title="Acerca de (página de ayuda)" rel="help"> ? </a>]</td><td valign="middle" align="right" colspan="1">[<a href="Cheat-sheet.es.html#Cheat-sheet" title="Capítulo siguiente"> Cheat sheet >> </a>]</td></tr><tr><td valign="middle" align="left" colspan="2">[<a href="Font.es.html#Font" title="Sección anterior en orden de lectura" accesskey="p" rel="previous"> < Font </a>]</td><td valign="middle" align="center" colspan="1">[<a href="Text-markup-commands.es.html#Text-markup-commands" title="Subir sección" accesskey="u" rel="up"> Subir : Text markup commands </a>]</td><td valign="middle" align="right" colspan="2">[<a href="Graphic.es.html#Graphic" title="Sección siguiente en orden de lectura" accesskey="n" rel="next"> Graphic > </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>
<p id="languages">
Other languages: <a href="Align.html">English</a>, <a href="Align.fr.html">français</a>, <a href="Align.de.html">deutsch</a>.
<br>
</p>
<!-- FOOTER -->
<!-- end div#main here -->
</div>
<div id="tocframe">
<p class="toc_uplink"><a href="../index.es.html"
title="Documentation Index"><< Volver al índice de la documentación</a></p>
<h4 class="toc_header"><a href="index.es.html#index" title="Start of the manual">Manual de referencia de la notación</a></h4>
<div class="contents">
<ul class="toc">
<li><a name="toc-Musical-notation-1" href="Musical-notation.es.html#Musical-notation">1. Musical notation</a>
<ul class="toc">
<li><a name="toc-Pitches-1" href="Pitches.es.html#Pitches">1.1 Pitches</a> </li>
<li><a name="toc-Rhythms-1" href="Rhythms.es.html#Rhythms">1.2 Rhythms</a> </li>
<li><a name="toc-Expressive-marks-1" href="Expressive-marks.es.html#Expressive-marks">1.3 Expressive marks</a> </li>
<li><a name="toc-Repeats-1" href="Repeats.es.html#Repeats">1.4 Repeats</a> </li>
<li><a name="toc-Simultaneous-notes-1" href="Simultaneous-notes.es.html#Simultaneous-notes">1.5 Simultaneous notes</a> </li>
<li><a name="toc-Staff-notation-1" href="Staff-notation.es.html#Staff-notation">1.6 Staff notation</a> </li>
<li><a name="toc-Editorial-annotations-1" href="Editorial-annotations.es.html#Editorial-annotations">1.7 Editorial annotations</a> </li>
<li><a name="toc-Text-1" href="Text.es.html#Text">1.8 Text</a> </li>
</ul>
</li>
<li><a name="toc-Specialist-notation-1" href="Specialist-notation.es.html#Specialist-notation">2. Specialist notation</a>
<ul class="toc">
<li><a name="toc-Vocal-music-1" href="Vocal-music.es.html#Vocal-music">2.1 Vocal music</a> </li>
<li><a name="toc-Keyboard-and-other-multi_002dstaff-instruments-1" href="Keyboard-and-other-multi_002dstaff-instruments.es.html#Keyboard-and-other-multi_002dstaff-instruments">2.2 Keyboard and other multi-staff instruments</a> </li>
<li><a name="toc-Unfretted-string-instruments-1" href="Unfretted-string-instruments.es.html#Unfretted-string-instruments">2.3 Unfretted string instruments</a> </li>
<li><a name="toc-Fretted-string-instruments-1" href="Fretted-string-instruments.es.html#Fretted-string-instruments">2.4 Fretted string instruments</a> </li>
<li><a name="toc-Percussion-1" href="Percussion.es.html#Percussion">2.5 Percussion</a> </li>
<li><a name="toc-Wind-instruments-1" href="Wind-instruments.es.html#Wind-instruments">2.6 Wind instruments</a> </li>
<li><a name="toc-Chord-notation-1" href="Chord-notation.es.html#Chord-notation">2.7 Chord notation</a> </li>
<li><a name="toc-Ancient-notation-1" href="Ancient-notation.es.html#Ancient-notation">2.8 Ancient notation</a> </li>
<li><a name="toc-World-music-1" href="World-music.es.html#World-music">2.9 World music</a> </li>
</ul>
</li>
<li><a name="toc-General-input-and-output-1" href="General-input-and-output.es.html#General-input-and-output">3. General input and output</a>
<ul class="toc">
<li><a name="toc-Input-structure-1" href="Input-structure.es.html#Input-structure">3.1 Input structure</a> </li>
<li><a name="toc-Titles-and-headers-1" href="Titles-and-headers.es.html#Titles-and-headers">3.2 Titles and headers</a> </li>
<li><a name="toc-Working-with-input-files-1" href="Working-with-input-files.es.html#Working-with-input-files">3.3 Working with input files</a> </li>
<li><a name="toc-Controlling-output-1" href="Controlling-output.es.html#Controlling-output">3.4 Controlling output</a> </li>
<li><a name="toc-MIDI-output-1" href="MIDI-output.es.html#MIDI-output">3.5 MIDI output</a> </li>
</ul>
</li>
<li><a name="toc-Spacing-issues-1" href="Spacing-issues.es.html#Spacing-issues">4. Spacing issues</a>
<ul class="toc">
<li><a name="toc-Paper-and-pages-1" href="Paper-and-pages.es.html#Paper-and-pages">4.1 Paper and pages</a> </li>
<li><a name="toc-Music-layout-1" href="Music-layout.es.html#Music-layout">4.2 Music layout</a> </li>
<li><a name="toc-Breaks-1" href="Breaks.es.html#Breaks">4.3 Breaks</a> </li>
<li><a name="toc-Vertical-spacing-1" href="Vertical-spacing.es.html#Vertical-spacing">4.4 Vertical spacing</a> </li>
<li><a name="toc-Horizontal-spacing-1" href="Horizontal-spacing.es.html#Horizontal-spacing">4.5 Horizontal spacing</a> </li>
<li><a name="toc-Fitting-music-onto-fewer-pages-1" href="Fitting-music-onto-fewer-pages.es.html#Fitting-music-onto-fewer-pages">4.6 Fitting music onto fewer pages</a> </li>
</ul>
</li>
<li><a name="toc-Changing-defaults-1" href="Changing-defaults.es.html#Changing-defaults">5. Changing defaults</a>
<ul class="toc">
<li><a name="toc-Interpretation-contexts-1" href="Interpretation-contexts.es.html#Interpretation-contexts">5.1 Interpretation contexts</a> </li>
<li><a name="toc-Explaining-the-Internals-Reference-1" href="Explaining-the-Internals-Reference.es.html#Explaining-the-Internals-Reference">5.2 Explaining the Internals Reference</a> </li>
<li><a name="toc-Modifying-properties-1" href="Modifying-properties.es.html#Modifying-properties">5.3 Modifying properties</a> </li>
<li><a name="toc-Useful-concepts-and-properties-1" href="Useful-concepts-and-properties.es.html#Useful-concepts-and-properties">5.4 Useful concepts and properties</a> </li>
<li><a name="toc-Advanced-tweaks-1" href="Advanced-tweaks.es.html#Advanced-tweaks">5.5 Advanced tweaks</a> </li>
</ul>
</li>
<li><a name="toc-Interfaces-for-programmers-1" href="Interfaces-for-programmers.es.html#Interfaces-for-programmers">6. Interfaces for programmers</a>
<ul class="toc">
<li><a name="toc-Music-functions-1" href="Music-functions.es.html#Music-functions">6.1 Music functions</a> </li>
<li><a name="toc-Programmer-interfaces-1" href="Programmer-interfaces.es.html#Programmer-interfaces">6.2 Programmer interfaces</a> </li>
<li><a name="toc-Building-complicated-functions-1" href="Building-complicated-functions.es.html#Building-complicated-functions">6.3 Building complicated functions</a> </li>
<li><a name="toc-Markup-programmer-interface-1" href="Markup-programmer-interface.es.html#Markup-programmer-interface">6.4 Markup programmer interface</a> </li>
<li><a name="toc-Contexts-for-programmers-1" href="Contexts-for-programmers.es.html#Contexts-for-programmers">6.5 Contexts for programmers</a> </li>
<li><a name="toc-Scheme-procedures-as-properties-1" href="Scheme-procedures-as-properties.es.html#Scheme-procedures-as-properties">6.6 Scheme procedures as properties</a> </li>
<li><a name="toc-Using-Scheme-code-instead-of-_005ctweak-1" href="Using-Scheme-code-instead-of-_005ctweak.es.html#Using-Scheme-code-instead-of-_005ctweak">6.7 Using Scheme code instead of <code>\tweak</code></a> </li>
<li><a name="toc-Difficult-tweaks-1" href="Difficult-tweaks.es.html#Difficult-tweaks">6.8 Difficult tweaks</a> </li>
</ul>
</li>
<li><a name="toc-Literature-list-1" href="Literature-list.es.html#Literature-list">A. Literature list</a> </li>
<li class="toc_current"><a name="toc-Notation-manual-tables-1" href="Notation-manual-tables.es.html#Notation-manual-tables">B. Notation manual tables</a>
<ul class="toc">
<li><a name="toc-Chord-name-chart-1" href="Chord-name-chart.es.html#Chord-name-chart">B.1 Chord name chart</a> </li>
<li><a name="toc-Common-chord-modifiers-1" href="Common-chord-modifiers.es.html#Common-chord-modifiers">B.2 Common chord modifiers</a> </li>
<li><a name="toc-Predefined-fretboard-diagrams-1" href="Predefined-fretboard-diagrams.es.html#Predefined-fretboard-diagrams">B.3 Predefined fretboard diagrams</a> </li>
<li><a name="toc-MIDI-instruments-1" href="MIDI-instruments.es.html#MIDI-instruments">B.4 MIDI instruments</a> </li>
<li><a name="toc-List-of-colors-1" href="List-of-colors.es.html#List-of-colors">B.5 List of colors</a> </li>
<li><a name="toc-The-Feta-font-1" href="The-Feta-font.es.html#The-Feta-font">B.6 The Feta font</a> </li>
<li><a name="toc-Note-head-styles-1" href="Note-head-styles.es.html#Note-head-styles">B.7 Note head styles</a> </li>
<li class="toc_current"><a name="toc-Text-markup-commands-1" href="Text-markup-commands.es.html#Text-markup-commands">B.8 Text markup commands</a>
<ul class="toc">
<li><a name="toc-Font-1" href="Font.es.html#Font">B.8.1 Font</a> </li>
<li class="toc_current"><a name="toc-Align-1" href="Align.es.html#Align">B.8.2 Align</a> </li>
<li><a name="toc-Graphic-1" href="Graphic.es.html#Graphic">B.8.3 Graphic</a> </li>
<li><a name="toc-Music-1" href="Music.es.html#Music">B.8.4 Music</a> </li>
<li><a name="toc-Instrument-Specific-Markup-1" href="Instrument-Specific-Markup.es.html#Instrument-Specific-Markup">B.8.5 Instrument Specific Markup</a> </li>
<li><a name="toc-Other-1" href="Other.es.html#Other">B.8.6 Other</a> </li>
</ul>
</li>
<li><a name="toc-Text-markup-list-commands-1" href="Text-markup-list-commands.es.html#Text-markup-list-commands">B.9 Text markup list commands</a> </li>
<li><a name="toc-List-of-articulations-1" href="List-of-articulations.es.html#List-of-articulations">B.10 List of articulations</a> </li>
<li><a name="toc-Percussion-notes-1" href="Percussion-notes.es.html#Percussion-notes">B.11 Percussion notes</a> </li>
<li><a name="toc-All-context-properties-1" href="All-context-properties.es.html#All-context-properties">B.12 All context properties</a> </li>
<li><a name="toc-Layout-properties-1" href="Layout-properties.es.html#Layout-properties">B.13 Layout properties</a> </li>
<li><a name="toc-Identifiers-1" href="Identifiers.es.html#Identifiers">B.14 Identifiers</a> </li>
<li><a name="toc-Scheme-functions-1" href="Scheme-functions.es.html#Scheme-functions">B.15 Scheme functions</a> </li>
</ul>
</li>
<li><a name="toc-Cheat-sheet-1" href="Cheat-sheet.es.html#Cheat-sheet">C. Cheat sheet</a> </li>
<li><a name="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.es.html#GNU-Free-Documentation-License">D. GNU Free Documentation License</a> </li>
<li><a name="toc-LilyPond-command-index-1" href="LilyPond-command-index.es.html#LilyPond-command-index">E. LilyPond command index</a> </li>
<li><a name="toc-LilyPond-index-1" href="LilyPond-index.es.html#LilyPond-index">F. LilyPond index</a> </li>
</ul>
</div>
</div>
</body>
</html>
