1 % DO NOT EDIT this file manually; it is automatically
2 % generated from Documentation/snippets/new
3 % Make any changes in Documentation/snippets/new/
4 % and then run scripts/auxiliar/makelsr.py
6 % This file is in the public domain.
10 lsrtags = "correction-wanted, expressive-marks, tweaks-and-overrides, version-specific"
13 Some dynamic expressions involve additional text, like @qq{sempre pp}.
14 Since dynamics are usually centered under the note, the \\pp would be
15 displayed way after the note it applies to.
17 To correctly align the @qq{sempre pp} horizontally, so that it is
18 aligned as if it were only the \\pp, there are several approaches:
20 * Simply use @code{\\once\\override DynamicText.X-offset = #-9.2}
21 before the note with the dynamics to manually shift it to the correct
22 position. Drawback: This has to be done manually each time you use that
25 * Add some padding (@code{#:hspace 7.1}) into the
26 definition of your custom dynamic mark, so that after lilypond
27 center-aligns it, it is already correctly aligned. Drawback: The
28 padding really takes up that space and does not allow any other markup
29 or dynamics to be shown in that position.
31 * Shift the dynamic script @code{\\once\\override ...X-offset = ..}.
32 Drawback: @code{\\once\\override} is needed for every invocation!
34 * Set the dimensions of the additional text to 0 (using
35 @code{#:with-dimensions '(0 . 0) '(0 . 0)}). Drawback: To LilyPond
36 @qq{sempre} has no extent, so it might put other stuff there and create
37 collisions (which are not detected by the collision detection!). Also,
38 there seems to be some spacing, so it's not exactly the same alignment
39 as without the additional text
41 * Add an explicit shifting directly inside the scheme function for the
44 * Set an explicit alignment inside the dynamic-script. By default, this
45 won't have any effect, only if one sets X-offset! Drawback: One needs
46 to set @code{DynamicText #'X-offset}, which will apply to all dynamic
47 texts! Also, it is aligned at the right edge of the additional text,
48 not at the center of pp.
54 doctitle = "Horizontally aligning custom dynamics (e.g. \"sempre pp\" \"piu f\" \"subito p\")"
58 \header { title = "Horizontally aligning custom dynamics" } % begin verbatim
61 \paper { ragged-right = ##f }
63 % Solution 1: Using a simple markup with a particular halign value
64 % Drawback: It's a markup, not a dynamic command, so \dynamicDown
65 % etc. will have no effect
66 semppMarkup = \markup { \halign #1.4 \italic "sempre" \dynamic "pp" }
68 % Solution 2: Using a dynamic script & shifting with
69 % \once \override ...X-offset = ..
70 % Drawback: \once \override needed for every invocation
78 % Solution 3: Padding the dynamic script so the center-alignment
79 % puts it at the correct position
80 % Drawback: the padding really reserves the space, nothing else can be there
89 % Solution 4: Dynamic, setting the dimensions of the additional text to 0
90 % Drawback: To lilypond "sempre" has no extent, so it might put
91 % other stuff there => collisions
92 % Drawback: Also, there seems to be some spacing, so it's not exactly the
93 % same alignment as without the additional text
97 (#:with-dimensions '(0 . 0) '(0 . 0)
103 % Solution 5: Dynamic with explicit shifting inside the scheme function
105 #(make-dynamic-script
107 #:translate '(-18.85 . 0)
108 #:line (#:normal-text
112 % Solution 6: Dynamic with explicit alignment. This has only effect
113 % if one sets X-offset!
114 % Drawback: One needs to set DynamicText.X-offset!
115 % Drawback: Aligned at the right edge of the additional text,
116 % not at the center of pp
118 #(make-dynamic-script
119 (markup #:line (#:right-align
124 \context StaffGroup <<
125 \context Staff = "s" <<
126 \set Staff.instrumentName = #"Normal"
129 c4\pp c\p c c | c\ff c c\pp c
132 \context Staff = "sMarkup" <<
133 \set Staff.instrumentName = \markup \column { Normal markup }
136 c4-\semppMarkup c\p c c | c\ff c c-\semppMarkup c
139 \context Staff = "sK" <<
140 \set Staff.instrumentName = \markup \column { Explicit shifting }
143 \once \override DynamicText.X-offset = #-9.2
146 \once \override DynamicText.X-offset = #-9.2
150 \context Staff = "sT" <<
151 \set Staff.instrumentName = \markup \column { Right padding }
154 c4\semppT c\p c c | c\ff c c\semppT c
157 \context Staff = "sM" <<
158 \set Staff.instrumentName = \markup \column { Setting dimension "to zero" }
161 c4\semppM c\p c c | c\ff c c\semppM c
164 \context Staff = "sG" <<
165 \set Staff.instrumentName = \markup \column { Shifting inside dynamics }
168 c4\semppG c\p c c | c\ff c c\semppG c
171 \context Staff = "sMII" <<
172 \set Staff.instrumentName = \markup \column { Alignment inside dynamics }
175 % Setting to ##f (false) gives the same result
176 \override DynamicText.X-offset = #0
177 c4\semppMII c\p c c | c\ff c c\semppMII c