1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
3 Translation of GIT committish: 18d03fa6a724b0102ccc47d194209802cea02f2e
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
16 @lilypondfile[quote]{text-headword.ly}
18 Esta sección explica cómo incluir texto (con diversos estilos de
19 formateo) en las partituras.
22 Ciertos elementos de texto de los que no nos ocupamos aquí se
23 tratan en otras secciones específicas: @ref{Música vocal},
24 @ref{Títulos y encabezamientos}.
27 * Escritura del texto::
28 * Formatear el texto::
32 @node Escritura del texto
33 @subsection Escritura del texto
34 @translationof Writing text
36 Esta sección presenta las distintas formas de añadir texto a una
39 @cindex texto, en otros idiomas
40 @warning{Para escribir texto con caracteres acentuados y
41 especiales (como los de idiomas distintos del inglés),
42 sencillamente inserte los caracteres directamente en el archivo de
43 LilyPond. El archivo se debe guardar como UTF-8. Para ver más
44 información, consulte @ref{Codificación del texto}.}
49 * Extensiones de texto::
50 * Indicaciones de texto::
55 @node Guiones de texto
56 @unnumberedsubsubsec Guiones de texto
57 @translationof Text scripts
59 @cindex texto, inscripciones de
60 @cindex texto, elementos no vacíos de
61 @cindex no vacíos, textos
62 @cindex texto destacado
64 Es posible añadir indicaciones de @qq{texto entre comillas} a una
65 partitura, como se muestra en el ejemplo siguiente. Estas
66 indicaciones se pueden colocar manualmente por encima o por debajo
67 del pentagrama, utilizando la sintaxis que se describe en
68 @ref{Dirección y posición}.
70 @lilypond[quote,verbatim]
71 \relative { a'8^"pizz." g f e a4-"scherz." f }
74 Esta sintaxis es en realidad una abreviatura; se puede añadir
75 explícitamente a una nota un formateado de texto más complejo
76 utilizando un bloque @code{\markup}, como se describe bajo
77 @ref{Formatear el texto}.
79 @lilypond[quote,verbatim]
81 a'8^\markup { \italic pizz. } g f e
82 a4_\markup { \tiny scherz. \bold molto } f }
85 De forma predeterminada, las indicaciones de texto no afectan al
86 espaciado de las notas. Sin embargo, su anchura sí podría tenerse
87 en cuenta: en el siguiente ejemplo, la primera cadena de texto no
88 afecta al espaciado, pero la segunda sí afecta.
90 @lilypond[quote,verbatim]
98 Se pueden adjuntar articulaciones a las notas, además de
99 inscripciones de texto. Para ver más información, consulte
100 @ref{Articulaciones y ornamentos}.
102 Para ver más información sobre el orden relativo de las
103 inscripciones de texto y las articulaciones, consulte
104 @rlearning{Colocación de los objetos}.
106 @funindex \textLengthOn
107 @funindex \textLengthOff
110 @code{\textLengthOn},
111 @code{\textLengthOff}.
115 Manual de aprendizaje:
116 @rlearning{Colocación de los objetos}.
118 Referencia de la notación:
119 @ref{Formatear el texto},
120 @ref{Dirección y posición},
121 @ref{Articulaciones y ornamentos}.
123 Fragmentos de código:
126 Referencia de funcionamiento interno:
127 @rinternals{TextScript}.
130 @cindex texto fuera del margen
131 @cindex margen, texto fuera del
132 @cindex texto, mantener dentro del margen
133 @cindex letra, mantener dentro del margen
136 La comprobación necesaria para asegurar que las inscripciones de
137 texto y la letra de las canciones se mantienen dentro de los
138 márgenes, requiere cálculos adicionales. En caso de que desee un
139 proceso ligeramente más rápido, puede utilizar
142 \override Score.PaperColumn.keep-inside-line = ##f
146 @node Extensiones de texto
147 @unnumberedsubsubsec Extensiones de texto
148 @translationof Text spanners
150 @cindex texto, elementos de extensión
152 Ciertas indicaciones de ejecución, p.ej., @i{rallentando} o
153 @i{accelerando}, se escriben como texto y se extienden sobre
154 muchos compases mediante líneas de puntos. Estos objetos, que
155 reciben el nombre de @q{spanners} u objetos de extensión, se
156 pueden crear desde una nota hasta otra usando la siguiente
159 @lilypond[verbatim,quote]
161 \override TextSpanner.bound-details.left.text = "rit."
167 @cindex texto, formateado de los elementos de extensión
168 @cindex formato de los elementos de extensión de texto
171 La cadena de texto que imprimir se establece a través de
172 propiedades de objeto. De forma predeterminada se imprime en
173 estilo cursiva, pero se pueden conseguir distintos efectos de
174 formato utilizando bloques @code{\markup}, como se describe en
175 @ref{Formatear el texto}.
177 @lilypond[quote,verbatim]
179 \override TextSpanner.bound-details.left.text =
180 \markup { \upright "rit." }
186 El estilo de la línea, así como la cadena de texto, se pueden
187 definir como una propiedad de objeto. Esta sintaxis se describe
188 en @ref{Estilos de línea}.
190 @funindex \textSpannerUp
191 @funindex \textSpannerDown
192 @funindex \textSpannerNeutral
196 @code{\textSpannerUp},
197 @code{\textSpannerDown},
198 @code{\textSpannerNeutral}.
202 LilyPond sólo puede manejar un objeto de extensión de texto por
206 @lilypondfile[verbatim,quote,texidoc,doctitle]
207 {dynamics-text-spanner-postfix.ly}
209 @lilypondfile[verbatim,quote,texidoc,doctitle]
210 {dynamics-custom-text-spanner-postfix.ly}
213 Referencia de la notación:
214 @ref{Estilos de línea},
215 @ref{Matices dinámicos},
216 @ref{Formatear el texto}.
218 Fragmentos de código:
220 @rlsr{Expressive marks}.
222 Referencia de funcionamiento interno:
223 @rinternals{TextSpanner}.
226 @node Indicaciones de texto
227 @unnumberedsubsubsec Indicaciones de texto
228 @translationof Text marks
230 @cindex texto, indicaciones de
231 @cindex indicaciones de texto
232 @cindex texto sobre la barra de compás
233 @cindex coda sobre la línea divisoria
234 @cindex segno sobre la línea divisoria
235 @cindex calderón sobre la línea divisoria
236 @cindex líneas divisorias, símbolos sobre las
241 Se pueden añadir a la partitura varios elementos de texto con la
242 sintaxis que se describe en @ref{Llamadas de ensayo}:
244 @c \mark needs to be placed on a separate line (it's not
245 @c attached to an object like \markup is). -vv
247 @lilypond[verbatim,quote]
258 Esta sintaxis posibilita colocar cualquier texto sobre la línea
259 divisoria; se pueden incorporar formatos más complejos para el
260 texto usando un bloque @code{\markup}, como está explicado en
261 @ref{Formatear el texto}:
263 @lilypond[quote,verbatim]
266 \mark \markup { \italic { colla parte } }
273 Esta sintaxis también permite imprimir símbolos especiales como
274 llamadas, segno o calderones, especificando el nombre del símbolo
275 correspondiente como se explica en
276 @ref{Notación musical dentro de elementos de marcado}:
278 @lilypond[quote,verbatim]
281 \mark \markup { \musicglyph #"scripts.ufermata" }
287 Estos objetos se tipografían solamente sobre el pentagrama
288 superior de la partitura; dependiendo de si están especificados al
289 final o en medio de un compás, se colocarán sobre la línea
290 divisoria o entre las notas. Si se especifican en un salto de
291 línea, las llamadas se imprimen al principio de la línea
294 @lilypond[quote,verbatim,ragged-right]
303 @funindex \markLengthOn
304 @funindex \markLengthOff
307 @code{\markLengthOn},
308 @code{\markLengthOff}.
313 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
314 {printing-marks-at-the-end-of-a-line.ly}
316 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
317 {printing-marks-on-every-staff.ly}
320 Referencia de la notación:
321 @ref{Llamadas de ensayo},
322 @ref{Formatear el texto},
323 @ref{Notación musical dentro de elementos de marcado},
324 @ref{La tipografía Emmentaler}.
326 Fragmentos de código:
329 Referencia de funcionamiento interno:
330 @rinternals{MarkEvent},
331 @rinternals{Mark_engraver},
332 @rinternals{RehearsalMark}.
336 @unnumberedsubsubsec Texto separado
337 @translationof Separate text
339 @cindex separado, texto
340 @cindex texto separado
341 @cindex independiente, texto
342 @cindex nivel superior, texto del
343 @cindex texto del nivel superior
344 @cindex texto independiente
348 Un bloque @code{\markup} puede existir de forma independiente,
349 fuera de cualquier bloque @code{\score}, como una @qq{expresión de
350 nivel superior}. Esta sintaxis se describe en
351 @ref{Estructura del archivo}.
353 @lilypond[verbatim,quote]
355 Tomorrow, and tomorrow, and tomorrow...
360 Esto hace posible imprimir texto separado de la música, lo que es
361 especialmente útil cuando el archivo de entrada contiene varias
362 piezas, tal y como se describe en
363 @ref{Varias partituras en un libro}.
365 @lilypond[quote,verbatim]
370 Tomorrow, and tomorrow, and tomorrow...
377 Los bloques de texto independientes pueden abarcar varias páginas,
378 posibilitando la impresión de documentos de texto o libros
379 íntegramente desde LilyPond. Esta funcionalidad y la sintaxis que
380 requiere se describen en
381 @ref{Elementos de marcado de varias páginas}.
385 @funindex \markuplist
394 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
395 {stand-alone-two-column-markup.ly}
398 Referencia de la notación:
399 @ref{Formatear el texto},
400 @ref{Estructura del archivo},
401 @ref{Varias partituras en un libro},
402 @ref{Elementos de marcado de varias páginas}.
404 Fragmentos de código:
407 Referencia de funcionamiento interno:
408 @rinternals{TextScript}.
411 @node Formatear el texto
412 @subsection Formatear el texto
413 @translationof Formatting text
415 Esta sección presenta los formateados básico y avanzado de texto,
416 usando la sintaxis específica del modo de @code{\markup}.
419 * Introducción al marcado de texto::
420 * Seleccionar la tipografía y su tamaño::
421 * Alineación de texto::
422 * Notación gráfica dentro de elementos de marcado::
423 * Notación musical dentro de elementos de marcado::
424 * Elementos de marcado de varias páginas::
427 @node Introducción al marcado de texto
428 @unnumberedsubsubsec Introducción al marcado de texto
429 @translationof Text markup introduction
432 @cindex texto, marcado de
433 @cindex marcado de texto
434 @cindex tipografiar texto
438 Se usa un bloque @code{\markup} para tipografiar texto con una
439 sintaxis ampliable que se denomina @qq{modo de marcado}.
441 @cindex marcado, expresiones de
442 @cindex expresiones de marcado
443 @cindex marcado, sintaxis
444 @cindex sintaxis del marcado
446 La sintaxis del marcado es similar a la sintaxis usual de
447 LilyPond: una expresión @code{\markup} se encierra entre llaves
448 @code{@{ @dots{} @}}. Una sola palabra se considera como una
449 expresión mínima, y por tanto no necesita estar encerrada entre
452 A diferencia de las indicaciones de @qq{texto entrecomillado}
453 simples, los bloques @code{\markup} pueden contener expresiones
454 anidadas o instrucciones de marcado, que se introducen utilizando
455 el carácter de barra invertida @code{\} . Estas instrucciones sólo
456 afectan a la expresión que sigue inmediatamente.
458 @lilypond[quote,verbatim]
461 a2^\markup { poco \italic più forte }
463 d2_\markup { \italic "string. assai" }
465 b1^\markup { \bold { molto \italic agitato } }
470 @cindex caracteres especiales en modo de marcado
471 @cindex marcado, caracteres especiales en modo de
472 @cindex reservados, impresión de caracteres
473 @cindex impresión de caracteres especiales
474 @cindex texto entrecomillado en modo de marcado
476 Un bloque @code{\markup} puede contener también cadenas de texto
477 entre comillas. Dichas cadenas se tratan como expresiones de
478 texto mínimas, y por tanto cualquier instrucción de marcado o
479 carácter especial (como @code{\} y@tie{}@code{#}) se imprimen
480 literalmente sin afectar al formateo del texto. Se puede hacer
481 que se impriman las propias comillas si se les antepone una barra
484 @lilypond[quote,verbatim]
486 a'1^"\italic markup..."
487 a_\markup { \italic "... prints \"italic\" letters!" }
492 Para que se traten como una expresión distinta, es necesario que
493 las listas de palabras estén encerradas entre comillas o
494 precedidas de una instrucción. La forma en que están definidas
495 las expresiones de marcado afecta a cómo se apilan, se centran y
496 se alinean estas expresiones; en el ejemplo siguiente, la segunda
497 expresión @code{\markup} se trata igual que la primera:
499 @lilypond[quote,verbatim]
501 c1^\markup { \center-column { a bbb c } }
502 c1^\markup { \center-column { a { bbb c } } }
503 c1^\markup { \center-column { a \line { bbb c } } }
504 c1^\markup { \center-column { a "bbb c" } }
508 Los marcados se pueden almacenar dentro de variables. Estas
509 variables se pueden adjuntar directamente a las notas:
511 @lilypond[quote,verbatim]
512 allegro = \markup { \bold \large Allegro }
522 Se puede encontrar una lista exhaustiva de las instrucciones
523 específicas de @code{\markup} en @ref{Text markup commands}.
526 Referencia de la notación:
527 @ref{Text markup commands}.
529 Fragmentos de código:
533 @file{scm/markup.scm}.
536 Los mensajes de error de sintaxis para el modo de marcado a menudo producen
540 @node Seleccionar la tipografía y su tamaño
541 @unnumberedsubsubsec Seleccionar la tipografía y su tamaño
542 @translationof Selecting font and font size
544 @cindex fuente tipográfica, cambiar
545 @cindex cambio de la fuente tipográfica
551 Está contemplado de forma básica el cambio de la fuente
552 tipográfica en el modo de marcado:
554 @lilypond[quote,verbatim]
558 \italic { non troppo \underline Vivo }
561 d,_\markup { \italic quasi \smallCaps Tromba }
566 @cindex fuente tipográfica, tamaño de
567 @cindex texto, tamaño de
569 @funindex \abs-fontsize
575 El tamaño de la fuente tipográfica se puede alterar en relación al
576 tamaño global del pentagrama, de una serie de formas como se ve a
579 Se puede fijar a un tamaño predefinido:
581 @lilypond[quote,verbatim]
583 b1_\markup { \huge Sinfonia }
584 b1^\markup { \teeny da }
585 b1-\markup { \normalsize camera }
589 Se puede establecer a un tamaño relativo al valor anterior:
591 @lilypond[quote,verbatim]
593 b1_\markup { \larger Sinfonia }
594 b1^\markup { \smaller da }
595 b1-\markup { \magnify #0.6 camera }
599 Se puede aumentar o disminuir de forma relativa al valor fijado
600 por el tamaño global del pentagrama:
602 @lilypond[quote,verbatim]
604 b1_\markup { \fontsize #-2 Sinfonia }
605 b1^\markup { \fontsize #1 da }
606 b1-\markup { \fontsize #3 camera }
610 También se puede establecer a un tamaño de puntos fijo,
611 independientemente del tamaño global del pentagrama:
613 @lilypond[quote,verbatim]
615 b1_\markup { \abs-fontsize #20 Sinfonia }
616 b1^\markup { \abs-fontsize #8 da }
617 b1-\markup { \abs-fontsize #14 camera }
621 Si el texto incluye espacios, es mejor escribir todo entre
622 comillas, de forma que el tamaño de cada espacio sea correcto para
623 el tamaño de los otros caracteres.
625 @lilypond[quote,verbatim]
626 \markup \fontsize #6 \bold { Sinfonia da camera }
627 \markup \fontsize #6 \bold { "Sinfonia da camera" }
635 @funindex \normal-size-super
637 El texto se puede imprimir como subíndice o como superíndice. De
638 forma predeterminada se imprimen en un tamaño menor, pero también
639 se puede usar un tamaño normal:
641 @lilypond[quote,verbatim]
644 \line { 1 \super st movement }
645 \line { 1 \normal-size-super st movement
646 \sub { (part two) } }
651 @cindex fuente tipográfica, familias de
653 El modo de marcado ofrece una manera fácil de elegir familias de
654 tipografía alternativas. A no ser que se especifique de otro
655 modo, se selecciona automáticamente la fuente predeterminada con
656 serifa, de tipo romano: en la última línea del ejemplo siguiente,
657 no hay diferencia entre la primera y la segunda palabra.
659 @lilypond[quote,verbatim]
662 \line { Act \number 1 }
663 \line { \sans { Scene I. } }
664 \line { \typewriter { Verona. An open place. } }
665 \line { Enter \roman Valentine and Proteus. }
671 Algunas de estas familias, usadas para elementos específicos como
672 números o matices, no ofrecen todos los caracteres, como se explica en
673 @ref{Indicaciones dinámicas contemporáneas} y
674 @ref{Marcas de repetición manual}.
676 @c \concat is actually documented in Align (it is not
677 @c a font-switching command). But we need it here. -vv
679 Si se usan dentro de una palabra, algunas instrucciones de cambio
680 de tipografía o de formateo pueden producir un espacio vacío no
681 deseado. Esto se puede solucionar concatenando en uno solo los
682 distintos elementos de texto:
684 @lilypond[quote,verbatim]
688 \concat { 1 \super st }
692 \concat { \dynamic p , }
693 \italic { con dolce espressione }
699 Se puede encontrar una lista exhaustiva de instrucciones de cambio
700 y utilización personalizada de las fuentes tipográficas en
703 También es posible definir conjuntos personalizados de fuentes,
704 tal y como se explica en @ref{Tipografías}.
709 @funindex \normalsize
728 Referencia de la notación:
730 @ref{Indicaciones dinámicas contemporáneas},
731 @ref{Marcas de repetición manual},
735 @file{scm/define-markup-commands.scm}.
737 Fragmentos de código:
740 Referencia de funcionamiento interno:
741 @rinternals{TextScript}.
744 La utilización de las instrucciones de tamaño de texto
745 @code{\teeny}, @code{\tiny}, @code{\small}, @code{\normalsize},
746 @code{\large} y @code{\huge} conducen a un espaciado de las líneas
747 inconsistente comparado con el uso de @code{\fontsize}.
750 @node Alineación de texto
751 @unnumberedsubsubsec Alineación de texto
752 @translationof Text alignment
754 @cindex texto, alineación de
755 @cindex alinear texto
756 @cindex alinear texto de marcado
757 @cindex alinear elementos de marcado
758 @cindex marcado, elementos, alinear
759 @cindex marcado, texto, alinear
761 Esta subsección trata sobre cómo colocar texto en el modo de
762 marcado. Los objetos de marcado también se pueden mover como un
763 todo, usando la sintaxis que se describe en
764 @rlearning{Mover objetos}.
766 @c Padding commands should be mentioned on this page, but
767 @c most of these require \box to be more clearly illustrated. -vv
769 @cindex texto, alineación horizontal
770 @cindex horizontal, alineación de texto
772 @funindex \left-align
773 @funindex \center-align
774 @funindex \right-align
776 Los objetos de marcado se pueden alinear de distintas maneras. De
777 forma predeterminada, una indicación de texto se alinea sobre el
778 borde izquierdo: en el ejemplo siguiente, no existe diferencia
779 entre los marcados primero y segundo.
781 @lilypond[quote,verbatim]
783 d''1-\markup { poco }
785 d-\markup { \left-align poco }
787 d-\markup { \center-align { poco } }
789 d-\markup { \right-align poco }
795 Se puede realizar un ajuste fino de la alineación horizontal usando un
798 @lilypond[quote,verbatim]
800 a'1-\markup { \halign #-1 poco }
802 a,-\markup { \halign #0 poco }
804 a,-\markup { \halign #0.5 poco }
806 a,-\markup { \halign #2 poco }
811 Ciertos objetos pueden poseer sus propios procedimientos de
812 alineación, y por tanto no resultan afectados por estas
813 instrucciones. Es posible mover estos objetos de marcado como un
814 todo, como se muestra por ejemplo en @ref{Indicaciones de texto}.
816 @cindex texto, alineación vertical
817 @cindex vertical, alineación de texto
823 La alineación vertical es un poco más compleja. Como se ha dicho
824 más arriba, los objetos de marcado se pueden mover como un todo;
825 sin embargo, también es posible mover elementos específicos dentro
826 de un bloque de marcado. En este caso, el elemento a mover se
827 debe preceder de un @emph{punto de anclaje}, que puede ser otro
828 elemento de marcado o un objeto invisible. El ejemplo siguiente
829 ejemplifica estas dos posibilidades; el último marcado en este
830 ejemplo no tiene punto de anclaje y por ello no resulta movido.
832 @lilypond[quote,verbatim]
836 \raise #2 { Scène 1 }
841 \lower #4 \bold { Très modéré }
845 \raise #4 \italic { Une forêt. }
851 @funindex \general-align
853 @funindex \translate-scaled
855 Algunas instrucciones pueden afectar tanto a la alineación
856 horizontal como a la vertical de los objetos de texto en el modo
857 de marcado. Cualquier objeto afectado por estas instrucciones se
858 deben preceder de un punto de anclaje:
860 @lilypond[quote,verbatim]
864 \translate #'(-1 . 2) "Scène 1"
869 \general-align #Y #3.2 \bold "Très modéré"
874 \translate-scaled #'(-1 . 2) \teeny "Une forêt."
880 @cindex varias líneas, marcado
881 @cindex marcado de varias líneas
882 @cindex varias líneas, texto
883 @cindex texto de varias líneas
884 @cindex texto en columnas
885 @cindex columnas, texto
888 @funindex \center-column
890 Un objeto de marcado puede incluir varias líneas de texto. En el
891 ejemplo siguiente, cada elemento o expresión se sitúa en su propia
892 línea, ya sea alineada por la izquierda o centrada:
894 @lilypond[quote,verbatim]
910 @cindex centrar texto en la página
911 @cindex texto, centrar en la página
912 @cindex marcado, centrar en la página
916 De forma similar, una lista de elementos o expresiones se puede
917 repartir de forma que rellene por completo el ancho de la línea
918 horizontal (si hay un solo elemento, se centra en el papel). A su
919 vez, estas expresiones pueden incluir texto de varias líneas o
920 cualquier otra expresión de marcado:
922 @lilypond[quote,verbatim]
925 \line { William S. Gilbert }
927 \huge \smallCaps "The Mikado"
929 \smallCaps "The Town of Titipu"
931 \line { Sir Arthur Sullivan }
939 @cindex texto ajustado a palabras
940 @cindex texto justificado
941 @cindex justificado, texto
942 @cindex ajustado a palabras, texto
943 @cindex marcado, texto, ajustado a palabras
944 @cindex texto de marcado ajustado a palabras
945 @cindex ajuste de línea, texto con
951 Las indicaciones de texto largas se pueden también ajustar
952 automáticamente según un ancho de línea dado. Estarán alineados
953 por la izquierda o justificados, como se muestra en el ejemplo
956 @lilypond[quote,verbatim]
959 \line \smallCaps { La vida breve }
960 \line \bold { Acto I }
962 (La escena representa el corral de una casa de
963 gitanos en el Albaicín de Granada. Al fondo una
964 puerta por la que se ve el negro interior de
965 una Fragua, iluminado por los rojos resplandores
970 \line \bold { Acto II }
971 \override #'(line-width . 50)
973 (Calle de Granada. Fachada de la casa de Carmela
974 y su hermano Manuel con grandes ventanas abiertas
975 a través de las que se ve el patio
976 donde se celebra una alegre fiesta)
982 @cindex texto, instrucciones de alineación
983 @cindex marcado, texto, instrucciones de alineación
984 @cindex alineación, instrucciones de texto
986 Hay una lista exhaustiva de instrucciones de alineación de texto
990 Manual de aprendizaje:
991 @rlearning{Mover objetos}.
993 Referencia de la notación:
995 @ref{Indicaciones de texto}.
998 @file{scm/define-markup-commands.scm}.
1000 Fragmentos de código:
1003 Referencia de funcionamiento interno:
1004 @rinternals{TextScript}.
1007 @node Notación gráfica dentro de elementos de marcado
1008 @unnumberedsubsubsec Notación gráfica dentro de elementos de marcado
1009 @translationof Graphic notation inside markup
1011 @cindex gráficos, insertar
1012 @cindex dibujar objetos gráficos
1013 @cindex gráficos, dibujar objetos
1014 @cindex insertar objetos gráficos
1015 @cindex gráficos, insertar objetos
1017 Se puede añadir diversos objetos gráficos a una partitura,
1018 utilizando instrucciones de marcado.
1020 @cindex enmarcar texto
1021 @cindex texto, enmarcar
1022 @cindex texto, decorar
1023 @cindex marcado, texto, decorar
1024 @cindex marcado, texto, enmarcar
1025 @cindex decorar texto
1029 @funindex \rounded-box
1033 Ciertas instrucciones de marcado permiten la decoración de
1034 elementos de texto con gráficos, como se muestra en el ejemplo
1037 @lilypond[quote,verbatim]
1038 \markup \fill-line {
1046 \bracket "1866 - 1925"
1049 \rounded-box \bold Prelude
1054 @cindex relleno alrededor de texto
1055 @cindex texto, relleno de
1056 @cindex marcado, relleno de textos de
1058 @funindex \pad-markup
1060 @funindex \pad-to-box
1061 @funindex \pad-around
1063 Algunas instrucciones pueden requerir un aumento del relleno
1064 alrededor del texto: esto se puede conseguir con algunas
1065 instrucciones de marcado descritas exhaustivamente en @ref{Align}.
1067 @lilypond[quote,verbatim]
1068 \markup \fill-line {
1070 \box "Charles Ives (1874 - 1954)"
1072 \box \pad-markup #2 "THE UNANSWERED QUESTION"
1073 \box \pad-x #8 "A Cosmic Landscape"
1080 \box \pad-to-box #'(-5 . 20) #'(0 . 5)
1081 \bold "Largo to Presto"
1084 "String quartet keeps very even time,
1085 Flute quartet keeps very uneven time."
1089 @cindex gráfica, notación
1090 @cindex símbolos no musicales
1091 @cindex no musicales, símbolos
1092 @cindex notación gráfica
1095 @funindex \draw-circle
1096 @funindex \filled-box
1098 @funindex \draw-line
1099 @funindex \arrow-head
1101 Se pueden imprimir otros símbolos o elementos gráficos sin que se
1102 requiera ningún otro texto. De igual manera que en el caso de las
1103 expresiones de marcado, dichos objetos se pueden combinar:
1105 @lilypond[quote,verbatim]
1108 \draw-circle #4 #0.4 ##f
1109 \filled-box #'(-4 . 4) #'(-0.5 . 0.5) #1
1115 \draw-line #'(0 . 4)
1116 \arrow-head #Y #DOWN ##f
1121 @cindex insertar gráficos
1122 @cindex imágenes, insertar
1123 @cindex gráficos, insertar
1127 @funindex \postscript
1129 Entre las funcionalidades gráficas avanzadas se encuentran la
1130 posibilidad de incluir archivos de imagen externos convertidos al
1131 formato de PostScript Encapsulado (@emph{eps}), y la inclusión
1132 directa de gráficos dentro del archivo de entrada, usando código
1133 PostScript nativo. En tal caso puede ser de utilidad la
1134 especificación explícita del tamaño del dibujo, como se
1135 ejemplifica a continuación:
1137 @lilypond[quote,verbatim,fragment]
1140 \epsfile #X #10 #"./context-example.eps"
1141 \with-dimensions #'(0 . 6) #'(0 . 10)
1157 Hay una lista exhaustiva de instrucciones específicas de gráficos
1161 Referencia de la notación:
1164 @ref{Anotaciones editoriales},
1168 @file{scm/define-markup-commands.scm},
1169 @file{scm/stencil.scm}.
1171 Fragmentos de código:
1174 Referencia de funcionamiento interno:
1175 @rinternals{TextScript}.
1178 @node Notación musical dentro de elementos de marcado
1179 @unnumberedsubsubsec Notación musical dentro de elementos de marcado
1180 @translationof Music notation inside markup
1182 @cindex notación dentro de marcado
1183 @cindex música dentro de marcado
1184 @cindex marcado, notación musical dentro de
1186 Se pueden añadir a la partitura diversos elementos de notación
1187 musical, dentro de un objeto de marcado.
1189 Las notas y las alteraciones se pueden escribir utilizando
1190 instrucciones de marcado:
1192 @lilypond[quote,verbatim,fragment]
1196 \note-by-number #1 #1 #1.5
1199 \natural \semiflat \flat
1200 \sesquiflat \doubleflat
1204 \natural \semisharp \sharp
1205 \sesquisharp \doublesharp
1210 Otros objetos de notación se pueden también imprimir en el modo de
1213 @lilypond[quote,verbatim]
1216 ees\finger \markup \tied-lyric #"4~1"
1217 fis_\markup { \dynamic rf }
1229 De forma más general, cualquier símbolo musical disponible se
1230 puede incluir por separado dentro de un objeto de marcado, como se
1231 ejemplifica a continuación; hay una lista exhaustiva de estos
1232 símbolos y sus nombres en @ref{La tipografía Emmentaler}.
1234 @lilypond[quote,verbatim]
1237 c'^\markup { \musicglyph #"eight" }
1239 c,8._\markup { \musicglyph #"clefs.G_change" }
1241 c2^\markup { \musicglyph #"timesig.neomensural94" }
1245 Otra forma de imprimir glifos que no son de texto se encuentra
1246 descrita en @ref{Explicación de las fuentes tipográficas}. Tiene
1247 la utilidad de imprimir llaves de distintos tamaños.
1249 El modo de marcado también contempla diagramas para instrumentos
1252 @lilypond[quote,verbatim]
1255 \fret-diagram-terse #"x;x;o;2;3;2;"
1258 \harp-pedal #"^-v|--ov^"
1263 \musicglyph #"accordion.discant"
1265 \raise #0.5 \musicglyph #"accordion.dot"
1266 \raise #1.5 \musicglyph #"accordion.dot"
1271 @c The accordion diagram is actually taken from a snippet.
1274 Dichos diagramas se encuentran documentados en @ref{Instrument
1277 @cindex partitura dentro marcado
1278 @cindex marcado, partitura dentro de
1280 Incluso una partitura completa se puede incluir dentro de un
1281 objeto de marcado. En tal caso, el bloque anidado @code{\score}
1282 debe contener un bloque @code{\layout}, como se muestra aquí:
1284 @lilypond[quote,verbatim]
1288 \relative { c'4 d e f }
1297 Hay una lista exhaustiva de instrucciones relacionadas con la
1298 notación musical en @ref{Music}.
1301 Referencia de la notación:
1303 @ref{La tipografía Emmentaler},
1304 @ref{Explicación de las fuentes tipográficas}.
1307 @file{scm/define-markup-commands.scm},
1308 @file{scm/fret-diagrams.scm},
1309 @file{scm/harp-pedals.scm}.
1311 Fragmentos de código:
1314 Referencia de funcionamiento interno:
1315 @rinternals{TextScript}.
1318 @node Elementos de marcado de varias páginas
1319 @unnumberedsubsubsec Elementos de marcado de varias páginas
1320 @translationof Multi-page markup
1322 @cindex páginas, marcado de varias
1323 @cindex marcado de varias páginas
1324 @cindex marcado, texto de, varias páginas
1325 @cindex texto que ocupa varias páginas
1327 @funindex \markuplist
1328 @funindex \justified-lines
1329 @funindex \wordwrap-lines
1331 Aunque los objetos de marcado estándar no se pueden dividir, una
1332 sintaxis específica hace posible la introducción de líneas de
1333 texto que pueden abarcar varias páginas:
1336 @lilypond[quote,verbatim]
1339 Un texto muy largo de líneas justificadas.
1343 Otro párrafo muy largo.
1350 Esta sintaxis acepta una lista de elementos de marcado, que pueden ser
1353 el resultado de una instrucción de lista de marcado,
1355 una lista de marcados,
1357 o una lista de listas de marcado.
1360 Hay una lista exhaustiva de las instrucciones de lista de marcado
1361 en @ref{Instrucciones de listas de marcado de texto}.
1364 Referencia de la notación:
1365 @ref{Instrucciones de listas de marcado de texto}.
1368 @file{scm/define-markup-commands.scm}.
1370 Manual de extensión:
1371 @rextend{Definición de nuevas instrucciones de lista de marcado}.
1373 Fragmentos de código:
1376 Referencia de funcionamiento interno:
1377 @rinternals{TextScript}.
1379 @funindex \markuplist
1387 @subsection Tipografías
1388 @translationof Fonts
1390 Esta sección presenta la forma en que se manejan las fuentes
1391 tipográficas, y cómo se pueden cambiar en las partituras.
1394 * Explicación de las fuentes tipográficas::
1395 * Fuentes de un solo elemento::
1396 * Fuentes tipográficas del documento completo::
1400 @node Explicación de las fuentes tipográficas
1401 @unnumberedsubsubsec Explicación de las fuentes tipográficas
1402 @translationof Fonts explained
1405 @cindex fuentes tipográficas, explicación
1406 @cindex llaves de distintos tamaños
1407 @cindex fuentes tipográficas, explicación
1408 @cindex llaves de varios tamaños
1409 @cindex fuentes tipográficas de símbolos en marcado
1410 @cindex símbolos, fuentes tipográficas en el marcado
1412 @funindex font-interface
1414 Las fuentes tipográficas se manejan a través de distintas
1415 bibliotecas. FontConfig se utiliza para detectar las tipografías
1416 disponibles en el sistema; las tipografías seleccionadas se trazan
1419 Las tipografías de notación musical se pueden describir como un
1420 conjunto de glifos específicos, ordenados en varias familias. La
1421 siguiente sintaxis permite usar directamente varios glifos de la tipografía
1422 @code{Feta} de LilyPond distintas a las de texto en el modo de
1425 @lilypond[quote,verbatim,fragment]
1428 \override #'(font-encoding . fetaBraces)
1430 \override #'(font-encoding . fetaText)
1432 \override #'(font-encoding . fetaMusic)
1433 \lookup #"noteheads.s0petrucci"
1439 Sin embargo, todos estos glifos excepto las llaves de varios
1440 tamaños que están contenidas en la fuente tipográfica
1441 @code{fetaBraces} están disponibles utilizando la sintaxis más
1442 sencilla que se describe en
1443 @ref{Notación musical dentro de elementos de marcado}.
1445 Cuando se usan los glifos de la fuente de llaves
1446 @code{fetaBraces}, el tamaño de la llave se especifica por la
1447 parte numérica del nombre del glifo, en unidades arbitrarias. Se
1448 puede especificar cualquier entero de @code{0} a @code{575}
1449 inclusive, siendo @code{0} el que produce la llave más pequeña.
1450 El valor óptimo se debe determinar por ensayo y error. Todos
1451 estos glifos son llaves izquierdas; las llaves derechas se pueden
1452 obtener mediante rotación, véase @ref{Rotación de objetos}.
1454 Están disponibles tres familias de fuentes tipográficas para el
1458 La fuente @emph{roman} (serif), que de forma predeterminada es
1459 LilyPond Serif (un alias de TeX Gyre Schola).
1461 La fuente @emph{sans}, que de forma predeterminada es LilyPond
1462 Sans Serif (un alias de TeX Gyre Heros).
1464 La fuente @emph{typewriter} mecanográfica (monoespaciada), que de
1465 forma predeterminada es LilyPond Monospace (un alias de TeX Gyre
1469 Cada familia puede incluir distintas formas y series. El ejemplo
1470 siguiente muestra la posibilidad de seleccionar familias, formas,
1471 series y tamaños alternativos. El valor que se da a
1472 @code{font-size} es el cambio requerido a partir del tamaño
1475 @lilypond[quote,verbatim,fragment]
1476 \override Score.RehearsalMark.font-family = #'typewriter
1477 \mark \markup "Ouverture"
1478 \override Voice.TextScript.font-shape = #'italic
1479 \override Voice.TextScript.font-series = #'bold
1480 d''2.^\markup "Allegro"
1481 \override Voice.TextScript.font-size = #-3
1486 Se puede usar una sintaxis similar en el modo de marcado, aunque
1487 en este caso es preferible usar la sintaxis sencilla que se
1488 explica en @ref{Seleccionar la tipografía y su tamaño}:
1490 @lilypond[quote,verbatim]
1494 \override #'(font-shape . italic)
1495 \override #'(font-size . 4)
1499 \override #'(font-family . typewriter)
1501 \override #'(font-series . bold)
1505 \override #'(font-family . sans)
1512 Aunque es fácil cambiar entre las fuentes tipográficas
1513 preconfiguradas, también es posible usar otras fuentes, como se
1514 explica en las siguientes secciones:
1515 @ref{Fuentes de un solo elemento} y
1516 @ref{Fuentes tipográficas del documento completo}.
1519 Referencia de la notación:
1520 @ref{La tipografía Emmentaler},
1521 @ref{Notación musical dentro de elementos de marcado},
1522 @ref{Rotación de objetos},
1523 @ref{Seleccionar la tipografía y su tamaño},
1527 @node Fuentes de un solo elemento
1528 @unnumberedsubsubsec Fuentes de un solo elemento
1529 @translationof Single entry fonts
1531 Se puede usar en una partitura cualquier fuente tipográfica que
1532 esté instalada en el sistema operativo y reconocida por parte de
1533 FontConfig, usando la siguiente sintaxis:
1535 @lilypond[quote,verbatim,fragment]
1536 \override Staff.TimeSignature.font-name = #"Bitstream Charter"
1537 \override Staff.TimeSignature.font-size = #2
1541 \override #'(font-name . "Bitstream Vera Sans,sans-serif, Oblique Bold")
1542 { Vera Oblique Bold }
1546 @cindex fuentes tipográficas, buscar, disponibles
1547 @cindex buscar fuentes tipográficas disponibles
1548 @cindex listar fuentes tipográficas disponibles
1549 @cindex disponibles, listar las fuentes tipográficas
1551 @var{font-name} puede describirse usando una lista de @q{fuentes
1552 tipográfcias} separadas por comas y una lista de @q{estilos}
1553 separados por espacios. En la medida en que la @q{fuente
1554 tipográfica} de la lista esté instalada y contenga el glifo
1555 solicitado, se usará. En caso contrario, se usará como
1556 sustitución la @emph{siguiente} fuente tipográfica de la lista.
1558 @funindex show-available-fonts
1560 La ejecución de lilypond con la opción siguiente presenta una
1561 lista de todas las tipografías disponibles en el sistema
1565 lilypond -dshow-available-fonts x
1569 Referencia de la notación:
1570 @ref{Explicación de las fuentes tipográficas},
1571 @ref{Fuentes tipográficas del documento completo}.
1573 Fragmentos de código:
1576 @c A source file gets never installed...
1578 @c @file{lily/font-config-scheme.cc}.
1581 @node Fuentes tipográficas del documento completo
1582 @unnumberedsubsubsec Fuentes tipográficas del documento completo
1583 @translationof Entire document fonts
1585 Se pueden cambiar las fuentes tipográficas que se usan como
1586 tipografías predeterminadas en las familias @emph{romana},
1587 @emph{sans-serif} y @emph{monoespaciada}, especificándolas en este
1588 orden como se ve en el ejemplo de abajo, que escala las
1589 tipografías automáticamente con el valor fijado para el tamaño
1590 global del pentagrama. De forma parecida a
1591 @ref{Fuentes de un solo elemento}, se puede describir usando una
1592 lista de @q{fuentes tipográficas} separadas por comas. Sin
1593 embargo, los @q{estilos} de fuente no se pueden describir. Para
1594 leer más explicaciones sobre las fuentes tipográficas, consulte
1595 @ref{Explicación de las fuentes tipográficas}.
1597 @cindex fuente, establecer la familia de
1598 @cindex fuentes tipográficas, cambiar para todo el documento
1600 @funindex make-pango-font-tree
1602 @lilypond[verbatim,quote]
1605 (make-pango-font-tree "Times New Roman"
1606 "Nimbus Sans,Nimbus Sans L"
1608 (/ staff-height pt 20)))
1615 \typewriter typewriter. }
1619 @c we don't do Helvetica / Courier, since GS incorrectly loads
1623 Referencia de la notación:
1624 @ref{Explicación de las fuentes tipográficas},
1625 @ref{Fuentes de un solo elemento},
1626 @ref{Seleccionar la tipografía y su tamaño},