-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 4be1308672c6f8efbe660c9eddc0a6a167c9ad31
+ Translation of GIT committish: 9b6add29eb85dc6cd860593a2c8826a366f8a719
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Tweaking output
@chapter Tweaking output
@node Objects and interfaces
@subsection Objects and interfaces
-@cindex objetos
-@cindex grobs
-@cindex selectores
-@cindex interfaces
+@cindex objeto
+@cindex grob
+@cindex objeto de extensión
+@cindex interfaz
+@cindex propiedades de objetos
+@cindex objeto, propiedades de
+@cindex layout (disposición), objeto de
+@cindex objeto de disposición (layout)
El trucaje consiste en modificar el funcionamiento y estructura
interna del programa LilyPond, por lo que en primer lugar
@node Naming conventions of objects and properties
@subsection Naming conventions of objects and properties
+@cindex nomemclatura, convenciones de, para objetos
+@cindex nomemclatura, convenciones de, para propiedades
+@cindex objetos, convenciones de nomenclatura
+@cindex propiedades, convenciones de nomenclatura
+
Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
sección @ref{Contexts and engravers}. En este lugar, para más fácil
referencia, presentamos una lista de los tipos de objetos y
@node Tweaking methods
@subsection Tweaking methods
+@cindex trucaje, métodos de
+
@strong{La instrucción \override}
@cindex override, instrucción
+@cindex override (sobreescritura), sintaxis de
+
@funindex \override
+@funindex override
Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
usan para cambiar las propiedades de los @strong{contextos} y para
La sintaxis genérica de esta instrucción es:
@example
-\override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} = #@var{valor}
+\override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} =
+#@var{valor}
@end example
@noindent
@strong{La instrucción \revert}
@cindex revert, instrucción
+
@funindex \revert
+@funindex revert
Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
se sobreescribe de nuevo o se encuentra una instrucción
@strong{El prefijo \once}
+@funindex \once
+@funindex once
+
Tanto la instrucción @code{\override} como @code{\set} se pueden
preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
@code{\override} o @code{\set} sea efectiva solamente durante el
@strong{La instrucción \overrideProperty}
@cindex overrideProperty, instrucción
+
@funindex \overrideProperty
+@funindex overrideProperty
Hay otra forma para la instrucción de sobreescritura,
@code{\overrideProperty}, que ocasionalmente es necesaria. La
@strong{La instrucción \tweak}
@cindex tweak, instrucción
+
@funindex \tweak
+@funindex tweak
La última instrucción de trucaje que está disponible es @code{\tweak}.
Se debe utilizar para cambiar las propiedades de objetos que suceden
@cindex corchete del grupo especial
@cindex grupo especial, corchete de
@cindex tresillo, corchete de
+
@funindex TupletBracket
La instrucción @code{\tweak} también se debe usar para cambiar la
@cindex propiedades de los grobs
@cindex grobs, propiedades de
@cindex presentación, propiedades de los objetos de
+@cindex Referencia de funcionamiento interno
Suponga que tiene una partitura con una ligadura de expresión que para
su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
continuación.
@subheading Finding the context
+
@cindex contexto, encontrar
+@cindex contexto, buscar, correcto
Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
especificar el contexto? ¿Cuál sería? Podemos suponer que las
@cindex sobreescritura por una sola vez
@cindex once override
+
@funindex \once
+@funindex once
Como puede ver, @emph{todas} las ligaduras son más gruesas en el
último ejemplo. Pero ¿y si quisiéramos que solamente la primera
@subheading Reverting
@cindex revert
-@cindex predeterminadas, devolver a las propiedades
+@cindex predeterminadas, recuperar las propiedades
+
@funindex \revert
+@funindex revert
Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
@node Properties found in interfaces
@subsection Properties found in interfaces
+@cindex interface
@cindex propiedades de los interfaces
@cindex interfaces, propiedades
interface.
Mire de nuevo la página del RFI que describe a LyricText. Al final de
-la página hay una lista de enlaces (en las versiones de html del RFI)
-a los interfaces que LyricText contempla. La lista tiene siete
-elementos, entre ellos @code{font-interface}. Al seguir este enlace
-llegamos a las propiedades asociadas con este interface, que también
-son propiedades de todos los objetos que lo llevan, entre ellos
-LyricText.
+la página hay una lista de enlaces a los interfaces que LyricText
+contempla. La lista tiene siete elementos, entre ellos
+@code{font-interface}. Al seguir este enlace llegamos a las
+propiedades asociadas con este interface, que también son propiedades
+de todos los objetos que lo llevan, entre ellos LyricText.
Ahora vemos todas las propiedades ajustables por el usuario que
controlan las tipografías, entre ellas @code{font-shape(symbol)},
Como nota aparte, aunque una nota importante, observe que a causa de
que los valores de @code{font-shape} son símbolos, deben ir precedidos
-de un apóstrofe, @code{'}. Esa es la razón por la que se necesitan
-apóstrofes antes de @code{thickness} en el ejemplo anterior y en
+de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
+apóstrofos antes de @code{thickness} en el ejemplo anterior y en
@code{font-shape}. Los dos son también símbolos. Los símbolos son
nombres especiales que son conocidos por LilyPond internamente.
Algunos de ellos son nombres de propiedades, como @code{thickness} o
-@code{font-shape}, otros son en efecto valores especiales que se les
-puede dar a las propiedades, como @code{italic}. Observe la
-distinción entre esto y las cadenas de texto arbitrarias, que
-aparecerían entrecomilladas como @code{"a text string"}.
+@code{font-shape}, otros se utilizan como valores que se les puede dar
+a las propiedades, como @code{italic}. Observe la distinción entre
+esto y las cadenas de texto arbitrarias, que aparecerían
+entrecomilladas como @code{"a text string"}. Para ver más detalles
+relacionados con los símbolos y las cadenas, consulte @ref{Scheme
+tutorial}.
-De acuerdo, entonces la instrucción @code{\override} que necesitamos
-para imprimir la letra en cursiva sería
+Así pues, la instrucción @code{\override} que necesitamos para
+imprimir la letra en cursiva sería
@example
\override LyricText #'font-shape = #'italic
y debe colocarse justo delante de, y cerca de, la letra a la que debe
afectar, como esto:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 6/8
{
y toda la letra se imprime en cursiva.
@subheading Specifying the context in lyric mode
+
@cindex contexto, especificación en modo letra
+@cindex letra, modo, especificar el contexto en
En el caso de la letra, si intenta especificar el contexto en el
formato que acabamos de dar, la instrucción no funcionará. Una
escriba siempre espacios antes y después del punto que separa el
nombre del contexto y el nombre del objeto.}
+@seealso
+
+Manual de aprendizaje:
+@ref{Scheme tutorial}.
+
@node Types of properties
@subsection Types of properties
@tab Un número decimal positivo (en unidades de espacios de pentagrama)
@tab @code{2.5}, @code{0.34}
@item Dirección
- @tab Una constante válida de dirección o su equivalente numérico
+ @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
@tab @code{LEFT}, @code{CENTER}, @code{UP},
@code{1}, @code{-1}
@item Entero
@tab Un número entero positivo
@tab @code{3}, @code{1}
@item Lista
- @tab Un conjunto de elementos entre paréntesis separados por espacios y precedido de un apóstrofe
+ @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
@tab @code{'(left-edge staff-bar)}, @code{'(1)},
@code{'(1.0 0.25 0.5)}
@item Marcado
@tab Cualquier valor decimal positivo o negativo
@tab @code{3.5}, @code{-2.45}
@item Pareja (de números)
- @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofe
+ @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
@tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
@item Símbolo
- @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofe
+ @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
@tab @code{'italic}, @code{'inside}
@item Desconocido
- @tab Un procedimiento o @code{#f} (para no producir ninguna acción)
+ @tab Un procedimiento o @code{#f} para no producir ninguna acción
@tab @code{bend::print}, @code{ly:text-interface::print},
@code{#f}
@item Vector
- @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofe-almohadilla, @code{'#}.
+ @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
@tab @code{'#(#t #t #f)}
@end multitable
+@seealso
+
+Manual de aprendizaje:
+@ref{Scheme tutorial}.
+
@node Appearance of objects
@section Appearance of objects
Antes de enredarnos con esto, recordemos que las propiedades de los
objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
@ref{Properties found in interfaces}). Esto es simplemente agrupar
-las propiedades que normalmente se necesitan juntas: si una de ellas
-se necesita para un objeto, también las otras. Así, ciertos objetos
-necesitan las propiedades de algunos interfaces, otros necesitan las
-de otros interfaces. Los interfaces que contienen las propiedades que
-un determinado grob necesita se encuentran relacionadas en el manual
-RFI al final de la página que describe dicho grob, y esas propiedades
-se pueden ver mirando dichos interfaces.
+las propiedades que se pueden usar juntas para trucar un objeto
+gráfico: si una de ellas se necesita para un objeto, también las
+otras. Así, ciertos objetos usan las propiedades de algunos
+interfaces, otros usan las de otros interfaces. Los interfaces que
+contienen las propiedades que un determinado grob necesita se
+encuentran relacionadas en el manual RFI al final de la página que
+describe dicho grob, y esas propiedades se pueden ver mirando dichos
+interfaces.
Hemos explicado cómo encontrar información sobre los grobs en
@ref{Properties of layout objects}. Usando el mismo enfoque, vamos al
considerar cada uno de ellos por orden.
@subheading stencil
+
@cindex stencil (sello), propiedad
Esta propiedad controla la apariencia de las barras de compás mediante
imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
antes, omitiendo el Contexto implícito, @code{Voice}:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override BarLine #'stencil = ##f
se registra nada en el archivo log de registro. Vamos a intentar
corregirlo escribiendo el contexto correcto:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'stencil = ##f
Y podemos ver que esto también quita todas las líneas divisorias.
@subheading transparent
+
@cindex transparente, propiedad
+@cindex transparencia
En la relación de propiedades que se especifican en la página del
@code{grob-interface} del RFI podemos ver que la propiedad
@code{grob-interface}. Así pues, la instrucción que hace transparente
a la indicación de compás es:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.TimeSignature #'transparent = ##t
vez de eso, para quitarla, el stencil o «sello» de la indicación de
compás se debe establecer al valor @code{#f}:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.TimeSignature #'stencil = ##f
lo dejamos donde está, pero lo hacemos invisible.
@subheading color
+
@cindex color, propiedad
Para finalizar, intentemos hacer invisibles las barras de compás
relacionados en la primera tabla de la @ruser{List of colors}. Para
poner las líneas divisorias de color blanco, escribimos:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'color = #white
@noindent
y de nuevo podemos comprobar que las barras de compás no son visibles.
-Observe que @emph{white} no viene precedido de un apóstrofe: no es un
+Observe que @emph{white} no viene precedido de un apóstrofo: no es un
símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
lista de valores internos que se requieren para establecer el color a
blanco. Los otros colores de la lista normal también son funciones.
@cindex colores de X11
@cindex X11, colores de
+@funindex x11-color
+
La segunda forma de cambiar el color es utilizar la lista de nombres
de colores de X11 que aparecen en la segunda lista de @ruser{List of
colors}. Sin embargo, éstos deben ir precedidos de otra función, que
convierte los nombres de colores de X11 en la lista de valores
internos, @code{x11-color}, de la siguiente manera:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'color = #(x11-color 'white)
@noindent
Observe que en este caso la función @code{x11-color} toma un símbolo
-como argumento, así que el símbolo debe ir precedido de un apóstrofe y
+como argumento, así que el símbolo debe ir precedido de un apóstrofo y
los dos deben ir entre paréntesis.
@cindex rgb, colores
@cindex color, rgb
+@funindex rgb-color
+
Aún hay una tercera función, que convierte valores RGB en colores
internos: la función @code{rgb-color}. Toma tres argumentos que dan
las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
@code{(rgb-color 1 1 1)}:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'color = #(rgb-color 1 1 1)
estableciendo todos los objetos de presentación de nuestro ejemplo a
varias gradaciones de gris:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
\time 12/16
\override Staff.StaffSymbol #'color = #(x11-color 'grey30)
@node Size of objects
@subsection Size of objects
+@cindex cambiar el tamaño de los objetos
+@cindex tamaño de los objetos
+@cindex objetos, tamaño de
+@cindex objetos, cambiar el tamaño de
+
Empezaremos examinando de nuevo un ejemplo anterior (véase
@ref{Nesting music expressions}) que nos mostraba cómo introducir un
pentagrama temporal, como en un @rglos{ossia}.
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
el sello de cada uno de ellos a @code{#f}, como sigue:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
Así pues, podemos reemplazar el ejemplo anterior con
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
Vamos a probarlo en nuestro ejemplo del ossia:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
para reducir otros objetos en la misma proporción. Se usa de la
siguiente forma:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
@menu
* Automatic behaviour::
* Within-staff objects::
-* Outside staff objects::
+* Outside-staff objects::
@end menu
@node Automatic behaviour
@subsection Automatic behaviour
+@cindex dentro del pentagrama, objetos
+@cindex fuera del pentagrama, objetos
+@cindex objetos dentro del pentagrama
+@cindex objetos fuera del pentagrama
+
Hay ciertos objetos en notación musical que pertenecen al pentagrama y
otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
@q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
acomodado por debajo de @q{Text2}.
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
c2^"Text1"
c^"Text2"
c^"Text3"
hacia abajo. Esto se controla automáticamente cuando está establecida
la propiedad @code{direction}.
+@cindex abajo
+@cindex arriba
+@cindex centro
+@cindex neutro
+
El ejemplo siguiente muestra en el compás 1 el comportamiento
predeterminado de las plicas, con las de las notas agudas apuntando
hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
forzadas hacia arriba, y por último cuatro notas devueltas al
comportamiento predeterminado.
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
a4 g c a
\override Stem #'direction = #DOWN
a g c a
nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
@subheading Fingering
+
@cindex digitación, colocación
+@cindex digitación de acordes
-La colocación de las digitaciones también resulta afectada por el
-valor de su propiedad @code{direction}, pero existen instrucciones
-especiales que permiten controlar las digitaciones de notas
-individuales, situando la digitación encima, debajo, a la izquierda o
-a la derecha de cada nota.
+La colocación de las digitaciones sobre notas sueltas también se puede
+controlar mediante la propiedad @code{direction}, pero los cambios
+sobre @code{direction} no tienen ningún efecto sobre las notas de los
+acordes. Como veremos, existen instrucciones especiales que permiten
+controlar las digitaciones de notas individuales, situando la
+digitación encima, debajo, a la izquierda o a la derecha de cada nota.
En primer lugar, he aquí el efecto de @code{direction} sobre las
-digitaciones; el primer compás muestra el comportamiento
-predeterminado, y después el efecto de especificar @code{DOWN} y
-@code{UP}:
+digitaciones aplicadas a notas sueltas. Se muestra en el primer
+compás el comportamiento predeterminado, y en los dos comases
+siguiente el efecto de especificar @code{DOWN} y @code{UP}:
@lilypond[quote,verbatim,relative=2]
c-5 a-3 f-1 c'-5
c-5 a-3 f-1 c'-5
@end lilypond
-Así es como se controla la digitación sobre notas aisladas, pero la
-propiedad @code{direction} se ignora para los acordes. En su lugar,
-de forma predeterminada las digitaciones se colocan automáticamente
-encima y debajo de las notas del acorde, como se muestra aquí:
+Sin embargo, la sobreescritura de la propiedad @code{direction} no es
+la forma más sencilla de especificar manualmente la digitación por
+encima o por debajo de las notas; suele ser preferible usar @code{_} o
+@code{^} en lugar de @code{-}, antes del número de la digitación.
+Este es el ejemplo anterior utilizando este método:
+
+@lilypond[quote,verbatim,relative=2]
+c-5 a-3 f-1 c'-5
+c_5 a_3 f_1 c'_5
+c^5 a^3 f^1 c'^5
+@end lilypond
+
+La propiedad @code{direction} se ignora para los acordes, pero los
+prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
+predeterminada, las digitaciones se colocan automáticamente encima y
+debajo de las notas de un acorde, como se muestra aquí:
@lilypond[quote,verbatim,relative=2]
<c-5 g-3>
<c-5 g-3 e-2 c-1>
@end lilypond
-Es posible tener un mayor control sobre la situación exacta de las
+@noindent
+pero se puede forzar de manera que todos o algunos de los números de
+digitación estén por encima o por debajo:
+
+@lilypond[quote,verbatim,relative=2]
+<c-5 g-3 e-2 c-1>
+<c^5 g_3 e_2 c_1>
+<c^5 g^3 e^2 c_1>
+@end lilypond
+
+Es posible ejercer un control aún mayor sobre la colocación de las
digitaciones mediante la utilización de la instrucción @code{\set
-fingeringOrientations}. El formato de esta instrucción es
+fingeringOrientations}. El formato de esta instrucción es:
@example
@code{\set fingeringOrientations = #'([up] [left/right] [down])}
@code{left} y @code{right} son mutuamente excluyentes: las
digitaciones pueden situarse en un lado o en el otro, no en los dos.
-Para controlar la colocación de la digitación de una sola nota usando
-esta instrucción es necesario escribirla como un acorde de una sola
-nota encerrándola entre ángulos simples.
+@warning{Para controlar la colocación de la digitación de una sola
+nota usando esta instrucción es necesario escribirla como un acorde de
+una sola nota encerrándola entre ángulos simples.}
Aquí podemos ver algunos ejemplos:
< c-1 e-2 g-3 b-5 > 4
@end lilypond
-@node Outside staff objects
-@subsection Outside staff objects
+
+@node Outside-staff objects
+@subsection Outside-staff objects
Los objetos fuera-del-pentagrama se colocan automáticamente para
evitar las colisiones. Los objetos que tienen el valor más bajo de la
de ellos.
@cindex texto, extensiones de
+@cindex octava alta y baja, corchete de
+
@funindex \startTextSpan
+@funindex startTextSpan
@funindex \stopTextSpan
-@cindex octava alta y baja, corchete de
+@funindex stopTextSpan
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
% Set details for later Text Spanner
También muestra la manera de crear corchetes de octava alta y baja.
+@cindex trucar la situación de los números de compás
+@cindex números de compás, ajustar posición
+@cindex trucar la situación de marcas metronómicas
+@cindex metrónomo, situación de las indicaciones de
+@cindex trucar la situación de las letras de ensayo
+@cindex ensayo, letras, trucar la colocación
+
Observe que los números de compás, las indicaciones metronómicas y las
mercas de ensayo no se muestran. De forma predeterminada, se crean
dentro del contexto @code{Score} y su prioridad
prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
aumentar la prioridad de @qq{Text3} hasta un valor superior:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
c2^"Text1"
c^"Text2"
\once \override TextScript #'outside-staff-priority = #500
@subheading \textLengthOn
-@funindex \textLengthOn
@cindex notas, espaciar junto al texto
+@funindex \textLengthOn
+@funindex textLengthOn
+@funindex \textLengthOff
+@funindex textLengthOff
+
De forma predeterminada, el texto producido mediante marcado no ocupa
ningún espacio horizontal en cuanto se refiere a la disposición de la
música. La instrucción @code{\textLengthOn} invierte este
comportamiento, ocasionando que las notas resulten tan espaciadas como
sea necesario para acomodar el texto:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\textLengthOn % Cause notes to space out to accommodate text
c2^"Text1"
c^"Text2"
con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
que no se puede usar con @code{\textLengthOn}.
+@cindex marcado, texto de, permitir las colisiones en
+
El texto de marcado también evita las notas que se proyectan por
encima del pentagrama. Si esto no es lo que deseamos, el
desplazamiento automático hacia arriba se puede desactivar mediante el
establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
muestra cómo el texto de marcado interactúa con tales notas.
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
% This markup is short enough to fit without collision
c2^"Tex"
c''2
@subheading Dynamics
+@cindex trucar la colocación de los matices
+@cindex dinámica, trucar la colocación de las indicaciones de
+@cindex matices, trucar la colocación
+
Las indicaciones de matiz dinámico normalmente se colocarán por debajo
del pentagrama, pero se pueden posicionar por encima con la
instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
el lugar óptimo, como muestra el siguiente ejemplo más bien
artificial:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
a4\f b\mf c\mp b\p
@end lilypond
@cindex grob, cambio de tamaño de un
@cindex escala de los grobs
-@cindex @code{X-offset}
-@cindex @code{Y-offset}
-@cindex @code{X-extent}
-@cindex @code{Y-extent}
En primer lugar debemos aprender cómo se especifica el tamaño de los
grobs. Todos los grobs tienen un punto de referencia definido dentro
@noindent
Veamos si funciona en nuestro ejemplo anterior:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
\override DynamicText #'extra-spacing-width = #'(0 . 0)
a4\f b\mf c\mp b\p
límite izquierdo media unidad a la izquierda y el límite derecho media
unidad hacia la derecha, deberíamos conseguirlo:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
% Extend width by 1 staff space
\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
@node Moving objects
@subsection Moving objects
+@cindex mover objetos superpuestos
+@cindex mover objetos que colisionan
+@cindex moving grobs que colisionan
+@cindex objetos que colisionan, mover
+@cindex grobs, mover, que colisionan
+
Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
de notación se pueden superponer, lo que es una lástima, pero en
realidad es bastante poco frecuente. Normalmente la necesidad de
izquierda), @code{right-padding} (relleno por la derecha),
@code{staff-padding} (relleno de pentagrama)
+@cindex relleno
@cindex left-padding, propiedad
@cindex padding, propiedad
@cindex right-padding, propiedad
@cindex staff-padding, propiedad
+
Según un objeto se está colocando, el valor de su propiedad de relleno
@code{padding} especifica el espacio intermedio que se debe dejar
entre él mismo y el límite más próximo del objeto contra el que se
@code{self-alignment-X} (Auto-alineamiento en el eje X)
@cindex self-alignment-X, propiedad
+
Esta propiedad se puede usar para alinear el objeto a la izquierda, a
la derecha, o centrarlo con respecto al punto de referencia del objeto
«padre». Se puede usar con todos los objetos que contemplan el
@code{extra-spacing-width} (anchura de separación adicional)
@cindex extra-spacing-width, propiedad
+
Esta propiedad está disponible para todos los objetos que contemplan
el interface @code{item-interface}. Toma dos números, el primero se
suma al límite izquierdo y el segundo se suma al límite derecho. Los
@code{staff-position} (posición de pentagrama)
@cindex staff-position, propiedad
+
@code{staff-position} es una propiedad del interface
@code{staff-symbol-referencer-interface}, que está contemplado por los
objetos que se colocan con relación al pentagrama. Especifica la
@table @code
@item extra-offset (desplazamiento adicional)
+
@cindex extra-offset, propiedad
+
Esta propiedad se aplica a cualquier objeto de presentación que
contemple el @code{grob-interface}. Toma una pareja de números que
especifican el desplazamiento adicional en las direcciones horizontal
reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
@item positions (posiciones)
+
@cindex positions, propiedad
+
Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
la altura de las barras de corchea, ligaduras de expresión y corchetes
de grupos de valoración especial. Toma una pareja de números que dan
superpone.
@subheading padding property
-@cindex relleno, propiedad
-@cindex padding, propiedad
+
+@cindex relleno
+@cindex arreglar notación que se superpone
+@cindex superpuesta, notación
La propiedad @code{padding} se puede ajustar para aumentar (o
disminuir) la distancia entre símbolos impresos encima o debajo de las
@subheading left-padding and right-padding
+
@cindex left-padding, propiedad
@cindex right-padding, propiedad
las notas con un becuadro y un bemol. Aquí vienen varios intentos de
hacerlo así:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
<b bes>
<b! bes>
<b? bes>
@noindent
@subheading staff-padding property
-@cindex staff-padding, propiedad
+
+@cindex alineación de objetos sobre la línea base
+@cindex objetos, alineación sobre la línea base
@code{staff-padding} se puede usar para alinear objetos como matices
dinámicos a lo largo de una línea de base a una altura fija sobre el
extensión. Así que ésta es la forma de alinear las indicaciones de
matiz en el ejemplo de la sección anterior:
-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
% Extend width by 1 unit
\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
@subheading self-alignment-X property
-@cindex self-alignment-X, propiedad
El ejemplo siguiente muestra cómo esto puede resolver la colisión
entre un objeto de digitación de cuerda y la plica de una nota
@end lilypond
@subheading staff-position property
-@cindex staff-position, propiedad
+
+@cindex objeto, colisión dentro del pentagrama
Los silencios multi-compás en una voz pueden chocar con las notas en
otra voz. Puesto que estos silencios se tipografían centrados entre
la línea adicional por encima del silencio se inserta automáticamente.
@subheading extra-offset property
-@cindex extra-offset, propiedad
+
+@cindex posicionar objetos
+@cindex posicionar grobs
+@cindex objetos, posicionar
+@cindex grobs, posicionar
La propiedad @code{extra-offset} da un completo control sobre el
posicionamiento de un objeto tanto vertical como horizontalmente.
@subheading positions property
-@cindex positions, propiedad
+
+@cindex controlar manualmente grupos especiales, ligaduras y barras
+@cindex manual, control, de grupos especiales, ligaduras y barras
+@cindex grupos especiales, barras de, control manual
+@cindex ligaduras de expresión, control manual
+@cindex ligaduras de fraseo, control manual
+@cindex barras de corchea, control manual
La propiedad @code{positions} permite controlar manualmente la
posición e inclinación de los tresillos, ligaduras de expresión y de
@end lilypond
@noindent
-pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
+Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
sería mover el extremo izquierdo de la ligadura de fraseo un poco
hacia abajo usando la propiedad @code{positions}. Esto también
resuelve la forma algo indecente de la ligadura.
segunda voz.
@subheading force-hshift property
-@cindex force-hshift, propiedad
+
@c FIXME: formatting stuff (ie not important right now IMO)
@c @a nchor Chopin finally corrected TODOgp
@cindex objetos, hace invisibles
@cindex eliminar objetos
@cindex objetos, eliminar
+@cindex objetos, ocultar
@cindex ocultar objetos
@cindex invisibles, objetos
+@cindex objetos invisibles
@cindex ligar notas entre voces distintas
@subheading Tying notes across voices
@node Using variables for tweaks
@subsection Using variables for tweaks
+@cindex variables, uso de, para trucos
+@cindex usar variables para hacer trucos
+@cindex trucos, usar variables para hacer
+
Las instrucciones de sobreescritura son con frecuencia largas y
tediosas de escribir, y se tienen que escribir de forma absolutamente
correcta. Si las mismas sobreescrituras se van a utilizar muchas
Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
usaría normalmente para los archivos @code{.ly} servirá perfectamente.
Este archivo contiene las definiciones de todas las instrucciones
-incorporadas como estándar dentro de LilyPond, como por ejemplo
-@code{\stemUp} y @code{\slurDotted}. Podrá ver que no son nada más
-que definiciones de variables que contienen una o varias instrucciones
-@code{\override}. Por ejemplo, @code{/tieDotted} está definido de tal
-forma que su valor es:
+estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} y
+@code{\slurDotted}. Podrá ver que no son nada más que definiciones de
+variables que contienen una o varias instrucciones @code{\override}.
+Por ejemplo, @code{/tieDotted} está definido de tal forma que su valor
+es:
@example
tieDotted = @{
@end example
Si no le gustan los valores predeterminados, estas instrucciones
-incorporadas se pueden redefinir con facilidad como cualquier otra
+predefinidas se pueden redefinir con facilidad como cualquier otra
variable, al principio de su archivo de código de entrada.
Los siguientes son los archivos más útiles que se encuentran en
@tab Contenido
@item @file{ly/engraver-init.ly}
@tab Definiciones de Contextos de grabadores
-@item @file{ly/paper-defaults.ly}
+@item @file{ly/paper-defaults-init.ly}
@tab especificaciones de valores predeterminados relacionados con el papel
@item @file{ly/performer-init.ly}
@tab Definiciones de Contextos de interpretación
@item @file{ly/property-init.ly}
- @tab Definiciones de todas las instrucciones incorporadas que son comunes
+ @tab Definiciones de todas las instrucciones predefinidas que son comunes
+@item @file{ly/spanner-init.ly}
+ @tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
@end multitable
Otros ajustes (como las definiciones de las instrucciones de marcado)
projects / lilypond.git / blobdiff