]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/es/user/programming-interface.itely
Doc-es: Overview of music functions.
[lilypond.git] / Documentation / es / user / programming-interface.itely
index b1ba88a65b3a3577e8a74d1e49f08dcade6489c4..1ea8480214e0340bfbc5627238502b8998dbccf8 100644 (file)
@@ -1,33 +1,40 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: c9b08ba86f4c59228b92e2357b2a0bc1c62c29dc
-
+    Translation of GIT committish: 4a527608c5ff2ce31e596495d00dce181dc1b9ea
 
     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.61"
 
 @node Interfaces for programmers
 @chapter Interfaces for programmers
 
-UNTRANSLATED NODE: IGNORE ME
+Se pueden realizar trucos avanzados mediante el uso de Scheme.  Si no
+está familizarizado con Scheme, le conviene leer nuestro tutorial de
+Scheme, @rlearning{Scheme tutorial}.
 
-@menu 
+@menu
 * Music functions::
 * Programmer interfaces::
 * Building complicated functions::
 * Markup programmer interface::
 * Contexts for programmers::
 * Scheme procedures as properties::
-@end menu 
+* Using Scheme code instead of \tweak::
+* Difficult tweaks::
+@end menu
+
+
 @node Music functions
 @section Music functions
 
-UNTRANSLATED NODE: IGNORE ME
+Esta sección trata sobre cómo crear funciones musicales dentro de
+LilyPond.
 
-@menu 
+@menu
 * Overview of music functions::
 * Simple substitution functions::
 * Paired substitution functions::
@@ -35,149 +42,228 @@ UNTRANSLATED NODE: IGNORE ME
 * Void functions::
 * Functions without arguments::
 * Overview of available music functions::
-@end menu 
+@end menu
+
 @node Overview of music functions
 @subsection Overview of music functions
 
-UNTRANSLATED NODE: IGNORE ME
+Es fácil hacer una función que sustituya a una variable en código de
+LilyPond.  La forma general de estas funciones es:
+
+@example
+funcion =
+#(define-music-function (analizador posicion @var{var1} @var{var2}... )
+                        (@var{var1-type?} @var{var2-type?}...)
+  #@{
+    @emph{...música...}
+  #@})
+@end example
+
+@noindent
+donde
+
+@multitable @columnfractions .33 .66
+@item @var{argi}         @tab @var{i}-ésima variable
+@item @var{argi-type?}   @tab tipo de variable
+@item @var{...música...}  @tab entrada normal de LilyPond, usando las variables como @code{#$var1}.
+@end multitable
+
+Los siguientes tipos de entrada se pueden usar como variables en una
+función musical.  Esta lista no es exhaustiva; consulte otros lugares
+de la documentación específica de Scheme para ver otros tipos de
+variables.
+
+@multitable @columnfractions .33 .66
+@headitem Tipo de entrada       @tab notación de @var{argi-type?}
+@item Entero                    @tab @code{integer?}
+@item Flotante (número decimal) @tab @code{number?}
+@item Cadena de texto           @tab @code{string?}
+@item Marcado                   @tab @code{markup?}
+@item Expresión musical         @tab @code{ly:music?}
+@item Pareja de variables          @tab @code{pair?}
+@end multitable
+
+Los argumentos @code{analizador} y @code{posicion} son obligatorios, y
+se usan en ciertas situaciones avanzadas.  El argumento
+@code{analizador} se usa para acceder al valor de otra variable de
+LilyPond.  El argumento @code{posicion} se usa para establecer el
+@q{origen} de la expresión musical que construye la función musical,
+de forma que en caso de producirse un error de sintaxis LilyPond pueda
+informar al usuario de un lugar adecuado donde buscar en el archivo de
+entrada.
+
 
 @node Simple substitution functions
 @subsection Simple substitution functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Paired substitution functions
 @subsection Paired substitution functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Mathematics in functions
 @subsection Mathematics in functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Void functions
 @subsection Void functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Functions without arguments
 @subsection Functions without arguments
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Overview of available music functions
 @subsection Overview of available music functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @include identifiers.tely
 @node Programmer interfaces
 @section Programmer interfaces
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
-@menu 
+@menu
 * Input variables and Scheme::
 * Internal music representation::
-@end menu 
+@end menu
+
 @node Input variables and Scheme
 @subsection Input variables and Scheme
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Internal music representation
 @subsection Internal music representation
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Building complicated functions
 @section Building complicated functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
-@menu 
+@menu
 * Displaying music expressions::
 * Music properties::
 * Doubling a note with slurs (example)::
 * Adding articulation to notes (example)::
-@end menu 
+@end menu
+
 @node Displaying music expressions
 @subsection Displaying music expressions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Music properties
 @subsection Music properties
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Doubling a note with slurs (example)
 @subsection Doubling a note with slurs (example)
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Adding articulation to notes (example)
 @subsection Adding articulation to notes (example)
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Markup programmer interface
 @section Markup programmer interface
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
 
-@menu 
+
+@menu
 * Markup construction in Scheme::
 * How markups work internally::
 * New markup command definition::
 * New markup list command definition::
-@end menu 
+@end menu
+
 @node Markup construction in Scheme
 @subsection Markup construction in Scheme
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node How markups work internally
 @subsection How markups work internally
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node New markup command definition
 @subsection New markup command definition
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node New markup list command definition
 @subsection New markup list command definition
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Contexts for programmers
 @section Contexts for programmers
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
 
-@menu 
+
+@menu
 * Context evaluation::
 * Running a function on all layout objects::
-@end menu 
+@end menu
+
 @node Context evaluation
 @subsection Context evaluation
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Running a function on all layout objects
 @subsection Running a function on all layout objects
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
 
 @node Scheme procedures as properties
 @section Scheme procedures as properties
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
+
+
+
+@node Using Scheme code instead of \tweak
+@section Using Scheme code instead of @code{\tweak}
+
+@untranslated
+
 
+@node Difficult tweaks
+@section Difficult tweaks
 
--- SKELETON FILE --
-When you actually translate this file, please remove these lines as
-well as all `UNTRANSLATED NODE: IGNORE ME' lines.
+@untranslated