Documentation/es/user/editorial.itely

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
   2 @c This file is included from notation.itely
   3 @ignore
   4     Translation of GIT committish: 41ef91786a08102d9b9a839f6a2f40cec263d723
   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 @c \version "2.12.0"
  11
  12 @node Editorial annotations
  13 @section Editorial annotations
  14
  15 @lilypondfile[quote]{editorial-headword.ly}
  16
  17 Esta sección trata de las diversas maneras de modificar el aspecto de
  18 las notas y de aplicar énfasis analítico o educativo.
  19
  20 @menu
  21 * Inside the staff::
  22 * Outside the staff::
  23 @end menu
  24
  25
  26 @node Inside the staff
  27 @subsection Inside the staff
  28
  29 Esta sección trata sobre cómo aplicar énfasis a los elementos situados
  30 dentro del pentagrama.
  31
  32 @menu
  33 * Selecting notation font size::
  34 * Fingering instructions::
  35 * Hidden notes::
  36 * Coloring objects::
  37 * Parentheses::
  38 * Stems::
  39 @end menu
  40
  41 @node Selecting notation font size
  42 @unnumberedsubsubsec Selecting notation font size
  43
  44 @cindex fuente tipográfica (de notación), tamaño
  45 @cindex selección del tamaño de la fuente tipográfica (de notación)
  46 @cindex notación, tamaño de la fuente
  47 @cindex notas, cabezas de
  48
  49 @funindex fontSize
  50 @funindex font-size
  51 @funindex magstep
  52 @funindex \huge
  53 @funindex \large
  54 @funindex \normalsize
  55 @funindex \small
  56 @funindex \tiny
  57 @funindex \teeny
  58 @funindex huge
  59 @funindex large
  60 @funindex normalsize
  61 @funindex small
  62 @funindex tiny
  63 @funindex teeny
  64
  65 Se puede alterar el tamaño de la fuente tipográfica de los elementos
  66 de notación.  Esto no cambia el tamaño de los símbolos variables, como
  67 las barras de corchea o las ligaduras.
  68
  69 @warning{Para los tamaños de tipografía del texto, consulte
  70 @ref{Selecting font and font size}.}
  71
  72 @lilypond[verbatim,quote,relative=2]
  73 \huge
  74 c4.-> d8---3
  75 \large
  76 c4.-> d8---3
  77 \normalsize
  78 c4.-> d8---3
  79 \small
  80 c4.-> d8---3
  81 \tiny
  82 c4.-> d8---3
  83 \teeny
  84 c4.-> d8---3
  85 @end lilypond
  86
  87 Internamente, esto establece un valor para la propiedad
  88 @code{fontSize}.  Esto, a su vez, hace que se establezca el valor de
  89 la propiedad @code{font-size} de todos los objetos de presentación.
  90 El valor de @code{font-size} es un número que indica el tamaño con
  91 relación al tamaño estándar para la altura vigente del pentagrama.
  92 Cada unidad hacia arriba es un incremento de un 12% del tamaño de la
  93 fuente, aproximadamente.  Seis unidades son exactamente un factor de
  94 dos.  La función de Scheme @code{magstep} convierte un número de
  95 tamaño @code{font-size} a un factor de escalado.  La propiedad
  96 @code{font-size} también se puede establecer directamente, de forma
  97 que queden afectados solamente determinados objetos gráficos.
  98
  99 @lilypond[verbatim,quote,relative=2]
 100 \set fontSize = #3
 101 c4.-> d8---3
 102 \override NoteHead #'font-size = #-4
 103 c4.-> d8---3
 104 \override Script #'font-size = #2
 105 c4.-> d8---3
 106 \override Stem #'font-size = #-5
 107 c4.-> d8---3
 108 @end lilypond
 109
 110 @cindex estándar, tamaño de la tipografía (de notación)
 111 @cindex fuente tipográfica (de notación), tamaño estándar de
 112
 113 @funindex font-interface
 114 @funindex font-size
 115
 116 Los cambios en el tamaño de la fuente se obtienen por medio del
 117 escalado del tamaño del diseño que se encuentra más cerca del tamaño
 118 deseado.  El tamaño estándar para la tipografía (para @code{font-size
 119 = #0}), depende de la altura estándar del pentagrama.  Para un
 120 pentagrama de 20 puntos, se selecciona una fuente de 10 puntos.
 121
 122 La propiedad @code{font-size} sólo se puede establecer en objetos
 123 gráficos que utilicen fuentes tipográficas.  Éstos son los que
 124 contemplan el interfaz de presentación @code{font-interface}.
 125
 126
 127 @predefined
 128 @code{\teeny} (enano),
 129 @code{\tiny} (muy pequeño),
 130 @code{\small} (pequeño),
 131 @code{\normalsize} (normal),
 132 @code{\large} (grande),
 133 @code{\huge} (enorme).
 134 @endpredefined
 135
 136
 137 @seealso
 138 Fragmentos de código:
 139 @rlsr{Editorial annotations}.
 140
 141 Referencia de funcionamiento interno:
 142 @rinternals{font-interface}.
 143
 144
 145 @node Fingering instructions
 146 @unnumberedsubsubsec Fingering instructions
 147
 148 @cindex digitación
 149 @cindex cambio de dedo
 150
 151 @funindex \finger
 152 @funindex finger
 153
 154 Las instrucciones de digitación se pueden introducir usando
 155 @var{nota}-@var{dígito}:
 156
 157 @lilypond[verbatim,quote,relative=2]
 158 c4-1 d-2 f-4 e-3
 159 @end lilypond
 160
 161 Para los cambios de dedo se pueden usar elementos de marcado de texto.
 162
 163 @lilypond[verbatim,quote,relative=2]
 164 c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
 165 @end lilypond
 166
 167 @cindex thumb-script
 168
 169 @funindex \thumb
 170 @funindex thumb
 171
 172 Puede usar la articulación de pulgar para indicar que una nota se debe
 173 tocar con el pulgar (p.ej. en música de cello).
 174
 175 @lilypond[verbatim,quote,relative=2]
 176 <a_\thumb a'-3>2 <b_\thumb b'-3>
 177 @end lilypond
 178
 179 @cindex digitación de acordes
 180 @cindex digitación, instrucciones de, para acordes
 181 @cindex acordes, digitación de
 182
 183 Las digitaciones para los acordes también se pueden añadir a las notas
 184 individuales del acorde escribiéndolas después de las alturas.
 185
 186 @lilypond[verbatim,quote,relative=2]
 187 <c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
 188 @end lilypond
 189
 190 Las indicaciones de digitación se pueden situar manualmente encima o
 191 debajo del pentagrama, véase @ref{Direction
 192 and placement}.
 193
 194 @snippets
 195
 196 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 197 {controlling-the-placement-of-chord-fingerings.ly}
 198
 199 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 200 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 201
 202 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 203 {avoiding-collisions-with-chord-fingerings.ly}
 204
 205
 206 @seealso
 207 Referencia de la notación:
 208 @ref{Direction and placement}.
 209
 210 Fragmentos de código:
 211 @rlsr{Editorial annotations}.
 212
 213 Referencia de funcionamiento interno:
 214 @rinternals{FingeringEvent},
 215 @rinternals{fingering-event},
 216 @rinternals{Fingering_engraver},
 217 @rinternals{New_fingering_engraver},
 218 @rinternals{Fingering}.
 219
 220
 221 @node Hidden notes
 222 @unnumberedsubsubsec Hidden notes
 223
 224 @cindex ocultas, notas
 225 @cindex invisibles, notas
 226 @cindex transparentes, notas
 227 @cindex notas ocultas
 228 @cindex notas invisibles
 229 @cindex notas transparentes
 230
 231 @funindex \hideNotes
 232 @funindex hideNotes
 233 @funindex \unHideNotes
 234 @funindex unHideNotes
 235
 236 Las notas ocultas (o invisibles, o transparentes) pueden ser de
 237 utilidad en la preparación de ejercicios de teoría o de composición.
 238
 239 @lilypond[verbatim,quote,relative=2]
 240 c4 d
 241 \hideNotes
 242 e4 f
 243 \unHideNotes
 244 g a
 245 \hideNotes
 246 b
 247 \unHideNotes
 248 c
 249 @end lilypond
 250
 251 Los objetos de notación que están anclados a notas invisibles, son a
 252 pesar de ello visibles.
 253
 254 @lilypond[verbatim,quote,relative=2]
 255 c4( d)
 256 \hideNotes
 257 e4(\p f)--
 258 @end lilypond
 259
 260
 261 @predefined
 262 @code{\hideNotes},
 263 @code{\unHideNotes}.
 264 @endpredefined
 265
 266
 267 @seealso
 268 Fragmentos de código:
 269 @rlsr{Editorial annotations}.
 270
 271 Referencia de funcionamiento interno:
 272 @rinternals{Note_spacing_engraver},
 273 @rinternals{NoteSpacing}.
 274
 275
 276 @node Coloring objects
 277 @unnumberedsubsubsec Coloring objects
 278
 279 @cindex coloreados, objetos
 280 @cindex colores
 281 @cindex colorear objetos
 282 @cindex objetos, colorear
 283 @cindex coloreadas, notas
 284 @cindex colorear notas
 285 @cindex notas coloreadas
 286 @cindex x11, color de
 287 @cindex x11-color
 288 @cindex colores de x11
 289 @cindex with-color
 290
 291 @funindex color
 292 @funindex \with-color
 293 @funindex with-color
 294 @funindex x11-color
 295
 296 Se pueden asignar colores a los objetos individuales.  Los nombres de
 297 color válidos se encuentran relacionados en la @ref{List of colors}.
 298
 299 @lilypond[verbatim,quote,relative=2]
 300 \override NoteHead #'color = #red
 301 c4 c
 302 \override NoteHead #'color = #(x11-color 'LimeGreen)
 303 d
 304 \override Stem #'color = #blue
 305 e
 306 @end lilypond
 307
 308 Se puede acceder al espectro completo de colores definido para X11
 309 usando la función de Scheme x11-color.  Esta función acepta un único
 310 argumento; éste puede ser un símbolo de la forma @var{'FulanoMengano}
 311 o una cadena de la forma @var{"FulanoMengano"}.  La primera forma es
 312 más rápida de escribir y también más eficiente.  Sin embargo, al usar
 313 la segunda forma es posible acceder a los colores de X11 por medio de
 314 la forma del nombre que tiene varias palabras.
 315
 316 Si @code{x11-color} no entiende el parámetro, el color predeterminado
 317 que se devuelve es el negro.
 318
 319 @lilypond[verbatim,quote,relative=2]
 320 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 321 \set Staff.instrumentName = \markup {
 322   \with-color #(x11-color 'navy) "Clarinet"
 323 }
 324
 325 gis8 a
 326 \override Beam #'color = #(x11-color "medium turquoise")
 327 gis a
 328 \override Accidental #'color = #(x11-color 'DarkRed)
 329 gis a
 330 \override NoteHead #'color = #(x11-color "LimeGreen")
 331 gis a
 332 % this is deliberate nonsense; note that the stems remain black
 333 \override Stem #'color = #(x11-color 'Boggle)
 334 b2 cis
 335 @end lilypond
 336
 337 @cindex rgb-color
 338 @cindex color rgb
 339 @cindex rgb, color
 340
 341 @funindex rgb-color
 342
 343 Se pueden especificar colores RGB exactos utilizando la función de
 344 Scheme @code{rgb-color}.
 345
 346 @lilypond[verbatim,quote,relative=2]
 347 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 348 \set Staff.instrumentName = \markup {
 349   \with-color #(x11-color 'navy) "Clarinet"
 350 }
 351
 352 \override Stem #'color = #(rgb-color 0 0 0)
 353 gis8 a
 354 \override Stem #'color = #(rgb-color 1 1 1)
 355 gis8 a
 356 \override Stem #'color = #(rgb-color 0 0 0.5)
 357 gis4 a
 358 @end lilypond
 359
 360
 361 @seealso
 362 Referencia de la notación:
 363 @ref{List of colors},
 364 @ref{The tweak command}.
 365
 366 Fragmentos de código:
 367 @rlsr{Editorial annotations}.
 368
 369
 370 @cindex x11,  color de
 371 @cindex coloreadas, notas de acorde
 372 @cindex notas coloreadas en acordes
 373 @cindex color en acordes
 374
 375 @funindex x11-color
 376
 377 @knownissues
 378 Un color de X11 no es necesariamente de la misma tonalidad exacta que
 379 un color normal de nombre similar.
 380
 381 No todos los colores de X11 se distinguen entre sí en un navegador
 382 web, es decir, un navegador de web podría no mostrar ninguna
 383 diferencia entre @code{'LimeGreen} (verde lima) y @code{'ForestGreen}
 384 (verde bosque).  Para la web se recomiendan los colores normales (o
 385 sea: @code{#blue}, azul, @code{#green}, verde, @code{#red}, rojo).
 386
 387 Las notas de un acorde no se pueden colorear con @code{\override}; en
 388 su lugar utilice @code{\tweak}.  Consulte @ref{The tweak command} para
 389 ver más detalles.
 390
 391
 392 @node Parentheses
 393 @unnumberedsubsubsec Parentheses
 394
 395 @cindex fantasma, notas
 396 @cindex notas fantasma
 397 @cindex notas entre paréntesis
 398 @cindex paréntesis
 399
 400 @funindex \parenthesize
 401 @funindex parenthesize
 402
 403 Los objetos se pueden encerrar entre paréntesis anteponiendo
 404 @code{\parenthesize} al evento musical.  Si se aplica a un acorde,
 405 encierra cada nota dentro de un par de paréntesis.  También se pueden
 406 poner entre paréntesis las notas individuales de un acorde.
 407
 408 @lilypond[verbatim,quote,relative=2]
 409 c2 \parenthesize d
 410 c2 \parenthesize <c e g>
 411 c2 <c \parenthesize e g>
 412 @end lilypond
 413
 414 Los objetos que no son notas también se pueden poner entre paréntesis.
 415
 416 @lilypond[verbatim,quote,relative=2]
 417 c2-\parenthesize -. d
 418 c2 \parenthesize r
 419 @end lilypond
 420
 421
 422 @seealso
 423 Fragmentos de código:
 424 @rlsr{Editorial annotations}.
 425
 426 Referencia de funciionamiento interno:
 427 @rinternals{Parenthesis_engraver},
 428 @rinternals{ParenthesesItem},
 429 @rinternals{parentheses-interface}.
 430
 431 @knownissues
 432
 433 Al poner un acorde entre paréntesis, se encierra cada una de las notas
 434 individuales entre paréntesis, en vez de un solo paréntesis grande
 435 rodeando al acorde completo.
 436
 437
 438 @node Stems
 439 @unnumberedsubsubsec Stems
 440
 441 @cindex plica
 442 @cindex plica invisible
 443 @cindex invisible, plica
 444
 445 @funindex \stemUp
 446 @funindex stemUp
 447 @funindex \stemDown
 448 @funindex stemDown
 449 @funindex \stemNeutral
 450 @funindex stemNeutral
 451
 452 Cuando se encuentra con una nota, se crea automáticamente un objeto
 453 @code{Stem} (plica).  Para las redondas y los silencios, también se
 454 crean pero se hacen invisibles.
 455
 456 @predefined
 457 @code{\stemUp},
 458 @code{\stemDown},
 459 @code{\stemNeutral}.
 460 @endpredefined
 461
 462 @snippets
 463
 464 @cindex stem, direction
 465 @cindex stem, up
 466 @cindex stem, down
 467 @cindex stem, neutral
 468
 469 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 470 {default-direction-of-stems-on-the-center-line-of-the-staff.ly}
 471
 472
 473 @seealso
 474 Referencia de la notación:
 475 @ref{Direction and placement}.
 476
 477 Fragmentos de código:
 478 @rlsr{Editorial annotations}.
 479
 480 Referencia de funcionamiento interno:
 481 @rinternals{Stem_engraver},
 482 @rinternals{Stem},
 483 @rinternals{stem-interface}.
 484
 485
 486 @node Outside the staff
 487 @subsection Outside the staff
 488
 489 Esta sección trata sobre cómo enfatizar elementos que están dentro del
 490 pentagrama, desde fuera del pentagrama.
 491
 492 @menu
 493 * Balloon help::
 494 * Grid lines::
 495 * Analysis brackets::
 496 @end menu
 497
 498 @node Balloon help
 499 @unnumberedsubsubsec Balloon help
 500
 501 @cindex globo
 502 @cindex notación, explicación de
 503 @cindex globo de ayuda
 504 @cindex ayuda, globos de
 505
 506 @funindex \balloonGrobText
 507 @funindex \balloonText
 508 @funindex Balloon_engraver
 509 @funindex balloonGrobText
 510 @funindex balloonText
 511 @funindex \balloonLengthOn
 512 @funindex balloonLengthOn
 513 @funindex \balloonLengthOff
 514 @funindex balloonLengthOff
 515
 516 Los elementos de notación se pueden marcar y nombrar con la ayuda de
 517 un cartel o globo de ayuda rectangular.  El propósito principal de
 518 esta funcionalidad es la explicación de la notación.
 519
 520 @c KEEP LY
 521 @lilypond[verbatim,quote,relative=2]
 522 \new Voice \with { \consists "Balloon_engraver" }
 523 {
 524   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
 525   a8
 526   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
 527   r
 528   <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
 529 }
 530 @end lilypond
 531
 532 Existen dos funciones musicales, @code{balloonGrobText} y
 533 @code{balloonText}; el primero se usa como @code{\once\override} para
 534 adjuntar un texto a cualquier grob, y el último se usa coqmo
 535 @code{\tweak}, normalmente dentro de acordes, para adjuntar un texto a
 536 una nota individual.
 537
 538 Los textos de globo normalmente influyen en el espaciado de las notas,
 539 pero esto puede cambiarse:
 540
 541 @c KEEP LY
 542 @lilypond[verbatim,quote,relative=2]
 543 \new Voice \with { \consists "Balloon_engraver" }
 544 {
 545   \balloonLengthOff
 546   \balloonGrobText #'Stem #'(3 . 4) \markup { "Soy una plica" }
 547   a8
 548   \balloonGrobText #'Rest #'(-4 . -4) \markup { "Soy un silencio" }
 549   r
 550   \balloonLengthOn
 551   <c, g'-\balloonText #'(-2 . -2) \markup { "Soy una cabeza" } c>2.
 552 }
 553 @end lilypond
 554
 555
 556 @predefined
 557 @code{\balloonLengthOn},
 558 @code{\balloonLengthOff}.
 559 @endpredefined
 560
 561
 562 @seealso
 563 Fragmentos de código:
 564 @rlsr{Editorial annotations}.
 565
 566 Referencia de funcionamiento interno:
 567 @rinternals{Balloon_engraver},
 568 @rinternals{BalloonTextItem},
 569 @rinternals{balloon-interface}.
 570
 571
 572 @node Grid lines
 573 @unnumberedsubsubsec Grid lines
 574
 575 @cindex rejilla, líneas de
 576 @cindex líneas de rejilla
 577 @cindex vertical, línea, entre pentagramas
 578 @cindex línea vertical entre pentagramas
 579
 580 @funindex Grid_point_engraver
 581 @funindex Grid_line_span_engraver
 582 @funindex gridInterval
 583
 584 Se pueden dibujar líneas verticales entre los pentagramas
 585 sincronizadas con las notas.
 586
 587 Se debe usar el grabador @code{Grid_point_engraver} para crear los
 588 puntos extremos de las líneas, mientras que el grabador
 589 @code{Grid_line_span_engraver} se debe utilizar para trazar
 590 efectivamente las líneas.  De forma predeterminada, esto centra las
 591 líneas de rejilla horizontalmente debajo y al lado izquierdo de la
 592 cabeza de las notas.  Las líneas de rejilla se extienden a partir de
 593 línea media de los pentagramas.  El intervalo @code{gridInterval} debe
 594 especificar la duración entre las líneas de rejilla.
 595
 596 @lilypond[verbatim,quote]
 597 \layout {
 598   \context {
 599     \Staff
 600     \consists "Grid_point_engraver"
 601     gridInterval = #(ly:make-moment 1 4)
 602   }
 603   \context {
 604     \Score
 605     \consists "Grid_line_span_engraver"
 606   }
 607 }
 608
 609 \score {
 610   \new ChoirStaff <<
 611     \new Staff \relative c'' {
 612       \stemUp
 613       c4. d8 e8 f g4
 614     }
 615     \new Staff \relative c {
 616       \clef bass
 617       \stemDown
 618       c4 g' f e
 619     }
 620   >>
 621 }
 622 @end lilypond
 623
 624 @snippets
 625
 626 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 627 {grid-lines--changing-their-appearance.ly}
 628
 629
 630 @seealso
 631 Fragmentos de código:
 632 @rlsr{Editorial annotations}.
 633
 634 Referencia de funcionamiento interno:
 635 @rinternals{Grid_line_span_engraver},
 636 @rinternals{Grid_point_engraver},
 637 @rinternals{GridLine},
 638 @rinternals{GridPoint},
 639 @rinternals{grid-line-interface},
 640 @rinternals{grid-point-interface}.
 641
 642
 643 @node Analysis brackets
 644 @unnumberedsubsubsec Analysis brackets
 645
 646 @cindex corchetes
 647 @cindex fraseo, corchetes de
 648 @cindex corchetes de fraseo
 649 @cindex musicológico, análisis
 650 @cindex análisis musicológico
 651 @cindex notas, corchetes de agrupación de
 652 @cindex horizontal, corchete
 653 @cindex corchete horizontal
 654
 655 @funindex Horizontal_bracket_engraver
 656 @funindex \startGroup
 657 @funindex startGroup
 658 @funindex \stopGroup
 659 @funindex stopGroup
 660
 661 Los corchetes se usan en análisis musical para indicar la estructura
 662 de las piezas musicales.  Están contemplados los corchetes
 663 horizontales simples.
 664
 665 @lilypond[verbatim,quote]
 666 \layout {
 667   \context {
 668     \Voice
 669     \consists "Horizontal_bracket_engraver"
 670   }
 671 }
 672 \relative c'' {
 673   c2\startGroup
 674   d\stopGroup
 675 }
 676 @end lilypond
 677
 678 Los corchetes de análisis se pueden anidar.
 679
 680 @lilypond[verbatim,quote]
 681 \layout {
 682   \context {
 683     \Voice
 684     \consists "Horizontal_bracket_engraver"
 685   }
 686 }
 687 \relative c'' {
 688   c4\startGroup\startGroup
 689   d4\stopGroup
 690   e4\startGroup
 691   d4\stopGroup\stopGroup
 692 }
 693 @end lilypond
 694
 695
 696 @seealso
 697 Fragmentos de código:
 698 @rlsr{Editorial annotations}.
 699
 700 Referencia de funcionamiento interno:
 701 @rinternals{Horizontal_bracket_engraver},
 702 @rinternals{HorizontalBracket},
 703 @rinternals{horizontal-bracket-interface},
 704 @rinternals{Staff}.