Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
@c \version "2.12.0"
Music Glossary:
@rglos{Frenched staff}.
+Learning Manual:
+@rlearning{Visibility and color of objects}.
+
Notation Reference:
+@ref{Changing context default settings},
@ref{Staff symbol},
-@ref{Ossia staves}.
+@ref{Ossia staves},
+@ref{Hidden notes},
+@ref{Invisible rests},
+@ref{Visibility of objects}.
Snippets:
@rlsr{Staff notation}.
\override NoteHead #'no-ledgers = ##t
@end example
+For the Known issues and warnings associated with
+@code{\RemoveEmptyStaffContext} see @ref{Changing context default
+settings}.
@node Writing parts
@subsection Writing parts
@cindex instrument names, changing
@cindex changing instrument names
-Instrument names may be changed in the middle of a piece:
+Instrument names may be changed in the middle of a piece.
+However, remember that @code{instrumentName} will not be
+displayed in the middle of the piece, as it only appears
+on the first staff:
@lilypond[verbatim,quote,ragged-right,relative=1]
\set Staff.instrumentName = #"First"
quotation begins. It is followed by two arguments: the name of the
quoted voice, as defined with @code{\addQuote}, and a music expression
that indicates the duration of the quote, usually spacer rests or
-multi-measure rests. The corresponding music from the quoted voice is
-inserted into the music expression:
+multi-measure rests. The corresponding music (including all articulations,
+dynamics, markup, etc.) from the quoted voice is inserted into the music
+expression:
@lilypond[verbatim,quote]
flute = \relative c'' {
- a4 gis g gis
+ a4 gis g->\f gis^\markup{quoted}
}
\addQuote "flute" { \flute }
process them in different ways. For details about this procedure,
see @ref{Using tags}.
+It is also possible to adjust which objects from the original voice are quoted
+by changing the @code{quotedEventTypes} property. By default, its value is
+@code{#'(StreamEvent)}, which means that everything is quoted. Setting it
+to e.g. @code{#'(note-event rest-event tie-event)} causes lilypond to quote
+only notes, rests and ties, but no articulations, markup or dynamics.
+
+@lilypond[verbatim,quote]
+clarinet = \relative c'' {
+ a4 gis g->\f gis^\markup{quoted}
+}
+\addQuote "clarinet" { \clarinet }
+
+\relative c' {
+ \set Score.quotedEventTypes = #'(note-event rest-event tie-event)
+ c4 cis \quoteDuring #"clarinet" { s2 }
+}
+@end lilypond
@snippets
@cindex rest-event
@funindex quotedEventTypes
+@funindex quotedCueEventTypes
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{quoting-another-voice.ly}
\cueDuring #@var{partname} #@var{voice} @var{music}
@end example
-This command copies the corresponding measures from @var{partname}
-into a @code{CueVoice} context. The @code{CueVoice} is created
-implicitly, and occurs simultaneously with @var{music}, which
+This command copies only the notes and rests from the corresponding measures
+from @var{partname} into a @code{CueVoice} context. The @code{CueVoice} is
+created implicitly, and occurs simultaneously with @var{music}, which
creates a polyphonic situation. The @var{voice} argument
determines whether the cue notes should be notated as a first or
second voice; @code{UP} corresponds to the first voice, and
@lilypond[verbatim,quote]
oboe = \relative c'' {
- r2 r8 d16 f e g f a
+ r2 r8 d16(\f f e g f a)
g8 g16 g g2.
}
\addQuote "oboe" { \oboe }
explicitly declared, or else the entire music expression would
belong to the @code{CueVoice} context.
+It is possible to adjust which aspects of the music are quoted with
+@code{\cueDuring} by setting the @code{quotedCueEventTypes} property. Its
+default value is @code{#'(note-event rest-event tie-event beam-event
+tuplet-span-event)}, which means that only notes, rest, ties, beams and
+tuplets are quoted, but not articulations, dynamic marks, markup etc.
+
+@lilypond[verbatim,quote]
+oboe = \relative c'' {
+ r2 r8 d16(\f f e g f a)
+ g8 g16 g g2.
+}
+\addQuote "oboe" { \oboe }
+
+\new Voice \relative c'' {
+ \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
+ beam-event tuplet-span-event
+ dynamic-event slur-event)
+ \cueDuring #"oboe" #UP { R1 }
+ g2 c,
+}
+@end lilypond
+
+
+
The name of the cued instrument can be printed by setting the
@code{instrumentCueName} property in the @code{CueVoice} context.
process them in different ways. For details about this procedure,
see @ref{Using tags}.
+@cindex notes, smaller
+@cindex smaller notes
+
+A @code{CueVoice} context may be created explicitly if notes of a
+smaller size are required, for example to set an alternative
+sequence of notes more suitable for a higher or lower voice.
+
+@lilypond[verbatim,relative=2]
+\time 12/8
+\key ees \major
+g4 ees8 f4 g8
+\stemDown
+<<
+ { d4. bes4 c8 }
+ \new CueVoice
+ { g'4. f4 ees8 }
+>>
+\stemUp
+d2. d2.
+@end lilypond
+
@seealso
Notation Reference:
projects / lilypond.git / blobdiff