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