]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/es/user/basic-notation.itely
a5326f47e2ab1824ee30742e416f58f4d49bb845
[lilypond.git] / Documentation / es / user / basic-notation.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond.tely
3 @ignore
4     Translation of GIT committish: fdfdc2c6ad77635367916c8300db150fcf29a5a3
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  See TRANSLATION for details.
8 @end ignore
9
10
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
14
15 @node Basic notation
16 @chapter Basic notation
17
18 Este capítulo explica cómo usar las funcionalidades de notación básica.
19
20 @menu
21 * Pitches::                     
22 * Rhythms::                     
23 * Polyphony::                   
24 * Staff notation::              
25 * Connecting notes::            
26 * Expressive marks::            
27 * Repeats::                     
28 @end menu
29
30
31
32 @node Pitches
33 @section Pitches
34
35 Esta sección trata tómo especificar la altura de las notas.
36
37 @menu
38 * Normal pitches::              
39 * Accidentals::                 
40 * Cautionary accidentals::      
41 * Micro tones::                 
42 * Note names in other languages::  
43 * Relative octaves::            
44 * Octave check::                
45 * Transpose::                   
46 * Rests::                       
47 * Skips::                       
48 @end menu
49
50
51 @node Normal pitches
52 @subsection Normal pitches
53
54 @cindex Nombres de las notas
55 @cindex alturas
56
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
59
60 @lilypond[quote,fragment,verbatim,ragged-right]
61 \clef bass
62 c d e f g a b c'
63 @end lilypond
64
65 El nombre de la nota @code{c} se tipografía una octava por debajo del Do central.
66
67 @lilypond[quote,fragment,verbatim,ragged-right]
68 \clef treble
69 c1
70 \clef bass
71 c1
72 @end lilypond
73
74 @funindex '
75 @funindex ,
76
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.
81
82 @lilypond[quote,ragged-right,fragment,verbatim]
83 \clef treble
84 c' c'' e' g d'' d' d c
85 \clef bass
86 c, c,, e, g d,, d, d c
87 @end lilypond
88
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}.
93
94
95 @node Accidentals
96 @subsection Accidentals
97
98 @cindex nombres de las notas, holandés
99 @cindex nombres de las notas, por omisión
100
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.
104
105 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
106 a2 ais a aes
107 a2 aisis a aeses
108 @end lilypond
109
110 @noindent
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}
114
115 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
116 a2 as e es
117 @end lilypond
118
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
122
123 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
124 a4 aes a2
125 @end lilypond
126
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}.
132
133 @lilypond[fragment,quote,ragged-right,verbatim,relative]
134 \key d \major
135 d e f g
136 d e fis g
137 @end lilypond
138
139
140 @commonprop
141
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}
146
147 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
148 ceses4 ces cis c
149 \set Staff.extraNatural = ##f
150 ceses4 ces cis c
151 @end lilypond
152
153
154 @seealso
155
156 Referencia del programa: @internalsref{LedgerLineSpanner},
157 @internalsref{NoteHead}.
158
159
160 @node Cautionary accidentals
161 @subsection Cautionary accidentals
162
163 @cindex alteración recordatoria
164 @cindex alteración de precaución
165 @cindex alteración con paréntesis
166 @cindex recordatoria, alteración
167 @funindex ?
168 @cindex precaución, alteración de
169 @cindex paréntesis, alteración con
170 @funindex !
171
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.
179
180 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
181 cis cis cis! cis? c c? c! c
182 @end lilypond
183
184
185 @seealso
186
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}.
189
190
191 @node Micro tones
192 @subsection Micro tones
193
194 @cindex cuartos de tono
195 @cindex semi-bemoles, semi-sostenidos
196
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
199
200 @lilypond[verbatim,ragged-right,quote,relative=2,fragment]
201 \set Staff.extraNatural = ##f
202 ceseh ceh cih cisih
203 @end lilypond
204
205 Los microtonos también se exportan al archivo MIDI.
206
207
208 @refbugs
209
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.
213
214
215
216 @node Note names in other languages
217 @subsection Note names in other languages
218
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:
224
225 @c  Should this be made into a multitable?
226 @cindex idiomas, nombres de las notas en otros
227 @example
228                      Nombres de las notas      sostenido   bemol       doble        doble
229                                                                       sostenido     bemol
230
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
240 @end example
241
242 @noindent
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).
249
250 @noindent
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.
257
258 @c What about Turkish Maquam music and similar microtonal systems?
259 @c
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.
263
264 @example
265                     Nombres de las notas       semi-      semi-  sesqui-    sesqui-
266                                                sostenido  bemol  sostenido  bemol
267
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  
276 @end example
277
278
279
280 @node Relative octaves
281
282 @subsection Relative octaves
283
284 @cindex Relativo
285 @cindex Relativas, especificación de octavas
286 @funindex \relative
287
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
293
294 @example
295 \relative @var{altura_inicial} @var{expresión_musical}
296 @end example
297
298 @noindent
299 o bien
300
301 @example
302 \relative @var{expresión_musical}
303 @end example
304
305 @noindent
306 @code{c'} se usa por defecto si no se define una altura inicial.
307
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.
316
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
322 comienzo.
323
324 Aquí podemos ver el modo relativo en acción:
325 @lilypond[quote,fragment,ragged-right,verbatim]
326 \relative c'' {
327   b c d c b c bes a
328 }
329 @end lilypond
330
331 Las marcas de cambio de octava se utilizan para intervalos mayores de la cuarta
332
333 @lilypond[quote,ragged-right,fragment,verbatim]
334 \relative c'' {
335   c g c f, c' a, e''
336 }
337 @end lilypond
338
339 Si el elemento anterior es un acorde, la primera nota del acorde se utiliza para
340 determinar la primera nota del siguiente acorde
341
342 @lilypond[quote,ragged-right,fragment,verbatim]
343 \relative c' {
344   c <c e g>
345   <c' e g>
346   <c, e' g>
347 }
348 @end lilypond
349
350 La altura después del @code{\relative} contiene un nombre de nota.
351
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}.
356
357
358 @node Octave check
359 @subsection Octave check
360
361 @cindex Comprobación de octava
362
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,
366
367 @example
368 \relative c'' @{ c='' b=' d,='' @}
369 @end example
370
371 @noindent
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'}.
377
378 También existe una comprobación de octava que no produce ninguna salida visible.
379 La sintaxis
380
381 @example
382 \octave @var{altura}
383 @end example
384
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.
389
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.
396
397 @example
398 \relative c' @{
399   e
400   \octave a'
401   \octave b'
402 @}
403 @end example
404
405
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.
411
412 @lilypond[quote,ragged-right,verbatim,fragment]
413 \relative c' {
414   e
415   \octave b
416   a
417 }
418 @end lilypond
419
420
421 @node Transpose
422 @subsection Transpose
423
424 @cindex Transposición
425 @cindex Transposición de alturas
426 @funindex \transpose
427
428 A music expression can be transposed with @code{\transpose}.  The
429 syntax is
430 @example
431 \transpose @var{desde} @var{hacia} @var{expresión_musical}
432 @end example
433
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}.
437
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
441 @example
442 \transpose d e @dots{}
443 @end example
444
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:
449
450 @example
451 \transpose a c @dots{}
452 @end example
453
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
458
459
460 @lilypond[quote,ragged-right,verbatim]
461 mus = { \key d \major cis d fis g }
462 \new Staff {
463   \clef "F" \mus
464   \clef "G"
465   \transpose c g' \mus
466   \transpose c f' \mus
467 }
468 @end lilypond
469
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
475
476 @example
477 \transpose c bes @{ e4 @dots{} @}
478 @end example
479
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}
483
484 @example
485 \transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @}
486 @end example
487
488
489 @seealso
490
491 Referencia del programa: @internalsref{TransposedMusic}.
492
493 Ejemplo: @inputfileref{input/@/test,smart@/-transpose@/.ly}.
494
495
496 @refbugs
497
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
501 @code{\transpose}.
502
503
504 @node Rests
505 @subsection Rests
506 @cindex Silencios
507
508 @funindex \rest
509 @funindex r
510
511 Los silencios se introducen como notas con el nombre @code{r}
512
513 @lilypond[fragment,quote,ragged-right,verbatim]
514 r1 r2 r4 r8
515 @end lilypond
516
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}.
521
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
524 aparecer la nota:
525
526 @lilypond[fragment,quote,ragged-right,verbatim]
527 a'4\rest d'4\rest
528 @end lilypond
529
530 @noindent
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.
533
534 @seealso
535
536 Referencia del programa: @internalsref{Rest}.
537
538
539 @node Skips
540 @subsection Skips
541
542 @cindex Desplazamiento
543 @cindex Silencio invisible
544 @cindex Nota de espaciado
545 @funindex \skip
546 @funindex s
547
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}}
550
551 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
552 a4 a4 s4 a4 \skip 1 a4
553 @end lilypond
554
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}
558
559 @lilypond[quote,ragged-right,verbatim]
560 <<
561   \relative { a'2 a2 }
562   \new Lyrics \lyricmode { \skip 2 bla2 }
563 >>
564 @end lilypond
565
566 El comando skip es un mero contenedor musical vacío.  No produce
567 ninguna salida, ni siguiera una salida transparente.
568
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.
572
573 @lilypond[quote,ragged-right,verbatim]
574 { s4 }
575 @end lilypond
576
577 El fragmento @code{@{ \skip 4 @} } produciría una página vacía.
578
579 @seealso
580
581 Referencia del programa: @internalsref{SkipMusic}.
582
583
584
585 @node Rhythms
586 @section Rhythms
587
588 Esta sección trata los ritmos, duraciones y compases.
589
590 @menu
591 * Durations::                   
592 * Augmentation dots::           
593 * Tuplets::                     
594 * Scaling durations::           
595 * Bar check::                   
596 * Barnumber check::             
597 * Automatic note splitting::    
598 @end menu
599
600
601 @node Durations
602 @subsection Durations
603
604 @cindex duración
605 @funindex \longa
606 @funindex \breve
607 @funindex \maxima
608
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
615 @code{\breve}
616
617 @example
618 c'\breve
619 c'1 c'2 c'4 c'8 c'16 c'32 c'64 c'64
620 r\longa r\breve
621 r1 r2 r4 r8 r16 r32 r64 r64
622 @end example
623
624 @lilypond[quote]
625 \score {
626 \relative c'' {
627     a\breve*1/2 \autoBeamOff
628     a1 a2 a4 a8 a16 a32 a64 a64
629    \bar "empty"
630    \break
631     r\longa*1/4 r\breve *1/2
632     r1 r2 r4 r8 r16 r32 r64 r64
633   }
634   \layout {
635     ragged-right = ##t
636     indent=0\mm
637     \context {
638       \Score
639         \remove "Bar_number_engraver"
640     }
641     \context {
642       \Staff
643         \remove "Clef_engraver"
644         \override StaffSymbol #'transparent = ##t
645         \override TimeSignature #'transparent = ##t
646         \override BarLine #'transparent = ##t
647         \consists "Pitch_squash_engraver"
648     }
649   }
650 }
651 @end lilypond
652
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
655 negra.
656
657 @lilypond[quote,ragged-right,verbatim,fragment]
658 { a a a2 a a4 a a1 a }
659 @end lilypond
660
661
662 @node Augmentation dots
663 @subsection Augmentation dots
664
665 @funindex .
666
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.
670
671 @lilypond[quote,ragged-right,fragment,verbatim]
672 a'4 b' c''4. b'8 a'4. b'4.. c''8.
673 @end lilypond
674
675 @refcommands
676
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
680 en particular
681
682 @funindex \dotsUp
683 @code{\dotsUp},
684 @funindex \dotsDown
685 @code{\dotsDown},
686 @funindex \dotsNeutral
687 @code{\dotsNeutral}.
688
689 @seealso
690
691 Referencia del programa: @internalsref{Dots} y @internalsref{DotColumn}.
692
693
694 @node Tuplets
695 @subsection Tuplets
696
697 @cindex grupos especiales
698 @cindex tresillos
699 @funindex \times
700
701 Los grupos especiales se obtienen a partir de una expresión musical
702 multiplicando todas las duraciones por una fracción:
703
704 @example
705 \times @var{fracción} @var{expresión_musical}
706 @end example
707
708 @noindent
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
714
715 @lilypond[quote,ragged-right,fragment,verbatim]
716 g'4 \times 2/3 {c'4 c' c'} d'4 d'4
717 @end lilypond
718
719 Los grupos pueden anidarse unos dentro de otros, por ejemplo
720
721 @lilypond[fragment,ragged-right,verbatim,relative=2]
722 \override TupletNumber #'text = #tuplet-number::calc-fraction-text
723 \times 4/6 {
724   a4 a
725   \times 3/5 { a a a a a }
726 }
727 @end lilypond
728
729 @refcommands
730
731 @funindex \tupletUp
732 @code{\tupletUp},
733 @funindex \tupletDown
734 @code{\tupletDown},
735 @funindex \tupletNeutral
736 @code{\tupletNeutral}.
737
738
739 @commonprop
740
741 @funindex tupletNumberFormatFunction
742 @cindex formateo de los grupos especiales
743
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
749
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 }
753 @end lilypond
754
755 @noindent
756 Para ver más información sobre @code{make-moment}, consulte
757 @ref{Time administration}.
758
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}
763
764 Para que no se impriman los números de los grupos, emplee
765
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 }
770 @end lilypond
771
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
775 siguiente
776
777 @lilypond[ragged-right]
778 \new RhythmicStaff {
779   \set tupletFullLength = ##t
780   \time 4/4
781   \times 4/5 {
782     c4 c1
783   }
784   \set tupletFullLengthNote = ##t
785   \time 2/4
786   \times 2/3 {
787     c4 c c 
788   }
789   \time 3/4
790   c4 
791 }
792 @end lilypond
793
794
795 @seealso
796
797 Referencia del programa: @internalsref{TupletBracket},
798 @internalsref{TupletNumber} y @internalsref{TimeScaledMusic}.
799
800
801
802 @node Scaling durations
803 @subsection Scaling durations
804
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}.
809
810 En el siguiente ejemplo las tres primeras notas duran exactamente dos
811 partes, pero no se imprime ningún corchete de tresillo.
812
813 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
814 \time 2/4
815 a4*2/3 gis4*2/3 a4*2/3
816 a4 a4 a4*2
817 b16*4 c4
818 @end lilypond
819
820
821 @seealso
822
823 En este manual: @ref{Tuplets}
824
825
826 @node Bar check
827 @subsection Bar check
828
829 @cindex Compás, comprobación de
830 @funindex barCheckSynchronize
831 @funindex |
832
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
838 @example
839 \time 3/4 c2 e4 | g2 |
840 @end example
841
842 Las comprobaciones de compás también se pueden usar en la letra de las canciones, por ejemplo
843
844 @example
845 \lyricmode @{
846   \time 2/4
847   Cam -- pa | ni -- tas 
848 @}
849 @end example
850
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.
857
858 @funindex |
859 @funindex pipeSymbol
860
861 También es posible redefinir el significado de @code{|}.  Se hace
862 asignando una expresión musical a @code{pipeSymbol},
863
864 @lilypond[quote,ragged-right,verbatim]
865 pipeSymbol = \bar "||"
866
867 { c'2 c' | c'2 c' }
868 @end lilypond
869
870
871 @node Barnumber check
872 @subsection Barnumber check
873
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
877
878 @verbatim
879 \barNumberCheck #123
880 @end verbatim
881
882 @noindent
883 imprimirá una advertencia si el @code{currentBarNumber} (número del
884 compás actual) no es 123 cuando se está procesando.
885
886
887 @node Automatic note splitting
888 @subsection Automatic note splitting
889
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.
895
896 @lilypond[quote,fragment,verbatim,relative=1,line-width=12\cm]
897 \new Voice \with {
898   \remove "Note_heads_engraver"
899   \consists "Completion_heads_engraver"
900 } {
901   c2. c8 d4 e f g a b c8 c2 b4 a g16 f4 e d c8. c2
902 }
903 @end lilypond
904
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.
909
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}.
913
914
915 @refbugs
916
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.
920
921
922 @code{Completion_heads_engraver} afecta sólo a las notas; no divide
923 silencios.
924
925
926 @seealso
927
928 Referencia del programa: @internalsref{Completion_heads_engraver}.
929
930
931 @node Polyphony
932 @section Polyphony
933
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.
937
938
939 @menu
940 * Chords::                      
941 * Stems::                       
942 * Basic polyphony::             
943 * Explicitly instantiating voices::  
944 * Collision Resolution::        
945 @end menu
946
947
948 @node Chords
949 @subsection Chords
950
951 @cindex Acordes
952
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.
956
957 @lilypond[verbatim,ragged-right,fragment,quote,relative=1]
958 <c e g>4 <c>8
959 @end lilypond
960
961 Para ver más información sobre los acordes, consulte @ref{Chord names}.
962
963
964 @node Stems
965 @subsection Stems
966
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.
970
971
972 @refcommands
973
974 @funindex \stemUp
975 @code{\stemUp},
976 @funindex \stemDown
977 @code{\stemDown},
978 @funindex \stemNeutral
979 @code{\stemNeutral}.
980
981
982 @commonprop
983
984 Para modificar la dirección de las plicas en medio de un pentragrama, utilice
985
986 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
987 a4 b c b
988 \override Stem #'neutral-direction = #up
989 a4 b c b
990 \override Stem #'neutral-direction = #down
991 a4 b c b
992 @end lilypond
993
994
995 @node Basic polyphony
996 @subsection Basic polyphony
997
998 @cindex polyphony
999
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{\\}
1003
1004 @funindex \\
1005
1006 @lilypond[quote,verbatim,fragment]
1007 \new Staff \relative c' {
1008   c16 d e f
1009   <<
1010     { g4 f e | d2 e2 } \\
1011     { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
1012     { s2. | s4 b4 c2 }
1013   >>
1014 }
1015 @end lilypond
1016
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}.
1019 @cindex capas
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.
1023
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.
1037
1038 @cindex cabezas de nota, estilos de
1039
1040 @lilypond[quote,verbatim,fragment]
1041 \new Staff \relative c' {
1042   \override NoteHead #'style = #'cross
1043   c16 d e f
1044   <<
1045     { g4 f e } \\
1046     { \override NoteHead #'style = #'triangle
1047     r8 e4 d c8 ~ }
1048   >> |
1049   <<
1050     { d2 e2 } \\
1051     { c8 b16 a b8 g ~ g2 } \\
1052     { \override NoteHead #'style = #'slash s4 b4 c2 }
1053   >>
1054 }
1055 @end lilypond
1056
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.
1060
1061 @example
1062 \relative @{ notaA << notaB \\ notaC >> notaD @}
1063 @end example
1064
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
1067 @code{notaA}.
1068
1069
1070 @node Explicitly instantiating voices
1071 @subsection Explicitly instantiating voices
1072
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.
1077
1078 Concretamente:
1079 @example
1080 << \superior \\ \inferior >>
1081 @end example
1082
1083 @noindent
1084 equivale a
1085
1086 @example
1087 <<
1088   \new Voice = "1" @{ \voiceOne \superior @}
1089   \new Voice = "2" @{ \voiceTwo \inferior @}
1090 >>
1091 @end example
1092
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.
1099
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.
1105
1106 @lilypond[quote,ragged-right,verbatim]
1107 \new Staff \relative c' {
1108   \override NoteHead #'style = #'cross
1109   c16 d e f
1110   \voiceOne
1111   <<
1112     { g4 f e | d2 e2 }
1113     \new Voice="1" { \voiceTwo
1114       r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1115       \oneVoice
1116     }
1117     \new Voice { \voiceThree
1118       s2. | s4 b4 c2
1119       \oneVoice
1120     }
1121   >>
1122   \oneVoice
1123 }
1124 @end lilypond
1125
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' {
1129   c16^( d e f
1130   \voiceOne
1131   <<
1132     { g4 f e | d2 e2) }
1133     \context Voice="1" { \voiceTwo
1134       r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2
1135       \oneVoice
1136     }
1137     \new Voice { \voiceThree
1138       s2. s4 b4 c2
1139       \oneVoice
1140     }
1141   >>
1142   \oneVoice
1143 }
1144 @end lilypond
1145
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.
1149
1150 @lilypond[quote,ragged-right,verbatim]
1151 \new Staff \relative c' {
1152   c16^( d e f
1153   \voiceOne
1154   <<
1155     { g4 f e | d2 e2) }
1156     \context Voice="1" { \voiceTwo
1157       r8 e4 d c8 ~ |
1158       <<
1159         {c8 b16 a b8 g ~ g2}
1160         \new Voice { \voiceThree
1161           s4 b4 c2
1162           \oneVoice
1163         }
1164       >>
1165     \oneVoice
1166     }
1167   >>
1168   \oneVoice
1169 }
1170 @end lilypond
1171
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:
1176
1177 @lilypond[quote,verbatim,ragged-right,relative=2]
1178 voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
1179
1180 \relative c''' <<
1181   { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
1182   { \voiceThree  b4} \\
1183   { \voiceFive d,} \\
1184   { \voiceTwo g,}
1185 >>
1186 @end lilypond
1187
1188
1189 @node Collision Resolution
1190 @subsection Collision Resolution
1191
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:
1196
1197 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
1198 \new Voice << {
1199   g8 g8
1200   \override Staff.NoteCollision
1201     #'merge-differently-dotted = ##t
1202   g8 g8
1203 } \\ { g8.[ f16] g8.[ f16] } >>
1204 @end lilypond
1205
1206 De forma similar puede mezclar cabezas de blanca con corcheas,
1207 ajustando @code{merge-differently-headed}:
1208
1209 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
1210 \new Voice << {
1211   c8 c4.
1212   \override Staff.NoteCollision
1213     #'merge-differently-headed = ##t
1214 c8 c4. } \\ { c2 c2 } >>
1215 @end lilypond
1216
1217 @noindent
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).
1220
1221 LilyPond también desplaza verticalmente los silencios que están en el lado contrario de una plica,
1222 por ejemplo
1223
1224 @lilypond[quote,ragged-right,fragment,verbatim]
1225 \new Voice << c''4 \\ r4 >>
1226 @end lilypond
1227
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.
1237
1238 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1239 \override Staff.NoteCollision #'merge-differently-headed = ##t
1240 <<
1241   { d=''2 g2 } \\
1242   { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
1243   { \voiceFour e,,2 e'2}
1244 >>
1245 <<
1246   { d'=''2 \shiftOn g2 } \\ 
1247   { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
1248   { \voiceFour e,,2 e'2}
1249 >>
1250 @end lilypond
1251
1252
1253 @refcommands
1254
1255 @funindex \oneVoice
1256 @code{\oneVoice},
1257 @funindex \voiceOne
1258 @code{\voiceOne},
1259 @funindex \voiceTwo
1260 @code{\voiceTwo},
1261 @funindex \voiceThree
1262 @code{\voiceThree},
1263 @funindex \voiceFour
1264 @code{\voiceFour}.
1265
1266 @funindex \shiftOn
1267 @code{\shiftOn},
1268 @funindex \shiftOnn
1269 @code{\shiftOnn},
1270 @funindex \shiftOnnn
1271 @code{\shiftOnnn},
1272 @funindex \shiftOff
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
1278 más grandes.
1279
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.
1284
1285 @lilypond[quote,verbatim,ragged-right]
1286 \relative <<
1287 {
1288   <d g>
1289   <d g>
1290 } \\ {
1291   <b f'>
1292   \once \override NoteColumn #'force-hshift = #1.7
1293   <b f'>
1294 } >>
1295 @end lilypond
1296
1297
1298 @seealso
1299
1300 Referencia del programa: los objetos responsables de resolver las colisiones son
1301 @internalsref{NoteCollision} y @internalsref{RestCollision}.
1302
1303
1304 @refbugs
1305
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.
1308
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}).
1313
1314
1315
1316 @node Staff notation
1317 @section Staff notation
1318
1319 @cindex Notación de los pentagramas
1320
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.
1323
1324 @menu
1325 * Clef::                        
1326 * Key signature::               
1327 * Time signature::              
1328 * Partial measures::            
1329 * Bar lines::                   
1330 * Unmetered music::             
1331 * System start delimiters::     
1332 * Staff symbol::                
1333 * Writing music in parallel::   
1334 @end menu
1335
1336
1337 @node Clef
1338 @subsection Clef
1339
1340 @funindex \clef
1341
1342 La clave indica qué líneas del pentagrama corresponden a qué
1343 notas.  La clave se establece con el comando @code{\clef} 
1344
1345 @lilypond[quote,ragged-right,fragment,verbatim]
1346 { c''2 \clef alto g'2 }
1347 @end lilypond
1348
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)
1360
1361 Las claves soportadas son
1362
1363 @multitable @columnfractions .33 .66
1364 @headitem Clave @tab Posición
1365 @item @code{treble}, violin, G, G2 @tab
1366 clave de Sol en 2ª
1367 @item @code{alto, C} @tab
1368 clave de Do en 3ª
1369 @item @code{tenor} @tab
1370 clave de Do en 4ª
1371 @item @code{bass, F} @tab
1372 clave de Fa en 4ª
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
1376 clave de Do en 1ª
1377 @item @code{mezzosoprano} @tab
1378 clave de Do en 2ª
1379 @item @code{baritone} @tab
1380 clave de Do en 5ª
1381 @item @code{varbaritone} @tab
1382 clave de Fa en 3ª
1383 @item @code{subbass} @tab
1384 clave de Fa en 5ª
1385 @item @code{percussion} @tab
1386 clave de percusión
1387 @item @code{tab} @tab
1388 clave de tablatura
1389 @end multitable
1390
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
1395 ejemplo:
1396
1397 @cindex clave de tenor coral
1398 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
1399 \clef "G_8" c4
1400 @end lilypond
1401
1402
1403 @commonprop
1404
1405 El comando @code{\clef "treble_8"} equivale a establecer
1406 @code{clefGlyph},
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.
1411
1412 @lilypond[quote,ragged-right,verbatim]
1413 {
1414   \set Staff.clefGlyph = #"clefs.F"
1415   \set Staff.clefPosition = #2
1416   c'4
1417   \set Staff.clefGlyph = #"clefs.G"
1418   c'4
1419   \set Staff.clefGlyph = #"clefs.C"
1420   c'4
1421   \set Staff.clefOctavation = #7
1422   c'4
1423   \set Staff.clefOctavation = #0
1424   \set Staff.clefPosition = #0
1425   c'4
1426   \clef "bass"
1427   c'4
1428   \set Staff.middleCPosition = #4
1429   c'4
1430 }
1431 @end lilypond
1432
1433
1434 @seealso
1435
1436 Manual: @ref{Grace notes}.
1437
1438 Referencia del programa: @internalsref{Clef}.
1439
1440
1441 @node Key signature
1442 @subsection Key signature
1443
1444 @cindex Armadura de la tonalidad
1445 @funindex \key
1446
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
1449 pentagrama.
1450
1451 El establecimiento o modificación de la armadura se hace con el comando @code{\key}
1452
1453 @example
1454 @code{\key} @var{nota} @var{tipo}
1455 @end example
1456
1457 @funindex \minor
1458 @funindex \major
1459 @funindex \minor
1460 @funindex \ionian
1461 @funindex \locrian
1462 @funindex \aeolian
1463 @funindex \mixolydian
1464 @funindex \lydian
1465 @funindex \phrygian
1466 @funindex \dorian
1467 @cindex modos eclesiásticos
1468
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).
1474
1475 Este comando establece la propiedad de contexto
1476 @code{Staff.keySignature}.  Se pueden especificar armaduras no estándar
1477 estableciendo esta propiedad directamente.
1478
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}.
1482
1483 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
1484 \key g \major
1485 f1
1486 fis
1487 @end lilypond
1488
1489
1490 @commonprop
1491
1492 Se imprime un símbolo de becuadro para cancelar las alteraciones anteriores.  Se puede
1493 suprimir esto estableciendo la propiedad @code{Staff.printKeyCancellation}.
1494
1495 @lilypond[quote,fragment,ragged-right,fragment,verbatim,relative=2]
1496 \key d \major
1497 a b cis d
1498 \key g \minor
1499 a bes c d
1500 \set Staff.printKeyCancellation = ##f
1501 \key d \major
1502 a b cis d
1503 \key g \minor
1504 a bes c d
1505 @end lilypond
1506
1507
1508 @seealso
1509
1510 Referencia del programa: @internalsref{KeyCancellation},
1511 @internalsref{KeySignature}.
1512
1513
1514 @node Time signature
1515 @subsection Time signature
1516
1517 @cindex Indicación de compás
1518 @cindex metro, medida
1519 @funindex \time
1520
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
1523 pentagrama.
1524
1525 La indicación de compás se estbablece mediante el comando @code{\time}
1526
1527 @lilypond[quote,ragged-right,fragment,verbatim]
1528 \time 2/4 c'2 \time 3/4 c'2.
1529 @end lilypond
1530
1531 @commonprop
1532
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
1535 de 2/2,
1536
1537 @lilypond[fragment,quote,ragged-right,verbatim]
1538 \time 4/4 c'1
1539 \time 2/2 c'1
1540 \override Staff.TimeSignature #'style = #'()
1541 \time 4/4 c'1
1542 \time 2/2 c'1
1543 @end lilypond
1544
1545 Existen muchas opciones para su presentación.  Consulte @ref{Ancient time
1546 signatures} para ver más ejemplos.
1547
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.
1554
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)}
1562
1563 @lilypond[quote,ragged-right,verbatim]
1564 \score {
1565   \relative c'' {
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))
1569     a4. g4
1570   }
1571   \layout {
1572     \context {
1573       \Staff
1574       \consists "Measure_grouping_engraver"
1575     }
1576   }
1577 }
1578 @end lilypond
1579
1580
1581 @seealso
1582
1583 Referencia del programa: @internalsref{TimeSignature} y
1584 @internalsref{Timing_translator}.
1585
1586 Ejemplos: @inputfileref{input/@/test,compound@/-time@/.ly}.
1587
1588
1589 @refbugs
1590
1591 EL barrado automático no utiliza la agrupación de compases especificada con
1592 @code{set-time-signature}.
1593
1594
1595 @node Partial measures
1596 @subsection Partial measures
1597
1598 @cindex anacrusa
1599 @cindex parte al alzar
1600 @cindex compás parcial
1601 @cindex parcial, compás
1602 @cindex acortar compases
1603 @funindex \partial
1604
1605 Los comases parciales como las anacrusas o partes al alzar se escriben
1606 usando la construcción
1607
1608 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
1609 \partial 16*5 c16 cis d dis e | a2. c,4 | b2
1610 @end lilypond
1611
1612 La sintaxis de este comando es la siguiente:
1613
1614 @example
1615 \partial @var{duración}
1616 @end example
1617
1618 donde @code{duración} es el valor rítmico que se se debe añadir antes del siguiente compás.
1619
1620 Esto se traduce internamente a
1621
1622 @example
1623 \set Timing.measurePosition = -@var{longitud de la duración}
1624 @end example
1625
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}.
1630
1631
1632 @refbugs
1633
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
1637
1638 @lilypond[verbatim,quote,ragged-right,relative,fragment]
1639 \grace f16
1640 \partial 4
1641 g4
1642 a2 g2
1643 @end lilypond
1644
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
1647 desagradables.
1648
1649
1650 @node Bar lines
1651 @subsection Bar lines
1652
1653 @cindex Barras de compás
1654 @funindex \bar
1655 @cindex líneas divisorias
1656 @cindex barras de repetición
1657
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.
1661
1662 Se pueden forzar tipos especiales de línea divisoria con 
1663 el comando @code{\bar}
1664
1665 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
1666 c4 \bar "|:" c4
1667 @end lilypond
1668
1669 Se encuentran disponibles los siguientes tipos de barra:
1670
1671 @lilypondfile[ragged-right,quote]{bar-lines.ly}
1672
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
1676 la línea siguiente.
1677
1678 Para permitir un salto de línea donde no hay ninguna línea divisoria visible,
1679 utilice
1680
1681 @example
1682 \bar ""
1683 @end example
1684
1685 @noindent
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).
1688
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}.
1692
1693 @lilypond[quote,ragged-right,fragment,verbatim]
1694 <<
1695   \new StaffGroup <<
1696     \new Staff {
1697       e'4 d'
1698       \bar "||"
1699       f' e'
1700     }
1701     \new Staff { \clef bass c4 g e g }
1702   >>
1703   \new Staff { \clef bass c2 c2 }
1704 >>
1705 @end lilypond
1706
1707
1708 @commonprop
1709
1710 @funindex whichBar
1711 @funindex repeatCommands
1712 @funindex defaultBarType
1713
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.
1717
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.
1722
1723 Le recomendamos que utilice siempre @code{\repeat} para hacer repeticiones.
1724 Consulte @ref{Repeats}.
1725
1726
1727 @seealso
1728
1729 En este manual: @ref{Repeats}, @ref{System start delimiters}.
1730
1731 Referencia del programa: @internalsref{BarLine} (creada al nivel de
1732 @internalsref{Staff} (pentagrama)), @internalsref{SpanBar} (a través de los pentagramas).
1733
1734
1735 @node Unmetered music
1736 @subsection Unmetered music
1737
1738 @cindex cadencia
1739 @funindex \cadenzaOn
1740 @funindex \cadenzaOff
1741
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}.
1746
1747 @lilypond[verbatim,quote,ragged-right,relative=2,fragment]
1748 c4 d e d
1749 \cadenzaOn
1750 c4 c d8 d d f4 g4.
1751 \cadenzaOff
1752 \bar "|"
1753 d4 e d c
1754 @end lilypond
1755
1756
1757 @refbugs
1758
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
1762
1763 @example
1764 \bar ""
1765 @end example
1766
1767 @noindent
1768 para indicar dónde se pueden producir los saltos.
1769
1770
1771 @node System start delimiters
1772 @subsection System start delimiters
1773
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
1781
1782 Muchas partituras constan de más de un pentagrama.  Estos pentagramas se pueden
1783 unir de cuatro formas distintas:
1784
1785 @itemize @bullet
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}.
1788
1789 @lilypond[verbatim,ragged-right,quote]
1790 \new GrandStaff
1791 \relative <<
1792   \new Staff { c1 c }
1793   \new Staff { c c }
1794 >>
1795 @end lilypond
1796
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}
1799
1800 @lilypond[verbatim,ragged-right,quote]
1801 \new StaffGroup
1802 \relative <<
1803   \new Staff { c1 c }
1804   \new Staff { c c }
1805 >>
1806 @end lilypond
1807
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}.
1810
1811 @lilypond[verbatim,ragged-right,quote]
1812 \new ChoirStaff
1813 \relative <<
1814   \new Staff { c1 c }
1815   \new Staff { c c }
1816 >>
1817 @end lilypond
1818
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.
1821
1822 @lilypond[verbatim,ragged-right,quote]
1823 \relative <<
1824   \new Staff { c1 c }
1825   \new Staff { c c }
1826 >>
1827 @end lilypond
1828 @end itemize
1829
1830
1831 @seealso
1832
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}.
1838
1839
1840 @commonprop
1841
1842 Los delimitadores del comienzo del sistema se pueden anidar muchas veces:
1843
1844 @lilypond[quote,ragged-right,verbatim]
1845 \new StaffGroup 
1846 \relative <<
1847   \set StaffGroup.systemStartDelimiterHierarchy
1848     = #'(SystemStartSquare (SystemStartBracket a (SystemStartSquare b)) d)
1849   \new Staff { c1 }
1850   \new Staff { c1 }
1851   \new Staff { c1 }
1852   \new Staff { c1 }
1853   \new Staff { c1 }
1854 >>
1855 @end lilypond
1856
1857
1858 @node Staff symbol
1859 @subsection Staff symbol
1860
1861 @cindex ajuste del símbolo del pentagrama
1862
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).
1867
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
1870 archivos de ejemplo
1871 @inputfileref{input/@/test,staff@/-lines@/.ly} y
1872 @inputfileref{input/@/test,staff@/-size@/.ly}.
1873
1874 Además, los pentagramas se pueden iniciar e interrumpir libremente.  Esto se
1875 hace con @code{\startStaff} y @code{\stopStaff}.
1876
1877 @lilypond[verbatim,relative=2,fragment]
1878 b4 b
1879 \override Staff.StaffSymbol #'line-count = 2
1880 \stopStaff \startStaff
1881 b b
1882 \revert Staff.StaffSymbol #'line-count
1883 \stopStaff \startStaff
1884 b b
1885 @end lilypond
1886
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:
1889
1890 @cindex ossia
1891
1892 @lilypondfile{ossia.ly}
1893
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
1898
1899 @seealso
1900
1901 Referencia del programa: @internalsref{StaffSymbol}.
1902
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}
1907
1908
1909 @node Writing music in parallel
1910 @subsection Writing music in parallel
1911
1912 @cindex Escribir música en paralelo
1913 @cindex Música intercalada
1914
1915 La música para varias partes se puede intercalar
1916
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''] |
1920   c'2                                c'2                                |
1921   r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
1922   c'2                                c'2                                |
1923 }
1924 \new StaffGroup <<
1925   \new Staff \new Voice \voiceA
1926   \new Staff \new Voice \voiceB
1927 >>
1928 @end lilypond
1929
1930 Esto funciona de manera aceptable para música de piano
1931
1932 @lilypond[quote,verbatim]
1933 music = {
1934   \key c \major
1935   \time 4/4
1936   \parallelMusic #'(voiceA voiceB voiceC voiceD) {
1937     % Bar 1
1938     r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
1939 e''] |
1940     c'2                                 c'2 |
1941     r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
1942     c2                                  c2 |
1943
1944     % Bar 2
1945     a'8 b'      c'' d''    e'' f''    g'' a'' |
1946     d'4         d'         d'         d' |
1947     c16 d e f   d e f g    e f g a    f g a b |
1948     a,4         a,4        a,4        a,4 |
1949
1950     % Bar 3 ...
1951   }
1952 }
1953
1954 \score {
1955   \new PianoStaff <<
1956     \music
1957     \new Staff <<
1958       \voiceA \\
1959       \voiceB
1960     >>
1961     \new Staff {
1962       \clef bass
1963       <<
1964         \voiceC \\
1965         \voiceD
1966       >>
1967     }
1968   >>
1969 }
1970 @end lilypond
1971
1972
1973 @node Connecting notes
1974 @section Connecting notes
1975
1976 This section deals with notation that affects groups of notes.
1977
1978 @menu
1979 * Ties::                        
1980 * Slurs::                       
1981 * Phrasing slurs::              
1982 * Laissez vibrer ties::         
1983 * Automatic beams::             
1984 * Manual beams::                
1985 * Grace notes::                 
1986 @end menu
1987
1988
1989 @node Ties
1990 @subsection Ties
1991
1992 @cindex tie
1993 @funindex ~
1994
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{~}
1999
2000 @lilypond[quote,ragged-right,fragment,verbatim]
2001 e' ~ e' <c' e' g'> ~ <c' e' g'>
2002 @end lilypond
2003
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,
2007
2008 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2009 <c~ e g~ b> <c e g b>
2010 @end lilypond
2011
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
2015
2016 @lilypond[quote,fragment,ragged-right]
2017 \time 3/4 c'2. c'2 ~ c'4
2018 @end lilypond
2019
2020 @noindent
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
2024
2025 @lilypond[fragment,quote,ragged-right]
2026 \relative {
2027   r8 c8 ~ c2 r4 | r8^"not" c2 ~ c8 r4
2028 }
2029 @end lilypond
2030
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
2034 lines.
2035
2036 @funindex \repeatTie
2037
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},
2040
2041 @lilypond[fragment,quote,ragged-right,relative=2]
2042 r <c e g>\repeatTie
2043 @end lilypond
2044
2045 @cindex repeating ties
2046 @cindex volta brackets and ties
2047
2048 @commonprop
2049
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,
2054
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
2060 @end lilypond
2061
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).
2066
2067 @lilypond[fragment,verbatim,relative=1,ragged-right,quote]
2068 <c e g>2~ <c e g> |
2069 \override TieColumn #'tie-configuration =
2070   #'((0.0 . 1) (-2.0 . 1) (-4.0 . 1))
2071 <c e g>~ <c e g> |
2072 @end lilypond
2073
2074
2075 @refcommands
2076
2077
2078 @funindex \tieUp
2079 @code{\tieUp},
2080 @funindex \tieDown
2081 @code{\tieDown},
2082 @funindex \tieNeutral
2083 @code{\tieNeutral},
2084 @funindex \tieDotted
2085 @code{\tieDotted},
2086 @funindex \tieDashed
2087 @code{\tieDashed},
2088 @funindex \tieSolid
2089 @code{\tieSolid}.
2090
2091
2092 @seealso
2093
2094 In this manual: @ref{Automatic note splitting}.
2095
2096 Program reference: @internalsref{Tie}.
2097
2098
2099 @refbugs
2100
2101 Switching staves when a tie is active will not produce a slanted tie.
2102
2103 Changing clefs or octavations during a tie is not really
2104 well-defined.  In these cases, a slur may be preferable.
2105
2106
2107 @node Slurs
2108 @subsection Slurs
2109
2110 @cindex Slurs
2111
2112 A slur indicates that notes are to be played bound or
2113 @emph{legato}.  They are entered using parentheses
2114
2115 @lilypond[quote,ragged-right,relative=2,fragment,verbatim]
2116 f( g a) a8 b( a4 g2 f4)
2117 <c e>2( <b d>2)
2118 @end lilypond
2119
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
2123 selected).
2124
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,
2128
2129 @lilypond[relative=2,ragged-right,quote,verbatim,fragment]
2130 c4_( c) c^( c)
2131 @end lilypond
2132
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}.
2135
2136
2137 @commonprop
2138
2139 Some composers write two slurs when they want legato chords.  This can
2140 be achieved in LilyPond by setting @code{doubleSlurs},
2141
2142 @lilypond[verbatim,ragged-right,relative,fragment,quote]
2143 \set doubleSlurs = ##t
2144 <c e>4 ( <d f> <c e> <d f> )
2145 @end lilypond
2146
2147
2148 @refcommands
2149
2150 @funindex \slurUp
2151 @code{\slurUp},
2152 @funindex \slurDown
2153 @code{\slurDown},
2154 @funindex \slurNeutral
2155 @code{\slurNeutral},
2156 @funindex \slurDashed
2157 @code{\slurDashed},
2158 @funindex \slurDotted
2159 @code{\slurDotted},
2160 @funindex \slurSolid
2161 @code{\slurSolid}.
2162
2163 @seealso
2164
2165 Program reference: @seeinternals{Slur}.
2166
2167
2168 @node Phrasing slurs
2169 @subsection Phrasing slurs
2170
2171 @cindex phrasing slurs
2172 @cindex phrasing marks
2173
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{\)}
2176 respectively
2177
2178 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
2179 \time 6/4 c'\( d( e) f( e) d\)
2180 @end lilypond
2181
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}.
2187
2188 You cannot have simultaneous phrasing slurs.
2189
2190
2191 @refcommands
2192
2193 @funindex \phrasingSlurUp
2194 @code{\phrasingSlurUp},
2195 @funindex \phrasingSlurDown
2196 @code{\phrasingSlurDown},
2197 @funindex \phrasingSlurNeutral
2198 @code{\phrasingSlurNeutral}.
2199
2200
2201 @seealso
2202
2203 Program reference: @internalsref{PhrasingSlur}.
2204
2205
2206 @node Laissez vibrer ties
2207 @subsection Laissez vibrer ties
2208 @cindex Laissez vibrer
2209 @cindex Ties, laissez vibrer
2210
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},
2214
2215 @lilypond[fragment,ragged-right,verbatim,relative=1]
2216 <c f g>\laissezVibrer
2217 @end lilypond
2218
2219 @seealso
2220
2221 Program reference:
2222 @internalsref{LaissezVibrerTie}
2223 @internalsref{LaissezVibrerTieColumn}
2224
2225 Example files:
2226 @lsr{connecting,laissez-vibrer-ties.ly}
2227
2228
2229 @node Automatic beams
2230 @subsection Automatic beams
2231
2232 LilyPond inserts beams automatically
2233
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
2236 @end lilypond
2237
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}
2241 for details.
2242
2243 Individual notes may be marked with @code{\noBeam} to prevent them
2244 from being beamed
2245
2246 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2247 \time 2/4 c8 c\noBeam c c
2248 @end lilypond
2249
2250
2251 @seealso
2252
2253 Program reference: @internalsref{Beam}.
2254
2255
2256 @node Manual beams
2257 @subsection Manual beams
2258
2259 @cindex beams, manual
2260 @funindex ]
2261 @funindex [
2262
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{]}
2267
2268 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2269 {
2270   r4 r8[ g' a r8] r8 g[ | a] r8
2271 }
2272 @end lilypond
2273
2274
2275 @commonprop
2276
2277 @funindex stemLeftBeamCount
2278 @funindex stemRightBeamCount
2279
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
2284 is erased
2285
2286 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2287 {
2288    f8[ r16
2289       f g a]
2290    f8[ r16
2291    \set stemLeftBeamCount = #1
2292       f g a]
2293 }
2294 @end lilypond
2295
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.
2299
2300 @lilypond[fragment,quote,relative=2,verbatim]
2301 c16[ c c c c c c c]
2302 \set subdivideBeams = ##t
2303 c16[ c c c c c c c]
2304 \set Score.beatLength = #(ly:make-moment 1 8)
2305 c16[ c c c c c c c]
2306 @end lilypond
2307 @funindex subdivideBeams
2308
2309 @noindent
2310 For more information about @code{make-moment}, see
2311 @ref{Time administration}.
2312
2313 Line breaks are normally forbidden when beams cross bar lines.  This
2314 behavior can be changed by setting @code{breakable}.
2315
2316 @funindex breakable
2317
2318 @cindex beams and line breaks
2319 @cindex beams, kneed
2320 @cindex kneed beams
2321 @cindex auto-knee-gap
2322
2323
2324 @refbugs
2325
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.
2328
2329 Automatically kneed cross-staff beams cannot be used together with
2330 hidden staves.  See @ref{Hiding staves}.
2331
2332 Beams do not avoid collisions with symbols around the notes, such as
2333 texts and accidentals.
2334
2335
2336 @node Grace notes
2337 @subsection Grace notes
2338
2339 @funindex \grace
2340 @cindex ornaments
2341 @cindex grace notes
2342 @cindex appoggiatura
2343 @cindex acciaccatura
2344
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
2352
2353 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2354 b4 \acciaccatura d8 c4 \appoggiatura e8 d4
2355 \acciaccatura { g16[ f] } e4
2356 @end lilypond
2357
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.
2361
2362 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2363 c4 \grace c16 c4
2364 \grace { c16[ d16] } c2 c4
2365 @end lilypond
2366
2367 @noindent
2368 Unlike @code{\acciaccatura} and @code{\appoggiatura}, the
2369 @code{\grace} command does not start a slur.
2370
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
2375
2376 @lilypond[quote,ragged-right]
2377 <<
2378   \relative c''{
2379     c4 \grace c16 c4 \grace {
2380     c16[ d16] } c2 c4
2381   }
2382   \new Lyrics \lyricmode {
2383     \override LyricText #'font-family = #'typewriter
2384
2385     \markup { (0,0) } 4
2386     \grace { \markup {
2387       ( \fraction 1 4 , \fraction -1 16 ) } 16 }
2388     \markup { (\fraction 1 4 , 0 ) } 4
2389     \grace {
2390       \markup { (\fraction 2 4 , \fraction "-1" 8 ) } 16
2391       \markup { (\fraction 2 4 , \fraction "-1" 16 ) } 16
2392     }
2393     \markup { ( \fraction 2 4 , 0 ) }
2394   }
2395 >>
2396 @end lilypond
2397
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
2401
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 } >>
2405 @end lilypond
2406
2407 @funindex \afterGrace
2408
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.
2412
2413 @lilypond[ragged-right, verbatim,relative=2,fragment]
2414 c1 \afterGrace d1 { c16[ d] } c4
2415 @end lilypond
2416
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.
2420
2421 @example
2422 afterGraceFraction = #(cons 7 8)
2423 @end example
2424
2425 @noindent
2426 will put the grace note at 7/8 of the main note.
2427
2428 The same effect can be achieved manually by doing
2429
2430 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2431 \new Voice {
2432   << { d1^\trill_( }
2433      { s2 \grace { c16[ d] } } >>
2434   c4)
2435 }
2436 @end lilypond
2437
2438 @noindent
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.
2441
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,
2445 for example,
2446
2447 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2448 \new Voice {
2449   \acciaccatura {
2450     \stemDown
2451     f16->
2452     \stemNeutral
2453   }
2454   g4
2455 }
2456 @end lilypond
2457
2458 @noindent
2459 The overrides should also be reverted inside the grace section.
2460
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.
2465
2466 @example
2467 \new Staff @{
2468   #(add-grace-property 'Voice 'Stem 'direction '())
2469   @dots{}
2470 @}
2471 @end example
2472
2473 @noindent
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}.
2479
2480 @noindent
2481 The slash through the stem in acciaccaturas can be obtained
2482 in other situations by @code{\override Stem  #'stroke-style = #"grace"}.
2483
2484
2485 @commonprop
2486
2487 Grace notes may be forced to use floating spacing,
2488
2489 @lilypond[relative=2,ragged-right]
2490 <<
2491   \override Score.SpacingSpanner #'strict-grace-spacing = ##t
2492   \new Staff {
2493      c'4
2494      \afterGrace
2495      c'4
2496      { c'16[ c'8 c'16] }
2497      c'4
2498   }  
2499   \new Staff {
2500      c'16[ c'16 c'16 c'16]
2501      c'16[ c'16 c'16 c'16]
2502      c'4
2503   }
2504 >>
2505 @end lilypond
2506
2507
2508 @seealso
2509
2510 Program reference: @internalsref{GraceMusic}.
2511
2512
2513 @refbugs
2514
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.
2518
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,
2522
2523 @lilypond[quote,ragged-right,relative=2,verbatim,fragment]
2524 << \new Staff { e4 \bar "|:" \grace c16 d4 }
2525    \new Staff { c4 \bar "|:" d4 } >>
2526 @end lilypond
2527
2528 @noindent
2529 This can be remedied by inserting grace skips of the corresponding
2530 durations in the other staves. For the above example
2531
2532 @example
2533 \new Staff @{ c4 \bar "|:" \grace s16 d4 @}
2534 @end example
2535
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.
2539
2540
2541
2542 @node Expressive marks
2543 @section Expressive marks
2544
2545 Expressive marks help musicians to bring more to the music than simple
2546 notes and rhythms.
2547
2548 @menu
2549 * Articulations::               
2550 * Fingering instructions::      
2551 * Dynamics::                    
2552 * Breath marks::                
2553 * Trills::                      
2554 * Glissando::                   
2555 * Arpeggio::                    
2556 * Falls and doits::             
2557 @end menu
2558
2559
2560 @node Articulations
2561 @subsection Articulations
2562
2563 @cindex Articulations
2564 @cindex scripts
2565 @cindex ornaments
2566
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
2571
2572 @lilypondfile[quote,ragged-right]{script-abbreviations.ly}
2573
2574 The meanings of these shorthands can be changed.  See
2575 @file{ly/@/script@/-init@/.ly} for examples.
2576
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.
2580
2581 @lilypond[quote,ragged-right,fragment,verbatim]
2582 c''4^^ c''4_^
2583 @end lilypond
2584
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{_},
2588 e.g.,
2589
2590 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
2591 c\fermata c^\fermata c_\fermata
2592 @end lilypond
2593
2594 @cindex accent
2595 @cindex marcato
2596 @cindex staccatissimo
2597 @cindex espressivo
2598 @cindex fermata
2599 @cindex stopped
2600 @cindex staccato
2601 @cindex portato
2602 @cindex tenuto
2603 @cindex upbow
2604 @cindex downbow
2605 @cindex foot marks
2606 @cindex organ pedal marks
2607 @cindex turn
2608 @cindex open
2609 @cindex flageolet
2610 @cindex reverseturn
2611 @cindex trill
2612 @cindex prall
2613 @cindex mordent
2614 @cindex prallprall
2615 @cindex prallmordent
2616 @cindex prall, up
2617 @cindex prall, down
2618 @cindex mordent
2619 @cindex thumb marking
2620 @cindex segno
2621 @cindex coda
2622 @cindex varcoda
2623
2624 Here is a chart showing all scripts available,
2625
2626 @lilypondfile[ragged-right,quote]{script-chart.ly}
2627
2628
2629 @commonprop
2630
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.
2639
2640 @lilypond[verbatim,relative=3,ragged-right,fragment,quote]
2641 \once \override TextScript #'script-priority = #-100
2642 a4^\prall^\markup { \sharp }
2643
2644 \once \override Script #'script-priority = #-100
2645 a4^\prall^\markup { \sharp }
2646 @end lilypond
2647
2648
2649 @seealso
2650
2651 Program reference: @internalsref{Script}.
2652
2653
2654 @refbugs
2655
2656 These signs appear in the printed output but have no effect on the
2657 MIDI rendering of the music.
2658
2659
2660 @node Fingering instructions
2661 @subsection Fingering instructions
2662
2663 @cindex fingering
2664 @cindex finger change
2665
2666 Fingering instructions can be entered using
2667 @example
2668 @var{note}-@var{digit}
2669 @end example
2670 For finger changes, use markup texts
2671
2672 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
2673 c4-1 c-2 c-3 c-4
2674 c^\markup { \finger "2 - 3" }
2675 @end lilypond
2676
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>
2681 @end lilypond
2682
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
2687 @end lilypond
2688
2689
2690 @commonprop
2691
2692 You may exercise greater control over fingering chords by
2693 setting @code{fingeringOrientations}
2694
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
2700 @end lilypond
2701
2702 Using this feature, it is also possible to put fingering instructions
2703 very close to note heads in monophonic music,
2704
2705 @lilypond[verbatim,ragged-right,quote,fragment]
2706 \set fingeringOrientations = #'(right)
2707 <es'-2>4
2708 @end lilypond
2709
2710
2711 @seealso
2712
2713 Program reference: @internalsref{Fingering}.
2714
2715 Examples: @lsr{expressive,fingering-chords.ly}
2716
2717
2718 @node Dynamics
2719 @subsection Dynamics
2720
2721 @cindex Dynamics
2722 @funindex \pppp
2723 @funindex \ppp
2724 @funindex \pp
2725 @funindex \p
2726 @funindex \mp
2727 @funindex \mf
2728 @funindex \f
2729 @funindex \ff
2730 @funindex \fff
2731 @funindex \ffff
2732 @funindex \fp
2733 @funindex \sf
2734 @funindex \sff
2735 @funindex \sp
2736 @funindex \spp
2737 @funindex \sfz
2738 @funindex \rfz
2739
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}.
2746
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
2750 @end lilypond
2751
2752 @funindex \<
2753 @funindex \>
2754 @funindex \!
2755
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
2762
2763 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2764 c\< c\! d\> e\!
2765 << f1 { s4 s4\< s4\! \> s4\! } >>
2766 @end lilypond
2767
2768 @noindent
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,
2774
2775 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2776 \set hairpinToBarline = ##f
2777 c4\< c2. c4\!
2778 @end lilypond
2779
2780 In some situations the @code{\espressivo} articulation mark may
2781 be suitable to indicate a crescendo and decrescendo on the one note,
2782
2783 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
2784 c2 b4 a g1\espressivo
2785 @end lilypond
2786
2787 This may give rise to very short hairpins.  Use @code{minimum-length}
2788 in @internalsref{Voice}.@internalsref{Hairpin} to lengthen them, for
2789 example
2790
2791 @example
2792 \override Voice.Hairpin #'minimum-length = #5
2793 @end example
2794
2795 @cindex al niente
2796 @cindex niente, al
2797
2798 Hairpins may be printed with a circled tip (al niente notation) by
2799 setting the @code{circled-tip} property,
2800
2801 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2802 \override Hairpin #'circled-tip = ##t
2803 c2\< c\!
2804 c4\> c\< c2\!
2805 @end lilypond
2806
2807
2808 @cindex crescendo
2809 @cindex decrescendo
2810 @cindex diminuendo
2811
2812 You can also use text saying @emph{cresc.} instead of hairpins
2813
2814 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2815 \setTextCresc
2816 c\< d e f\!
2817 \setHairpinCresc
2818 e\> d c b\!
2819 \setTextDecresc
2820 c\> d e f\!
2821 \setTextDim
2822 e\> d c b\!
2823 @end lilypond
2824
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
2829 a'2\< a a a\!\mf
2830 @end lilypond
2831
2832 To create new dynamic marks or text that should be aligned
2833 with dynamics, see @ref{New dynamic marks}.
2834
2835 Vertical positioning of dynamics is handled by
2836 @internalsref{DynamicLineSpanner}.
2837
2838
2839 @commonprop
2840
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.
2845
2846 @example
2847 \override DynamicLineSpanner #'staff-padding = #4
2848 @end example
2849
2850 You may also use this property if the dynamics are colliding
2851 with other notation.
2852
2853 Crescendi and decrescendi that end on the first note of a
2854 new line are not printed.  To change this behavior, use
2855
2856 @example
2857 \override Score.Hairpin #'after-line-breaking = ##t
2858 @end example
2859
2860 Text style dynamic changes (such as @emph{cresc.} and @emph{dim.})
2861 are printed with a
2862 dashed line showing their extent.  To surpress printing this line, use
2863
2864 @example
2865 \override DynamicTextSpanner #'dash-period = #-1.0
2866 @end example
2867
2868
2869 @refcommands
2870
2871 @funindex \dynamicUp
2872 @code{\dynamicUp},
2873 @funindex \dynamicDown
2874 @code{\dynamicDown},
2875 @funindex \dynamicNeutral
2876 @code{\dynamicNeutral}.
2877
2878
2879 @seealso
2880
2881 Program reference: @internalsref{DynamicText}, @internalsref{Hairpin}.
2882 Vertical positioning of these symbols is handled by
2883 @internalsref{DynamicLineSpanner}.
2884
2885
2886 @node Breath marks
2887 @subsection Breath marks
2888
2889 Breath marks are entered using @code{\breathe}
2890
2891 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
2892 c'4 \breathe d4
2893 @end lilypond
2894
2895
2896 @commonprop
2897
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]
2902 c'4
2903 \override BreathingSign #'text
2904   = #(make-musicglyph-markup "scripts.rvarcomma")
2905 \breathe
2906 d4
2907 @end lilypond
2908
2909 @seealso
2910
2911 Program reference: @internalsref{BreathingSign}.
2912
2913 Examples: @lsr{expressive,breathing-sign.ly}
2914
2915
2916 @node Trills
2917 @subsection Trills
2918
2919 Short trills are printed like normal articulation; see @ref{Articulations}.
2920
2921 Long running trills are made with @code{\startTrillSpan} and
2922 @code{\stopTrillSpan},
2923
2924 @lilypond[verbatim,ragged-right,relative=2,quote,fragment]
2925 \new Voice {
2926   << { c1 \startTrillSpan }
2927      { s2. \grace { d16[\stopTrillSpan e] } } >>
2928   c4 }
2929 @end lilypond
2930
2931 @cindex Pitched trills
2932
2933 Trills that should be executed on an explicitly specified pitch can be
2934 typeset with the command @code{pitchedTrill},
2935
2936 @lilypond[ragged-right,verbatim,fragment,relative=1,quote]
2937 \pitchedTrill c4\startTrillSpan fis
2938 f\stopTrillSpan
2939 @end lilypond
2940
2941 The first argument is the main note.  The pitch of the second
2942 is printed as a stemless note head in parentheses.
2943
2944
2945 @refcommands
2946
2947 @code{\startTrillSpan},
2948 @funindex \startTrillSpan
2949 @code{\stopTrillSpan}.
2950 @funindex \stopTrillSpan
2951
2952
2953 @seealso
2954
2955 Program reference: @internalsref{TrillSpanner}.
2956
2957
2958 @node Glissando
2959 @subsection Glissando
2960
2961 @cindex Glissando
2962 @funindex \glissando
2963
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
2967
2968 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
2969 c2\glissando c'
2970 \override Glissando #'style = #'zigzag
2971 c2\glissando c,
2972 @end lilypond
2973
2974
2975 @seealso
2976
2977 Program reference: @internalsref{Glissando}.
2978
2979 Example files:
2980 @lsr{expressive,glissando.ly}, @lsr{expressive,line-styles.ly}
2981
2982
2983
2984 @refbugs
2985
2986 Printing text over the line (such as @emph{gliss.}) is not supported.
2987
2988
2989 @node Arpeggio
2990 @subsection Arpeggio
2991
2992 @cindex Arpeggio
2993 @cindex broken chord
2994 @funindex \arpeggio
2995
2996 You can specify an arpeggio sign (also known as broken chord) on a
2997 chord by attaching an @code{\arpeggio} to a chord
2998
2999 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3000 <c e g c>\arpeggio
3001 @end lilypond
3002
3003 A square bracket on the left indicates that the player should not
3004 arpeggiate the chord
3005
3006 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3007 \arpeggioBracket
3008 <c' e g c>\arpeggio
3009 @end lilypond
3010
3011 The direction of the arpeggio is sometimes denoted by adding an
3012 arrowhead to the wiggly line
3013
3014 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3015 \new Voice {
3016   \arpeggioUp
3017   <c e g c>\arpeggio
3018   \arpeggioDown
3019   <c e g c>\arpeggio
3020 }
3021 @end lilypond
3022
3023
3024 @commonprop
3025
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}
3029
3030 @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
3031 \new PianoStaff <<
3032   \set PianoStaff.connectArpeggios = ##t
3033   \new Staff { <c' e g c>\arpeggio }
3034   \new Staff { \clef bass <c,, e g>\arpeggio }
3035 >>
3036 @end lilypond
3037
3038
3039 @refcommands
3040
3041 @code{\arpeggio},
3042 @funindex \arpeggioUp
3043 @code{\arpeggioUp},
3044 @funindex \arpeggioDown
3045 @code{\arpeggioDown},
3046 @funindex \arpeggioNeutral
3047 @code{\arpeggioNeutral},
3048 @funindex \arpeggioBracket
3049 @code{\arpeggioBracket}.
3050
3051
3052 @seealso
3053
3054 Notation manual: @ref{Ties}, for writing out arpeggios.
3055
3056 Program reference: @internalsref{Arpeggio}.
3057
3058
3059 @refbugs
3060
3061 It is not possible to mix connected arpeggios and unconnected
3062 arpeggios in one @internalsref{PianoStaff} at the same point in time.
3063
3064
3065 @node Falls and doits
3066 @subsection Falls and doits
3067
3068 Falls and doits can be added to notes using the @code{\bendAfter}
3069 command,
3070
3071 @lilypond[fragment,ragged-right,relative=2]
3072 \override Score.SpacingSpanner #'shortest-duration-space = #3.0
3073 c4-\bendAfter #+5
3074 c4-\bendAfter #-3
3075 @end lilypond
3076
3077
3078 @node Repeats
3079 @section Repeats
3080
3081 Repetition is a central concept in music, and multiple notations exist
3082 for repetitions.
3083
3084 @menu
3085 * Repeat types::                
3086 * Repeat syntax::               
3087 * Repeats and MIDI::            
3088 * Manual repeat commands::      
3089 * Tremolo repeats::             
3090 * Tremolo subdivisions::        
3091 * Measure repeats::             
3092 @end menu
3093
3094
3095 @node Repeat types
3096 @subsection Repeat types
3097
3098 @cindex repeats
3099 @funindex \repeat
3100
3101 The following types of repetition are supported
3102
3103 @table @code
3104 @item unfold
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.
3108
3109 @item volta
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
3113 default.
3114
3115
3116 @item tremolo
3117 Make tremolo beams.  These are not played in MIDI output by default.
3118
3119 @item percent
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.
3123
3124 @end table
3125
3126
3127 @node Repeat syntax
3128 @subsection Repeat syntax
3129
3130 @cindex volta
3131 @cindex prima volta
3132 @cindex seconda volta
3133
3134 LilyPond has one syntactic construct for specifying different types of
3135 repeats.  The syntax is
3136
3137 @example
3138 \repeat @var{variant} @var{repeatcount} @var{repeatbody}
3139 @end example
3140
3141 If you have alternative endings, you may add
3142 @funindex \alternative
3143 @example
3144 \alternative @{
3145   @var{alternative1}
3146   @var{alternative2}
3147   @var{alternative3}
3148   @dots{}
3149 @}
3150 @end example
3151
3152 @noindent
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.
3156
3157 Standard repeats are used like this
3158
3159 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3160 c1
3161 \repeat volta 2 { c4 d e f }
3162 \repeat volta 2 { f e d c }
3163 @end lilypond
3164
3165 With alternative endings
3166
3167 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3168 c1
3169 \repeat volta 2 {c4 d e f}
3170 \alternative { {d2 d} {f f,} }
3171 @end lilypond
3172
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.
3179
3180 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3181 \new Staff {
3182   \partial 4
3183   \repeat volta 4 { e | c2 d2 | e2 f2 | }
3184   \alternative { { g4 g g } { a | a a a a | b2. } }
3185 }
3186 @end lilypond
3187
3188 @funindex \repeatTie
3189
3190 Ties may be added to a second ending,
3191
3192 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
3193 c1
3194 \repeat volta 2 {c4 d e f ~ }
3195 \alternative { {f2 d} {f\repeatTie f,} }
3196 @end lilypond
3197
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.
3201
3202 @lilypond[verbatim,ragged-right,quote]
3203 \relative c''{
3204   \time 3/4
3205   c c c
3206   \set Staff.voltaSpannerDuration = #(ly:make-moment 3 4)
3207   \repeat "volta" 5 { d d d }
3208   \alternative { { e e e f f f }
3209   { g g g } }
3210 }
3211 @end lilypond
3212
3213
3214 @seealso
3215
3216 Examples:
3217
3218 Brackets for the repeat are normally only printed over the topmost
3219 staff.  This can be adjusted by setting the @code{voltaOnThisStaff}
3220 property; see
3221
3222 @lsr{repeats,volta@/-multi@/-staff@/.ly}.
3223
3224
3225 @refbugs
3226
3227 @cindex repeat, ambiguous
3228
3229 A nested repeat like
3230
3231 @example
3232 \repeat @dots{}
3233 \repeat @dots{}
3234 \alternative
3235 @end example
3236
3237 @noindent
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.
3242
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.
3247
3248 Volta brackets are not vertically aligned.
3249
3250
3251 @node Repeats and MIDI
3252 @subsection Repeats and MIDI
3253
3254 @cindex expanding repeats
3255 @funindex \unfoldRepeats
3256
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.
3261
3262 @lilypond[quote,verbatim,fragment,line-width=8.0\cm]
3263 \unfoldRepeats {
3264   \repeat tremolo 8 {c'32 e' }
3265   \repeat percent 2 { c''8 d'' }
3266   \repeat volta 2 {c'4 d' e' f'}
3267   \alternative {
3268     { g' a' a' g' }
3269     {f' e' d' c' }
3270   }
3271 }
3272 \bar "|."
3273 @end lilypond
3274
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,
3279
3280 @example
3281 \score @{
3282   @var{..music..}
3283   \layout @{ .. @}
3284 @}
3285 \score @{
3286   \unfoldRepeats @var{..music..}
3287   \midi @{ .. @}
3288 @}
3289 @end example
3290
3291
3292 @node Manual repeat commands
3293 @subsection Manual repeat commands
3294
3295 @funindex repeatCommands
3296
3297 The property @code{repeatCommands} can be used to control the layout of
3298 repeats.  Its value is a Scheme list of repeat commands.
3299
3300 @table @asis
3301 @item @code{start-repeat}
3302 Print a @code{|:} bar line.
3303
3304 @item @code{end-repeat}
3305 Print a @code{:|} bar line.
3306
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;
3312
3313 @item @code{(volta #f)}
3314 Stop a running volta bracket.
3315 @end table
3316
3317 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
3318 c4
3319   \set Score.repeatCommands = #'((volta "93") end-repeat)
3320 c4 c4
3321   \set Score.repeatCommands = #'((volta #f))
3322 c4 c4
3323 @end lilypond
3324
3325
3326 @seealso
3327
3328 Program reference: @internalsref{VoltaBracket},
3329 @internalsref{RepeatedMusic},
3330 @internalsref{VoltaRepeatedMusic},
3331 @internalsref{UnfoldedRepeatedMusic}, and
3332 @internalsref{FoldedRepeatedMusic}.
3333
3334
3335 @node Tremolo repeats
3336 @subsection Tremolo repeats
3337
3338 @cindex tremolo beams
3339
3340 To place tremolo marks between notes, use @code{\repeat} with tremolo
3341 style
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 }
3347 }
3348 @end lilypond
3349
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
3354 @end lilypond
3355
3356 Similar output is obtained using the tremolo subdivision, described in
3357 @ref{Tremolo subdivisions}.
3358
3359
3360 @seealso
3361
3362 In this manual: @ref{Tremolo subdivisions}, @ref{Repeats}.
3363
3364 Program reference: @internalsref{Beam}, @internalsref{StemTremolo}.
3365
3366
3367 @node Tremolo subdivisions
3368 @subsection Tremolo subdivisions
3369
3370 @cindex tremolo marks
3371 @funindex tremoloFlags
3372
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
3378 used
3379
3380 @lilypond[quote,ragged-right,verbatim,fragment]
3381 c'2:8 c':32 | c': c': |
3382 @end lilypond
3383
3384
3385 @refbugs
3386
3387 Tremolos entered in this way do not carry over into the MIDI output.
3388
3389
3390 @seealso
3391
3392 In this manual: @ref{Tremolo repeats}.
3393
3394 Elsewhere: @internalsref{StemTremolo}.
3395
3396
3397 @node Measure repeats
3398 @subsection Measure repeats
3399
3400 @cindex percent repeats
3401 @cindex measure repeats
3402
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.
3408
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 }
3413 }
3414 @end lilypond
3415
3416 Measure repeats of more than 2 measures get a counter, if you switch
3417 on the @code{countPercentRepeats} property,
3418
3419 @lilypond[relative=2,fragment,quote,verbatim,ragged-right]
3420 \new Voice {
3421 \set countPercentRepeats = ##t
3422   \repeat "percent" 4 { c1 }
3423 }
3424 @end lilypond
3425
3426
3427
3428 Isolated percents can also be printed. This is done by putting a
3429 multi-measure rest with a different print function,
3430
3431 @lilypond[fragment,verbatim,quote]
3432 \override MultiMeasureRest #'stencil
3433   = #ly:multi-measure-rest::percent
3434 R1
3435 @end lilypond
3436
3437
3438
3439
3440 @seealso
3441
3442 Program reference: @internalsref{RepeatSlash},
3443 @internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
3444 @internalsref{DoublePercentRepeatCounter},
3445 @internalsref{PercentRepeatCounter},
3446 @internalsref{PercentRepeatedMusic}.
3447
3448
3449