Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(989)

Side by Side Diff: Documentation/notation/staff.itely

Issue 4518053: Doc: NR 1.6.3 - edit eg.s in quoting other voices (Closed)
Patch Set: Third Draft Created 12 years, 10 months ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 @c -*- coding: utf-8; mode: texinfo; -*- 1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore 2 @ignore
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH 3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4 4
5 When revising a translation, copy the HEAD committish of the 5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors' 6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes.. 7 Guide, node Updating translation committishes..
8 @end ignore 8 @end ignore
9 9
10 @c \version "2.13.36" 10 @c \version "2.13.36"
(...skipping 1001 matching lines...) Expand 10 before | Expand all | Expand 10 after
1012 1012
1013 Internals Reference: 1013 Internals Reference:
1014 @rinternals{InstrumentName}, 1014 @rinternals{InstrumentName},
1015 @rinternals{PianoStaff}, 1015 @rinternals{PianoStaff},
1016 @rinternals{Staff}. 1016 @rinternals{Staff}.
1017 1017
1018 1018
1019 @node Quoting other voices 1019 @node Quoting other voices
1020 @unnumberedsubsubsec Quoting other voices 1020 @unnumberedsubsubsec Quoting other voices
1021 1021
1022 @cindex cues 1022 @cindex quote, voices
1023 @cindex quoting other voices 1023 @cindex voices, quoting
1024 @cindex fragments 1024 @cindex fragments, quoting
1025 @cindex cue notes 1025 @cindex cue notes
1026 1026
1027 @funindex \addQuote 1027 @funindex \addQuote
1028 @funindex addQuote 1028 @funindex addQuote
1029 @funindex \quoteDuring 1029 @funindex \quoteDuring
1030 @funindex quoteDuring 1030 @funindex quoteDuring
1031 @funindex \transposition 1031 @funindex \transposition
1032 @funindex transposition 1032 @funindex transposition
1033 1033
1034 It is very common for one voice to double some of the music from 1034 It is very common for one voice to use the same notes as those from
1035 another voice. For example, the first and second violins may play the 1035 another voice. For example, first and second violins playing the same
1036 same notes during a passage of music. In LilyPond this is accomplished 1036 phrase during a particular passage of the music. This is done by
1037 by letting one voice @emph{quote} the other voice without having to 1037 letting one voice @emph{quote} the other, without having to re-enter the
1038 re-enter it. 1038 music all over again for the second voice.
1039 1039
1040 Before a part can be quoted, the @code{\addQuote} command must be used 1040 The @code{\addQuote} command, used in the top level scope, defines a
1041 to initialize the quoted fragment. This command must be used in the 1041 stream of music from which fragments can be quoted.
1042 toplevel scope. The first argument is an identifying string, and the
1043 second is a music expression:
1044
1045 @example
1046 flute = \relative c'' @{
1047 a4 gis g gis
1048 @}
1049 \addQuote "flute" @{ \flute @}
1050 @end example
1051 1042
1052 The @code{\quoteDuring} command is used to indicate the point where the 1043 The @code{\quoteDuring} command is used to indicate the point where the
1053 quotation begins. It is followed by two arguments: the name of the 1044 quotation begins. It is followed by two arguments; the name of the
1054 quoted voice, as defined with @code{\addQuote}, and a music expression 1045 quoted voice, as defined with @code{\addQuote}, and a music expression
1055 that indicates the duration of the quote, usually spacer rests or 1046 that for the duration of the quote.
1056 multi-measure rests. The corresponding music (including all articulations,
1057 dynamics, markup, etc.) from the quoted voice is inserted into the music
1058 expression:
1059 1047
1060 @lilypond[verbatim,quote] 1048 @lilypond[verbatim,quote]
1061 flute = \relative c'' { 1049 fluteNotes = \relative c'' {
1062 a4 gis g->\f gis^\markup{quoted} 1050 a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
1063 } 1051 }
1064 \addQuote "flute" { \flute }
1065 1052
1066 \relative c' { 1053 oboeNotes = \relative c'' {
1067 c4 cis \quoteDuring #"flute" { s2 } 1054 c4 cis c b \quoteDuring #"flute" { s1 }
1055 }
1056
1057 \addQuote "flute" { \fluteNotes }
1058
1059 \score {
1060 <<
1061 \new Staff \with { instrumentName = "Flute" } \fluteNotes
1062 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1063 >>
1068 } 1064 }
1069 @end lilypond 1065 @end lilypond
1070 1066
1071 If the music expression used for @code{\quoteDuring} contains 1067 If the music expression used in @code{\quoteDuring} contains notes
1072 anything but a spacer rest or multi-measure rest, a polyphonic 1068 instead of spacer or multimeasure rests then the quote will appear as
1073 situation is created, which is often not desirable: 1069 polyphony and may produce unexpected results.
1074 1070
1075 @lilypond[verbatim,quote] 1071 @lilypond[verbatim,quote]
1076 flute = \relative c'' { 1072 fluteNotes = \relative c'' {
1077 a4 gis g gis 1073 a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
1078 } 1074 }
1079 \addQuote "flute" { \flute }
1080 1075
1081 \relative c' { 1076 oboeNotes = \relative c'' {
1082 c4 cis \quoteDuring #"flute" { c4 b } 1077 c4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
1078 }
1079
1080 \addQuote "flute" { \fluteNotes }
1081
1082 \score {
1083 <<
1084 \new Staff \with { instrumentName = "Flute" } \fluteNotes
1085 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1086 >>
1083 } 1087 }
1084 @end lilypond 1088 @end lilypond
1085 1089
1086 Quotations recognize instrument transposition settings for both 1090 The @code{\quoteDuring} command uses the @\code{\transposition} settings
1087 the source and target instruments if the @code{\transposition} 1091 of both quoted and quoting parts to produce notes for the quoting part
1088 command is used. For details about @code{\transposition}, see 1092 that have the same sounding pitch as those in the quoted part.
1089 @ref{Instrument transpositions}.
1090 1093
1091 @lilypond[verbatim,quote] 1094 @lilypond[verbatim,quote]
1092 clarinet = \relative c'' { 1095 clarinetNotes = \relative c'' {
1093 \transposition bes 1096 \transposition bes
1094 a4 gis g gis 1097 \key d \major
1098 b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
1095 } 1099 }
1096 \addQuote "clarinet" { \clarinet }
1097 1100
1098 \relative c' { 1101 oboeNotes = \relative c'' {
1099 c4 cis \quoteDuring #"clarinet" { s2 } 1102 c4 cis c b \quoteDuring #"clarinet" { s1 }
1103 }
1104
1105 \addQuote "clarinet" { \clarinetNotes }
1106
1107
1108 \score {
1109 <<
1110 \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
1111 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1112 >>
1100 } 1113 }
1101 @end lilypond 1114 @end lilypond
1102 1115
1103 It is possible to tag quotations with unique names in order to 1116 By default quoted music will include all articulations, dynamics,
1104 process them in different ways. For details about this procedure, 1117 markups, etc. and insert them into the music expression. It is possible
1105 see @ref{Using tags}. 1118 to choose which of these objects from the quoted music are displayed (or
1119 not) by using the @code{quotedEventTypes} context property.
1106 1120
1107 It is also possible to adjust which objects from the original voice are quoted 1121 This can also be used to give different articulation for the music
1108 by changing the @code{quotedEventTypes} property. By default, its value is 1122 expression in the other voice using the @code{\quoteDuring} function.
1109 @code{#'(StreamEvent)}, which means that everything is quoted. Setting it
1110 to e.g. @code{#'(note-event rest-event tie-event)} causes lilypond to quote
1111 only notes, rests and ties, but no articulations, markup or dynamics.
1112 1123
1113 @lilypond[verbatim,quote] 1124 @lilypond[verbatim,quote]
1114 clarinet = \relative c'' { 1125 fluteNotes = \relative c'' {
1115 a4 gis g->\f gis^\markup{quoted} 1126 a4 gis g gis | b4~^"quoted" r8 ais\p a4( f)
1127 }
1128
1129 oboeNotes = \relative c'' {
1130 c4 cis c b \quoteDuring #"flute" { s4 b8( s8)\mf s4 s4 }
1116 } 1131 }
1117 \addQuote "clarinet" { \clarinet }
1118 1132
1119 \relative c' { 1133 \addQuote "flute" { \fluteNotes }
1120 \set Score.quotedEventTypes = #'(note-event rest-event tie-event) 1134
1121 c4 cis \quoteDuring #"clarinet" { s2 } 1135 \score {
1122 } 1136 <<
1137 \set Score.quotedEventTypes = #'(note-event slur-event)
1138 \new Staff \with { instrumentName = "Flute" } \fluteNotes
1139 \new Staff \with { instrumentName = "Oboe" } \oboeNotes
1140 >>
1141 }
1123 @end lilypond 1142 @end lilypond
1124 1143
1144 Quotes can also be tagged see @ref{Using tags}.
Graham Percival (old account) 2011/05/12 13:35:03 add comma or semicolon after "tagged".
pkx166h 2011/05/12 15:20:55 Done.
1145
1125 @snippets 1146 @snippets
1126 1147
1127 @lilypondfile[verbatim,lilyquote,texidoc,doctitle] 1148 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
1128 {quoting-another-voice-with-transposition.ly} 1149 {quoting-another-voice-with-transposition.ly}
1129 1150
1130 @cindex note-event 1151 @cindex note-event
1131 @cindex articulation-event 1152 @cindex articulation-event
1132 @cindex dynamic-event 1153 @cindex dynamic-event
1133 @cindex rest-event 1154 @cindex rest-event
1134 1155
(...skipping 253 matching lines...) Expand 10 before | Expand all | Expand 10 after
1388 Internals Reference: 1409 Internals Reference:
1389 @rinternals{CueVoice}, 1410 @rinternals{CueVoice},
1390 @rinternals{Voice}. 1411 @rinternals{Voice}.
1391 1412
1392 1413
1393 @knownissues 1414 @knownissues
1394 1415
1395 Collisions can occur with rests, when using @code{\cueDuring}, 1416 Collisions can occur with rests, when using @code{\cueDuring},
1396 between @code{Voice} and @code{CueVoice} contexts. 1417 between @code{Voice} and @code{CueVoice} contexts.
1397 1418
OLDNEW
« no previous file with comments | « no previous file | no next file » | no next file with comments »

Powered by Google App Engine
RSS Feeds Recent Issues | This issue
This is Rietveld f62528b