This is a followup issue to the changes introduced by issue 3095.
@end ignore
+@item
+Tuplets are now created with the @code{\tuplet} command, which
+takes a fraction @code{@var{t}/@var{n}} to specify that @var{t}
+notes are played in the time usually allowed for @var{n}. One
+@code{\tuplet} command can create several tuplet groups if their
+duration is typed after the fraction.
+@lilypond[quote,verbatim,relative=2]
+\tuplet 3/2 { c8 d e } \tuplet 3/2 { f e d } c2
+\tuplet 3/2 4 { c8 d e f e d } c2
+@end lilypond
+The @code{\times} command with its inverted fraction order
+@code{@var{n}/@var{t}} is still available.
+
@item
Introducing two new markup-commands; @code{\draw-dashed-line} and
@code{\draw-dotted-line}.
@item
other than that, everything is on the table. Is it a problem to
have the tagline inside \header? What should the default behavior
-of \include be? When we abolish \times, do we move to \tuplet 3:2
-or \tuplet 2/3 or what (for typical triplets in 4/4 time)?
+of \include be?
@item
we need to get standards for command names. This will help users
@cindex tuplets
@cindex triplets
-@funindex \times
-@funindex times
+@funindex \tuplet
+@funindex tuplet
Music Glossary: @rglos{note value}, @rglos{triplet}.
-@notation{Tuplets} are made with the @code{\times} keyword. It
+@notation{Tuplets} are made with the @code{\tuplet} keyword. It
takes two arguments: a fraction and a piece of music. The
-duration of the piece of music is multiplied by the fraction.
-Triplets make notes occupy 2/3 of their notated duration, so a
-@notation{triplet} has 2/3 as its fraction
+fraction is the number of tuplet notes over the number
+of notes normally filling the same duration.
+For triplets, there are three notes instead of two, so
+@notation{triplets} have 3/2 as their fraction.
@lilypond[verbatim,quote,relative=2]
\tuplet 3/2 { f8 g a }
\context {
\Score
\override SpacingSpanner
- #'base-shortest-duration = #(ly:make-moment 1 32)
+ #'base-shortest-duration = #(ly:make-moment 1/32)
}
}
}
\context {
\Score
\override SpacingSpanner
- #'base-shortest-duration = #(ly:make-moment 1 1)
+ #'base-shortest-duration = #(ly:make-moment 1/1)
\override NonMusicalPaperColumn
#'line-break-system-details = #'((alignment-distances . (3 3)))
\override BarLine #'stencil = ##f
\context {
\Score
\override SpacingSpanner
- #'base-shortest-duration = #(ly:make-moment 2 1)
+ #'base-shortest-duration = #(ly:make-moment 2/1)
\override NonMusicalPaperColumn
#'line-break-system-details = #'((alignment-distances . (3 3)))
\override BarLine #'stencil = ##f
\context {
\Score
\override SpacingSpanner #'base-shortest-duration =
- #(ly:make-moment 2 1)
+ #(ly:make-moment 2/1)
\override NonMusicalPaperColumn
#'line-break-system-details = #'((alignment-distances . (3 3)))
\override BarLine #'stencil = ##f
@lilypond[quote,notime]
\relative c'' {
\override Staff.Clef #'full-size-change = ##t
- \set Score.proportionalNotationDuration = #(ly:make-moment 1 8)
+ \set Score.proportionalNotationDuration = #(ly:make-moment 1/8)
\clef french
g1
\clef treble
@lilypond[quote,line-width=13.0\cm]
\relative c'' {
\time 4/4
- \times 2/3 {g8_"triplets" g g} g4 g8 g g4 \bar "||"
- \times 2/5 {g8_"quintuplets" g g g g} g4 g8 g g4 \bar "||"
+ \tuplet 3/2 {g8_"triplets" g g} g4 g8 g g4 \bar "||"
+ \tuplet 5/2 {g8_"quintuplets" g g g g} g4 g8 g g4 \bar "||"
}
@end lilypond
@lilypond[quote,line-width=13.0\cm]
\relative c'' {
\time 3/4
- \times 3/2 {g4_"duplets" g} |
+ \tuplet 2/3 {g4_"duplets" g} |
g4 g g \bar "||"
- \times 6/4 {g8_"quadruplets" g g g} |
+ \tuplet 4/6 {g8_"quadruplets" g g g} |
g8 g g g g4 \bar "||"
}
@end lilypond
}
\relative c'' {
c2. c32 b c b c b c b | c1
- c2. b32 c b c \times 4/5 { b c b c b } | c1
+ c2. b32 c b c \tuplet 5/4 { b c b c b } | c1
}
>>
@end lilypond
@cindex tuplets
@cindex triplets
-@funindex \times
-@funindex times
+@funindex \tuplet
+@funindex tuplet
-Tuplets are made from a music expression by multiplying all the
-durations with a fraction:
+Tuplets are made from a music expression with the @code{\tuplet}
+command, multiplying the speed of the music expression by a
+fraction:
@example
-\times @var{fraction} @{ @var{music} @}
+\tuplet @var{fraction} @{ @var{music} @}
@end example
@noindent
-The duration of @code{@var{music}} will be multiplied by the
-fraction. The fraction's denominator will be printed over or
+The fraction's numerator will be printed over or
under the notes, optionally with a bracket. The most common
-tuplet is the triplet in which 3 notes have the duration of 2, so
-the notes are 2/3 of their written length.
+tuplets are triplets: 3@tie{}notes sound within the duration
+normally allowed for@tie{}2:
@lilypond[quote,verbatim,relative=2]
a2 \tuplet 3/2 { b4 b b }
c4 c \tuplet 3/2 { b4 a g }
@end lilypond
+@cindex tuplet grouping
+@noindent
+When entering long passages of tuplets, having to write a separate
+@code{\tuplet} command for each group is inconvenient. It is
+possible to specify the duration of one tuplet group directly
+before the music in order to have the tuplets grouped
+automatically:
+
+@lilypond[quote,verbatim,relative=2]
+g2 r8 \tuplet 3/2 8 { cis16 d e e f g g f e }
+@end lilypond
+
@cindex tuplet bracket placement
@funindex \tupletUp
@knownissues
Grace notes may be placed within tuplet brackets, @emph{except}
when a staff begins with a grace note followed by a tuplet. In this
-particular case, the grace note must be placed before the @code{\times}
+particular case, the grace note must be placed before the @code{\tuplet}
command to avoid errors.
@cindex tempo marks within tuplet brackets
@funindex timeSignatureFraction
@funindex \scaleDurations
@funindex scaleDurations
-@funindex \times
-@funindex times
+@funindex \tuplet
+@funindex tuplet
Polymetric notation is supported explicitly or by manually modifying the
visible time signature symbol and/or scaling note durations.
explicitly named in order to attach lyrics to it, the partcombiner will
stop working.
-@code{\partcombine...} functions cannot be placed inside a @code{\times}
+@code{\partcombine...} functions cannot be placed inside a @code{\tuplet}
or @code{\relative} block.
If @code{printPartCombineTexts} is set and the two voices play the same
--- /dev/null
+\version "2.17.11"
+
+\header {
+ lsrtags = "rhythms"
+
+ texidoc = "
+By default, only the numerator of the tuplet number is printed over the
+tuplet bracket. Alternatively, num:den of the tuplet number may
+be printed, or the tuplet number may be suppressed altogether.
+
+"
+ doctitle = "Changing the tuplet number"
+}
+
+
+\relative c'' {
+ \tuplet 3/2 { c8 c c }
+ \tuplet 3/2 { c8 c c }
+ \override TupletNumber.text = #tuplet-number::calc-fraction-text
+ \tuplet 3/2 { c8 c c }
+ \override TupletNumber.stencil = ##f
+ \tuplet 3/2 { c8 c c }
+}
--- /dev/null
+\version "2.17.11"
+
+\header {
+ lsrtags = "rhythms, syntax-and-expressions"
+
+ texidoc = "
+The property @code{tupletSpannerDuration} sets how long each of the
+tuplets contained within the brackets after @code{\\tuplet} should last.
+Many consecutive tuplets can then be placed within a single
+@code{\\tuplet} expression, thus saving typing.
+
+There are several ways to set @code{tupletSpannerDuration}. The command
+@code{\\tupletSpan} sets it to a given duration, and clears it when
+instead of a duration @code{\\default} is specified. Another way is
+to use an optional argument with @code{\\tuplet}.
+"
+ doctitle = "Entering several tuplets using only one \\tuplet command"
+}
+
+
+\relative c' {
+ \time 2/4
+ \tupletSpan 4
+ \tuplet 3/2 { c8^"\\tupletSpan 4" c c c c c }
+ \tupletSpan \default
+ \tuplet 3/2 { c8^"\\tupletSpan \\default" c c c c c }
+ \tuplet 3/2 4 { c8^"\\tuplet 3/2 4 {...}" c c c c c }
+}