]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/fr/notation/changing-defaults.itely
Docs-{fr,ja}: remove trailing ' @c external' in arguments of @translationof
[lilypond.git] / Documentation / fr / notation / changing-defaults.itely
1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
2
3 @ignore
4     Translation of GIT committish: 76de7e168dbc9ffc7671d99663c5ce50dae42abb
5
6     When revising a translation, copy the HEAD committish of the
7     version that you are working on.  See TRANSLATION for details.
8 @end ignore
9
10 @c \version "2.12.0"
11
12 @c Translators: Valentin Villenave, Jean-Charles Malahieude
13 @c Translation checkers: Gilles Thibault
14
15
16 @node Modification des réglages prédéfinis
17 @chapter Modification des réglages prédéfinis
18 @translationof Changing defaults
19
20 LilyPond est conçu pour engendrer, par défaut, des partitions de la
21 plus haute qualité.  Cependant, on peut parfois avoir à modifier cette
22 mise en page par défaut.  Celle-ci est réglée par tout un ensemble de
23 @qq{leviers et manettes}, dont ce chapitre ne cherche pas à faire
24 l'inventaire exhaustif.  Le propos est plutôt ici de mettre en évidence
25 les différents groupes auxquels s'apparentent ces contrôles, et d'expliquer
26 comment trouver le bon levier pour obtenir tel ou tel effet en particulier.
27
28 @cindex Référence des propriétés internes
29
30 Les moyens de contrôle des différents réglages sont décrits dans un document
31 séparé, la
32 @iftex
33 référence des propriétés internes
34 @end iftex
35 @ifnottex
36 @ref{Top,Référence des propriétés internes,,lilypond-internals}.
37 @end ifnottex
38 Ce guide répertorie toutes les variables, fonctions et autres options que
39 LilyPond met à votre disposition.  Il est consultable
40 @c leave the @uref as one long line.
41 @uref{http://@/lilypond@/.org/@/doc/@/stable/@/Documentation/@/user/@/lilypond@/-internals/,en@tie{}ligne},
42 au format HTML, mais est également inclus dans la documentation
43 fournie avec le logiciel.
44
45 Il est quatre domaines dans lesquels on peut modifier les réglages par
46 défaut :
47
48 @itemize @bullet
49 @item
50 La notation automatique, ce qui revient à modifier la manière dont les
51 éléments de notation sont automatiquement créés -- par exemple, les
52 règles de ligature. 
53
54 @item
55 L'apparence, qui se rapporte aux objets pris individuellement -- ainsi
56 de la direction des hampes, du placement des indications textuelles.
57
58 @item
59 Les contextes, qui recouvrent la manière dont les évènements musicaux
60 sont représentés sous forme de notation -- par exemple, le fait
61 d'attribuer un chiffre de mesure distinct à chaque portée. 
62
63 @item
64 La mise en page, autrement dit les marges, l'espacement, la taille du
65 papier ; tous ces facteurs font l'objet des chapitres 
66 @ref{Généralités en matière d'entrée et sortie} et @ref{Gestion de l'espace}.
67 @end itemize
68
69 En sous-main, LilyPond se sert du langage Scheme (un dérivé du LISP) comme
70 infrastructure.  Modifier les choix de mise en page revient à pénétrer dans
71 les entrailles du programme, et de ce fait requiert l'emploi du Scheme.
72 Les fragments de Scheme, dans un fichier @code{.ly}, sont introduits par le
73 caractère @q{hash}, (@code{#}, improprement surnommé @q{dièse}).@footnote{Le
74 @rlearning{Tutoriel Scheme} fournit quelques notions de base pour saisir
75 des nombres, des listes, des chaînes de caractères ou des symboles, en
76 Scheme.} 
77
78
79 @menu
80 * Contextes d'interprétation::
81 * En quoi consiste la référence du programme::
82 * Modification de propriétés::
83 * Propriétés et contextes utiles::
84 * Retouches avancées::
85 @end menu
86
87 @node Contextes d'interprétation
88 @section Contextes d'interprétation
89 @translationof Interpretation contexts
90
91 Cette section traite des contextes.
92
93 @menu
94 * Tout savoir sur les contextes::
95 * Création d'un contexte::
96 * Conservation d'un contexte::
97 * Modification des greffons de contexte::
98 * Modification des réglages par défaut d'un contexte::
99 * Définition de nouveaux contextes::
100 * Alignement des contextes::
101 @end menu
102
103
104 @seealso
105 Manuel d'initiation :
106 @rlearning{Contextes et graveurs}.
107
108 Fichiers d'initialisation :
109 @file{ly/@/engraver@/-init@/.ly},
110 @file{ly/@/performer@/-init@/.ly}.
111
112 Morceaux choisis :
113 @rlsr{Contexts and engravers}.
114
115 Référence des propriétés internes :
116 @rinternals{Contexts},
117 @rinternals{Engravers and Performers}.
118
119
120 @node Tout savoir sur les contextes
121 @subsection Tout savoir sur les contextes
122 @translationof Contexts explained
123
124 @ignore
125 @c TODO Rethink and rewrite
126
127 >> > > - list of contexts: my *danger unmaintainable*
128 >> > > alarm just went off.  I'm
129
130 I knew it would... And leaving out some of them is perfectly fine
131 with me.
132 I do think that a list like this, with the main contexts and a
133 brief
134 description of  what they do (perhaps also with a note about what
135 default
136 behavior is associated with each of them, but this may be
137 unmanageable),
138 should be there, and then we could simply list the remaining ones
139 without
140 further explanation and with links to the IR.
141 @end ignore
142
143 @c TODO Improve layout, order and consistency of wording -td
144
145 @c TODO Add introduction which explains contexts in generality  -td
146
147 @c TODO Describe propagation of property values -td
148
149
150 @menu
151 * Score -- le père de tous les contextes::
152 * Contextes de haut niveau -- les systèmes::
153 * Contextes de niveau intermédiaire -- les portées::
154 * Contextes de bas niveau -- les voix::
155 @end menu
156
157 @node Score -- le père de tous les contextes
158 @unnumberedsubsubsec Score -- le père de tous les contextes
159 @translationof Score - the master of all contexts
160
161 @untranslated
162
163
164 @node Contextes de haut niveau -- les systèmes
165 @unnumberedsubsubsec Contextes de haut niveau -- les systèmes
166 @translationof Top-level contexts - staff containers
167
168 @untranslated
169
170
171 @node Contextes de niveau intermédiaire -- les portées
172 @unnumberedsubsubsec Contextes de niveau intermédiaire -- les portées
173 @translationof Intermediate-level contexts - staves
174
175 @untranslated
176
177
178 @node Contextes de bas niveau -- les voix
179 @unnumberedsubsubsec Contextes de bas niveau -- les voix
180 @translationof Bottom-level contexts - voices
181
182 @untranslated
183
184
185 @node Création d'un contexte
186 @subsection Création d'un contexte
187 @translationof Creating contexts
188
189 @untranslated
190
191
192 @node Conservation d'un contexte
193 @subsection Conservation d'un contexte
194 @translationof Keeping contexts alive
195
196 @untranslated
197
198
199 @node Modification des greffons de contexte
200 @subsection Modification des greffons de contexte
201 @translationof Modifying context plug-ins
202
203 Les contextes, tels que @code{Score} ou @code{Staff}, ne contiennent
204 pas que des propriétés ; ils mettent également en œuvre certains
205 sous-programmes (@q{plug-ins}, pour employer le terme consacré) nommés
206 @q{graveurs} (@q{engravers}, pour reprendre le terme anglais).
207 Ces sous-programmes sont chargés de créer les différents éléments de
208 notation : 
209 On trouve ainsi dans le contexte @code{Voice}, un graveur
210 @code{Note_head_engraver}, 
211 chargé des têtes de notes, et dans le contexte @code{Staff}, un graveur
212 @code{Key_signature_engraver}, chargé de l'armure.
213
214 Vous trouverez une description exhaustive de chaque graveur dans
215 @ifhtml
216 @rinternals{Engravers and Performers}.
217 @end ifhtml
218 @ifnothtml
219 Program reference @expansion{} Translation @expansion{} Engravers.
220 @end ifnothtml
221 Chaque contexte mentionné dans
222 @ifhtml
223 @rinternals{Contexts}
224 @end ifhtml
225 @ifnothtml
226 Program reference @expansion{} Translation @expansion{} Context.
227 @end ifnothtml
228 répertorie les graveurs mis en œuvre.
229
230
231 On peut faire, au moyen de ces graveurs, sa propre @qq{cuisine}, en
232 modifiant les contextes à volonté.
233
234
235 Lorsque un contexte est créé, par la commande @code{\new} ou @code{\context}, on peut
236 y adjoindre un bloc @code{\with} (en anglais @q{avec}), dans lequel il est possible
237 d'ajouter (commande @code{\consists}) ou d'enlever (commande @code{\remove})
238 des graveurs :
239
240 @funindex \with
241
242 @example
243 \new @var{contexte} \with @{
244   \consists @dots{}
245   \consists @dots{}
246   \remove @dots{}
247   \remove @dots{}
248   @emph{etc.}
249 @}
250 @{
251   @emph{..musique..}
252 @}
253 @end example
254
255 @noindent
256 Ici les points de suspension @dots{} devront être remplacés par les noms
257 des graveurs désirés.  Dans l'exemple suivant, on enlève du contexte
258 @code{Staff}, le chiffre de mesure (graveur @code{Time_signature_engraver})
259 et la clé (graveur @code{Clef_engraver}).
260
261 @lilypond[quote,relative=1,verbatim,fragment]
262 <<
263   \new Staff {
264     f2 g
265   }
266   \new Staff \with {
267      \remove "Time_signature_engraver"
268      \remove "Clef_engraver"
269   } {
270     f2 g2
271   }
272 >>
273 @end lilypond
274
275 La clé et le chiffre de mesure ont disparu de la deuxième portée.  C'est
276 une méthode quelque peu radicale, puisqu'elle affectera toute la portée
277 jusqu'à la fin de la partition.  L'espacement s'en trouve également
278 affecté, ce qui peut être ou non l'effet recherché.  Une méthode plus
279 sophistiquée aurait été de rendre ces objets transparents (voir
280 @rlearning{Visibilité et couleur des objets}). 
281
282 Dans l'exemple suivant, voici une mise en pratique plus utile.  En temps
283 normal, les barres de mesure et la métrique sont synchronisées verticalement
284 dans toute la partition.  Les graveurs qui en sont responsables se nomment
285 @code{Timing_translator} et @code{Default_bar_line_engraver}.
286 En les enlevant du contexte @code{Score} pour les attribuer au contexte
287 @code{Staff}, chaque portée peut désormais avoir sa propre métrique.
288
289 @cindex polymétrique, partition
290 @cindex Chiffres de mesure multiples
291
292 @lilypond[quote,relative=1,ragged-right,verbatim,fragment]
293 \new Score \with {
294   \remove "Timing_translator"
295   \remove "Default_bar_line_engraver"
296 } <<
297   \new Staff \with {
298     \consists "Timing_translator"
299     \consists "Default_bar_line_engraver"
300   } {
301       \time 3/4
302       c4 c c c c c
303   }
304   \new Staff \with {
305     \consists "Timing_translator"
306     \consists "Default_bar_line_engraver"
307   } {
308        \time 2/4
309        c4 c c c c c
310   }
311 >>
312 @end lilypond
313
314
315 @c deprecated node: delete. --fv
316 @ignore
317 @n ode Retouches de mise en forme au sein des contextes
318 @s ubsection Retouches de mise en forme au sein des contextes
319 @t ranslationof Layout tunings within contexts
320
321 Chaque contexte est chargé de créer plusieurs types d'objets graphiques.
322 Il contient également les réglages nécessaires pour chacun de ces objets.
323 Si l'on modifie ces réglages, les objets n'auront plus la même apparence.
324
325 La syntaxe employée pour ce faire est
326
327 @example
328 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
329 @end example
330
331 Ici @var{objet} est un objet graphique, tel que @code{Stem} (les hampes)
332 ou @code{NoteHead} (les têtes de note) ; @var{propriété} est une variable
333 (désignée par un symbole, ce qui explique l'apostrophe) employée par le système
334 de mise en page.  La sous-section @ref{Élaboration d'une retouche} vous
335 aidera à savoir quoi mettre à la place de @var{objet}, @var{propriété} et
336 @var{valeur} ; notre propos n'est ici que d'examiner l'emploi de cette commande.
337
338 La commande suivante :
339
340 @verbatim
341 \override Staff.Stem #'thickness = #4.0
342 @end verbatim
343
344 @noindent
345 rend les hampes plus épaisses (la valeur par défaut est 1.3, ce qui signifie qu'elles
346 sont 1,3 fois plus épaisses que les lignes de la portée).  Dans la mesure où nous avons
347 indiqué @code{Staff} comme contexte, ce réglage ne s'appliquera qu'à la portée courante ;
348 les autres portées demeureront intactes.
349
350
351 @lilypond[quote,verbatim,relative=2,fragment]
352 c4
353 \override Staff.Stem #'thickness = #4.0
354 c4
355 c4
356 c4
357 @end lilypond
358
359 La commande @code{\override} modifie donc la définition de l'objet @code{Stem}
360 dans le contexte @code{Staff} ; toutes les hampes qui suivent seront affectées.
361
362 Tout comme avec la commande @code{\set}, l'argument @var{contexte} peut être omis, auquel
363 cas le contexte par défaut (ici, @code{Voice}) sera employé.  La commande @code{\once}
364 permet de n'appliquer la modification qu'une seule fois.
365
366 @lilypond[quote,fragment,verbatim,relative=2]
367 c4
368 \once \override Stem #'thickness = #4.0
369 c4
370 c4
371 @end lilypond
372
373 La commande @code{\override} doit être entrée @emph{avant} l'objet concerné.
374 Ainsi, lorsque l'on veut altérer un objet qui se prolonge, tel qu'une liaison,
375 une ligature ou tout autre objet dit @emph{Spanner}, la commande @code{\override}
376 doit être saisie avant que l'objet soit créé.
377
378 @lilypond[quote,fragment,verbatim,relative=2]
379 \override Slur #'thickness = #3.0
380 c8[( c
381 \override Beam #'thickness = #0.6
382 c8 c])
383 @end lilypond
384
385 @noindent
386 Dans cet exemple, la liaison (@emph{Slur}) est épaissie, mais non la ligature
387 (@emph{Beam}).  En effet, le code qui lui est relatif n'a pas été inséré avant le début de
388 la ligature, et demeure donc sans effet.
389
390 De même que la commande @code{\unset}, la commande @code{\revert} défait
391 ce qui a été fait par une commande @code{\override}.  Tout comme avec @code{\unset},
392 elle ne peut annuler que les réglages effectués dans le même contexte.
393 Ainsi dans l'exemple suivant, la commande @code{\revert} est sans effet.
394
395 @example
396 \override Voice.Stem #'thickness = #4.0
397 \revert Staff.Stem #'thickness
398 @end example
399
400 Il existe, à l'intérieur même de certaines propriétés, des options que l'on
401 nomme @q{sous-propriétés}.  La syntaxe est alors
402
403 @c leave this as a long long
404 @example
405 \override @var{contexte}.@var{objet} #'@var{propriété} #'@var{sous-propriété} = #@var{valeur}
406 @end example
407
408 @noindent
409 Ainsi, par exemple :
410
411 @example
412 \override Stem #'(details beamed-lengths) = #'(4 4 3)
413 @end example
414
415
416 @seealso
417 Référence du programme : @rinternals{OverrideProperty}, @rinternals{RevertProperty},
418 @rinternals{PropertySet}, @rinternals{Backend}, et
419 @rinternals{All layout objects}.
420
421
422 @knownissues
423
424 La sous-couche Scheme ne vérifie pas la saisie des propriétés de façon
425 très stricte.  Des références cycliques dans des valeurs Scheme peuvent
426 de ce fait interrompre, ou faire planter le programme -- ou bien les deux.
427 @end ignore
428
429 @node Modification des réglages par défaut d'un contexte
430 @subsection Modification des réglages par défaut d'un contexte
431 @translationof Changing context default settings
432
433 Les réglages montrés dans les sous-sections @ref{La commande de fixation (set)}, @ref{Modification des greffons de contexte} et
434 @ref{Retouches de mise en forme au sein des contextes} peuvent également être saisis indépendamment
435 de la musique dans le bloc @code{\layout}, au moyen de la commande @code{\context} :
436
437 @example
438 \layout @{
439   @dots{}
440   \context @{
441     \Staff
442
443     \set fontSize = #-2
444     \override Stem #'thickness = #4.0
445     \remove "Time_signature_engraver"
446   @}
447 @}
448 @end example
449
450 Le raccourci @code{\Staff} invoque les définitions inhérentes au contexte
451 @code{Staff}, de façon à ce qu'elles puissent être modifiées.
452
453 Les lignes suivantes affecteront toutes les portées (tous les contextes @code{Staff})
454 dans la partition.
455 @example
456 \set fontSize = #-2
457 \override Stem #'thickness = #4.0
458 \remove "Time_signature_engraver"
459 @end example
460
461 @noindent
462 Les autres contextes peuvent être modifiés de même manière.
463
464 La commande @code{\set}, dans le bloc @code{\layout}, est facultative ; aussi
465 les lignes suivantes produiront-elles le même effet.
466
467 @example
468 \context @{
469   @dots{}
470   fontSize = #-2
471 @}
472 @end example
473
474
475 @knownissues
476
477 Il est impossible de stocker des modifications de contexte dans un identificateur.
478
479 Le raccourci @code{\RemoveEmptyStaffContext} détruit tous les réglages
480 du contexte @code{\Staff}.  Pour modifier des propriétés de portées gouvernées
481 par @code{\RemoveEmptyStaffContext}, il faut le faire impérativement @emph{après}
482 avoir invoqué @code{\RemoveEmptyStaffContext} :
483
484 @example
485 \layout @{
486   \context @{
487     \RemoveEmptyStaffContext
488
489     \override Stem #'thickness = #4.0
490   @}
491 @}
492 @end example
493
494
495 @node Définition de nouveaux contextes
496 @subsection Définition de nouveaux contextes
497 @translationof Defining new contexts
498
499 Les contextes tels que @code{Staff} ou @code{Voice} sont faits
500 de briques de constructions empilées.  En combinant divers graveurs,
501 il est possible de créer de nouveaux types de contextes.
502
503 Dans l'exemple suivant, on construit, de zéro, un nouveau contexte très
504 semblable à @code{Voice}, mais qui n'imprime que des têtes de notes en forme
505 de barres obliques au centre de la portée.  Un tel contexte, par exemple, peut
506 servir à indiquer un passage improvisé dans un morceau de jazz.
507
508 @c KEEP LY
509 @lilypond[quote,ragged-right]
510 \layout { \context {
511   \name ImproVoice
512   \type "Engraver_group"
513   \consists "Note_heads_engraver"
514   \consists "Rhythmic_column_engraver"
515   \consists "Text_engraver"
516   \consists Pitch_squash_engraver
517   squashedPosition = #0
518   \override NoteHead #'style = #'slash
519   \override Stem #'transparent = ##t
520   \alias Voice
521 }
522 \context { \Staff
523   \accepts "ImproVoice"
524 }}
525
526 \relative c'' {
527   a4 d8 bes8 \new ImproVoice { c4^"ad lib" c
528    c4 c^"dévêtez-vous" c_"tout en jouant :)" c }
529   a1
530 }
531 @end lilypond
532
533
534 On a rassemblé les réglages dans un bloc @code{\context}, lui-même dans
535 le bloc @code{\layout} :
536
537 @example
538 \layout @{
539   \context @{
540     @dots{}
541   @}
542 @}
543 @end example
544
545 En lieu et place des points (@dots{}), voici les éléments à saisir :
546
547 @itemize @bullet
548 @item Tout d'abord, il convient de donner un nom @code{\name} à notre nouveau contexte :
549
550 @example
551 \name ImproVoice
552 @end example
553
554 @item Comme il est très semblable à @code{Voice}, nous souhaitons que toutes les
555 commandes associées au @code{Voice} déjà existant, restent valables.  D'où nécessité
556 de la commande @code{\alias}, qui va l'associer au contexte @code{Voice} :
557
558 @example
559 \alias Voice
560 @end example
561
562 @item Ce contexte doit pouvoir imprimer des notes, et des indications textuelles ;
563 on ajoute donc les graveurs appropriés.
564
565 @example
566 \consists Note_heads_engraver
567 \consists Text_engraver
568 @end example
569
570 @item Cependant, on veut que les notes s'affichent toutes au centre de la portée :
571
572 @example
573 \consists Pitch_squash_engraver
574 squashedPosition = #0
575 @end example
576
577 @noindent
578 Le graveur @rinternals{Pitch_squash_engraver} intercepte les notes créées par
579 @rinternals{Note_heads_engraver}, et les @q{écrase} pour qu'elles aient toutes la
580 même position verticale, définie par @code{squashedPosition} : ici il s'agit de la
581 valeur@tie{}@code{0}, c'est-à-dire la ligne du milieu.
582
583 @item On veut que les notes aient la forme d'une barre oblique, sans aucune hampe :
584
585 @example
586 \override NoteHead #'style = #'slash
587 \override Stem #'transparent = ##t
588 @end example
589
590 @item Afin que tous ces graveurs puissent travailler de concert, on leur adjoint un
591 sous-programme spécial, introduit par la commande @code{\type} : il s'agit de
592 @code{Engraver_group},
593
594 @example
595 \type "Engraver_group"
596 @end example
597
598 @end itemize
599
600 Récapitulons -- on se retrouve avec le bloc suivant :
601
602 @example
603 \context @{
604   \name ImproVoice
605   \type "Engraver_group"
606   \consists "Note_heads_engraver"
607   \consists "Text_engraver"
608   \consists Pitch_squash_engraver
609   squashedPosition = #0
610   \override NoteHead #'style = #'slash
611   \override Stem #'transparent = ##t
612   \alias Voice
613 @}
614 @end example
615
616 @funindex \accepts
617 Ce n'est pas tout.  En effet, on veut intégrer le nouveau contexte
618 @code{ImproVoice} dans la hiérarchie des contextes.  Tout comme le
619 contexte @code{Voice}, sa place est au sein du contexte @code{Staff}.
620 Nous allons donc modifier le contexte @code{Staff},
621 au moyen de la commande @code{\accepts} :
622
623 @example
624 \context @{
625   \Staff
626   \accepts ImproVoice
627 @}
628 @end example
629
630 @funindex \denies
631 Le contraire de @code{\accepts} est @code{\denies},
632 qui est parfois utile lorsque l'on recycle des définitions de
633 contextes déjà existantes.
634
635 Enfin, tout cela doit prendre place dans le bloc @code{\layout},
636 comme suit :
637
638 @example
639 \layout @{
640   \context @{
641     \name ImproVoice
642     @dots{}
643   @}
644   \context @{
645     \Staff
646     \accepts "ImproVoice"
647   @}
648 @}
649 @end example
650
651 On peut alors saisir la musique, comme dans l'exemple plus haut :
652
653 @example
654 \relative c'' @{
655   a4 d8 bes8
656   \new ImproVoice @{
657     c4^"ad lib" c
658     c4 c^"dévêtez-vous"
659     c c_"tout en jouant :)"
660   @}
661   a1
662 @}
663 @end example
664
665
666 @node Alignement des contextes
667 @subsection Alignement des contextes
668 @translationof Aligning contexts
669
670
671 Il est possible d'aligner verticalement chaque nouveau contexte,
672 en-dessous ou au-dessus, par exemple dans le cas de musique vocale
673 (@rlearning{Ensemble vocal}) ou d'@qq{ossias}.
674
675 @cindex ossia
676 @findex alignAboveContext
677 @findex alignBelowContext
678
679 @lilypond[quote,ragged-right]
680 ossia = { f4 f f f }
681 \score{
682   \relative c' \new Staff = "main" {
683     c4 c c c
684     <<
685       \new Staff \with { alignAboveContext = #"main" } \ossia
686       { d8 f d f d f d f }
687     >>
688   }
689 }
690 @end lilypond
691
692
693 @node En quoi consiste la référence des propriétés internes
694 @section En quoi consiste la référence des propriétés internes
695 @translationof Explaining the Internals Reference
696
697
698 @menu
699 * Navigation dans la référence du programme::
700 * Interfaces de rendu::
701 * Détermination de la propriété d'un objet graphique (grob)::
702 * Conventions de nommage::
703 @end menu
704
705 @node Navigation dans la référence du programme
706 @subsection Navigation dans la référence du programme
707 @translationof Navigating the program reference
708
709 Comment, par exemple, déplacer le doigté dans le fragment suivant ?
710
711 @lilypond[quote,fragment,relative=2,verbatim]
712 c-2
713 \stemUp
714 f
715 @end lilypond
716
717 Sur la page de la documentation relative aux doigtés, c'est-à-dire
718 @ref{Doigtés}, se trouve l'indication suivante :
719
720
721 @seealso
722 Référence du programme : @rinternals{Fingering}.
723
724
725 @c  outdated info; probably will delete.
726 @ignore
727 This fragment points to two parts of the program reference: a page
728 on @code{FingerEvent} and one on @code{Fingering}.
729
730 The page on @code{FingerEvent} describes the properties of the music
731 expression for the input @code{-2}.  The page contains many links
732 forward.  For example, it says
733
734 @quotation
735 Accepted by: @rinternals{Fingering_engraver},
736 @end quotation
737
738 @noindent
739 That link brings us to the documentation for the Engraver, the
740 plug-in, which says
741
742 @quotation
743 This engraver creates the following layout objects: @rinternals{Fingering}.
744 @end quotation
745
746 In other words, once the @code{FingerEvent}s are interpreted, the
747 @code{Fingering_engraver} plug-in will process them.
748 @end ignore
749
750 @ignore
751 @c  I can't figure out what this is supposed to mean.  -gp
752
753 The @code{Fingering_engraver} is also listed to create
754 @rinternals{Fingering} objects,
755
756 @c  old info?  it doesn't make any sense to me with our current docs.
757 This is also the
758 second bit of information listed under @b{See also} in the Notation
759 manual.
760 @end ignore
761
762 @ifnothtml
763 Ladite référence est disponible au format HTML, ce qui rend la navigation bien
764 plus aisée.  Il est possible soit de la lire en ligne, soit de la télécharger
765 dans ce format.  La démarche présentée ici sera plus difficle à comprendre
766 dans un document au format PDF.
767 @end ifnothtml
768
769 Suivons le lien @rinternals{Fingering}.  En haut de la nouvelle page,
770 on peut lire
771
772 @quotation
773 Fingering objects are created by: @rinternals{Fingering_engraver} and
774 @rinternals{New_fingering_engraver}.
775 @end quotation
776
777 En d'autres termes, @emph{Les indications de doigtés}
778 (@code{Fingering} en anglais) @emph{sont créées par les graveurs
779 @rinternals{Fingering_engraver} et @rinternals{New_fingering_engraver}.}
780
781 En suivant derechef les liens propres à la référence du programme, on suit en fait
782 le cheminement qui aboutit à la création de la partition :
783
784 @itemize @bullet
785
786 @item @rinternals{Fingering}:
787 @rinternals{Fingering} objects are created by:
788 @rinternals{Fingering_engraver}
789
790 @item @rinternals{Fingering_engraver}:
791 Music types accepted: @rinternals{fingering-event}
792
793 @item @rinternals{fingering-event}:
794 Music event type @code{fingering-event} is in Music expressions named
795 @rinternals{FingeringEvent}
796 @end itemize
797
798 Ce cheminement se produit, bien sûr, en sens inverse : nous sommes ici partis
799 du résultat, et avons abouti aux évènements (en anglais @q{Events}) engendrés
800 par le fichier d'entrée.  L'inverse est également possible : on peut partir d'un
801 évènement, et suivre le cheminement de LilyPond qui aboutit à la création d'un
802 ou plusieurs objets graphiques.
803
804 La référence du programme peut également se parcourir comme un document normal.
805 On y trouve des chapitres tels que
806 @ifhtml
807 @rinternals{Music definitions},
808 @end ifhtml
809 @ifnothtml
810 @code{Music definitions}
811 @end ifnothtml
812 @rinternals{Translation}, ou encore @rinternals{Backend}.  Chaque chapitre
813 recense toutes les définitions employées, et les propriétés sujettes à
814 ajustements.
815
816 @c -- what about adding a link to the glossary here ? -vv
817 @ignore
818 La Référence du programme n'est pas traduite en français -- notamment du fait
819 qu'elle est en évolution constante, tout comme LilyPond.  En revanche, les termes
820 musicaux font l'objet d'un @commentfairelelien{glossaire} fort utile pour les utilisateurs
821 francophones.
822 @end ignore
823
824
825 @node Interfaces de rendu
826 @subsection Interfaces de rendu
827 @translationof Layout interfaces
828
829 @cindex interfaces de rendu
830 @cindex rendu, interfaces de
831 @cindex objets graphiques
832
833 Tous les éléments de notation sont considérés comme des objets graphiques
834 (en anglais @q{Graphical Object}, d'où le diminutif @emph{Grob}).
835 Chaque objet est doté d'un certain nombre de propriétés (l'épaisseur du trait,
836 l'orientation, etc.), et lié à d'autres objets.
837 Le fonctionnement de ces objets est décrit en détail dans @rinternals{grob-interface}.
838
839 Prenons l'exemple des doigtés (en anglais @q{Fingering}).
840 La page @code{Fingering} de la Référence du programme établit une liste de définitions
841 propres à ce type d'objets :
842
843 @quotation
844 @code{padding} (dimension, in staff space):
845
846 @code{0.5}
847 @end quotation
848
849 @noindent
850 Ce qui signifie que les doigtés doivent être maintenus à une certaine distance (@emph{padding})
851 des notes : 0,5 unités @emph{staff-space} (espace de portée).
852
853
854 Chaque objet peut avoir plusieurs attributs, en tant qu'élément typographique
855 ou musical.  Ainsi, un doigté (objet @q{Fingering}) possède les attributs suivants :
856
857
858 @itemize @bullet
859 @item
860 Sa taille ne dépend pas de l'espacement horizontal, contrairement aux liaisons ou ligatures.
861
862 @item
863 C'est du texte -- un texte vraiment court, certes.
864
865 @item
866 Ce texte est imprimé au moyen d'une fonte, contrairement aux liaisons ou ligatures.
867
868 @item
869 Sur l'axe horizontal, le centre de ce symbole doit être aligné avec le centre de la note.
870
871 @item
872 Sur l'axe vertical, le symbole doit être proche de la note et de la portée.
873
874 @item
875 Sur l'axe vertical encore, il doit également s'ordonner avec les éventuels
876 autres symboles, ponctuations, ou éléments textuels.
877 @end itemize
878
879 Faire appliquer ces différents attributs est le rôle des @emph{interfaces},
880 que l'on trouve en bas de la page @rinternals{Fingering}.
881
882 @quotation
883 This object supports the following interfaces:
884 @rinternals{item-interface},
885 @rinternals{self-alignment-interface},
886 @rinternals{side-position-interface}, @rinternals{text-interface},
887 @rinternals{text-script-interface}, @rinternals{font-interface},
888 @rinternals{finger-interface}, and @rinternals{grob-interface}.
889 @end quotation
890
891 @noindent
892 En français,
893
894 @quotation
895 Cet objet admet les interfaces suivantes :
896 @end quotation
897
898 Suit la liste des interfaces en question, présentées comme autant de liens,
899 qui conduisent sur les pages dédiées à chacune d'entre elles.
900 Chaque interface est dotée d'un certain nombre de propriétés, dont certaines
901 peuvent être modifiées, et d'autres non (les @q{Internal properties}, ou
902 propriétés internes).
903
904 Pour aller encore plus loin, plutôt que de simplement parler de l'objet
905 @code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
906 son âme même, dans les fichiers source de LilyPond (voir
907 @rlearning{Autres sources de documentation}), en l'occurence le fichier
908 @file{scm/@/define@/-grobs@/.scm} :
909
910 @example
911 (Fingering
912   . ((padding . 0.5)
913      (avoid-slur . around)
914      (slur-padding . 0.2)
915      (staff-padding . 0.5)
916      (self-alignment-X . 0)
917      (self-alignment-Y . 0)
918      (script-priority . 100)
919      (stencil . ,ly:text-interface::print)
920      (direction . ,ly:script-interface::calc-direction)
921      (font-encoding . fetaNumber)
922      (font-size . -5)           ; don't overlap when next to heads.
923      (meta . ((class . Item)
924      (interfaces . (finger-interface
925                     font-interface
926                     text-script-interface
927                     text-interface
928                     side-position-interface
929                     self-alignment-interface
930                     item-interface))))))
931 @end example
932
933 @noindent
934 @dots{}où l'on découvre que l'objet @code{Fingering} n'est rien de plus qu'un
935 amas de variables et de réglages.  La page de la Référence du programme est
936 en fait directement engendrée par cette définition.
937
938
939 @node Détermination de la propriété d'un objet graphique (grob)
940 @subsection Détermination de la propriété d'un objet graphique (grob)
941 @translationof Determining the grob property
942
943
944 Nous voulions changer la position du chiffre @b{2} dans le fragment suivant :
945
946 @lilypond[quote,fragment,relative=2,verbatim]
947 c-2
948 \stemUp
949 f
950 @end lilypond
951
952 Dans la mesure où le @b{2} est placé, verticalement, à proximité de la note qui lui
953 correspond, nous allons devoir trouver l'interface en charge de ce placement, qui se
954 trouve être @code{side-position-interface}.  Sur la page de cette interface, on
955 peut lire :
956
957 @quotation
958 @code{side-position-interface}
959
960 Position a victim object (this one) next to other objects (the
961 support).  The property @code{direction} signifies where to put the
962 victim object relative to the support (left or right, up or down?)
963 @end quotation
964
965 @noindent
966 Ce qui signifie
967 @quotation
968 @code{side-position-interface}
969
970 Placer l'objet affecté à proximité d'autres objets.  La propriété
971 @code{direction} indique où placer l'objet (à droite ou à gauche,
972 en haut ou en bas).
973 @end quotation
974
975 @cindex padding
976 @noindent
977 En-dessous de cette description se trouve décrite la variable @code{padding} :
978
979 @quotation
980 @table @code
981 @item padding
982 (dimension, in staff space)
983
984 Add this much extra space between objects that are next to each other.
985 @end table
986 @end quotation
987
988 @noindent
989 Ce qui signifie
990 @quotation
991 Ajouter tel espace supplémentaire entre des objets proches les uns des
992 autres.
993 @end quotation
994
995 @noindent
996 En augmentant la valeur de @code{padding}, on peut donc éloigner le doigté de la
997 note.  La commande suivante insère trois unités d'espace vide entre la note et le doigté :
998
999 @example
1000 \once \override Voice.Fingering #'padding = #3
1001 @end example
1002
1003 En ajoutant cette commande avant la création du doigté (de l'objet @q{Fingering}),
1004 donc avant @code{c2}, on obtient le résultat suivant :
1005
1006 @lilypond[quote,relative=2,fragment,verbatim]
1007 \once \override Voice.Fingering #'padding = #3
1008 c-2
1009 \stemUp
1010 f
1011 @end lilypond
1012
1013
1014 Dans le cas présent, le réglage intervient dans le contexte @code{Voice},
1015 ce qui pouvait également se déduire de la Référence du programme, où la page
1016 du graveur @rinternals{Fingering_engraver} indique :
1017
1018 @quotation
1019 Fingering_engraver is part of contexts: @dots{} @rinternals{Voice}
1020 @end quotation
1021
1022 @noindent
1023 Ce qui signifie
1024 @quotation
1025 Le graveur Fingering_engraver fait partie des contextes : @dots{} @rinternals{Voice}
1026 @end quotation
1027
1028
1029 @node Conventions de nommage
1030 @subsection Conventions de nommage
1031 @translationof Naming conventions
1032
1033 @untranslated
1034
1035
1036 @node Modification de propriétés
1037 @section Modification de propriétés
1038 @translationof Modifying properties
1039
1040 @c TODO change the menu and subsection node names to use
1041 @c backslash once the new macro to handle the refs
1042 @c is available.  Need to find and change all refs at
1043 @c the same time. -td
1044
1045 @menu
1046 * Vue d'ensemble de la modification des propriétés::
1047 * La commande de fixation (set)::
1048 * La commande de dérogation (@emph{override})::
1049 * Élaboration d'une retouche::
1050 * La commande d'affinage (@emph{tweak})::
1051 * set ou override::
1052 @end menu
1053
1054 @node Vue d'ensemble de la modification des propriétés
1055 @subsection Vue d'ensemble de la modification des propriétés
1056 @translationof Overview of modifying properties
1057
1058 @untranslated
1059
1060
1061 @node La commande de fixation (set)
1062 @subsection La commande @code{\set}
1063 @translationof The set command
1064
1065 @cindex propriétés
1066 @funindex \set
1067 @cindex modifier des propriétés
1068
1069 Chaque contexte peut avoir plusieurs @emph{propriétés}, c'est-à-dire
1070 des variables qu'il inclut.  Ces dernières peuvent être modifiées @qq{à la volée},
1071 c'est-à-dire pendant que la compilation s'accomplit.  C'est là le rôle de la
1072 commande @code{\set}.
1073
1074 @example
1075 \set @var{contexte}.@var{propriété} = #@var{valeur}
1076 @end example
1077
1078 Ainsi :
1079 @lilypond[quote,verbatim,relative=2,fragment]
1080 R1*2
1081 \set Score.skipBars = ##t
1082 R1*2
1083 @end lilypond
1084
1085 Cette commande permet de condenser les mesures vides de notes, en des silences
1086 multi-mesures.  Il s'agit d'un objet Scheme, auquel on attribue la valeur booléenne
1087 @q{vrai}, c'est-à-dire la lettre @code{#t} pour @q{True} en anglais.
1088
1089 Ce changement étant appliqué @q{à la volée}, il n'affecte que le second groupe de notes.
1090
1091 Si l'argument @var{contexte} n'est pas spécifié, alors la propriété cherchera à s'appliquer
1092 dans le contexte le plus restreint où elle est employée : le plus souvent
1093  @code{ChordNames}, @code{Voice}, ou @code{Lyrics}.  Dans l'exemple suivant,
1094
1095 @lilypond[quote,verbatim,relative=2,fragment]
1096 c8 c c c
1097 \set autoBeaming = ##f
1098 c8 c c c
1099 @end lilypond
1100
1101 @noindent
1102 aucun argument @var{contexte} n'a été donné à la commande @code{\set}.
1103 De ce fait, les ligatures automatiques sont désactivées dans le
1104 contexte actuel, c'est-à-dire @rinternals{Voice}.  Notez que le
1105 contexte le plus restreint n'est pas toujours le bon,
1106 et peut ne pas contenir la propriété qui vous intéresse : ainsi, la propriété
1107 @code{skipBars}, évoquée plus haut, ne relève pas du contexte @code{Voice},
1108 et le code suivant ne fonctionnera pas.
1109
1110 @lilypond[quote,verbatim,relative=2,fragment]
1111 R1*2
1112 \set skipBars = ##t
1113 R1*2
1114 @end lilypond
1115
1116 Les contextes s'organisent de façon hiérarchique : aussi, lorsqu'un contexte de niveau
1117 supérieur est spécifié (par exemple @code{Staff}), la propriété sera modifée dans
1118 tous les contextes inférieurs (tous les contextes @code{Voice}, par exemple)
1119 qu'il contient.
1120
1121 @funindex \unset
1122
1123 La commande @code{\unset} permet d'annuler la définition d'une propriété :
1124
1125 @example
1126 \unset @var{contexte}.@var{propriété}
1127 @end example
1128
1129 @noindent
1130 si et seulement si cette propriété à été définie dans ce @var{contexte}
1131 précis ; ainsi,
1132
1133 @example
1134 \set Staff.autoBeaming = ##f
1135 @end example
1136
1137 @noindent
1138 même s'il s'applique à tous les contextes @code{Voice} contenus dans le
1139 contexte @code{Staff}, ne peut être annulé au niveau @code{Voice}.  Le code
1140 suivant sera sans effet.
1141
1142 @example
1143 \unset Voice.autoBeaming
1144 @end example
1145
1146 @noindent
1147 En d'autres termes, la commande @code{\unset} doit impérativement être
1148 accompagnée du même contexte que la commande @code{\set} d'origine.
1149 Pour annuler l'effet, dans notre exemple, de @code{Staff.autoBeaming = ##f},
1150 il faut donc entrer :
1151 @example
1152 \unset Staff.autoBeaming
1153 @end example
1154
1155 Si l'on se trouve dans le contexte le plus restreint, il n'est pas obligatoire,
1156 là encore, de spécifier le @var{contexte}.  Ainsi, les deux lignes suivantes sont équivalentes.
1157
1158
1159 @example
1160 \set Voice.autoBeaming = ##t
1161 \set autoBeaming = ##t
1162 @end example
1163
1164
1165 @cindex \once
1166 Pour modifier une propriété de façon à ce qu'elle ne s'applique qu'une seule fois,
1167 il convient d'employer la commande @code{\once} :
1168
1169 @lilypond[quote,verbatim,relative=2,fragment]
1170 c4
1171 \once \set fontSize = #4.7
1172 c4
1173 c4
1174 @end lilypond
1175
1176 Ici le changement de taille est annulé aussitôt après la note concernée.
1177
1178 La référence du programme contient une description exhaustive de toutes les
1179 propriétés contexte par contexte : voir
1180 @ifhtml
1181 @rinternals{Tunable context properties}.
1182 @end ifhtml
1183 @ifnothtml
1184 Translation @expansion{} Tunable context properties.
1185 @end ifnothtml
1186
1187
1188 @node La commande de dérogation (@emph{override})
1189 @subsection La commande @code{\override}
1190 @translationof The override command
1191
1192
1193 La commande @code{\override} permet de modifier la mise en page
1194 en détail.  Examinons son utilisation concrètementet dans les détails.
1195 La syntaxe de cette commande ressemble généralement à :
1196
1197 @example
1198 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
1199 @end example
1200
1201 La propriété @var{propriété} de l'objet @var{objet}, appartenant au contexte
1202 @var{contexte}, se voit ainsi attribuer la valeur @var{valeur}.
1203
1204
1205 @c deprecated node. Delete. --fv
1206 @node Élaboration d'une retouche
1207 @subsection Élaboration d'une retouche
1208 @translationof Constructing a tweak
1209
1210 Les commandes permettant de modifier l'apparence de la partition
1211 ressemblent en général à
1212
1213 @example
1214 \override Voice.Stem #'thickness = #3.0
1215 @end example
1216
1217 @noindent
1218 Pour élaborer un réglage de ce type, on a besoin de connaître précisément :
1219
1220 @itemize
1221 @item le contexte : ici @code{Voice} (la voix).
1222 @item l'objet à affecter : ici @code{Stem} (les hampes).
1223 @item la propriété à modifier : ici @code{thickness} (l'épaisseur du trait).
1224 @item la valeur désirée : ici @code{3.0} (par défaut, elle est de 1.3).
1225 @end itemize
1226
1227 Certaines @q{sous-propriétés} sont parfois contenues dans une propriété.
1228 La commande devient alors :
1229
1230 @example
1231 \override Stem #'(details beamed-lengths) = #'(4 4 3)
1232 @end example
1233
1234 @cindex documentation exhaustive
1235 @cindex trouver des objets graphiques
1236 @cindex objets graphiques, description
1237 @cindex régler
1238 @funindex \override
1239
1240 Pour bien des propriétés, quel que soit le type de valeur requise,
1241 attribuer la valeur @q{faux} (@code{##f} en Scheme) reviendra à désactiver
1242 complètement l'action de la propriété qui se trouve ainsi purement
1243 ignorée par LilyPond.  Cela peut s'avérer fort utile pour des propriétés
1244 causant des désagréments.
1245
1246 @c such announcements are to be avoided -vv
1247 @ignore
1248 We demonstrate how to glean this information from the notation manual
1249 and the program reference.
1250 @end ignore
1251
1252
1253 @node La commande d'affinage (@emph{tweak})
1254 @subsection La commande @code{\tweak}
1255 @translationof The tweak command
1256
1257
1258 @funindex \tweak
1259
1260 Dans certains cas, on peut passer par un raccourci pour arranger les
1261 objets graphiques.  Lorsqu'un objet est directement engendré par un élément distinct
1262 du fichier source, on peut utiliser la commande @code{\tweak}.
1263
1264 Dans l'accord suivant, les notes sont modifiées une par une :
1265
1266 @lilypond[relative=2,fragment,verbatim,ragged-right]
1267 <
1268   c
1269   \tweak #'color #red d
1270   g
1271   \tweak #'duration-log #1  a
1272 >4-\tweak #'padding #10 -.
1273 @end lilypond
1274
1275 Comme on peut le voir, les propriétés sont ici modifiées directement
1276 en même temps que les objets sont saisis.  Il n'est plus besoin de spécifier ni
1277 le nom de l'objet (@emph{grob}), ni le contexte dans lequel cela doit s'appliquer.
1278
1279 Ce procédé ne marche que pour des objets directement liés aux évènements
1280 (@rinternals{Event}) du fichier source.  Par exemple :
1281
1282 @itemize @bullet
1283 @item Les têtes de notes au sein d'un accord, qui sont directement engendrées par
1284 les hauteurs indiquées
1285 @item Les signes d'articulation, engendrés par les indications de ponctuation.
1286 @end itemize
1287
1288 En revanche, les hampes ou les altérations sont engendrées par les têtes de notes,
1289 et non par des évènements dans le fichier source.  De même pour les clés, qui ne
1290 sont pas directement engendrées par le fichier source, mais plutôt par le
1291 changement d'une propriété interne.
1292
1293 En fait, très peu d'objets passent @emph{directement} du code source à la partition.
1294 Une note toute simple, par exemple @code{c4}, fait l'objet d'un traitement et n'est donc
1295 pas directement rendue ; c'est pourquoi le code suivant ne sera d'aucun effet :
1296
1297 @example
1298 \tweak #'color #red c4
1299 @end example
1300
1301 @noindent
1302 Voir pour plus de détails @ref{Affichage d'expressions musicales}.
1303
1304
1305 @node set ou override
1306 @subsection @code{\set} ou @code{\override}
1307 @translationof set versus override
1308
1309
1310 Si les propriétés peuvent être modifiées de deux façons, par les commandes
1311 @code{\set} et @code{\override}, c'est qu'il y a deux types de propriétés.
1312
1313 Les contextes peuvent avoir des propriétés, dont les noms commencent par une
1314 minuscule puis comprennent une ou plusieurs majuscules (de style
1315 @code{totoTutu}).  Elles ont surtout trait
1316 à la notation des éléments musicaux : par exemple, @code{localKeySignature} permet
1317 de choisir s'il faut ou non imprimer une altération, ou @code{measurePosition} permet
1318 de choisir quand il faut imprimer une barre de mesure.  Ces propriétés de contextes
1319 sont appelées à changer au long de l'interprétation de la partition :
1320 @code{measurePosition} en est un exemple évident.  Ces propriétés doivent
1321 être modifiées avec la commande @code{\set}.
1322
1323 Il existe un type particulier de propriétés : les descriptions
1324 d'éléments.  Ces propriétés, dont les noms commencent par une majuscule, puis comprennent
1325 une ou plusieurs majuscules (de style @code{TotoTata}), contiennent les réglages
1326 @q{par défaut} pour les objets graphiques.  Ces réglages sont sous forme de liste Scheme ; on
1327 peut les consulter dans le fichier @file{scm/@/define@/-grobs@/.scm}.
1328 Les descriptions d'éléments doivent être modifiées avec la commande @code{\override}.
1329
1330 @code{\override} est en fait un raccourci :
1331
1332 @example
1333 \override @var{contexte}.@var{objet} #'@var{propriété} = #@var{valeur}
1334 @end example
1335
1336 @noindent
1337 est plus ou moins l'équivalent de
1338
1339 @c  leave this long line -gp
1340 @example
1341 \set @var{contexte}.@var{objet} #'@var{propriété} = #(cons (cons '@var{propriété} @var{valeur}) <valeur précédente de @var{contexte})
1342 @end example
1343
1344 La valeur de @code{context} (la liste Scheme, ou @q{alist}) sert à initialiser
1345 les propriétés des objets un par un.  Les objets eux-même ont leurs propriétés,
1346 dont les noms, dans la tradition du langage Scheme, comprennent un trait d'union
1347 (@code{toto-titi}).  Ces propriétés internes changent constamment au cours de la mise
1348 en page : en fait, la gravure d'une page n'est autre que le calcul de toutes
1349 ces propriétés, au moyen de fonctions de rappel.
1350
1351 La propriété @code{fontSize} est une exception : c'est un raccourci, qui équivaudrait
1352 à saisir @code{\override @dots{} #'font-size} pour tous les objets
1353 textuels.  Dans la mesure où il s'agit d'une manipulation très
1354 courante, une propriété spéciale a été créée.  Elle doit
1355 être modifiée avec la commande @code{\set}.
1356
1357
1358
1359 @node Propriétés et contextes utiles
1360 @section Propriétés et contextes utiles
1361 @translationof Useful concepts and properties
1362
1363
1364 @menu
1365 * Modes de saisie::
1366 * Direction et positionnement::
1367 * Distances et unités de mesure::
1368 * Propriétés des lignes de portée::
1369 * Extenseurs et prolongateurs::
1370 * Visibilité des objets::
1371 * Styles de ligne::
1372 * Rotation des objets::
1373 @end menu
1374
1375 @node Modes de saisie
1376 @subsection Modes de saisie
1377 @translationof Input modes
1378
1379 @untranslated
1380
1381
1382 @node Direction et positionnement
1383 @subsection Direction et positionnement
1384 @translationof Direction and placement
1385
1386 @untranslated
1387
1388
1389 @node Distances et unités de mesure
1390 @subsection Distances et unités de mesure
1391 @translationof Distances and measurements
1392
1393 @untranslated
1394
1395
1396 @node Propriétés des lignes de portée
1397 @subsection Propriétés des lignes de portée
1398 @translationof Staff symbol properties
1399
1400 @untranslated
1401
1402
1403 @node Extenseurs et prolongateurs
1404 @subsection Extenseurs et prolongateurs
1405 @translationof Spanners
1406
1407 @untranslated
1408
1409
1410 @unnumberedsubsubsec Utilisation de @code{spanner-interface}
1411 @unnumberedsubsubsec Utilisation de @code{line-spanner-interface}
1412 @node Visibilité des objets
1413 @subsection Visibilité des objets
1414 @translationof Visibility of objects
1415
1416 @untranslated
1417
1418
1419 @menu
1420 * Suppression des stencils::
1421 * Transparence des objets::
1422 * Blanchiment des objets::
1423 * Utilisation de break-visibility::
1424 * Considérations spécifiques::
1425 @end menu
1426
1427 @node Suppression des stencils
1428 @unnumberedsubsubsec Suppression des stencils
1429 @translationof Removing the stencil
1430
1431 @untranslated
1432
1433
1434 @node Transparence des objets
1435 @unnumberedsubsubsec Transparence des objets
1436 @translationof Making objects transparent
1437
1438 @untranslated
1439
1440
1441 @node Blanchiment des objets
1442 @unnumberedsubsubsec Blanchiment des objets
1443 @translationof Painting objects white
1444
1445 @untranslated
1446
1447
1448 @node Utilisation de break-visibility
1449 @unnumberedsubsubsec Utilisation de break-visibility
1450 @translationof Using break-visibility
1451
1452 @untranslated
1453
1454
1455 @node Considérations spécifiques
1456 @unnumberedsubsubsec Considérations spécifiques
1457 @translationof Special considerations
1458
1459 @untranslated
1460
1461
1462 @node Styles de ligne
1463 @subsection Styles de ligne
1464 @translationof Line styles
1465
1466 @untranslated
1467
1468
1469 @node Rotation des objets
1470 @subsection Rotation des objets
1471 @translationof Rotating objects
1472
1473 @untranslated
1474
1475
1476 @menu
1477 * Rotation des objets de mise en forme::
1478 * Rotation des étiquettes::
1479 @end menu
1480
1481 @node Rotation des objets de mise en forme
1482 @unnumberedsubsubsec Rotation des objets de mise en forme
1483 @translationof Rotating layout objects
1484
1485 @untranslated
1486
1487
1488 @node Rotation des étiquettes
1489 @unnumberedsubsubsec Rotation des étiquettes
1490 @translationof Rotating markup
1491
1492 @untranslated
1493
1494
1495 @node Retouches avancées
1496 @section Retouches avancées
1497 @translationof Advanced tweaks
1498
1499 @untranslated
1500
1501
1502 @menu
1503 * Alignement des objets::
1504 * Regroupement vertical d'objets graphiques::
1505 * Modification des stencils::
1506 * Modification de l'allure des éléments::
1507 @end menu
1508
1509 @node Alignement des objets
1510 @subsection Alignement des objets
1511 @translationof Aligning objects
1512
1513 @untranslated
1514
1515
1516 @menu
1517 * Détermination directe de @code{X-offset} et @code{Y-offset}::
1518 * Utilisation de @code{side-position-interface}::
1519 * Utilisation de @code{self-alignment-interface}::
1520 * Utilisation de @code{break-aligned-interface}::
1521 @end menu
1522
1523 @node Détermination directe de @code{X-offset} et @code{Y-offset}
1524 @unnumberedsubsubsec Détermination directe de @code{X-offset} et @code{Y-offset}
1525 @translationof Setting @code{X-offset} and @code{Y-offset} directly
1526
1527 @untranslated
1528
1529
1530 @node Utilisation de @code{side-position-interface}
1531 @unnumberedsubsubsec Utilisation de @code{side-position-interface}
1532 @translationof Using the @code{side-position-interface}
1533
1534 @untranslated
1535
1536
1537 @node Utilisation de @code{self-alignment-interface}
1538 @unnumberedsubsubsec Utilisation de @code{self-alignment-interface}
1539 @translationof Using the @code{self-alignment-interface}
1540
1541 @untranslated
1542
1543
1544 @unnumberedsubsubsec Utilisation des procédures @code{aligned-on-parent}
1545 @unnumberedsubsubsec Utilisation des procédures @code{centered-on-parent}
1546 @node Utilisation de @code{break-aligned-interface}
1547 @unnumberedsubsubsec Utilisation de @code{break-aligned-interface}
1548 @translationof Using the @code{break-alignable-interface}
1549
1550 @untranslated
1551
1552
1553 @node Regroupement vertical d'objets graphiques
1554 @subsection Regroupement vertical d'objets graphiques
1555 @translationof Vertical grouping of grobs
1556
1557 Les objets @code{VerticalAlignment} et @code{VerticalAxisGroup}
1558 travaillent de concert.  Comme leurs noms anglais l'indiquent,
1559 @code{VerticalAxisGroup} regroupe différents objets tels que les portées
1560 (@code{Staff}), les paroles (@code{Lyrics}) et ainsi de suite ; puis
1561 @code{VerticalAlignment} synchronise verticalement ces différents groupes.
1562 En général, il n'y a qu'un seul @code{VerticalAlignment} pour l'ensemble
1563 de la partition, mais chaque contexte @code{Staff}, @code{Lyrics}, etc.
1564 possède son propre @code{VerticalAxisGroup}.
1565
1566
1567 @node Modification des stencils
1568 @subsection Modification des stencils
1569 @translationof Modifying stencils
1570
1571 @untranslated
1572
1573
1574 @node Modification de l'allure des éléments
1575 @subsection Modification de l'allure des éléments
1576 @translationof Modifying shapes
1577
1578 @menu
1579 * Modification des liaisons::
1580 @end menu
1581
1582 @node Modification des liaisons
1583 @unnumberedsubsubsec Modification des liaisons
1584 @translationof Modifying ties and slurs
1585
1586 @untranslated
1587