force a particular direction manually, for details
see @ref{Direction and placement}.
-@predefined
+@predefined
@code{\autoBeamOff},
@code{\dotsUp},
@code{\dotsDown},
@code{\dotsNeutral}.
+@endpredefined
@seealso
-
Music Glossary:
@rglos{breve},
@rglos{longa},
To modify the duration of notes without printing a tuplet bracket,
see @ref{Scaling durations}.
-@predefined
+@predefined
@code{\tupletUp},
@code{\tupletDown},
@code{\tupletNeutral}.
+@endpredefined
@snippets
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{permitting-line-breaks-within-beamed-tuplets.ly}
-@seealso
+@seealso
Music Glossary:
@rglos{triplet},
@rglos{tuplet},
@rinternals{TupletNumber},
@rinternals{TimeScaledMusic}.
+
@knownissues
@cindex grace notes within tuplet brackets
When the first note on a staff is a grace note followed by a
@seealso
-
Notation Reference:
@ref{Tuplets},
@ref{Invisible rests},
@predefined
-
@code{\tieUp},
@code{\tieDown},
@code{\tieNeutral},
@code{\tieDotted},
@code{\tieDashed},
@code{\tieSolid}.
+@endpredefined
@snippets
@seealso
-
Music Glossary:
@rglos{tie},
@rglos{laissez vibrer}.
@seealso
-
Notation Reference:
@ref{Full measure rests}.
\skip 1 \skip1 \skip 1
@end lilypond
-@seealso
+@seealso
Snippets:
@rlsr{Rhythms}.
When a multi-measure rest immediately follows a @code{\partial}
setting, resulting bar-check warnings may not be displayed.
+
@predefined
@code{\textLengthOn},
@code{\textLengthOff},
@code{\fermataMarkup},
@code{\compressFullBarRests},
@code{\expandFullBarRests}.
+@endpredefined
+
@snippets
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{multi--measure-rest-markup.ly}
-@seealso
+@seealso
Music Glossary:
@rglos{multi-measure rest}.
Mensural time signatures are covered in
@ref{Mensural time signatures}.
-@predefined
+@predefined
@code{\numericTimeSignature},
@code{\defaultTimeSignature}.
+@endpredefined
-@snippets
-@c TODO Send as snippet called "Changing the time signature without affecting the beat length"
-
-The @code{\time} command sets the properties
-@code{timeSignatureFraction}, @code{beatLength}, and
-@code{measureLength} in the @code{Timing} context, which is
-normally aliased to @code{Score}. Changing the value of
-@code{timeSignatureFraction} causes the new time signature symbol
-to be printed without changing the other properties:
+@snippets
-@lilypond[quote,verbatim,relative=2]
-\time 3/4
-a16 a a a a a a a a a a a
-% Change time signature but keep 3/4 beaming
-% due to unchanged beatLength
-\set Score.timeSignatureFraction = #'(12 . 16)
-a16 a a a a a a a a a a a
-\time 12/16
-% Lose 3/4 beaming now beatLength has changed to 16
-a16 a a a a a a a a a a a
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{changing-the-time-signature-without-affecting-the-beaming.ly}
@cindex compound time signatures
@cindex time signature, compound
@seealso
-
Music Glossary:
@rglos{time signature}
command: i.e., @code{\partial 4} is internally translated to
@code{-4}, meaning @qq{there is a quarter note left in the measure.}
-@seealso
+@seealso
Music Glossary:
@rglos{anacrusis}.
Internal Reference:
@rinternals{Timing_translator}.
+
@knownissues
The @code{\partial} command is intended to be used only at the
d4 e d c
@end lilypond
-@predefined
+@predefined
@code{\cadenzaOn},
@code{\cadenzaOff}.
+@endpredefined
-@seealso
+@seealso
Music Glossary:
@rglos{cadenza}.
Snippets:
@rlsr{Rhythms}.
+
@knownissues
LilyPond will insert line breaks and page breaks only at a
@seealso
-
Music Glossary:
@rglos{polymetric},
@rglos{polymetric time signature},
@rglos{meter}.
Notation Reference:
-@ref{Time signature,
+@ref{Time signature},
@ref{Scaling durations}.
Snippets:
@rinternals{Default_bar_line_engraver},
@rinternals{Staff}.
+
@knownissues
When using different time signatures in parallel, notes
measures are not entirely filled, then the ties show exactly how
much each measure is off.
-@seealso
+@seealso
Music Glossary: @rglos{tie}
Learning Manual:
>>
@end lilypond
+
@predefined
@code{\improvisationOn},
@code{\improvisationOff}.
+@endpredefined
+
@snippets
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{guitar-strum-rhythms.ly}
-@seealso
+@seealso
Snippets:
@rlsr{Rhythms}.
@rinternals{RhythmicStaff},
@rinternals{Pitch_squash_engraver}.
+
@node Beams
@subsection Beams
to define beaming patterns that differ from the defaults. The
default beaming rules for most common time signatures are defined
in @file{scm/@/auto@/-beam@/.scm}. If there are no beaming rules
-defined for the time signature being used the beaming is controlled
-by the values of three context properties, @code{measureLength},
-@code{beatLength} and @code{beatGrouping}. Both the beaming rules
-and the context properties can be overridden, see
-@ref{Setting automatic beam behavior}.
+defined for a particular beam's duration in the time signature being
+used, its beaming is controlled by the values of three context
+properties, @code{measureLength}, @code{beatLength} and
+@code{beatGrouping}. Both the beaming rules and the context
+properties can be overridden, see @ref{Setting automatic beam behavior}.
@cindex autoBeamOn
@cindex autoBeamOff
c16 c8
@end lilypond
+
@predefined
@code{\autoBeamOff},
@code{\autoBeamOn}.
+@endpredefined
+
@snippets
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{changing-beam-knee-gap.ly}
-@seealso
+@seealso
Notation Reference:
@ref{Manual beams},
@ref{Setting automatic beam behavior}.
defining the beam end points. The second method, modifying the
specification of the beam end points, can be used for any time
signature. This second method @strong{must} be used for those time
-signatures for which beam ending rules are pre-defined, unless
-these have all been reverted. There are predefined rules for time
-signatures of 3/2, 3/4, 4/4, 2/4, 4/8, 4/16, 6/8, 9/8 and 12/8.
+signatures and beam durations combinations for which beam ending
+rules are pre-defined, unless these have all been reverted. There
+are predefined rules for time signatures of 3/2, 3/4, 4/4, 2/4,
+4/8, 4/16, 6/8, 9/8 and 12/8.
@i{@strong{Modifying the grouping of beats}}
-If there are no beam-ending rules defined for the time signature
-in use the beaming is controlled by three context properties:
+If there are no beam-ending rules defined for the beam duration of a
+particular beam in the time signature in use, its beaming is
+controlled by three context properties:
@code{measureLength}, @code{beatLength} and @code{beatGrouping}.
These properties may be set in the @code{Score}, @code{Staff} or
@code{Voice} contexts to delimit their scope.
@end itemize
-@warning{These three properties are effective @strong{only} if
-there are no beam-ending rules defined for the time signature in
-force, or if these beam-ending rules have all been reverted.}
+@warning{These three properties become effective for a particular
+beam @strong{only} if there are no beam-ending rules predefined for
+that beam's duration in the time signature in use, or if these
+beam-ending rules have all been reverted.}
By default the @code{measureLength} and @code{beatLength} are
derived from the time signature set by the @code{\time} command.
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{grouping-beats.ly}
-@c TODO Convert to snippet called "Specifying context with beatGrouping"
-
-By specifying the context, the effect of @code{beatGrouping} can be
-limited to the context specified, and the values set in higher-level
-contexts overridden:
-
-@lilypond[quote,verbatim]
-\score {
- \new Staff <<
- \time 7/8
- \new Voice {
- \relative c'' {
- \set Staff.beatGrouping = #'(2 3 2)
- a8 a a a a a a
- }
- }
- \new Voice {
- \relative c' {
- \voiceTwo
- \set Voice.beatGrouping = #'(1 3 3)
- f8 f f f f f f
- }
- }
- >>
-}
-@end lilypond
-
-
-@c TODO Send as snippet?
-
-The property @code{measureLength} determines where bar lines
-should be inserted and, with @code{beatLength} and
-@code{beatGrouping}, how automatic beams should be generated
-for time signatures for which no beam-ending rules are defined.
-
-@lilypond[quote,verbatim,relative=2]
-\time 3/4 % auto beam on 1/4 note groups
-a16 a a a a a a a a a a a a a a a
-\time 12/16 % no defined auto-beaming for this time sig
-a16 a a a a a a a a a a a a a a a
-\time 3/4
-a16 a a a a a a a a a a a a a a a
-\set Score.timeSignatureFraction = #'(12 . 16) %keep 3/4 beaming
- % due to beatLength
-a16 a a a a a a a a a a a a a a a
-\set Score.beatLength = #(ly:make-moment 1 8) %beam on 1/8 notes
-a16 a a a a a a a a a a a a a a a
-\set Score.beatLength = #(ly:make-moment 1 16)
-\set Score.beatGrouping = #'(3 4 2 3) %beam on 3/16, 7/16, 9/16, 12/16
-a16 a a a a a a a a a a a a a a a
-@end lilypond
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{specifying-context-with-beatgrouping.ly}
-@c End of snippet
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{using-beatlength-and-beatgrouping.ly}
@funindex subdivideBeams
<< {a8 a a a16 a a a a8 a} \\ {f4. f8 f f f} >>
@end lilypond
-@c TODO Add example using Score for multiple staves?
-@c Hmm. Not sure it works correctly. Needs more investigation.
-
@warning{If any unexpected beam behavior occurs, check the default
automatic beam settings in @file{scm/@/auto@/-beam@/.scm} for
possible interference, because the beam endings defined there will
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{beam-grouping-in-7-8-time.ly}
-@ignore
-
-@c TODO Does this example add anything?
-
-In this
-example, automatic beams can only end on a dotted quarter note
-@example
-#(override-auto-beam-setting '(end * * * *) 3 8)
-#(override-auto-beam-setting '(end * * * *) 1 2)
-#(override-auto-beam-setting '(end * * * *) 7 8)
-@end example
-
-In 4/4 time signature, this means that automatic beams could end only on
-3/8 and on the fourth beat of the measure (after 3/4, that is 2 times
-3/8, has passed within the measure).
-
-@end ignore
-
@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{reverting-default-beam-endings.ly}
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{beam-endings-in-score-context.ly}
-@predefined
+@predefined
@funindex \autoBeamOff
@code{\autoBeamOff},
@funindex \autoBeamOn
@code{\autoBeamOn}.
+@endpredefined
@knownissues
@dots{} \\ @dots{} >>}. If a polyphonic voice ends while an
automatic beam is still accepting notes, it is not typeset.
-@seealso
+@seealso
Snippets:
@rlsr{Rhythms}.
@snippets
-@c TODO Add snippet "Flat flags and beam nibs" when available
-@c Added to LSR 27 Oct 08
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{flat-flags-and-beam-nibs.ly}
@node Feathered beams
@unnumberedsubsubsec Feathered beams
The @code{\featherDurations} command only works with very short
music snippets, and when numbers in the fraction are small.
-@seealso
+@seealso
Snippets:
@rlsr{Rhythms}.
-
@node Bars
@subsection Bars
In scores with many staves, a @code{\bar} command in one staff is
automatically applied to all staves. The resulting bar lines are
connected between different staves of a @code{StaffGroup},
-@code{InnerStaffGroup}, @code{PianoStaff}, or @code{GrandStaff}.
+@code{PianoStaff}, or @code{GrandStaff}.
@lilypond[quote,fragment,verbatim]
<<
@code{"|"}. This may be changed at any time
with @code{\set Timing.defaultBarType = }@var{bartype}.
-@seealso
+@seealso
Notation Reference:
@ref{Line breaking},
@ref{Repeats},
@seealso
-
Snippets:
@rlsr{Rhythms}.
will print a warning if the @code{currentBarNumber} is not 123
when it is processed.
-@seealso
+@seealso
Snippets:
@rlsr{Rhythms}.
For common tweaks to the positioning of rehearsal marks, see
@ref{Formatting text}.
-@seealso
+@seealso
Notation Reference:
@ref{The Feta font},
@ref{Formatting text}.
Internals Reference: @rinternals{RehearsalMark}.
+
@node Special rhythmic concerns
@subsection Special rhythmic concerns
@seealso
-
Music Glossary:
@rglos{grace notes},
@rglos{acciaccatura},
>>
@end lilypond
-@seealso
+@seealso
Music Glossary:
@rglos{cadenza}.
@seealso
-
This manual: @ref{Bar numbers}, @ref{Unmetered music}
Snippets:
projects / lilypond.git / blobdiff