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.
7 %% Note: this file works from version 2.17.6
11 lsrtags = "correction-wanted, expressive-marks, tweaks-and-overrides, version-specific"
14 Some dynamic expressions involve additional text, like @qq{sempre pp}.
15 Since dynamics are usually centered under the note, the \\pp would be
16 displayed way after the note it applies to.
18 To correctly align the @qq{sempre pp} horizontally, so that it is
19 aligned as if it were only the \\pp, there are several approaches:
21 * Simply use @code{\\once\\override DynamicText.X-offset = #-9.2}
22 before the note with the dynamics to manually shift it to the correct
23 position. Drawback: This has to be done manually each time you use that
26 * Add some padding (@code{#:hspace 7.1}) into the
27 definition of your custom dynamic mark, so that after lilypond
28 center-aligns it, it is already correctly aligned. Drawback: The
29 padding really takes up that space and does not allow any other markup
30 or dynamics to be shown in that position.
32 * Shift the dynamic script @code{\\once\\override ...X-offset = ..}.
33 Drawback: @code{\\once\\override} is needed for every invocation!
35 * Set the dimensions of the additional text to 0 (using
36 @code{#:with-dimensions '(0 . 0) '(0 . 0)}). Drawback: To LilyPond
37 @qq{sempre} has no extent, so it might put other stuff there and create
38 collisions (which are not detected by the collision detection!). Also,
39 there seems to be some spacing, so it's not exactly the same alignment
40 as without the additional text
42 * Add an explicit shifting directly inside the scheme function for the
45 * Set an explicit alignment inside the dynamic-script. By default, this
46 won't have any effect, only if one sets X-offset! Drawback: One needs
47 to set @code{DynamicText #'X-offset}, which will apply to all dynamic
48 texts! Also, it is aligned at the right edge of the additional text,
49 not at the center of pp.
51 doctitle = "Horizontally aligning custom dynamics (e.g. \"sempre pp\" \"piu f\" \"subito p\")"
55 \header { title = "Horizontally aligning custom dynamics" }
57 \paper { ragged-right = ##f }
59 % Solution 1: Using a simple markup with a particular halign value
60 % Drawback: It's a markup, not a dynamic command, so \dynamicDown
61 % etc. will have no effect
62 semppMarkup = \markup { \halign #1.4 \italic "sempre" \dynamic "pp" }
64 % Solution 2: Using a dynamic script & shifting with
65 % \once \override ...X-offset = ..
66 % Drawback: \once \override needed for every invocation
74 % Solution 3: Padding the dynamic script so the center-alignment
75 % puts it at the correct position
76 % Drawback: the padding really reserves the space, nothing else can be there
85 % Solution 4: Dynamic, setting the dimensions of the additional text to 0
86 % Drawback: To lilypond "sempre" has no extent, so it might put
87 % other stuff there => collisions
88 % Drawback: Also, there seems to be some spacing, so it's not exactly the
89 % same alignment as without the additional text
93 (#:with-dimensions '(0 . 0) '(0 . 0)
99 % Solution 5: Dynamic with explicit shifting inside the scheme function
101 #(make-dynamic-script
103 #:translate '(-18.85 . 0)
104 #:line (#:normal-text
108 % Solution 6: Dynamic with explicit alignment. This has only effect
109 % if one sets X-offset!
110 % Drawback: One needs to set DynamicText.X-offset!
111 % Drawback: Aligned at the right edge of the additional text,
112 % not at the center of pp
114 #(make-dynamic-script
115 (markup #:line (#:right-align
120 \context StaffGroup <<
121 \context Staff = "s" <<
122 \set Staff.instrumentName = #"Normal"
125 c4\pp c\p c c | c\ff c c\pp c
128 \context Staff = "sMarkup" <<
129 \set Staff.instrumentName = \markup \column { Normal markup }
132 c4-\semppMarkup c\p c c | c\ff c c-\semppMarkup c
135 \context Staff = "sK" <<
136 \set Staff.instrumentName = \markup \column { Explicit shifting }
139 \once \override DynamicText.X-offset = #-9.2
142 \once \override DynamicText.X-offset = #-9.2
146 \context Staff = "sT" <<
147 \set Staff.instrumentName = \markup \column { Right padding }
150 c4\semppT c\p c c | c\ff c c\semppT c
153 \context Staff = "sM" <<
154 \set Staff.instrumentName = \markup \column { Setting dimension "to zero" }
157 c4\semppM c\p c c | c\ff c c\semppM c
160 \context Staff = "sG" <<
161 \set Staff.instrumentName = \markup \column { Shifting inside dynamics }
164 c4\semppG c\p c c | c\ff c c\semppG c
167 \context Staff = "sMII" <<
168 \set Staff.instrumentName = \markup \column { Alignment inside dynamics }
171 % Setting to ##f (false) gives the same result
172 \override DynamicText.X-offset = #0
173 c4\semppMII c\p c c | c\ff c c\semppMII c