1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
4 Translation of GIT committish: fdfdc2c6ad77635367916c8300db150fcf29a5a3
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
11 @c A menu is needed before every deeper *section nesting of @node's; run
12 @c M-x texinfo-all-menus-update
13 @c to automatically fill in these menus before saving changes
16 @chapter Basic notation
18 Este capítulo explica cómo usar las funcionalidades de notación básica.
35 Esta sección trata tómo especificar la altura de las notas.
40 * Cautionary accidentals::
42 * Note names in other languages::
52 @subsection Normal pitches
54 @cindex Nombres de las notas
57 El nombre de una nota se especifica usando las letras minúsculas de la @code{a} a la @code{g}.
58 Una escala ascendente de Do mayor se tipografía con
60 @lilypond[quote,fragment,verbatim,ragged-right]
65 El nombre de la nota @code{c} se tipografía una octava por debajo del Do central.
67 @lilypond[quote,fragment,verbatim,ragged-right]
77 La especificación opcional de la octava tiene la forma de una serie de
78 comillas simples o apóstrofes (@samp{'}) o bien una serie de comas
79 (@samp{,}). Cada @samp{'} eleva la altura una octava;
80 cada @samp{,} baja la altura una octava.
82 @lilypond[quote,ragged-right,fragment,verbatim]
84 c' c'' e' g d'' d' d c
86 c, c,, e, g d,, d, d c
89 Se puede usar un método alternativo para declarar en qué octava grabar
90 una nota; este método no requiere tantas especificaciones de octava
91 (@code{'} y @code{,}). Consulte
92 @ref{Relative octaves}.
96 @subsection Accidentals
98 @cindex nombres de las notas, holandés
99 @cindex nombres de las notas, por omisión
101 Un sostenido se forma añadiendo @code{-is} tal final del nombre de la nota y
102 un bemol se forma añadiendo @code{-es}. Los dobles sostenidos y dobles bemoles
103 se obtienen apadiendo @code{-isis} o @code{-eses} al nombre de la nota.
105 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
111 Estos son los nombres de las notas en holandés. En holandés, @code{aes} se contrae en
112 @code{as}, pero las dos formas se aceptan. De forma similar, se aceptan
113 tanto @code{es} como @code{ees}
115 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
119 Un becuadro cancelará el efecto de una alteración accidental o de la armadura.
120 Sin embargo, los becuadros no se codifican dentro de la sintaxis del nombre de la nota con un
121 sufijo; una altura natural se muestra como un simple nombre de nota
123 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
127 La entrada @code{d e f} se interpreta como @q{imprimir un Re natural,
128 Mi natural y Fa natural}, independientemente de la armadura de la tonalidad.
129 Para ver más información acerca de la distinción entre
130 el contenido musical y la presentación de ese contenido, consulte
131 @ref{Accidentals and key signatures}.
133 @lilypond[fragment,quote,ragged-right,verbatim,relative]
142 De acuerdo con las reglas estándar del tipografiado, se imprime un signo de becuadro
143 antes de un sostenido o un bemos siempre que una alteración anterior tiene que cancelarse.
144 Para modificar este comportamiento, utilice
145 @code{\set Staff.extraNatural = ##f}
147 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
149 \set Staff.extraNatural = ##f
156 Referencia del programa: @internalsref{LedgerLineSpanner},
157 @internalsref{NoteHead}.
160 @node Cautionary accidentals
161 @subsection Cautionary accidentals
163 @cindex alteración recordatoria
164 @cindex alteración de precaución
165 @cindex alteración con paréntesis
166 @cindex recordatoria, alteración
168 @cindex precaución, alteración de
169 @cindex paréntesis, alteración con
172 Normalmente las alteraciones accidentales se imprimen automáticamente, pero también puede
173 imprimirlas manualmente. Un alteración recordatoria
174 se puede forzar añadiendo un signo de admiración @code{!}
175 después de la altura de la nota. Una alteración de precaución
176 (o sea, una alteración encerrada en paréntesis) se peude obtener añadiendo el
177 signo de interrogación @samp{?} después del nombre de la nota. Estas alteraciones adicionales
178 se pueden usar también para producir notas con becuadro.
180 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
181 cis cis cis! cis? c c? c! c
187 La producción sutomática de alteraciones accidentales se puede ajustar de muchas formas.
188 Para ver más información, consulte @ref{Automatic accidentals}.
192 @subsection Micro tones
194 @cindex cuartos de tono
195 @cindex semi-bemoles, semi-sostenidos
197 Los medios bemoles y los medios sostenidos se forman añadiendo @code{-eh} y
198 @code{-ih}; a continuación presentamos una serie de DOs cada vez más agudos
200 @lilypond[verbatim,ragged-right,quote,relative=2,fragment]
201 \set Staff.extraNatural = ##f
205 Los microtonos también se exportan al archivo MIDI.
210 No existen estándares reconocidos ampliamente para denotar
211 los bemoles de tres cuartos, de manera que los símbolos de LilyPond
212 no se ajustan a ningún estándar.
216 @node Note names in other languages
217 @subsection Note names in other languages
219 Existen conjuntos predefinidos de nombres de notas para algunos idiomas
220 aparte del inglés. Para usarlos, incluya el archivo de incio
221 específico del idioma. Por ejemplo, añada @code{\include "english.ly"}
222 al principio del archivo de entrada. Los archivos de idioma disponibles
223 y los nombres de las notas que definen son los siguientes:
225 @c Should this be made into a multitable?
226 @cindex idiomas, nombres de las notas en otros
228 Nombres de las notas sostenido bemol doble doble
231 nederlands.ly c d e f g a bes b -is -es -isis -eses
232 english.ly c d e f g a bf b -s/-sharp -f/-flat -ss/-x/ -ff/
233 -sharpsharp -flatflat
234 deutsch.ly c d e f g a b h -is -es -isis -eses
235 norsk.ly c d e f g a b h -iss/-is -ess/-es -ississ/-isis -essess/-eses
236 svenska.ly c d e f g a b h -iss -ess -ississ -essess
237 italiano.ly do re mi fa sol la sib si -d -b -dd -bb
238 catalan.ly do re mi fa sol la sib si -d/-s -b -dd/-ss -bb
239 espanol.ly do re mi fa sol la sib si -s -b -ss -bb
243 Tenga en cuenta que en holandés, alemán, noruego y sueco, los bemoles
244 del @samp{La} como por ejemplo @code{aes} y @code{aeses}
245 se contraen normalmente como @code{as} y @code{ases} (o más frecuentemente
246 como @code{asas}). Algunas veces se definen sólo estas contracciones
247 en los archivos de idioma correrspondientes (esto también se aplica a los
248 sufijos para cuartos de tono que se ven más abajo).
251 Algunas músicas utilizan microtonos cuyas alteraciones son fracciones
252 de un sostenido o bemol @q{normales}. Los nombres de nota para cuartos
253 de tono que se definen en los distintos archivos de idioma se encuentran
254 listados en la tabla siguiente. Aquí los prefijos @q{semi-} y @q{sesqui-}
255 significan @q{medio} y @q{uno y medio} respectivamente. Para el noruego,
256 sueco, catalán y español no se ha definido aún ningún nombre especial.
258 @c What about Turkish Maquam music and similar microtonal systems?
260 @c Note that the term "three-quarter-sharp/-flat" used in lilypond's source code
261 @c is actually misleading since the alteration is in fact one and a half
262 @c of a regular sharp/flat. Whence the naming "sesqui-sharp/-flat" used below.
265 Nombres de las notas semi- semi- sesqui- sesqui-
266 sostenido bemol sostenido bemol
268 nederlands.ly c d e f g a bes b -ih -eh -isih -eseh
269 english.ly c d e f g a bf b -qs -qf -tqs -tqf
270 deutsch.ly c d e f g a b h -ih -eh -isih -eseh
271 norsk.ly c d e f g a b h
272 svenska.ly c d e f g a b h
273 italiano.ly do re mi fa sol la sib si -sd -sb -dsd -bsb
274 catalan.ly do re mi fa sol la sib si
275 espanol.ly do re mi fa sol la sib si
280 @node Relative octaves
282 @subsection Relative octaves
285 @cindex Relativas, especificación de octavas
288 Las octavas se especifican añadiendo @code{'} y @code{,} a los nombres de las notas.
289 Cuando copie música existente, es fácil poner accidentalmente una nota en la octava
290 equivocada y es difícil encontrar dicho error. La octava relativa
291 previene estos errores haciendo que los errores tengan consecuencias mucho mayores:
292 un solo error transporta una octava el resto de la pieza
295 \relative @var{altura_inicial} @var{expresión_musical}
302 \relative @var{expresión_musical}
306 @code{c'} se usa por defecto si no se define una altura inicial.
308 La octava de las notas que aparecen dentro de @var{expresión_musical} se calculan como
309 sigue: si no se usa ninguna marca de cambio de octava, el intervalo básico
310 entre la nota actual y la anterior se toma siempre como si fuera una cuarta o menos.
311 Esta distancia se determina independientemente de las alteraciones; un
312 @code{fisis} (Fa doble sostenido) después de un @code{ceses} (Do doble bemol) se colocará
313 por encima del @code{ceses}. En otras palabras, una cuarta doble aumentada se considera
314 un intervalo menor que una quinta disminuida, incluso aunque la cuarta doble aumentada
315 tiene siete semitonos mientras que la quinta disminuida sólo tiene seis semitonos.
317 Las marcas de cambio de octava @code{'} y @code{,} se pueden añadir para
318 elevar o bajar la altura en una octava más. Al entrar en el modo relativo,
319 se peude especificar una altura de inicio absoluta que se comportará como
320 la nota precedente a la primera nota de la @var{expresión_musical}. Si no
321 se especifica ninguna altura inicial, se utilizará el Do central como
324 Aquí podemos ver el modo relativo en acción:
325 @lilypond[quote,fragment,ragged-right,verbatim]
331 Las marcas de cambio de octava se utilizan para intervalos mayores de la cuarta
333 @lilypond[quote,ragged-right,fragment,verbatim]
339 Si el elemento anterior es un acorde, la primera nota del acorde se utiliza para
340 determinar la primera nota del siguiente acorde
342 @lilypond[quote,ragged-right,fragment,verbatim]
350 La altura después del @code{\relative} contiene un nombre de nota.
352 La converión relativa no afecta a las secciones @code{\transpose},
353 @code{\chordmode} o @code{\relative} en su argumento. Para usar
354 el modo relativo dentro de música transportada, se debe escribir
355 un @code{\relative} adicional dentro de @code{\transpose}.
359 @subsection Octave check
361 @cindex Comprobación de octava
363 Las comprobaciones de octava hacen que los errores de octava sean más
364 fáciles de corregir: una nota puede venir seguida de @code{=}@var{comillas}
365 lo que indica cuál debería ser su octava absoluta. En el siguiente ejemplo,
368 \relative c'' @{ c='' b=' d,='' @}
372 la @code{d} generará una advertencia, porque se esperaba un @code{d''}
373 (a causa de que el intervalo de @code{b'} a @code{d''} es de una tercera solamente),
374 pero aparece un @code{d'}. En la salida, la octava se corrige para que sea
375 un @code{d''} y la siguiente nota se calcula de forma relativa a @code{d''}
376 en lugar de a @code{d'}.
378 También existe una comprobación de octava que no produce ninguna salida visible.
385 Esto comprueba que @var{altura} (sin las comillas) produce @var{altura} (con
386 las comillas) en modo @code{\relative} comparado con la nota que se da en el
387 comando @code{\relative}. Si no es así, se imprime una advertencia, y la
388 octava se corrige. La @var{altura} no se imprime como una nota.
390 En el ejemplo que aparece a continuación, la primera comprobación
391 se aprueba sin más problema, porque el @code{e} (en modo @code{relative})
392 está dentro de una quinta desde @code{a'}. Sin embargo
393 la segunda comprobación produce una advertencia porque el @code{e} no está dentro
394 de una quinta del @code{b'}. Se imprime el mensaje de advertencia y la octava se ajusta
395 de modo que las notas siguientes están en la octava correcta de nuevo.
406 La octava de una nota que sigue a una comprobación de octava
407 se determina con respecto a la nota que la precede. En el siguiente fragmento,
408 la última nota es una @code{a'}, por encima del Do central. Esto
409 significa que la comprobeación de @code{\octave} se aprueba satisfactoriamente,
410 así que la comprobación se peude borrar sin que cambie la salida de la pieza.
412 @lilypond[quote,ragged-right,verbatim,fragment]
422 @subsection Transpose
424 @cindex Transposición
425 @cindex Transposición de alturas
428 A music expression can be transposed with @code{\transpose}. The
431 \transpose @var{desde} @var{hacia} @var{expresión_musical}
434 Esto significa que la @var{expresión_musical} se transporta el intervalo
435 que hay entre las notas @var{desde} y @var{hacia}: cualquier nota con la altura @code{desde}
436 se cambia por @code{hacia}.
438 Por ejemplo, tomemos una pieza escrita en la tonalidad de Re mayor.
439 Si esta pieza es demasiado grave para el ejecutante, se puede transportar
440 hacia arriba a Mi mayor con
442 \transpose d e @dots{}
445 Suponga una pieza escrita para el violín (que es un instrumento en Do). Si
446 esta parte se tiene que tocar con un clarinete en La (para el que un La
447 se escribe como un Do, y que suena una tercera menor por debajo de lo que
448 está escrito), el siguiente transporte producirá la particella correcta:
451 \transpose a c @dots{}
454 @code{\transpose} distingue entre notas enarmónicas: tanto
455 @code{\transpose c cis} como @code{\transpose c des} transportarán un
456 semitono hacia arriba. La primera versión imprimirá sostenidos y la
457 segunda imprimirá bemoles
460 @lilypond[quote,ragged-right,verbatim]
461 mus = { \key d \major cis d fis g }
470 @code{\transpose} también se puede usar para introducir notas escritas para un
471 instrumento transpositor. Las alturas se introducen normalmente en LilyPond
472 en Do (o en @q{afinación de concierto}), pero se pueden introducir en otra
473 tonalidad. Por ejemplo, al introducir música para una trompeta en Si bemol
474 que comienza en un Re de concierto, se puede escribir
477 \transpose c bes @{ e4 @dots{} @}
480 Para imprimir esta música en Si bemol de nuevo (o sea, para producir una particella de trompeta
481 en vez de una partitura para el director en afinación de concierto), puede envolver la música existente
482 con otro @code{transpose}
485 \transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
491 Referencia del programa: @internalsref{TransposedMusic}.
493 Ejemplo: @inputfileref{input/@/test,smart@/-transpose@/.ly}.
498 Si quiere usar al mismo tiempo @code{\transpose} y @code{\relative},
499 debe escribir @code{\transpose} por fuera de @code{\relative}, porque
500 @code{\relative} no tendrá ningún efecto sobre la música que aparezca dentro de un
511 Los silencios se introducen como notas con el nombre @code{r}
513 @lilypond[fragment,quote,ragged-right,verbatim]
517 Los silencios de un compás centrados en medio del comás,
518 se deben hacer com silencios multicompás. Se pueden usar para
519 un solo compás así como para muchos compases, y se tratan en
520 @ref{Multi measure rests}.
522 Para especificar explícitamente la posición vertical de un silencio, escriba una nota
523 seguida de @code{\rest}. Se colocará un silencio en la posición en que debería
526 @lilypond[fragment,quote,ragged-right,verbatim]
531 Esto hace mucho más sencillo el formateo de la música polifónica,
532 porque el formateador automático de colisiones de silencios se olvidará de ellos.
536 Referencia del programa: @internalsref{Rest}.
542 @cindex Desplazamiento
543 @cindex Silencio invisible
544 @cindex Nota de espaciado
548 Un silencio invisible -- también conocido como @q{skip} (desplazamiento) --
549 se puede introducir como una nota con el nombre @samp{s} o con @code{\skip @var{duración}}
551 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
552 a4 a4 s4 a4 \skip 1 a4
555 La sintaxis de @code{s} sólo está disponible en el modo de notas y en el modo de acordes.
556 En otras situaciones, por ejemplo, cuando se introduce la letra, debe
557 usar el comando @code{\skip}
559 @lilypond[quote,ragged-right,verbatim]
562 \new Lyrics \lyricmode { \skip 2 bla2 }
566 El comando skip es un mero contenedor musical vacío. No produce
567 ninguna salida, ni siguiera una salida transparente.
569 El comando de desplazamiento @code{s} crea una @internalsref{Staff} y una
570 @internalsref{Voice} cuando es necesario, de forma similar a los comandos de nota y de silencio.
571 Por ejemplo, el fragmento siguiente produce un pentagrama vacío.
573 @lilypond[quote,ragged-right,verbatim]
577 El fragmento @code{@{ \skip 4 @} } produciría una página vacía.
581 Referencia del programa: @internalsref{SkipMusic}.
588 Esta sección trata los ritmos, duraciones y compases.
592 * Augmentation dots::
594 * Scaling durations::
597 * Automatic note splitting::
602 @subsection Durations
609 En los modos de Nota, Acorde y Letra, las duraciones se designan
610 mediante números y puntos: las duraciones se introducen como sus
611 valores recíprocos respecto de la redonda. Por ejemplo, una negra
612 se escribe usando un @code{4} (puesto que es 1/4 de redonda), mientras
613 que una blanca se escribe con un @code{2} (por ser 1/2 de redonda). Para
614 notas mayores de la redonda se deben usar los comandos @code{\longa} y
619 c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
621 r1 r2 r4 r8 r16 r32 r64 r64
627 a\breve*1/2 \autoBeamOff
628 a1 a2 a4 a8 a16 a32 a64 a64
631 r\longa*1/4 r\breve *1/2
632 r1 r2 r4 r8 r16 r32 r64 r64
639 \remove "Bar_number_engraver"
643 \remove "Clef_engraver"
644 \override StaffSymbol #'transparent = ##t
645 \override TimeSignature #'transparent = ##t
646 \override BarLine #'transparent = ##t
647 \consists "Pitch_squash_engraver"
653 Si la duración se omite, su valor será el de la duración de la nota
654 anterior. Por omisión, el valor de la primera nota es el de una
657 @lilypond[quote,ragged-right,verbatim,fragment]
658 { a a a2 a a4 a a1 a }
662 @node Augmentation dots
663 @subsection Augmentation dots
667 Para obtener duraciones de notas con puntillo, simplemente escriba un
668 punto (@samp{.}) después del número. Las notas con doble puntillo se
669 consiguen de manera similar.
671 @lilypond[quote,ragged-right,fragment,verbatim]
672 a'4 b' c''4. b'8 a'4. b'4.. c''8.
677 Normalmente los puntillos se desplazan hacia arriba para evitar las
678 líneas del pentagrama, excepto en situaciones de polifonía. Se pueden
679 utilizar los siguientes comandos para forzar manualmente una dirección
686 @funindex \dotsNeutral
691 Referencia del programa: @internalsref{Dots} y @internalsref{DotColumn}.
697 @cindex grupos especiales
701 Los grupos especiales se obtienen a partir de una expresión musical
702 multiplicando todas las duraciones por una fracción:
705 \times @var{fracción} @var{expresión_musical}
709 La duración de la @var{expresión _musical} se multiplicará or la
710 fracción. El denominador de la fracción se imprimirá sobre las notas,
711 opcionalmente con un corchete. El grupo especial más común es el
712 tresillo, en el que 3 notas tienen el valor de 2, por tanto las notas
713 duran 2/3 de su valor escrito
715 @lilypond[quote,ragged-right,fragment,verbatim]
716 g'4 \times 2/3 {c'4 c' c'} d'4 d'4
719 Los grupos pueden anidarse unos dentro de otros, por ejemplo
721 @lilypond[fragment,ragged-right,verbatim,relative=2]
722 \override TupletNumber #'text = #tuplet-number::calc-fraction-text
725 \times 3/5 { a a a a a }
733 @funindex \tupletDown
735 @funindex \tupletNeutral
736 @code{\tupletNeutral}.
741 @funindex tupletNumberFormatFunction
742 @cindex formateo de los grupos especiales
744 La propiedad @code{tupletSpannerDuration} (duración del selector de
745 grupo) especifica la duración de cada corchete. Con esto puede hacer
746 muchos grupos escribiendo @code{\times} una sola vez, ahorrándose
747 mucho trabajo de teclado. En el siguiente ejemplo se muestran dos
748 tresillos, aunque @code{\times} sólo se ha utilizado una vez
750 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
751 \set tupletSpannerDuration = #(ly:make-moment 1 4)
752 \times 2/3 { c8 c c c c c }
756 Para ver más información sobre @code{make-moment}, consulte
757 @ref{Time administration}.
759 El formato del número se determina por medio de la propiedad @code{text} en
760 @code{TupletNumber}. Por defecto se imprime sólo el denominador, pero si
761 su valor se establece a la función @code{tuplet-number::calc-fraction-text},
762 se imprimirá como @var{numerador}:@var{denominador}
764 Para que no se impriman los números de los grupos, emplee
766 @lilypond[quote,fragment,relative=2,ragged-right,verbatim]
767 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
768 \override TupletNumber #'transparent = ##t
769 \times 2/3 { c8 c c } \times 2/3 { c8 c c }
772 @c needs revision. FVD
773 Se puede hacer que los corchetes de grupo abarquen tanto como su
774 duración completa indique o que lleguen hasta justo antes de la nota
777 @lilypond[ragged-right]
779 \set tupletFullLength = ##t
784 \set tupletFullLengthNote = ##t
797 Referencia del programa: @internalsref{TupletBracket},
798 @internalsref{TupletNumber} y @internalsref{TimeScaledMusic}.
802 @node Scaling durations
803 @subsection Scaling durations
805 Es posible alterar la duración de las figuras en un factor @var{N/M}
806 añadiendo @samp{*@var{N/M}} (o @samp{*@var{N}} si @var{M=1}). Esto no
807 afectará a la apariencia de las notas o silencios que se producen. Se
808 pueden combinar en la forma @samp{*M*N}.
810 En el siguiente ejemplo las tres primeras notas duran exactamente dos
811 partes, pero no se imprime ningún corchete de tresillo.
813 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
815 a4*2/3 gis4*2/3 a4*2/3
823 En este manual: @ref{Tuplets}
827 @subsection Bar check
829 @cindex Compás, comprobación de
830 @funindex barCheckSynchronize
833 Las comprobaciones de compás ayudan a detectar errores en las duraciones. Una comprobación de compás se
834 escribe usando el símbolo de la barra vertical, @samp{|}. Cuando se encuentra durante
835 la interpretación, debe caer en el límite entre dos compases. Si no es así,
836 se muestra una advertencia. En el siguiente ejemplo, la segunda comprobación
837 de compás avisará de un error
839 \time 3/4 c2 e4 | g2 |
842 Las comprobaciones de compás también se pueden usar en la letra de las canciones, por ejemplo
847 Cam -- pa | ni -- tas
851 Las comprobaciones de compás fallidas tienen su origen en la
852 introducción incorrecta de las duraciones. Las duraciones incorrectas
853 a menudo desbaratan la partitura completamente, sobre todo si la
854 música es polifónica, por ello el mejor sitio para empezar a corregir
855 la entrada es hacer un barrido en busca de comprobaciones de compás
856 fallidas y duraciones incorrectas.
861 También es posible redefinir el significado de @code{|}. Se hace
862 asignando una expresión musical a @code{pipeSymbol},
864 @lilypond[quote,ragged-right,verbatim]
865 pipeSymbol = \bar "||"
871 @node Barnumber check
872 @subsection Barnumber check
874 Al copiar piezas musicales grandes peude servir de ayuda comprobar que
875 el número de compás de LilyPond corresponde al original desde el que está copiando.
876 Esto se puede comprobar con @code{\barNumberCheck}, por ejemplo
883 imprimirá una advertencia si el @code{currentBarNumber} (número del
884 compás actual) no es 123 cuando se está procesando.
887 @node Automatic note splitting
888 @subsection Automatic note splitting
890 Las notas largas se pueden convertir automáticamente en notas ligadas.
891 Se hace mediante la sustitución del @internalsref{Note_heads_engraver}
892 por el @internalsref{Completion_heads_engraver}. En los siguientes
893 ejemplos, las notas que atraviesan la barra de compás se dividen y se
894 unen mediante una ligadura.
896 @lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
898 \remove "Note_heads_engraver"
899 \consists "Completion_heads_engraver"
901 c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
905 Este grabador dicide todas las notas largas en la barra de compás e
906 inserta ligaduras. Uno de sus usos es depurar partituras complejas:
907 si los compases no están completos, las ligaduras mostrarán
908 exactamente cuánto le falta a cada compás.
910 Si quiere permitir el salto de línea en las barras de compás en las
911 que @internalsref{Completion_heads_engraver} divide las notas, debe
912 eliminar también @internalsref{Forbid_line_breaks_engraver}.
917 No todas las duraciones (sobre todo las que contienen grupos
918 especiales) se pueden representar exactamente con notas normales y
919 puntillos, pero el grabador nunca insertará grupos especiales.
922 @code{Completion_heads_engraver} afecta sólo a las notas; no divide
928 Referencia del programa: @internalsref{Completion_heads_engraver}.
934 La polifonía en música hace referencia a tener más de una voz en una
935 pieza cualquiera de música. En LilyPond la polifonía hace referencia
936 a tener más de una voz en el mismo pentagrama.
943 * Explicitly instantiating voices::
944 * Collision Resolution::
953 Un acorde se forma encerrando un conjunto de notas entre @code{<} y
954 @code{>}. Un acorde puede ir seguido de una duración o un conjunto de
955 articulaciones, como si fueran simples notas.
957 @lilypond[verbatim,ragged-right,fragment,quote,relative=1]
961 Para ver más información sobre los acordes, consulte @ref{Chord names}.
967 Cuando se encuentra con una nota, se crea un objeto
968 @internalsref{Stem} (plica) automáticamente. Para las redondas y los
969 silencios, también se crean pero se hacen invisibles.
978 @funindex \stemNeutral
984 Para modificar la dirección de las plicas en medio de un pentragrama, utilice
986 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
988 \override Stem #'neutral-direction = #up
990 \override Stem #'neutral-direction = #down
995 @node Basic polyphony
996 @subsection Basic polyphony
1000 La manera más fácil de escribir fragmentos con más de una voz sobre el mismo pentagrama
1001 es introducir cada voz como una secuencia (con @code{@{...@}}), y combinarlas
1002 simultáneamente, separando las voces con @code{\\}
1006 @lilypond[quote,verbatim,fragment]
1007 \new Staff \relative c' {
1010 { g4 f e | d2 e2 } \\
1011 { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
1017 El separador hace que se produsca un nuevo contexto de @internalsref{Voice}@footnote{Las voces polifónicas
1018 se conocen a veces como @q{capas} en otros programas de edición de partituras}.
1020 Llevan los nombres @code{"1"}, @code{"2"}, etc. En cada
1021 uno de estos contextos, la dirección vertical de las ligaduras, plicas, etc., se establece
1022 de la manera que corresponda.
1024 Todas estas voces están separadas de la voz que contiene las noas
1025 justo por fuera de la construcción @code{<< \\ >>}. Esto se debe
1026 tener en cuenta cuando haga algún cambio en una voz. También
1027 significa que las ligaduras de unión y de expresión no pueden salir ni
1028 entrar en una construcción @code{<< \\ >>}. En cambio las voces
1029 paralelas que están en construcciones @code{<< \\ >>} separadas dentro
1030 del mismo pentagrama, son la misma voz. Presentamos a continuación el
1031 mismo ejemplo, con cabezas distintas apra cada voz. Dése cuenta de
1032 que el cambio al estilo de cabezas de nota en la voz principal no
1033 afecta a las que están dentro de la construcción @code{<< \\ >>}.
1034 También, el cambio a la segunda voz en la primera construcción
1035 @code{<< \\ >>} es efectiva en la segunda @code{<< \\ >>}, y la voz se
1036 liga de una construcción a otra.
1038 @cindex cabezas de nota, estilos de
1040 @lilypond[quote,verbatim,fragment]
1041 \new Staff \relative c' {
1042 \override NoteHead #'style = #'cross
1046 { \override NoteHead #'style = #'triangle
1051 { c8 b16 a b8 g ~ g2 } \\
1052 { \override NoteHead #'style = #'slash s4 b4 c2 }
1057 La polifonía no cambia la relación entre las notas que están dentro de
1058 un bloque @code{\relative @{ @}}. Cada una de las notas se calcula
1059 relativa a la nota inmediatamente anterior.
1062 \relative @{ notaA << notaB \\ notaC >> notaD @}
1065 @code{notaC} es relativa a @code{notaB}, no a @code{notaA};
1066 @code{notaD} es relativa a @code{notaC}, no a @code{notaB} ni a
1070 @node Explicitly instantiating voices
1071 @subsection Explicitly instantiating voices
1073 Los contextos de @internalsref{Voice} también se pueden instanciar manualmente
1074 dentro de un bloque @code{<< >>} para crear música polifónica, usando
1075 @code{\voiceOne}, hasta @code{\voiceFour} para asignar las direcciones de las plicas
1076 y un desplazamiento horizontal para cada parte.
1080 << \superior \\ \inferior >>
1088 \new Voice = "1" @{ \voiceOne \superior @}
1089 \new Voice = "2" @{ \voiceTwo \inferior @}
1093 Los comandos @code{\voiceXXX} establecen la dirección de las plicas, ligaduras de expresión y de unión,
1094 articulaciones, anotaciones de texto, puntillos y digitaciones.
1095 @code{\voiceOne} y @code{\voiceThree} hacen
1096 a los mencionados objetos apuntar hacia arriba, mientras que @code{\voiceTwo} y @code{\voiceFour}
1097 los hacen apuntar hacia abajo.
1098 El comando @code{\oneVoice} hace volver a los ajustes normales.
1100 Una expresión que aparece directamente dentro de un @code{<< >>} pertenece a
1101 la voz principal. Es útil cuando aparecen voces adicionales al tiempo que está cantando la voz
1102 principal. A continuación podemos ver una representación mejor del ejemplo del apartado anterior.
1103 Las cabezas en forma de cruz demuestran que
1104 la melodía principal ahora está en un contexto de una voz única.
1106 @lilypond[quote,ragged-right,verbatim]
1107 \new Staff \relative c' {
1108 \override NoteHead #'style = #'cross
1113 \new Voice="1" { \voiceTwo
1114 r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1117 \new Voice { \voiceThree
1126 La definición correcta de las voces permite que la melodía se pueda marcar con ligaduras de expresión.
1127 @lilypond[quote,ragged-right,verbatim]
1128 \new Staff \relative c' {
1133 \context Voice="1" { \voiceTwo
1134 r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1137 \new Voice { \voiceThree
1146 Al evitar el separador @code{\\} posibilitamos la escritura de
1147 construcciones polifónicas anidadas, lo que en algún caso podría constituir
1148 una forma más natural de tipografiar la música.
1150 @lilypond[quote,ragged-right,verbatim]
1151 \new Staff \relative c' {
1156 \context Voice="1" { \voiceTwo
1159 {c8 b16 a b8 g ~ g2}
1160 \new Voice { \voiceThree
1172 En ciertos casos de música polifónica compleja podría ser necesario
1173 utilizar voces adicionales para evitar colisiones entre las notas.
1174 Las voces adicionales se añaden definiendo un identificador como se
1175 muestra a continuación:
1177 @lilypond[quote,verbatim,ragged-right,relative=2]
1178 voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
1181 { \voiceOne g4 ~ \stemDown g32[ f( es d c b a b64 )g] } \\
1182 { \voiceThree b4} \\
1189 @node Collision Resolution
1190 @subsection Collision Resolution
1192 Normalmente las cabezas de nota con un número de puntillos diferente
1193 no se mezclan en una sola, pero cuando se establece como cierta
1194 propiedad @code{merge-differently-dotted} en el objeto
1195 @internalsref{NoteCollision}, se juntan en una sola:
1197 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
1200 \override Staff.NoteCollision
1201 #'merge-differently-dotted = ##t
1203 } \\ { g8.[ f16] g8.[ f16] } >>
1206 De forma similar puede mezclar cabezas de blanca con corcheas,
1207 ajustando @code{merge-differently-headed}:
1209 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
1212 \override Staff.NoteCollision
1213 #'merge-differently-headed = ##t
1214 c8 c4. } \\ { c2 c2 } >>
1218 @code{merge-differently-headed} y @code{merge-differently-dotted}
1219 se aplican solamente a direcciones de plica opuestas (es decir, a las voces 1 y 2).
1221 LilyPond también desplaza verticalmente los silencios que están en el lado contrario de una plica,
1224 @lilypond[quote,ragged-right,fragment,verbatim]
1225 \new Voice << c''4 \\ r4 >>
1228 Si tres o más notas coinciden verticalmente en la misma columna,
1229 @code{merge-differently-headed} no puede completar satisfactoriamente
1230 la mezcla de las dos notas que deberían mezclarse.
1231 Para hacer posible que la mezcla funcione, aplique un @code{\shift} (desplazamiento) a la nota que no
1232 debe mezclarse. En el primer compás del ejemplo siguiente,
1233 @code{merge-differently-headed} no funciona (la cabeza de la blanca está rellena)
1234 En el segundo compás, se aplica @code{\shiftOn} para mover horizontalmente el
1235 @code{g} (Sol) superior, y @code{merge-differently-headed}
1236 funciona correctamente.
1238 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1239 \override Staff.NoteCollision #'merge-differently-headed = ##t
1242 { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
1243 { \voiceFour e,,2 e'2}
1246 { d'=''2 \shiftOn g2 } \\
1247 { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
1248 { \voiceFour e,,2 e'2}
1261 @funindex \voiceThree
1263 @funindex \voiceFour
1270 @funindex \shiftOnnn
1273 @code{\shiftOff}: estos comandos especifican el grado en que
1274 se deben desplazar los acordes de la voz en curso.
1275 Las voces exteriores (normalmente: la voz uno y la voz dos)
1276 tienen @code{\shiftOff} (desplazamiento desactivado), mientras que las voces interiores (tres y cuatro)
1277 tienen @code{\shiftOn} (desplazamiento activado). @code{\shiftOnn} y @code{\shiftOnnn} definen niveles de desplazamiento
1280 Cuando LilyPond no puede con todo, se pueden usar la propiedad
1281 @code{force-hshift} (forzar desplazamiento) del objeto
1282 @internalsref{NoteColumn} y los silencios con altura para sobreescibir
1283 las decisiones de tipografía.
1285 @lilypond[quote,verbatim,ragged-right]
1292 \once \override NoteColumn #'force-hshift = #1.7
1300 Referencia del programa: los objetos responsables de resolver las colisiones son
1301 @internalsref{NoteCollision} y @internalsref{RestCollision}.
1306 Cuando se emplea @code{merge-differently-headed} con una corchea (o una nota más corta) con la plica hacia arriba,
1307 y una blanca con la plica hacia abajo, la corchea no tiene el desplazamiento correcto.
1309 No hay soporte para racimos (clusters) donde la misma nota se presenta
1310 con diferentes alteraciones accidentales dentro del mismo acorde. En
1311 este caso se recomienda usar la transcripción enarmónica, o usar la
1312 notación especial de racimos (ver @ref{Clusters}).
1316 @node Staff notation
1317 @section Staff notation
1319 @cindex Notación de los pentagramas
1321 Esta sección describe la notación musical que se produce en el nivel del pentagrama,
1322 como las armaduras de tonalidad, claves e indicaciones de compás.
1328 * Partial measures::
1331 * System start delimiters::
1333 * Writing music in parallel::
1342 La clave indica qué líneas del pentagrama corresponden a qué
1343 notas. La clave se establece con el comando @code{\clef}
1345 @lilypond[quote,ragged-right,fragment,verbatim]
1346 { c''2 \clef alto g'2 }
1349 @cindex clave de Sol
1350 @cindex clave de violín
1351 @cindex clave de Do en tercera (clave de viola)
1352 @cindex clave de Do en cuarta (clave de tenor)
1353 @cindex clave de Fa en cuarta (clave de bajo)
1354 @cindex clave de Sol en primera (clave de violín francesa)
1355 @cindex clave de Do en primera (clave de soprano)
1356 @cindex clave de Do en segunda (clave de mezzosoprano)
1357 @cindex clave de Do en quinta (clave de barítono)
1358 @cindex clave de Fa en tercera (clave de varbarítono)
1359 @cindex clave de Fa en quinta (clave de subbajo)
1361 Las claves soportadas son
1363 @multitable @columnfractions .33 .66
1364 @headitem Clave @tab Posición
1365 @item @code{treble}, violin, G, G2 @tab
1367 @item @code{alto, C} @tab
1369 @item @code{tenor} @tab
1371 @item @code{bass, F} @tab
1373 @item @code{french} @tab
1374 clave de Sol en 1ª, conocida también como clave de violín francesa
1375 @item @code{soprano} @tab
1377 @item @code{mezzosoprano} @tab
1379 @item @code{baritone} @tab
1381 @item @code{varbaritone} @tab
1383 @item @code{subbass} @tab
1385 @item @code{percussion} @tab
1387 @item @code{tab} @tab
1391 Al añadir @code{_8} o @code{^8} al nombre de la clave, la clave se transpone
1392 una octava hacia abajo o hacia arriba, respectivamente, y @code{_15} y
1393 @code{^15} la transpone dos octavas. El argumento @var{nombre_de_clave}
1394 se debe encerrar entre comillas cuando contiene guiones bajos o dígitos. Por
1397 @cindex clave de tenor coral
1398 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
1405 El comando @code{\clef "treble_8"} equivale a establecer
1407 @code{clefPosition} (que controla la posición Y de la clave),
1408 @code{middleCPosition} y @code{clefOctavation}. Se imprime una clave
1409 cuando se cambia cualquiera de estas propiedades. El siguiente ejemplo muestra
1410 las posibilidades que se ofrecen estableciendo manualmente las propiedades.
1412 @lilypond[quote,ragged-right,verbatim]
1414 \set Staff.clefGlyph = #"clefs.F"
1415 \set Staff.clefPosition = #2
1417 \set Staff.clefGlyph = #"clefs.G"
1419 \set Staff.clefGlyph = #"clefs.C"
1421 \set Staff.clefOctavation = #7
1423 \set Staff.clefOctavation = #0
1424 \set Staff.clefPosition = #0
1428 \set Staff.middleCPosition = #4
1436 Manual: @ref{Grace notes}.
1438 Referencia del programa: @internalsref{Clef}.
1442 @subsection Key signature
1444 @cindex Armadura de la tonalidad
1447 La armadura indica la tonalidad en que se toca una pieza. Está
1448 denotada por un conjunto de alteraciones (bemoles o sostenidos) al comienzo del
1451 El establecimiento o modificación de la armadura se hace con el comando @code{\key}
1454 @code{\key} @var{nota} @var{tipo}
1463 @funindex \mixolydian
1467 @cindex modos eclesiásticos
1469 Aquí, @var{tipo} debe ser @code{\major} o @code{\minor} para obtener
1470 @var{nota}-mayor o @var{nota}-menor, respectivamente. También puede
1471 usar los nombres estándar de modo (también conocidos como @q{modos eclesiásticos}): @code{\ionian} (jónico),
1472 @code{\locrian} (locrio), @code{\aeolian} (eolio), @code{\mixolydian} (mixolidio), @code{\lydian} (lidio),
1473 @code{\phrygian} (frigio) y @code{\dorian} (dórico).
1475 Este comando establece la propiedad de contexto
1476 @code{Staff.keySignature}. Se pueden especificar armaduras no estándar
1477 estableciendo esta propiedad directamente.
1479 Las alteraciones accidentales y las armaduras son una frecuente causa de confusión para los nuevos usuarios,
1480 porque las notas sin alteración pueden llevar signos de becuadro en función de la armadura.
1481 Para leer más información, consulte @ref{Accidentals} o @ref{Accidentals and key signatures}.
1483 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
1492 Se imprime un símbolo de becuadro para cancelar las alteraciones anteriores. Se puede
1493 suprimir esto estableciendo la propiedad @code{Staff.printKeyCancellation}.
1495 @lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
1500 \set Staff.printKeyCancellation = ##f
1510 Referencia del programa: @internalsref{KeyCancellation},
1511 @internalsref{KeySignature}.
1514 @node Time signature
1515 @subsection Time signature
1517 @cindex Indicación de compás
1518 @cindex metro, medida
1521 La indicación de compás indica el metro de la pieza: su patrón regular de
1522 partes fuertes y dábiles. Se denota por una fracción al comienzo del
1525 La indicación de compás se estbablece mediante el comando @code{\time}
1527 @lilypond[quote,ragged-right,fragment,verbatim]
1528 \time 2/4 c'2 \time 3/4 c'2.
1533 Se puede personalizar el símbolo que se imprime mediante la propiedad @code{style}.
1534 Un valor de @code{#'()} produce un estilo de fracción para los compases de 4/4 y
1537 @lilypond[fragment,quote,ragged-right,verbatim]
1540 \override Staff.TimeSignature #'style = #'()
1545 Existen muchas opciones para su presentación. Consulte @ref{Ancient time
1546 signatures} para ver más ejemplos.
1548 @code{\time} establece las propiedades @code{timeSignatureFraction},
1549 @code{beatLength} y @code{measureLength} en el contexto @code{Timing},
1550 cuyo nombre alternativo normalmente es @internalsref{Score}. La
1551 propiedad @code{measureLength} determina el lugar en que se deben insertar las barras de compás
1552 y cómo se generan las barras de corchea auromáticas. La modificación del valor de
1553 @code{timeSignatureFraction} también provoca que se imprima el símbolo.
1555 Están disponibles más opciones a través de la función de Scheme
1556 @code{set-time-signature}. En combinación con el grabador
1557 @internalsref{Measure_grouping_engraver} (agrupación de compases), creará signos de
1558 @internalsref{MeasureGrouping}. Estos signos facilitan la lectura de música moderna
1559 rítmicamente compleja. En el siguiente ejemplo el compás de 9/8
1560 se subdivide en 2, 2, 2 y 3. Eseto se pasa a
1561 @code{set-time-signature} como un tercer argumento @code{(2 2 2 3)}
1563 @lilypond[quote,ragged-right,verbatim]
1566 #(set-time-signature 9 8 '(2 2 2 3))
1567 g8[ g] d[ d] g[ g] a8[( bes g]) |
1568 #(set-time-signature 5 8 '(3 2))
1574 \consists "Measure_grouping_engraver"
1583 Referencia del programa: @internalsref{TimeSignature} y
1584 @internalsref{Timing_translator}.
1586 Ejemplos: @inputfileref{input/@/test,compound@/-time@/.ly}.
1591 EL barrado automático no utiliza la agrupación de compases especificada con
1592 @code{set-time-signature}.
1595 @node Partial measures
1596 @subsection Partial measures
1599 @cindex parte al alzar
1600 @cindex compás parcial
1601 @cindex parcial, compás
1602 @cindex acortar compases
1605 Los comases parciales como las anacrusas o partes al alzar se escriben
1606 usando la construcción
1608 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1609 \partial 16*5 c16 cis d dis e | a2. c,4 | b2
1612 La sintaxis de este comando es la siguiente:
1615 \partial @var{duración}
1618 donde @code{duración} es el valor rítmico que se se debe añadir antes del siguiente compás.
1620 Esto se traduce internamente a
1623 \set Timing.measurePosition = -@var{longitud de la duración}
1626 La propiedad @code{measurePosition} contiene un número racional
1627 que indica qué parte del compás ha transcurrido hasta el momento.
1628 Observe que es un número negativo; @code{\partial 4} se traduce internamente
1629 con el significado de @qq{queda un valor de negra en este compás}.
1634 Este comando no tiene en cuenta los mordentes al comienzo
1635 de la música. Cuando una pieza comienza con mordentes en la anacrusa,
1636 el @code{\partial} debe escribirse después de las notas del mordente
1638 @lilypond[verbatim,quote,ragged-right,relative,fragment]
1645 El uso de @code{\partial} está previsto solamente para el comienzo de una
1646 pieza. Si se emplea después del comienzo se obtendrán varias advertencias
1651 @subsection Bar lines
1653 @cindex Barras de compás
1655 @cindex líneas divisorias
1656 @cindex barras de repetición
1658 Las líneas divisorias delimitan a los compases pero también se pueden usar
1659 para indicar las repeticiones. Normalmente se insertan de manera automática.
1660 Los saltos de línea solamente pueden producirse sobre las barras de compás.
1662 Se pueden forzar tipos especiales de línea divisoria con
1663 el comando @code{\bar}
1665 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
1669 Se encuentran disponibles los siguientes tipos de barra:
1671 @lilypondfile[ragged-right,quote]{bar-lines.ly}
1673 Además se puede especificar @code{"||:"}, que equivale a
1674 @code{"|:"} excepto en los saltos de línea, en que produce una doble barra
1675 al final de la línea y una repetición izquierda (de comienzo) al principio de
1678 Para permitir un salto de línea donde no hay ninguna línea divisoria visible,
1686 De esta manera se insertará una barra invisible de compás y se hará posible
1687 el salto de línea en este punto (sin incrementar el contador de los números de compás).
1689 En las partituras con muchos pentragramas, un comando @code{\bar} en uno de ellos se aplica
1690 automáticamente a todos los demás. Las líneas resultantes se conectan entre los distintos pentagramas
1691 de un @code{StaffGroup}, @code{PianoStaff} o @code{ChoirStaff}.
1693 @lilypond[quote,ragged-right,fragment,verbatim]
1701 \new Staff { \clef bass c4 g e g }
1703 \new Staff { \clef bass c2 c2 }
1711 @funindex repeatCommands
1712 @funindex defaultBarType
1714 El comando @code{\bar }@var{tipo_de_barra} es una forma corta de hacer
1715 @code{\set Timing.whichBar = }@var{tipo_de_barra}. Cuando @code{whichBar}
1716 se establece con el valor de una cadena, se crea una línea divisoria de ese tipo.
1718 Una líne divisoria se crea cuando se establece la propiedad @code{whichBar}.
1719 Al comienzo del compás su valor se toma de
1720 @code{Timing.defaultBarType}. Los contenidos de los @code{repeatCommands} se
1721 utilizan para sobreescribir a las barras de compás por omisión.
1723 Le recomendamos que utilice siempre @code{\repeat} para hacer repeticiones.
1724 Consulte @ref{Repeats}.
1729 En este manual: @ref{Repeats}, @ref{System start delimiters}.
1731 Referencia del programa: @internalsref{BarLine} (creada al nivel de
1732 @internalsref{Staff} (pentagrama)), @internalsref{SpanBar} (a través de los pentagramas).
1735 @node Unmetered music
1736 @subsection Unmetered music
1739 @funindex \cadenzaOn
1740 @funindex \cadenzaOff
1742 Las líneas divisorias y los números de compás se calculan autmáticamente.
1743 Para música sin compasear (por ejemplo cadencias), esto no es deseable.
1744 Para desactivar las barras y los números de compás automáticos, utilice los comandos
1745 @code{\cadenzaOn} y @code{\cadenzaOff}.
1747 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
1759 LilyPond insertará saltos de línea y de página solamente en las barras de compás.
1760 A menos que la música sin compasear acabe antes del final de la línea del pentagrama,
1761 tendrá que insertar barras de compás invisibles
1768 para indicar dónde se pueden producir los saltos.
1771 @node System start delimiters
1772 @subsection System start delimiters
1774 @cindex comienzo del sistema
1775 @cindex Pentagramas, varios
1776 @cindex corchete vertical
1777 @cindex llave vertical
1778 @cindex pentagramas de piano
1779 @cindex pentagramas, grupo de
1780 @cindex pauta de coro
1782 Muchas partituras constan de más de un pentagrama. Estos pentagramas se pueden
1783 unir de cuatro formas distintas:
1786 @item El grupo comienza con una llave a la izquierda y las líneas de compás
1787 están conectadas. Esto se hace con el contexto @internalsref{GrandStaff}.
1789 @lilypond[verbatim,ragged-right,quote]
1797 @item El grupo comienza con un corchete recto y las líneas de compás están conectadas.
1798 Esto se hace con el contexto @internalsref{StaffGroup}
1800 @lilypond[verbatim,ragged-right,quote]
1808 @item El grupo comienza con un corchete recto pero las líneas de compás no están conectadas.
1809 Esto se hace con el contexto @internalsref{ChoirStaff}.
1811 @lilypond[verbatim,ragged-right,quote]
1819 @item El grupo comienza con una línea vertical. Las líneas de compás
1820 no están conectadas. Ésta es la opción por defecto para la partitura.
1822 @lilypond[verbatim,ragged-right,quote]
1833 Las barras de compás al principio de cada sistema son
1834 @internalsref{SystemStartBar}, @internalsref{SystemStartBrace} y
1835 @internalsref{SystemStartBracket}. En cada contexto solamente se
1836 crea uno de estos tipos, y ese tipo está determinado por la propiedad
1837 @internalsref{systemStartDelimiter}.
1842 Los delimitadores del comienzo del sistema se pueden anidar muchas veces:
1844 @lilypond[quote,ragged-right,verbatim]
1847 \set StaffGroup.systemStartDelimiterHierarchy
1848 = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
1859 @subsection Staff symbol
1861 @cindex ajuste del símbolo del pentagrama
1863 Las notas, signos dinámicos, etc. están agrupados con un conjunto de líneas horizontales
1864 que reciben el nombre de pentagrama o pauta (@q{staff}, en plural @q{staves}). En
1865 LilyPond, estas líneas se dibujan utilizando un objeto de presentación separado
1866 que se llama el @code{staff symbol} (el símbolo del pentagrama).
1868 El símbolo del pentagrama se puede ajustar en el número, grosor
1869 y separación de las líneas, usando las propiedades. Esto se demuestra en los
1871 @inputfileref{input/@/test,staff@/-lines@/.ly} y
1872 @inputfileref{input/@/test,staff@/-size@/.ly}.
1874 Además, los pentagramas se pueden iniciar e interrumpir libremente. Esto se
1875 hace con @code{\startStaff} y @code{\stopStaff}.
1877 @lilypond[verbatim,relative=2,fragment]
1879 \override Staff.StaffSymbol #'line-count = 2
1880 \stopStaff \startStaff
1882 \revert Staff.StaffSymbol #'line-count
1883 \stopStaff \startStaff
1887 En combinación con los pentagramas ocultos o franceses,
1888 esto se puede usar para componer tipográficamente secciones de ossia. He aquí un ejemplo:
1892 @lilypondfile{ossia.ly}
1894 @cindex pentagrama, establecer el número de líneas del
1895 @cindex pentagrama, establecer el grosor de las líneas del
1896 @cindex grosor de las líneas del pentagrama, establecer
1897 @cindex número de líneas del pentagrama, establecer
1901 Referencia del programa: @internalsref{StaffSymbol}.
1903 Ejemplos: @inputfileref{input/@/test,staff@/-lines@/.ly},
1904 @inputfileref{input/@/test@/,ossia.ly},
1905 @inputfileref{input/@/test,staff@/-size@/.ly},
1906 @lsr{staff,staff-line-positions.ly}
1909 @node Writing music in parallel
1910 @subsection Writing music in parallel
1912 @cindex Escribir música en paralelo
1913 @cindex Música intercalada
1915 La música para varias partes se puede intercalar
1917 @lilypond[quote,fragment,verbatim]
1918 \parallelMusic #'(voiceA voiceB) {
1919 r8 g'16[ c''] e''[ g' c'' e''] r8 g'16[ c''] e''[ g' c'' e''] |
1921 r8 a'16[ d''] f''[ a' d'' f''] r8 a'16[ d''] f''[ a' d'' f''] |
1925 \new Staff \new Voice \voiceA
1926 \new Staff \new Voice \voiceB
1930 Esto funciona de manera aceptable para música de piano
1932 @lilypond[quote,verbatim]
1936 \parallelMusic #'(voiceA voiceB voiceC voiceD) {
1938 r8 g'16[ c''] e''[ g' c'' e''] r8 g'16[ c''] e''[ g' c''
1941 r8 a16[ d'] f'[ a d' f'] r8 a16[ d'] f'[ a d' f'] |
1945 a'8 b' c'' d'' e'' f'' g'' a'' |
1947 c16 d e f d e f g e f g a f g a b |
1973 @node Connecting notes
1974 @section Connecting notes
1976 This section deals with notation that affects groups of notes.
1982 * Laissez vibrer ties::
1995 A tie connects two adjacent note heads of the same pitch. The tie in
1996 effect extends the length of a note. Ties should not be confused with
1997 slurs, which indicate articulation, or phrasing slurs, which indicate
1998 musical phrasing. A tie is entered using the tilde symbol @samp{~}
2000 @lilypond[quote,ragged-right,fragment,verbatim]
2001 e' ~ e' <c' e' g'> ~ <c' e' g'>
2004 When a tie is applied to a chord, all note heads whose pitches match
2005 are connected. When no note heads match, no ties will be created. Chords
2006 may be partially tied by placing the tie inside the chord,
2008 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2009 <c~ e g~ b> <c e g b>
2012 A tie is just a way of extending a note duration, similar to the
2013 augmentation dot. The following example shows two ways of notating
2014 exactly the same concept
2016 @lilypond[quote,fragment,ragged-right]
2017 \time 3/4 c'2. c'2 ~ c'4
2021 Ties are used either when the note crosses a bar line, or when dots
2022 cannot be used to denote the rhythm. When using ties, larger note
2023 values should be aligned to subdivisions of the measure, such as
2025 @lilypond[fragment,quote,ragged-right]
2027 r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
2031 If you need to tie a lot of notes over bars, it may be easier to use
2032 automatic note splitting (see @ref{Automatic note splitting}). This
2033 mechanism automatically splits long notes, and ties them across bar
2036 @funindex \repeatTie
2038 When a second alternative of a repeat starts with a tied note, you
2039 have to repeat the tie. This can be achieved with @code{\repeatTie},
2041 @lilypond[fragment,quote,ragged-right,relative=2]
2045 @cindex repeating ties
2046 @cindex volta brackets and ties
2050 Ties are sometimes used to write out arpeggios. In this case, two tied
2051 notes need not be consecutive. This can be achieved by setting the
2052 @code{tieWaitForNote} property to true. The same feature is also useful,
2053 for example, to tie a tremolo to a chord. For example,
2055 @lilypond[fragment,verbatim,relative=1,ragged-right,quote]
2056 \set tieWaitForNote = ##t
2057 \grace { c16[~ e~ g]~ } <c, e g>2
2058 \repeat "tremolo" 8 { c32~ c'~ } <c c,>1
2059 e8~ c~ a~ f~ <e' c a f>2
2062 Ties may be engraved manually by changing the @code{tie-configuration}
2063 property. The first number indicates the distance from the center
2064 of the staff in staff-spaces, and the second number indicates the
2065 direction (1=up, -1=down).
2067 @lilypond[fragment,verbatim,relative=1,ragged-right,quote]
2069 \override TieColumn #'tie-configuration =
2070 #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
2082 @funindex \tieNeutral
2084 @funindex \tieDotted
2086 @funindex \tieDashed
2094 In this manual: @ref{Automatic note splitting}.
2096 Program reference: @internalsref{Tie}.
2101 Switching staves when a tie is active will not produce a slanted tie.
2103 Changing clefs or octavations during a tie is not really
2104 well-defined. In these cases, a slur may be preferable.
2112 A slur indicates that notes are to be played bound or
2113 @emph{legato}. They are entered using parentheses
2115 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2116 f( g a) a8 b( a4 g2 f4)
2120 The direction of a slur can be specified with
2121 @code{\slur@emph{DIR}}, where @code{@emph{DIR}} is
2122 either @code{Up}, @code{Down}, or @code{Neutral} (automatically
2125 However, there is a convenient shorthand for forcing slur
2126 directions. By adding @code{_} or @code{^} before the opening
2127 parentheses, the direction is also set. For example,
2129 @lilypond[relative=2,ragged-right,quote,verbatim,fragment]
2133 Only one slur can be printed at once. If you need to print a long
2134 slur over a few small slurs, please see @ref{Phrasing slurs}.
2139 Some composers write two slurs when they want legato chords. This can
2140 be achieved in LilyPond by setting @code{doubleSlurs},
2142 @lilypond[verbatim,ragged-right,relative,fragment,quote]
2143 \set doubleSlurs = ##t
2144 <c e>4 ( <d f> <c e> <d f> )
2154 @funindex \slurNeutral
2155 @code{\slurNeutral},
2156 @funindex \slurDashed
2158 @funindex \slurDotted
2160 @funindex \slurSolid
2165 Program reference: @seeinternals{Slur}.
2168 @node Phrasing slurs
2169 @subsection Phrasing slurs
2171 @cindex phrasing slurs
2172 @cindex phrasing marks
2174 A phrasing slur (or phrasing mark) connects notes and is used to
2175 indicate a musical sentence. It is written using @code{\(} and @code{\)}
2178 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2179 \time 6/4 c'\( d( e) f( e) d\)
2182 Typographically, the phrasing slur behaves almost exactly like a
2183 normal slur. However, they are treated as different objects. A
2184 @code{\slurUp} will have no effect on a phrasing slur; instead, use
2185 @code{\phrasingSlurUp}, @code{\phrasingSlurDown}, and
2186 @code{\phrasingSlurNeutral}.
2188 You cannot have simultaneous phrasing slurs.
2193 @funindex \phrasingSlurUp
2194 @code{\phrasingSlurUp},
2195 @funindex \phrasingSlurDown
2196 @code{\phrasingSlurDown},
2197 @funindex \phrasingSlurNeutral
2198 @code{\phrasingSlurNeutral}.
2203 Program reference: @internalsref{PhrasingSlur}.
2206 @node Laissez vibrer ties
2207 @subsection Laissez vibrer ties
2208 @cindex Laissez vibrer
2209 @cindex Ties, laissez vibrer
2211 L.v. ties (laissez vibrer) indicate that notes must not be damped at the
2212 end. It is used in notation for piano, harp and other string and
2213 percussion instruments. They can be entered using @code{\laissezVibrer},
2215 @lilypond[fragment,ragged-right,verbatim,relative=1]
2216 <c f g>\laissezVibrer
2222 @internalsref{LaissezVibrerTie}
2223 @internalsref{LaissezVibrerTieColumn}
2226 @lsr{connecting,laissez-vibrer-ties.ly}
2229 @node Automatic beams
2230 @subsection Automatic beams
2232 LilyPond inserts beams automatically
2234 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2235 \time 2/4 c8 c c c \time 6/8 c c c c8. c16 c8
2238 When these automatic decisions are not good enough, beaming can be
2239 entered explicitly. It is also possible to define beaming patterns
2240 that differ from the defaults. See @ref{Setting automatic beam behavior}
2243 Individual notes may be marked with @code{\noBeam} to prevent them
2246 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2247 \time 2/4 c8 c\noBeam c c
2253 Program reference: @internalsref{Beam}.
2257 @subsection Manual beams
2259 @cindex beams, manual
2263 In some cases it may be necessary to override the automatic beaming
2264 algorithm. For example, the autobeamer will not put beams over rests
2265 or bar lines. Such beams are specified manually by marking the begin
2266 and end point with @code{[} and @code{]}
2268 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2270 r4 r8[ g' a r8] r8 g[ | a] r8
2277 @funindex stemLeftBeamCount
2278 @funindex stemRightBeamCount
2280 Normally, beaming patterns within a beam are determined automatically.
2281 If necessary, the properties @code{stemLeftBeamCount} and
2282 @code{stemRightBeamCount} can be used to override the defaults. If
2283 either property is set, its value will be used only once, and then it
2286 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2291 \set stemLeftBeamCount = #1
2296 The property @code{subdivideBeams} can be set in order to subdivide
2297 all 16th or shorter beams at beat positions, as defined by the
2298 @code{beatLength} property.
2300 @lilypond[fragment,quote,relative=2,verbatim]
2302 \set subdivideBeams = ##t
2304 \set Score.beatLength = #(ly:make-moment 1 8)
2307 @funindex subdivideBeams
2310 For more information about @code{make-moment}, see
2311 @ref{Time administration}.
2313 Line breaks are normally forbidden when beams cross bar lines. This
2314 behavior can be changed by setting @code{breakable}.
2318 @cindex beams and line breaks
2319 @cindex beams, kneed
2321 @cindex auto-knee-gap
2326 Kneed beams are inserted automatically when a large gap is detected
2327 between the note heads. This behavior can be tuned through the object.
2329 Automatically kneed cross-staff beams cannot be used together with
2330 hidden staves. See @ref{Hiding staves}.
2332 Beams do not avoid collisions with symbols around the notes, such as
2333 texts and accidentals.
2337 @subsection Grace notes
2342 @cindex appoggiatura
2343 @cindex acciaccatura
2345 Grace notes are ornaments that are written out. The most common ones
2346 are acciaccatura, which should be played as very short. It is denoted
2347 by a slurred small note with a slashed stem. The appoggiatura is a
2348 grace note that takes a fixed fraction of the main note, and is
2349 denoted as a slurred note in small print without a slash. They
2350 are entered with the commands @code{\acciaccatura} and
2351 @code{\appoggiatura}, as demonstrated in the following example
2353 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2354 b4 \acciaccatura d8 c4 \appoggiatura e8 d4
2355 \acciaccatura { g16[ f] } e4
2358 Both are special forms of the @code{\grace} command. By prefixing this
2359 keyword to a music expression, a new one is formed, which will be
2360 printed in a smaller font and takes up no logical time in a measure.
2362 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2364 \grace { c16[ d16] } c2 c4
2368 Unlike @code{\acciaccatura} and @code{\appoggiatura}, the
2369 @code{\grace} command does not start a slur.
2371 Internally, timing for grace notes is done using a second, @q{grace}
2372 timing. Every point in time consists of two rational numbers: one
2373 denotes the logical time, one denotes the grace timing. The above
2374 example is shown here with timing tuples
2376 @lilypond[quote,ragged-right]
2379 c4 \grace c16 c4 \grace {
2382 \new Lyrics \lyricmode {
2383 \override LyricText #'font-family = #'typewriter
2387 ( \fraction 1 4 , \fraction -1 16 ) } 16 }
2388 \markup { (\fraction 1 4 , 0 ) } 4
2390 \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
2391 \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
2393 \markup { ( \fraction 2 4 , 0 ) }
2398 The placement of grace notes is synchronized between different staves.
2399 In the following example, there are two sixteenth grace notes for
2400 every eighth grace note
2402 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2403 << \new Staff { e4 \grace { c16[ d e f] } e4 }
2404 \new Staff { c4 \grace { g8[ b] } c4 } >>
2407 @funindex \afterGrace
2409 If you want to end a note with a grace, use the @code{\afterGrace}
2410 command. It takes two arguments: the main note, and the grace notes
2411 following the main note.
2413 @lilypond[ragged-right, verbatim,relative=2,fragment]
2414 c1 \afterGrace d1 { c16[ d] } c4
2417 This will put the grace notes after a @q{space} lasting 3/4 of the
2418 length of the main note. The fraction 3/4 can be changed by setting
2419 @code{afterGraceFraction}, ie.
2422 afterGraceFraction = #(cons 7 8)
2426 will put the grace note at 7/8 of the main note.
2428 The same effect can be achieved manually by doing
2430 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2433 { s2 \grace { c16[ d] } } >>
2439 By adjusting the duration of the skip note (here it is a half-note),
2440 the space between the main-note and the grace is adjusted.
2442 A @code{\grace} section will introduce special typesetting settings,
2443 for example, to produce smaller type, and set directions. Hence, when
2444 introducing layout tweaks, they should be inside the grace section,
2447 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2459 The overrides should also be reverted inside the grace section.
2461 The layout of grace sections can be changed throughout the music using
2462 the function @code{add-grace-property}. The following example
2463 undefines the @code{Stem} direction for this grace, so
2464 that stems do not always point up.
2468 #(add-grace-property 'Voice 'Stem 'direction '())
2474 Another option is to change the variables @code{startGraceMusic},
2475 @code{stopGraceMusic}, @code{startAcciaccaturaMusic},
2476 @code{stopAcciaccaturaMusic}, @code{startAppoggiaturaMusic},
2477 @code{stopAppoggiaturaMusic}. More information is in the file
2478 @file{ly/@/grace@/-init@/.ly}.
2481 The slash through the stem in acciaccaturas can be obtained
2482 in other situations by @code{\override Stem #'stroke-style = #"grace"}.
2487 Grace notes may be forced to use floating spacing,
2489 @lilypond[relative=2,ragged-right]
2491 \override Score.SpacingSpanner #'strict-grace-spacing = ##t
2500 c'16[ c'16 c'16 c'16]
2501 c'16[ c'16 c'16 c'16]
2510 Program reference: @internalsref{GraceMusic}.
2515 A score that starts with a @code{\grace} section needs an explicit
2516 @code{\new Voice} declaration, otherwise the main note and the grace
2517 note end up on different staves.
2519 Grace note synchronization can also lead to surprises. Staff notation,
2520 such as key signatures, bar lines, etc., are also synchronized. Take
2521 care when you mix staves with grace notes and staves without, for example,
2523 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2524 << \new Staff { e4 \bar "|:" \grace c16 d4 }
2525 \new Staff { c4 \bar "|:" d4 } >>
2529 This can be remedied by inserting grace skips of the corresponding
2530 durations in the other staves. For the above example
2533 \new Staff @{ c4 \bar "|:" \grace s16 d4 @}
2536 Grace sections should only be used within sequential music
2537 expressions. Nesting or juxtaposing grace sections is not supported,
2538 and might produce crashes or other errors.
2542 @node Expressive marks
2543 @section Expressive marks
2545 Expressive marks help musicians to bring more to the music than simple
2550 * Fingering instructions::
2561 @subsection Articulations
2563 @cindex Articulations
2567 A variety of symbols can appear above and below notes to indicate
2568 different characteristics of the performance. They are added to a note
2569 by adding a dash and the character signifying the
2570 articulation. They are demonstrated here
2572 @lilypondfile[quote,ragged-right]{script-abbreviations.ly}
2574 The meanings of these shorthands can be changed. See
2575 @file{ly/@/script@/-init@/.ly} for examples.
2577 The script is automatically placed, but the direction can be forced as
2578 well. Like other pieces of LilyPond code, @code{_} will place them
2579 below the staff, and @code{^} will place them above.
2581 @lilypond[quote,ragged-right,fragment,verbatim]
2585 Other symbols can be added using the syntax
2586 @var{note}@code{\}@var{name}. Again, they
2587 can be forced up or down using @code{^} and @code{_},
2590 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
2591 c\fermata c^\fermata c_\fermata
2596 @cindex staccatissimo
2606 @cindex organ pedal marks
2615 @cindex prallmordent
2619 @cindex thumb marking
2624 Here is a chart showing all scripts available,
2626 @lilypondfile[ragged-right,quote]{script-chart.ly}
2631 The vertical ordering of scripts is controlled with the
2632 @code{script-priority} property. The lower this number, the closer it
2633 will be put to the note. In this example, the
2634 @internalsref{TextScript} (the sharp symbol) first has the lowest
2635 priority, so it is put lowest in the first example. In the second, the
2636 prall trill (the @internalsref{Script}) has the lowest, so it is on the
2637 inside. When two objects have the same priority, the order in which
2638 they are entered decides which one comes first.
2640 @lilypond[verbatim,relative=3,ragged-right,fragment,quote]
2641 \once \override TextScript #'script-priority = #-100
2642 a4^\prall^\markup { \sharp }
2644 \once \override Script #'script-priority = #-100
2645 a4^\prall^\markup { \sharp }
2651 Program reference: @internalsref{Script}.
2656 These signs appear in the printed output but have no effect on the
2657 MIDI rendering of the music.
2660 @node Fingering instructions
2661 @subsection Fingering instructions
2664 @cindex finger change
2666 Fingering instructions can be entered using
2668 @var{note}-@var{digit}
2670 For finger changes, use markup texts
2672 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
2674 c^\markup { \finger "2 - 3" }
2677 You can use the thumb-script to indicate that a note should be
2678 played with the thumb (e.g., in cello music)
2679 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
2680 <a_\thumb a'-3>8 <b_\thumb b'-3>
2683 Fingerings for chords can also be added to individual notes
2684 of the chord by adding them after the pitches
2685 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
2686 < c-1 e-2 g-3 b-5 >4
2692 You may exercise greater control over fingering chords by
2693 setting @code{fingeringOrientations}
2695 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
2696 \set fingeringOrientations = #'(left down)
2697 <c-1 es-2 g-4 bes-5 > 4
2698 \set fingeringOrientations = #'(up right down)
2699 <c-1 es-2 g-4 bes-5 > 4
2702 Using this feature, it is also possible to put fingering instructions
2703 very close to note heads in monophonic music,
2705 @lilypond[verbatim,ragged-right,quote,fragment]
2706 \set fingeringOrientations = #'(right)
2713 Program reference: @internalsref{Fingering}.
2715 Examples: @lsr{expressive,fingering-chords.ly}
2719 @subsection Dynamics
2740 Absolute dynamic marks are specified using a command after a note
2741 @code{c4\ff}. The available dynamic marks are @code{\ppppp},
2742 @code{\pppp}, @code{\ppp},
2743 @code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff},
2744 @code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff},
2745 @code{\sp}, @code{\spp}, @code{\sfz}, and @code{\rfz}.
2747 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
2748 c\ppp c\pp c \p c\mp c\mf c\f c\ff c\fff
2749 c2\fp c\sf c\sff c\sp c\spp c\sfz c\rfz
2756 A crescendo mark is started with @code{\<} and terminated with
2757 @code{\!} or an absolute dynamic. A decrescendo is started with
2758 @code{\>} and is also terminated with @code{\!} or an absolute
2759 dynamic. @code{\cr} and @code{\decr} may be used instead of
2760 @code{\<} and @code{\>}. Because these marks are bound to notes, you must
2761 use spacer notes if multiple marks are needed during one note
2763 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2765 << f1 { s4 s4\< s4\! \> s4\! } >>
2769 A hairpin normally starts at the left edge of the beginning note
2770 and ends on the right edge of the ending note. If the ending
2771 note falls on the downbeat, the hairpin ends on the immediately
2772 preceding barline. This may be modified by setting the
2773 @code{hairpinToBarline} property,
2775 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2776 \set hairpinToBarline = ##f
2780 In some situations the @code{\espressivo} articulation mark may
2781 be suitable to indicate a crescendo and decrescendo on the one note,
2783 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2784 c2 b4 a g1\espressivo
2787 This may give rise to very short hairpins. Use @code{minimum-length}
2788 in @internalsref{Voice}.@internalsref{Hairpin} to lengthen them, for
2792 \override Voice.Hairpin #'minimum-length = #5
2798 Hairpins may be printed with a circled tip (al niente notation) by
2799 setting the @code{circled-tip} property,
2801 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2802 \override Hairpin #'circled-tip = ##t
2812 You can also use text saying @emph{cresc.} instead of hairpins
2814 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2825 You can also supply your own texts
2826 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2827 \set crescendoText = \markup { \italic "cresc. poco" }
2828 \set crescendoSpanner = #'dashed-line
2832 To create new dynamic marks or text that should be aligned
2833 with dynamics, see @ref{New dynamic marks}.
2835 Vertical positioning of dynamics is handled by
2836 @internalsref{DynamicLineSpanner}.
2841 Dynamics that occur at, begin on, or end on, the same note
2842 will be vertically aligned. If you want to ensure that dynamics
2843 are aligned when they do not occur on the same note, you can
2844 increase the @code{staff-padding} property.
2847 \override DynamicLineSpanner #'staff-padding = #4
2850 You may also use this property if the dynamics are colliding
2851 with other notation.
2853 Crescendi and decrescendi that end on the first note of a
2854 new line are not printed. To change this behavior, use
2857 \override Score.Hairpin #'after-line-breaking = ##t
2860 Text style dynamic changes (such as @emph{cresc.} and @emph{dim.})
2862 dashed line showing their extent. To surpress printing this line, use
2865 \override DynamicTextSpanner #'dash-period = #-1.0
2871 @funindex \dynamicUp
2873 @funindex \dynamicDown
2874 @code{\dynamicDown},
2875 @funindex \dynamicNeutral
2876 @code{\dynamicNeutral}.
2881 Program reference: @internalsref{DynamicText}, @internalsref{Hairpin}.
2882 Vertical positioning of these symbols is handled by
2883 @internalsref{DynamicLineSpanner}.
2887 @subsection Breath marks
2889 Breath marks are entered using @code{\breathe}
2891 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2898 The glyph of the breath mark can be tuned by overriding the
2899 @code{text} property of the @code{BreathingSign} layout object with
2900 any markup text. For example,
2901 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2903 \override BreathingSign #'text
2904 = #(make-musicglyph-markup "scripts.rvarcomma")
2911 Program reference: @internalsref{BreathingSign}.
2913 Examples: @lsr{expressive,breathing-sign.ly}
2919 Short trills are printed like normal articulation; see @ref{Articulations}.
2921 Long running trills are made with @code{\startTrillSpan} and
2922 @code{\stopTrillSpan},
2924 @lilypond[verbatim,ragged-right,relative=2,quote,fragment]
2926 << { c1 \startTrillSpan }
2927 { s2. \grace { d16[\stopTrillSpan e] } } >>
2931 @cindex Pitched trills
2933 Trills that should be executed on an explicitly specified pitch can be
2934 typeset with the command @code{pitchedTrill},
2936 @lilypond[ragged-right,verbatim,fragment,relative=1,quote]
2937 \pitchedTrill c4\startTrillSpan fis
2941 The first argument is the main note. The pitch of the second
2942 is printed as a stemless note head in parentheses.
2947 @code{\startTrillSpan},
2948 @funindex \startTrillSpan
2949 @code{\stopTrillSpan}.
2950 @funindex \stopTrillSpan
2955 Program reference: @internalsref{TrillSpanner}.
2959 @subsection Glissando
2962 @funindex \glissando
2964 A glissando is a smooth change in pitch. It is denoted by a line or a
2965 wavy line between two notes. It is requested by attaching
2966 @code{\glissando} to a note
2968 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2970 \override Glissando #'style = #'zigzag
2977 Program reference: @internalsref{Glissando}.
2980 @lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
2986 Printing text over the line (such as @emph{gliss.}) is not supported.
2990 @subsection Arpeggio
2993 @cindex broken chord
2996 You can specify an arpeggio sign (also known as broken chord) on a
2997 chord by attaching an @code{\arpeggio} to a chord
2999 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3003 A square bracket on the left indicates that the player should not
3004 arpeggiate the chord
3006 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3011 The direction of the arpeggio is sometimes denoted by adding an
3012 arrowhead to the wiggly line
3014 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3026 When an arpeggio crosses staves, you may attach an arpeggio to the chords
3027 in both staves and set
3028 @internalsref{PianoStaff}.@code{connectArpeggios}
3030 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3032 \set PianoStaff.connectArpeggios = ##t
3033 \new Staff { <c' e g c>\arpeggio }
3034 \new Staff { \clef bass <c,, e g>\arpeggio }
3042 @funindex \arpeggioUp
3044 @funindex \arpeggioDown
3045 @code{\arpeggioDown},
3046 @funindex \arpeggioNeutral
3047 @code{\arpeggioNeutral},
3048 @funindex \arpeggioBracket
3049 @code{\arpeggioBracket}.
3054 Notation manual: @ref{Ties}, for writing out arpeggios.
3056 Program reference: @internalsref{Arpeggio}.
3061 It is not possible to mix connected arpeggios and unconnected
3062 arpeggios in one @internalsref{PianoStaff} at the same point in time.
3065 @node Falls and doits
3066 @subsection Falls and doits
3068 Falls and doits can be added to notes using the @code{\bendAfter}
3071 @lilypond[fragment,ragged-right,relative=2]
3072 \override Score.SpacingSpanner #'shortest-duration-space = #3.0
3081 Repetition is a central concept in music, and multiple notations exist
3087 * Repeats and MIDI::
3088 * Manual repeat commands::
3090 * Tremolo subdivisions::
3096 @subsection Repeat types
3101 The following types of repetition are supported
3105 Repeated music is fully written (played) out. This is useful when
3106 entering repetitious music. This is the only kind of repeat that
3107 is included in MIDI output.
3110 Repeats are not written out, but alternative endings (volte) are
3111 printed, left to right with brackets. This is the standard notation
3112 for repeats with alternatives. These are not played in MIDI output by
3117 Make tremolo beams. These are not played in MIDI output by default.
3120 Make beat or measure repeats. These look like percent signs. These
3121 are not played in MIDI output by default. Percent repeats must be
3122 declared within a @code{Voice} context.
3128 @subsection Repeat syntax
3132 @cindex seconda volta
3134 LilyPond has one syntactic construct for specifying different types of
3135 repeats. The syntax is
3138 \repeat @var{variant} @var{repeatcount} @var{repeatbody}
3141 If you have alternative endings, you may add
3142 @funindex \alternative
3153 where each @var{alternative} is a music expression. If you do not
3154 give enough alternatives for all of the repeats, the first alternative
3155 is assumed to be played more than once.
3157 Standard repeats are used like this
3159 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3161 \repeat volta 2 { c4 d e f }
3162 \repeat volta 2 { f e d c }
3165 With alternative endings
3167 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3169 \repeat volta 2 {c4 d e f}
3170 \alternative { {d2 d} {f f,} }
3173 In the following example, the first ending is not a complete
3174 bar (it only had 3 beats). The beginning of the second ending
3175 contains the 4th beat from the first ending. This @q{extra}
3176 beat in the second ending is due to the first time ending,
3177 and has nothing to do with the @code{\partial} at the
3178 beginning of the example.
3180 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3183 \repeat volta 4 { e | c2 d2 | e2 f2 | }
3184 \alternative { { g4 g g } { a | a a a a | b2. } }
3188 @funindex \repeatTie
3190 Ties may be added to a second ending,
3192 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3194 \repeat volta 2 {c4 d e f ~ }
3195 \alternative { {f2 d} {f\repeatTie f,} }
3198 It is possible to shorten volta brackets
3199 by setting @code{voltaSpannerDuration}. In the next example, the
3200 bracket only lasts one measure, which is a duration of 3/4.
3202 @lilypond[verbatim,ragged-right,quote]
3206 \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
3207 \repeat "volta" 5 { d d d }
3208 \alternative { { e e e f f f }
3218 Brackets for the repeat are normally only printed over the topmost
3219 staff. This can be adjusted by setting the @code{voltaOnThisStaff}
3222 @lsr{repeats,volta@/-multi@/-staff@/.ly}.
3227 @cindex repeat, ambiguous
3229 A nested repeat like
3238 is ambiguous, since it is is not clear to which @code{\repeat} the
3239 @code{\alternative} belongs. This ambiguity is resolved by always
3240 having the @code{\alternative} belong to the inner @code{\repeat}.
3241 For clarity, it is advisable to use braces in such situations.
3243 Timing information is not remembered at the start of an alternative,
3244 so after a repeat timing information must be reset by hand; for
3245 example, by setting @code{Score.measurePosition} or entering
3246 @code{\partial}. Similarly, slurs or ties are also not repeated.
3248 Volta brackets are not vertically aligned.
3251 @node Repeats and MIDI
3252 @subsection Repeats and MIDI
3254 @cindex expanding repeats
3255 @funindex \unfoldRepeats
3257 With a little bit of tweaking, all types of repeats can be present
3258 in the MIDI output. This is achieved by applying the
3259 @code{\unfoldRepeats} music function. This function changes all
3260 repeats to unfold repeats.
3262 @lilypond[quote,verbatim,fragment,line-width=8.0\cm]
3264 \repeat tremolo 8 {c'32 e' }
3265 \repeat percent 2 { c''8 d'' }
3266 \repeat volta 2 {c'4 d' e' f'}
3275 When creating a score file using @code{\unfoldRepeats} for MIDI,
3276 it is necessary to make two @code{\score} blocks: one for MIDI (with
3277 unfolded repeats) and one for notation (with volta, tremolo, and
3278 percent repeats). For example,
3286 \unfoldRepeats @var{..music..}
3292 @node Manual repeat commands
3293 @subsection Manual repeat commands
3295 @funindex repeatCommands
3297 The property @code{repeatCommands} can be used to control the layout of
3298 repeats. Its value is a Scheme list of repeat commands.
3301 @item @code{start-repeat}
3302 Print a @code{|:} bar line.
3304 @item @code{end-repeat}
3305 Print a @code{:|} bar line.
3307 @item @code{(volta @var{text})}
3308 Print a volta bracket saying @var{text}: The text can be specified as
3309 a text string or as a markup text, see @ref{Text markup}. Do not
3310 forget to change the font, as the default number font does not contain
3311 alphabetic characters;
3313 @item @code{(volta #f)}
3314 Stop a running volta bracket.
3317 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
3319 \set Score.repeatCommands = #'((volta "93") end-repeat)
3321 \set Score.repeatCommands = #'((volta #f))
3328 Program reference: @internalsref{VoltaBracket},
3329 @internalsref{RepeatedMusic},
3330 @internalsref{VoltaRepeatedMusic},
3331 @internalsref{UnfoldedRepeatedMusic}, and
3332 @internalsref{FoldedRepeatedMusic}.
3335 @node Tremolo repeats
3336 @subsection Tremolo repeats
3338 @cindex tremolo beams
3340 To place tremolo marks between notes, use @code{\repeat} with tremolo
3342 @lilypond[quote,verbatim,ragged-right]
3343 \new Voice \relative c' {
3344 \repeat "tremolo" 8 { c16 d16 }
3345 \repeat "tremolo" 4 { c16 d16 }
3346 \repeat "tremolo" 2 { c16 d16 }
3350 Tremolo marks can also be put on a single note. In this case, the
3351 note should not be surrounded by braces.
3352 @lilypond[quote,verbatim,ragged-right]
3353 \repeat "tremolo" 4 c'16
3356 Similar output is obtained using the tremolo subdivision, described in
3357 @ref{Tremolo subdivisions}.
3362 In this manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
3364 Program reference: @internalsref{Beam}, @internalsref{StemTremolo}.
3367 @node Tremolo subdivisions
3368 @subsection Tremolo subdivisions
3370 @cindex tremolo marks
3371 @funindex tremoloFlags
3373 Tremolo marks can be printed on a single note by adding
3374 @q{@code{:}[@var{number}]} after the note. The number indicates the
3375 duration of the subdivision, and it must be at least 8. A
3376 @var{length} value of 8 gives one line across the note stem. If the
3377 length is omitted, the last value (stored in @code{tremoloFlags}) is
3380 @lilypond[quote,ragged-right,verbatim,fragment]
3381 c'2:8 c':32 | c': c': |
3387 Tremolos entered in this way do not carry over into the MIDI output.
3392 In this manual: @ref{Tremolo repeats}.
3394 Elsewhere: @internalsref{StemTremolo}.
3397 @node Measure repeats
3398 @subsection Measure repeats
3400 @cindex percent repeats
3401 @cindex measure repeats
3403 In the @code{percent} style, a note pattern can be repeated. It is
3404 printed once, and then the pattern is replaced with a special sign.
3405 Patterns of one and two measures are replaced by percent-like signs,
3406 patterns that divide the measure length are replaced by slashes.
3407 Percent repeats must be declared within a @code{Voice} context.
3409 @lilypond[quote,verbatim,ragged-right]
3410 \new Voice \relative c' {
3411 \repeat "percent" 4 { c4 }
3412 \repeat "percent" 2 { c2 es2 f4 fis4 g4 c4 }
3416 Measure repeats of more than 2 measures get a counter, if you switch
3417 on the @code{countPercentRepeats} property,
3419 @lilypond[relative=2,fragment,quote,verbatim,ragged-right]
3421 \set countPercentRepeats = ##t
3422 \repeat "percent" 4 { c1 }
3428 Isolated percents can also be printed. This is done by putting a
3429 multi-measure rest with a different print function,
3431 @lilypond[fragment,verbatim,quote]
3432 \override MultiMeasureRest #'stencil
3433 = #ly:multi-measure-rest::percent
3442 Program reference: @internalsref{RepeatSlash},
3443 @internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
3444 @internalsref{DoublePercentRepeatCounter},
3445 @internalsref{PercentRepeatCounter},
3446 @internalsref{PercentRepeatedMusic}.