X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fes%2Fuser%2Ftweaks.itely;h=55874258b91b59c4b0fe6f996b8850bdf56dd61d;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=363f66c31d19bd35c9151f7f7ac4a3e92e440ac1;hpb=7f3f0083f89d87c5ed0422858e9648fc759e98a4;p=lilypond.git diff --git a/Documentation/es/user/tweaks.itely b/Documentation/es/user/tweaks.itely index 363f66c31d..55874258b9 100644 --- a/Documentation/es/user/tweaks.itely +++ b/Documentation/es/user/tweaks.itely @@ -1,13 +1,13 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*- @c This file is part of lilypond.tely @ignore - Translation of GIT committish: 17d84cfa9ddb152b05d1e17ab72109fb4eefa684 + Translation of GIT committish: 45945bd973aa9161b10e3f517902afb7ef4b4a56 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.65" +@c \version "2.12.0" @node Tweaking output @chapter Tweaking output @@ -126,8 +126,8 @@ que vamos a utilizar en este capítulo. @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 nomenclatura, convenciones de, para objetos +@cindex nomenclatura, convenciones de, para propiedades @cindex objetos, convenciones de nomenclatura @cindex propiedades, convenciones de nomenclatura @@ -187,13 +187,13 @@ Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se usan para cambiar las propiedades de los @strong{contextos} y para quitar y poner @strong{grabadores}, en @ref{Modifying context properties} y @ref{Adding and removing engravers}. Ahora debemos -examinar algunas instrucciones importantes más. +examinar algunas otras instrucciones importantes. La instrucción que cambia las propiedades de los @strong{objetos de presentación} es @code{\override}. Puesto que esta instrucción debe modificar propiedades internas que se encuentran en un lugar profundo dentro de LilyPond, su sintaxis no es tan simple como la del resto de -las instrucciones que hemos visto hasta ahora. Tiene que saber +las instrucciones que hemos usado hasta ahora. Tiene que saber exactamente qué propiedad de qué objeto y en qué contexto se debe modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace. @@ -371,14 +371,14 @@ se cambiaría de la siguiente forma: @end lilypond Observe que la sintaxis de @code{\tweak} no es igual que la de -@code{\override}. Ni el contexto ni el objeto de -presentación se deben especificar; de hecho, generaría un error -hacerlo. Los dos están implícitos por el siguiente elemento del flujo -de entrada. Así que la sintaxis genérica de la instrucción -@code{\tweak} es, simplemente, +@code{\override}. Ni el contexto ni el objeto de presentación se +deben especificar; de hecho, generaría un error hacerlo. Los dos +están implícitos por el siguiente elemento del flujo de entrada. +Observe también que no debe haber un signo igual. Así que la sintaxis +genérica de la instrucción @code{\tweak} es, simplemente, @example -\tweak #'@var{propiedad-de-presentación} = #@var{valor} +\tweak #'@var{propiedad-de-presentación} #@var{valor} @end example Una instrucción @code{\tweak} también se puede usar para modificar @@ -853,15 +853,15 @@ relacionados con los símbolos y las cadenas, consulte @ref{Scheme tutorial}. Así pues, la instrucción @code{\override} que necesitamos para -imprimir la letra en cursiva sería +imprimir la letra en cursiva, es: @example \override LyricText #'font-shape = #'italic @end example @noindent -y debe colocarse justo delante de, y cerca de, la letra a la que debe -afectar, como esto: +Esto debe escribirse justo delante de la letra a la que debe afectar, +de esta forma: @cindex font-shape, propiedad, ejemplo @cindex italic, ejemplo @@ -1070,10 +1070,10 @@ contextos en los que el grabador de líneas divisorias opera. Todos ellos son del tipo @code{Staff}, y así la razón de que la instrucción @code{\override} no funcionara como esperábamos, es porque @code{Barline} no se encuentra en el contexto predeterminado -@code{Voice}. Si el contexto se especifica mal, la instrucción -simplemente no funciona. No se produce ningún mensaje de error, y no -se registra nada en el archivo log de registro. Vamos a intentar -corregirlo escribiendo el contexto correcto: +@code{Voice}. Si el contexto no se especifica correctamente, la +instrucción simplemente no funciona. No se produce ningún mensaje de +error, y no se registra nada en el archivo log de registro. Vamos a +intentar corregirlo escribiendo el contexto correcto: @cindex BarLine, ejemplo de sobreescritura @cindex stencil, propiedad, ejemplo @@ -1090,6 +1090,22 @@ corregirlo escribiendo el contexto correcto: Ahora las barras de compás han desaparecido. +Sin embargo, observe que el establecimiento de la propiedad +@code{stencil} al valor @code{#f} produce errores cuando las se +requieren las dimensiones del objeto para un procesamiento correcto. +Por ejemplo, se generan errores si la propiedad @code{stencil} del +objeto @code{NoteHead} se establece al valor @code{#f}. Si es el +caso, podemos en vez de ello utilizar la función @code{point-stencil}, +que establece el sello a un objeto con tamaño nulo: + +@lilypond[quote,verbatim,relative=2] +{ + c c + \once \override NoteHead #'stencil = #point-stencil + c c +} +@end lilypond + @subheading break-visibility @cindex break-visibility, propiedad @@ -1343,7 +1359,7 @@ pentagrama temporal, como en un @rglos{ossia}. << { f c c } \new Staff \with { - alignAboveContext = "main" } + alignAboveContext = #"main" } { f8 f c } >> r4 | @@ -1370,7 +1386,7 @@ el sello de cada uno de ellos a @code{#f}, como sigue: << { f c c } \new Staff \with { - alignAboveContext = "main" + alignAboveContext = #"main" } { \override Staff.Clef #'stencil = ##f @@ -1433,7 +1449,7 @@ Así pues, podemos reemplazar el ejemplo anterior con << { f c c } \new Staff \with { - alignAboveContext = "main" + alignAboveContext = #"main" % Don't print clefs in this staff \override Clef #'stencil = ##f % Don't print time signatures in this staff @@ -1503,7 +1519,7 @@ Vamos a probarlo en nuestro ejemplo del ossia: << { f c c } \new Staff \with { - alignAboveContext = "main" + alignAboveContext = #"main" \override Clef #'stencil = ##f \override TimeSignature #'stencil = ##f % Reduce all font sizes by ~24% @@ -1558,7 +1574,7 @@ siguiente forma: @cindex TimeSignature, ejemplo de sobreescritura @cindex fontSize, propiedad, ejemplo @cindex StaffSymbol, ejemplo de sobreescritura -@cindex magstep function, ejemplo de utilización +@cindex magstep, función, ejemplo de utilización @cindex staff-space, propiedad, ejemplo @cindex stencil, propiedad, ejemplo @@ -1570,7 +1586,7 @@ siguiente forma: << { f c c } \new Staff \with { - alignAboveContext = "main" + alignAboveContext = #"main" \override Clef #'stencil = ##f \override TimeSignature #'stencil = ##f fontSize = #-2 @@ -1704,7 +1720,7 @@ pentagramas adyacentes: @node Within-staff objects @subsection Within-staff objects -Ya hemos visto cómo las instrucciones @code{\voiceXXX} affectan a la +Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la dirección de las ligaduras de expresión y de unión, digitaciones y todo lo demás que dependa de la dirección de las plicas. Cuando se escribe música polifónica, estas instrucciones son esenciales para que @@ -1830,7 +1846,7 @@ 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 aplicadas a notas sueltas. Se muestra en el primer -compás el comportamiento predeterminado, y en los dos comases +compás el comportamiento predeterminado, y en los dos compases siguiente el efecto de especificar @code{DOWN} y @code{UP}: @cindex Fingering, ejemplo de sobreescritura @@ -2121,6 +2137,35 @@ c\ff c \stopTextSpan c, c c c @end lilypond +@cindex ligaduras y outside-staff-priority +@cindex ligaduras y articulaciones +@cindex articulaciones y ligaduras + +De forma predeterminada, las ligaduras de expresión están clasificadas +como objetos dentro-del-pentagrama, pero con frecuencia aparecen +encima del pentagrama si las notas que une son muy agudas. Ello puede +empujar a una posición muy elevada a los objetos fuera-del-pentagrama +como las articulaciones, pues la ligadura se colocará en primer lugar. +La propiedad @code{avoid-slur} de la articulación se puede establecer +al valor @code{'inside} (por dentro) para llevarla al interior de la +ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si +la prioridad @code{outside-staff-priority} está también ajustada al +valor @code{#f}. De forma alternativa, la prioridad +@code{outside-staff-priority} de la ligadura se puede fijar en un +valor numérico para hacer que se sitúe en línea con otros objetos +fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo +que muestra el efecto de los dos métodos: + +@lilypond[quote,verbatim,relative=2] +c4( c^\markup\tiny\sharp d4.) c8 +c4( +\once \override TextScript #'avoid-slur = #'inside +\once \override TextScript #'outside-staff-priority = ##f +c^\markup\tiny\sharp d4.) c8 +\once \override Slur #'outside-staff-priority = #500 +c4( c^\markup\tiny\sharp d4.) c8 +@end lilypond + Los cambios en @code{outside-staff-priority} también se pueden emplear para controlar la situación vertical de los objetos individuales, aunque los resultados pueden no siempre ser deseables. Suponga que @@ -2344,9 +2389,9 @@ que se estudia en la sección siguiente. @cindex mover objetos superpuestos @cindex mover objetos que colisionan -@cindex moving grobs que colisionan +@cindex mover grobs que colisionan @cindex objetos que colisionan, mover -@cindex grobs, mover, que colisionan +@cindex grobs que colisionan, mover Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos de notación se pueden superponer, lo que es una lástima, pero en @@ -3027,7 +3072,7 @@ que lo más fácil es introducir estas cuatro voces temporalmente en el momento en que se necesiten. Si ha olvidado cómo hacerlo, lea @ref{I'm hearing Voices}. Vamos a comenzar introduciendo las notas como dos variables y disponiendo la estructura de pentagramas en un -bloque score, y veremos qué produce LilyPond de forma predeterminada: +bloque Score, y veremos qué produce LilyPond de forma predeterminada: @lilypond[quote,verbatim,ragged-right] rhMusic = \relative c'' { @@ -3537,7 +3582,7 @@ Ambos métodos quitan de la salida impresa la indicación metronómica que alarga el calderón, y los dos afectan al tempo del MIDI tal y como queríamos, pero la indicación metronómica transparente de la primera línea fuerza una colocación muy alta de la indicación de tempo que -sigue, meintras que la segunda (con el sello suprimido) no lo hace. +sigue, mientras que la segunda (con el sello suprimido) no lo hace. @node Using variables for tweaks @subsection Using variables for tweaks @@ -3550,12 +3595,16 @@ 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 veces, podría merecer la pena definir variables para guardarlas. -Suponga que queremos realzar ciertas palabras de la letra de una + +Supongamos que queremos realzar ciertas palabras de la letra de una canción imprimiéndolas en cursiva y negrita. Las instrucciones @code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las -canciones si están incluidas dentro de un @code{\markup}, lo que las -hace tediosas de escribir. ¿Podríamos, como alternativa, utilizar las -instrucciones @code{\override} y @code{\revert}? +canciones si están incluidas, junto con la palabra o palabras que se +pretenden modificar, dentro de un @code{\markup}, lo que las hace +tediosas de escribir. La necesidad de incluir las propias palabras +impide que se puedan usar en variables simples. ¿Podríamos, como +alternativa, utilizar las instrucciones @code{\override} y +@code{\revert}? @example @code{\override Lyrics . LyricText #'font-shape = #'italic} @@ -3566,9 +3615,13 @@ instrucciones @code{\override} y @code{\revert}? @end example Estas instrucciones también serían extremadamente tediosas de escribir -si hubiera muchas palabras que quisiéramos subrayar. Entonces, en vez -de esto las definimos como dos variables, y las usamos de la siguiente -forma, aunque normalmente quizá elegiríamos unos nombres de variable +si hubiera muchas palabras que quisiéramos subrayar. Pero sí +@emph{podemos} definirlas como dos variables y usarlas para delimitar +las palabras que destacar. Otra ventaja de la utilización de +variables para estas sobreescrituras es que ya no son necesarios los +espacios que rodean al punto, puesto que no se interpretan +directamente en el modo @code{\lyricmode}. He aquí un ejemplo de +esto, aunque en la práctica quizá elegiríamos unos nombres de variable más cortos para que fueran más rápidos de teclear: @cindex LyricText, ejemplo de sobreescritura @@ -3577,12 +3630,12 @@ más cortos para que fueran más rápidos de teclear: @lilypond[quote,verbatim] emphasize = { - \override Lyrics . LyricText #'font-shape = #'italic - \override Lyrics . LyricText #'font-series = #'bold + \override Lyrics.LyricText #'font-shape = #'italic + \override Lyrics.LyricText #'font-series = #'bold } normal = { - \revert Lyrics . LyricText #'font-shape - \revert Lyrics . LyricText #'font-series + \revert Lyrics.LyricText #'font-shape + \revert Lyrics.LyricText #'font-series } global = { \time 4/4 \partial 4 \key c \major} @@ -3793,7 +3846,7 @@ dinámicamente a un valor determinado por el procedimiento en el momento en que se invoca. En este ejemplo damos a las cabezas de las notas un color que depende de su posición dentro del pentagrama. -@cindex x11-color function, ejemplo de utilización +@cindex x11-color, función, ejemplo de utilización @cindex NoteHead, ejemplo de sobreescritura @cindex color, propiedad, establecer a procedimiento de Scheme