1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: 1440fffdf8579046cc2033b9c697a190b34b91e5
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. See TRANSLATION for details.
11 @c Translators: Jean-Charles Malahieude
13 @node Editorial annotations
14 @section Editorial annotations
16 @lilypondfile[quote]{editorial-headword.ly}
24 @node Inside the staff
25 @subsection Inside the staff
29 * Selecting notation font size::
30 * Fingering instructions::
38 @node Selecting notation font size
39 @unnumberedsubsubsec Selecting notation font size
41 Le plus sûr moyen de régler la taille de la police, quelque soit le
42 contexte, consiste à définir la propriété @code{fontSize}.
44 @lilypond[quote,fragment,relative=1,verbatim]
53 Ceci ne modifiera en rien la taille des différents symboles tels que
54 ligatures ou liaisons.
56 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
57 de définir la propriété @code{font-size} pour tous les objets de
58 rendu. La valeur de @code{font-size} est un entier représentant la
59 taille proportionnellement à la hauteur standard de la portée en
60 cours. Chaque incrément correspond à une augmentation d'environ
61 12@tie{}% de la taille de la police. Un pas de six aboutit exactement
62 au doublement de la taille. La fonction Scheme @code{magstep}
63 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
64 Vous pouvez aussi définir directement la propriété @code{font-size} de
65 manière à n'affecter seulement que certains objets de rendu.
67 @lilypond[quote,fragment,relative=1,verbatim]
69 \override NoteHead #'font-size = #-4
71 \override NoteHead #'font-size = #3
75 Pour changer la taille des symboles musicaux (police Feta), LilyPond met
76 à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
77 cf. @ref{Setting the staff size}. La taille standard, pour laquelle
78 @code{font-size} vaut 0, dépend de la hauteur de la portée. À une
79 portée de 20 points correspond une police de 10 points.
81 La propriété @code{font-size} ne peut intervenir que pour les objets
82 qui utilisent des polices, autrement dit ceux qui disposent de
83 l'interface de rendu @rinternals{font-interface}.
87 Les commandes suivantes définissent @code{fontSize} pour la voix en
99 @node Fingering instructions
100 @unnumberedsubsubsec Fingering instructions
103 @cindex substitution de doigt
106 Les doigtés peuvent être indiqués comme suit :
108 @var{note}-@var{chiffre_du_doigt}
110 Pour les substitutions de doigts, on a recours à une indication
111 textuelle (commande @code{\markup}) de doigté
112 (commande @code{\finger}).
114 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
116 c^\markup { \finger "2 - 3" }
120 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
121 dans une partition de violoncelle, si une note doit être jouée avec le
122 pouce (@q{thumb} en anglais).
124 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
125 <a_\thumb a'-3>8 <b_\thumb b'-3>
129 Les doigtés des accords peuvent être saisis note par note,
130 en les indiquant après chaque hauteur de note.
132 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
139 On peut contrôler précisément les doigtés des accords en réglant
140 la propriété @code{fingeringOrientations}.
142 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
143 \set fingeringOrientations = #'(left down)
144 <c-1 es-2 g-4 bes-5 > 4
145 \set fingeringOrientations = #'(up right down)
146 <c-1 es-2 g-4 bes-5 > 4
150 Cette propriété permet également, dans de la musique monophonique,
151 d'indiquer des doigtés très proches des têtes de notes.
153 @lilypond[verbatim,ragged-right,quote,fragment]
154 \set fingeringOrientations = #'(right)
161 Référence du programme : @rinternals{Fingering}.
163 Exemples : @rlsr{Editorial annotations}.
167 @unnumberedsubsubsec Hidden notes
169 @cindex Masquées, notes
170 @cindex Invisibles, notes
171 @cindex Transparentes, notes
174 @funindex \unHideNotes
175 Les notes masquées --- ou invisibles ou encore transparentes --- sont
176 utiles dans le cadre d'exercices de théorie ou de composition.
178 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
187 @node Coloring objects
188 @unnumberedsubsubsec Coloring objects
190 Des objets peuvent être colorisés individuellement. Une listes des
191 noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
193 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
194 \override NoteHead #'color = #red
196 \override NoteHead #'color = #(x11-color 'LimeGreen)
198 \override Stem #'color = #blue
202 L'intégralité de la palette des couleurs définies pour X11 est
203 accessible par la fonction Scheme x11-color. Cette fonction prend
204 en argument une expression symbolique
207 \override Beam #'color = #(x11-color 'MediumTurquoise)
210 ou une chaîne de caractères
213 \override Beam #'color = #(x11-color "MediumTurquoise")
216 La première formulation est à la fois plus rapide à écrire et aussi
217 plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms
218 composés des couleurs de X11.
221 \override Beam #'color = #(x11-color "medium turquoise")
224 Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
225 revient à la couleur par défaut, le noir. Le problème ressort de
226 façon évidente au vu de la partition finale.
228 L'exemple suivant illustre l'utilisation de la fonction
229 @code{x11-color}. Notez que, après avoir été définie à (x11-color
230 'Boggle), la couleur des hampes repasse au noir.
232 @lilypond[quote,ragged-right,verbatim]
234 \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
235 \set Staff.instrumentName = \markup {
236 \with-color #(x11-color 'navy) "Clarinet"
240 \override Beam #'color = #(x11-color "medium turquoise")
242 \override NoteHead #'color = #(x11-color "LimeGreen")
244 \override Stem #'color = #(x11-color 'Boggle)
252 Annexes : @ref{List of colors}.
256 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
257 internet. Aussi nous vous recommandons, dans le cadre d'une
258 présentation multimedia, d'utiliser des couleurs de base.
260 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
261 normale ayant un nom similaire.
263 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
264 @code{\override}. si besoin est, utilisez @code{\tweak}.
265 Pour plus de détails, consultez @ref{Objects connected to the input}.
269 @unnumberedsubsubsec Parentheses
271 @cindex fantômes, notes
272 @cindex notes fantômes
273 @cindex parenthèses, notes entre
275 Des objets peuvent être mis entre parenthèses en saisissant
276 @code{\parenthesize} juste avant l'événement musical.
278 @lilypond[relative=2,fragment,verbatim,ragged-right]
286 Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
287 comprendre qu'une seule note.
290 < \parenthesize NOTE>
295 @unnumberedsubsubsec Ambitus
298 L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
299 partition. Ce terme peut aussi désigner la tessiture qu'un instrument
300 est capable d'atteindre. Souvent, cet ambitus est imprimé au début des
301 partitions vocales, afin que les exécutants puissent voir au premier
302 coup d'oeil s'ils sont en mesure de tenir la partie en question.
304 Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
305 représentant la hauteur la plus basse et la plus haute. Pour imprimer
306 cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
307 au contexte @rinternals{Voice}. Ainsi,
313 \consists Ambitus_engraver
321 @lilypond[quote,ragged-right]
325 \consists Ambitus_engraver
329 \relative \new Staff {
334 Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
335 graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
336 plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
337 alors celui de toutes les voix cumulées, non d'une seule des voix
340 @lilypond[verbatim,ragged-right,quote]
342 \consists "Ambitus_engraver"
346 \remove "Ambitus_engraver"
348 \override Ambitus #'X-offset = #-1.0
353 \remove "Ambitus_engraver"
362 Cet exemple met en œuvre une fonctionnalité avancée :
365 \override Ambitus #'X-offset = #-1.0
369 Ce réglage déplace l'ambitus vers la gauche. Le même résultat aurait pu
370 être obtenu avec @code{extra-offset}, mais alors le système de mise en
371 forme n'aurait pas attribué d'espace supplémentaire pour l'objet
376 Référence du programme : @rinternals{Ambitus},
377 @rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
378 @rinternals{AmbitusAccidental}.
380 Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
384 LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
389 @unnumberedsubsubsec Stems
391 Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
392 automatiquement. Pour les rondes et les silences, ils sont aussi
393 créés, mais en mode invisible.
401 @funindex \stemNeutral
407 Pour changer la direction des hampes au milieu de la portée, utilisez
409 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
411 \override Stem #'neutral-direction = #up
413 \override Stem #'neutral-direction = #down
418 @node Outside the staff
419 @subsection Outside the staff
425 * Blank music sheet::
429 @subsubsection Balloon help
431 Vous pouvez marquer et nommer des éléments de notation à l'aide de
432 bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
435 En voici un exemple :
437 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
438 \new Voice \with { \consists "Balloon_engraver" }
440 \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
441 <c-\balloonText #'(-2 . -2) \markup { Hello } >8
446 Vous disposez de deux fonctions musicales, @code{balloonText} et
447 @code{balloonGrobText}. @code{balloonGrobText} prend en argument
448 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
449 comme une simple articulation. Les autres arguments sont le décalage
450 et le texte de la bulle.
453 @cindex notation, expliquer
457 Référence du programme : @rinternals{text-balloon-interface}.
461 @subsubsection Grid lines
463 Vous pouvez tracer des lignes entre les portées, synchronisées avec
466 @lilypond[ragged-right,quote,verbatim]
470 \consists "Grid_point_engraver" %% active les guides
471 gridInterval = #(ly:make-moment 1 4)
476 \consists "Grid_line_span_engraver"
477 %% centre les lignes guides horizontalement sous les notes
478 \override NoteColumn #'X-offset = #-0.5
489 %% centre les lignes guides verticalement
490 \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
500 Exemples : @rlsr{Editorial annotations}.
503 @node Blank music sheet
504 @subsubsection Blank music sheet
506 @cindex Papier musique
507 @cindex Portées, feuille blanche
509 Une feuille de papier musique s'obtient en utilisant des notes
510 invisibles, et en invalidant le @code{Bar_number_engraver}.
513 @lilypond[quote,verbatim]
514 \layout{ indent = #0 }
516 \repeat unfold 2 % À modifier pour plus de lignes.
521 \override TimeSignature #'transparent = ##t
522 % décommenter la ligne suivante selon besoin
523 % \override Clef #'transparent = ##t
525 \remove Bar_number_engraver
528 % à adapter selon les portées désirées
529 \new Staff \emptymusic
530 \new TabStaff \emptymusic