]> 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 17e51e7fab6711fe0748a3b469d99ad6872e79ee..1ea8480214e0340bfbc5627238502b8998dbccf8 100644 (file)
@@ -1,28 +1,40 @@
-@node Interfaces for programmers
-@chapter Interfaces for programmers
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
+@c This file is part of lilypond.tely
+@ignore
+    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
 
-UNTRANSLATED NODE: IGNORE ME
+@c \version "2.11.61"
 
-@menu 
+@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
 * Music functions::
 * Programmer interfaces::
 * Building complicated functions::
 * Markup programmer interface::
 * Contexts for programmers::
 * Scheme procedures as properties::
-@end menu 
-@node Music functions
-@section Music functions
+* Using Scheme code instead of \tweak::
+* Difficult tweaks::
+@end menu
 
-UNTRANSLATED NODE: IGNORE ME
 
-@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
 * Overview of music functions::
 * Simple substitution functions::
 * Paired substitution functions::
@@ -30,205 +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
-
-UNTRANSLATED NODE: IGNORE ME
 
+@node Simple substitution functions
 @subsection Simple substitution functions
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Paired substitution functions
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Paired substitution functions
 @subsection Paired substitution functions
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Mathematics in functions
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Mathematics in functions
 @subsection Mathematics in functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
 
-@node Void functions
-
-UNTRANSLATED NODE: IGNORE ME
 
+@node Void functions
 @subsection Void functions
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Functions without arguments
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Functions without arguments
 @subsection Functions without arguments
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Overview of available music functions
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Overview of available music functions
 @subsection Overview of available music functions
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
 
-@include identifiers.tely
-
-UNTRANSLATED NODE: IGNORE ME
 
+@include identifiers.tely
 @node Programmer interfaces
 @section Programmer interfaces
 
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@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
-
-UNTRANSLATED NODE: IGNORE ME
 
+@node Internal music representation
 @subsection Internal music representation
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Building complicated functions
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Building complicated functions
 @section Building complicated functions
 
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@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
-
-@node Music properties
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Music properties
 @subsection Music properties
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Doubling a note with slurs (example)
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@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)
-
-UNTRANSLATED NODE: IGNORE ME
 
+@node Adding articulation to notes (example)
 @subsection Adding articulation to notes (example)
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
 
-@node Markup programmer interface
-
-UNTRANSLATED NODE: IGNORE ME
 
+@node Markup programmer interface
 @section Markup programmer interface
 
-UNTRANSLATED NODE: IGNORE ME
+@untranslated
 
-@menu 
-
-UNTRANSLATED NODE: IGNORE ME
 
+@menu
 * Markup construction in Scheme::
 * How markups work internally::
 * New markup command definition::
-@end menu 
+* New markup list command definition::
+@end menu
+
 @node Markup construction in Scheme
 @subsection Markup construction in Scheme
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node How markups work internally
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@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
 
-@subsection New markup command definition
 
-UNTRANSLATED NODE: IGNORE ME
+@node New markup list command definition
+@subsection New markup list command definition
 
-@node Contexts for programmers
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@node Contexts for programmers
 @section Contexts for programmers
 
-UNTRANSLATED NODE: IGNORE ME
-
-@menu 
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@menu
 * Context evaluation::
 * Running a function on all layout objects::
-@end menu 
+@end menu
+
 @node Context evaluation
 @subsection Context evaluation
 
-UNTRANSLATED NODE: IGNORE ME
-
-@node Running a function on all layout objects
+@untranslated
 
-UNTRANSLATED NODE: IGNORE ME
 
+@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
 
-@section Scheme procedures as properties
 
-UNTRANSLATED NODE: IGNORE ME
+@node Difficult tweaks
+@section Difficult tweaks
 
+@untranslated