version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Interfaces for programmers
@chapter Interfaces for programmers
* Building complicated functions::
* Markup programmer interface::
* Contexts for programmers::
-* Scheme procedures as properties::
-* TODO moved into scheme::
+* Scheme procedures as properties::
+* Using Scheme code instead of \tweak::
+* Difficult tweaks::
@end menu
to create complicated music functions.
@menu
-* Displaying music expressions::
-* Music properties::
-* Doubling a note with slurs (example)::
-* Adding articulation to notes (example)::
+* Displaying music expressions::
+* Music properties::
+* Doubling a note with slurs (example)::
+* Adding articulation to notes (example)::
@end menu
@cindex internal storage
@funindex \displayMusic
-@funindex \displayLilyMusic
When writing a music function it is often instructive to inspect how
a music expression is stored internally. This can be done with the
The note pitch can be changed by setting this 'pitch property,
+@funindex \displayLilyMusic
+
@example
#(set! (ly:music-property (first (ly:music-property someNote 'elements))
'pitch)
providing a LilyPond-like syntax. For example,
@example
(markup #:column (#:line (#:bold #:italic "hello" #:raise 0.4 "world")
- #:bigger #:line ("foo" "bar" "baz")))
+ #:larger #:line ("foo" "bar" "baz")))
@end example
@noindent
is equivalent to:
@example
\markup \column @{ \line @{ \bold \italic "hello" \raise #0.4 "world" @}
- \bigger \line @{ foo bar baz @} @}
+ \larger \line @{ foo bar baz @} @}
@end example
@noindent
@code{(markup markup1 markup2 ... )}
@item @code{\command} @tab @code{#:command}
@item @code{\variable} @tab @code{variable}
-@item @code{\center-align @{ ... @}} @tab @code{#:center-align ( ... )}
+@item @code{\center-column @{ ... @}} @tab @code{#:center-column ( ... )}
@item @code{string} @tab @code{"string"}
@item @code{#scheme-arg} @tab @code{scheme-arg}
@end multitable
@itemx @var{scm markup}
@itemx @var{scm scm}
@itemx @var{scm scm markup}
+@itemx @var{scm scm markup markup}
@itemx @var{scm markup markup}
@itemx @var{scm scm scm}
@end table
returned, rather than the @code{simple-closure} object.
-@node TODO moved into scheme
-@section TODO moved into scheme
-
-@menu
-* Using Scheme code instead of \tweak::
-* Difficult tweaks::
-@end menu
-
@node Using Scheme code instead of \tweak
-@subsection Using Scheme code instead of @code{\tweak}
+@section Using Scheme code instead of @code{\tweak}
The main disadvantage of @code{\tweak} is its syntactical
inflexibility. For example, the following produces a syntax error.
(acons 'font-size -3
(ly:music-property m 'tweaks)))
m)
-
+
\relative c'' @{
c4^\F c4_\F
@}
@node Difficult tweaks
-@subsection Difficult tweaks
+@section Difficult tweaks
There are a few classes of difficult adjustments.