Documentation/fr/user/educational.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: f7420240e4ce1fe2217646482a47d00f566af52c
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @node Educational use
  10 @section Educational use
  11
  12 @menu
  13 * Note heads::
  14 * Inside the staff::
  15 * Outside the staff::
  16 @end menu
  17
  18
  19 @node Note heads
  20 @subsection Note heads
  21
  22 @menu
  23 * Easy notation note heads::
  24 * Shape note heads::
  25 * Improvisation::
  26 * Special noteheads::
  27 @end menu
  28
  29 @node Easy Notation note heads
  30 @unnumberedsubsubsec Easy Notation note heads
  31
  32 @cindex tête de note, apprentissage
  33 @cindex notation facile
  34 @cindex Hal Leonard
  35
  36 Les notes @q{easy play} comportent le nom de la note à l'intérieur de
  37 la tête.  On l'utilise dans des partitions pour débutants.
  38
  39 @lilypond[quote,ragged-right,verbatim,fragment,staffsize=26]
  40   \easyHeadsOn
  41   c'2 e'4 f' | g'1
  42 @end lilypond
  43
  44 La commande @code{\easyHeadsOn} remplace tous les réglages de l'objet
  45 @internalsref{NoteHead}.  L'impression doit être de plus grande
  46 taille, afin que les lettres soient lisibles.  Voir à ce propos
  47 @ref{Setting the staff size}.
  48
  49 @refcommands
  50
  51 @funindex \easyHeadsOn
  52 @code{\easyHeadsOn}
  53
  54
  55 @node Shape note heads
  56 @unnumberedsubsubsec Shape note heads
  57
  58 @cindex tête de note, allure
  59
  60 En notation profilée, le profil d'une tête de note correspond à la
  61 fonction harmonique de cette note dans la gamme.  Ce style de notation
  62 était très en vogue dans les recueils de chansons américains du XIXe
  63 siècle.
  64
  65 Des notes profilées sont produites après activation de
  66 @code{\aikenHeads} ou @code{\sacredHarpHeads}, selon le style.
  67
  68 @lilypond[verbatim,relative=1,fragment]
  69   \aikenHeads
  70   c8 d4 e8 a2 g1
  71   \sacredHarpHeads
  72   c8 d4. e8 a2 g1
  73 @end lilypond
  74
  75 Les profils sont déterminés par la hauteur dans la gamme, le premier
  76 degré étant défini par la commande @code{\key}.
  77
  78 @funindex \key
  79 @funindex shapeNoteStyles
  80 @funindex \aikenHeads
  81 @funindex \sacredHarpHeads
  82
  83 Les notes profilées sont mises en œuvre par la propriété
  84 @code{shapeNoteStyles}, dont les valeurs sont constituées d'une liste
  85 de symboles.  Le n-ième élément indique le style à utiliser pour le
  86 n-ième degré de la gamme.  Toutes les combinaisons sont possibles :
  87
  88 @lilypond[verbatim,relative=1,fragment]
  89   \set shapeNoteStyles  = ##(cross triangle fa #f mensural xcircle diamond)
  90   c8 d4. e8 a2 g1
  91 @end lilypond
  92
  93
  94 @node Improvisation
  95 @unnumberedsubsubsec Improvisation
  96
  97 L'improvisation peut quelquefois s'indiquer à l'aide de notes de forme
  98 allongée (@emph{slash}).  Ces têtes de notes sont créées  par
  99 l'adjonction du graveur @internalsref{Pitch_squash_engraver} au
 100 contexte @internalsref{Voice}, de telle sorte que la commande
 101
 102 @example
 103 \set squashedPosition = #0
 104 \override NoteHead #'style = #'slash
 105 @end example
 106
 107 @noindent
 108 active les notes penchées.
 109
 110 Vous disposez des raccourcis @code{\improvisationOn} et son corollaire
 111 @code{\improvisationOff} pour cette séquence, comme l'illustre
 112 l'exemple ci dessous.
 113
 114 @lilypond[verbatim,ragged-right,quote]
 115 \new Voice \with {
 116   \consists Pitch_squash_engraver
 117 } \transpose c c' {
 118   e8 e g a a16(bes)(a8) g \improvisationOn
 119   e8
 120   ~e2~e8 f4 fis8
 121   ~fis2 \improvisationOff a16(bes) a8 g e
 122 }
 123 @end lilypond
 124
 125
 126 @node Special noteheads
 127 @unnumberedsubsubsec Special noteheads
 128
 129 @cindex têtes de note, spéciales
 130
 131 Certains instruments utilisent des têtes de note différentes à des
 132 fins spécifiques --- des croix pour le @q{parlato} des chanteurs ou les
 133 notes étouffées des guitares ; des losanges pour les harmoniques des
 134 cordes.  Il existe un raccourci (@code{\harmonic}) pour les notes en
 135 losange ; pour les autres styles de tête, il vous faudra jouer avec la
 136 propriété @code{NoteHead}.
 137
 138 @lilypond[ragged-right,relative=1,fragment,verbatim,quote]
 139 c4 d
 140 \override NoteHead #'style = #'cross
 141 e f
 142 \revert NoteHead #'style
 143 e d <c f\harmonic> <d a'\harmonic>
 144 @end lilypond
 145
 146 @noindent
 147 Pour une liste exhaustive des styles de tête de note, consultez
 148 @ref{Note head styles}.
 149
 150
 151 @seealso
 152
 153 Référence du programme : @internalsref{NoteHead}.
 154
 155
 156 @node Inside the staff
 157 @subsection Inside the staff
 158
 159
 160 @menu
 161 * Selecting notation font size::
 162 * Fingering instructions::
 163 * Hidden notes::
 164 * Coloring objects::
 165 * Parentheses::
 166 * Ambitus::
 167 * Stems::
 168 @end menu
 169
 170 @node Selecting notation font size
 171 @unnumberedsubsubsec Selecting notation font size
 172
 173 Le plus sûr moyen de régler la taille de la police, quelque soit le
 174 contexte, consiste à définir la propriété @code{fontSize}.
 175
 176 @lilypond[quote,fragment,relative=1,verbatim]
 177 c8
 178 \set fontSize = #-4
 179 c f
 180 \set fontSize = #3
 181 g
 182 @end lilypond
 183
 184 @noindent
 185 Ceci ne modifiera en rien la taille des différents symboles tels que
 186 ligatures ou liaisons.
 187
 188 En interne, la propriété @code{fontSize} d'un contexte aura pour effet
 189 de définir la propriété @code{font-size} pour tous les objets de
 190 rendu.  La valeur de @code{font-size} est un entier représentant la
 191 taille proportionnellement à la hauteur standard de la portée en
 192 cours.  Chaque incrément correspond à une augmentation d'environ
 193 12@tie{}% de la taille de la police. Un pas de six aboutit exactement
 194 au doublement de la taille.  La fonction Scheme @code{magstep}
 195 convertit le nombre affecté à @code{font-size} en facteur d'échelle.
 196 Vous pouvez aussi définir directement la propriété @code{font-size} de
 197 manière à n'affecter seulement que certains objets de rendu.
 198
 199 @lilypond[quote,fragment,relative=1,verbatim]
 200 c8
 201 \override NoteHead #'font-size = #-4
 202 c f
 203 \override NoteHead #'font-size = #3
 204 g
 205 @end lilypond
 206
 207 Pour changer la taille des symboles musicaux (police Feta), LilyPond met
 208 à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
 209 cf. @ref{Setting the staff size}.  La taille standard, pour laquelle
 210 @code{font-size} vaut 0, dépend de la hauteur de la portée.  À une
 211 portée de 20 points correspond une police de 10 points.
 212
 213 La propriété @code{font-size} ne peut intervenir que pour les objets
 214 qui utilisent des polices, autrement dit ceux qui disposent de
 215 l'interface de rendu @internalsref{font-interface}.
 216
 217 @refcommands
 218
 219 Les commandes suivantes définissent @code{fontSize} pour la voix en
 220 cours :
 221
 222 @funindex \tiny
 223 @code{\tiny},
 224 @funindex \small
 225 @code{\small},
 226 @funindex \normalsize
 227 @code{\normalsize}.
 228
 229
 230
 231 @node Fingering instructions
 232 @unnumberedsubsubsec Fingering instructions
 233
 234 @cindex doigté
 235 @cindex substitution de doigt
 236
 237
 238 Les doigtés peuvent être indiqués comme suit :
 239 @example
 240 @var{note}-@var{chiffre_du_doigt}
 241 @end example
 242 Pour les substitutions de doigts, on a recours à une indication
 243 textuelle (commande @code{\markup}) de doigté
 244 (commande @code{\finger}).
 245
 246 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
 247 c4-1 c-2 c-3 c-4
 248 c^\markup { \finger "2 - 3" }
 249 @end lilypond
 250
 251
 252 La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
 253 dans une partition de violoncelle, si une note doit être jouée avec le
 254 pouce (@q{thumb} en anglais).
 255
 256 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
 257 <a_\thumb a'-3>8 <b_\thumb b'-3>
 258 @end lilypond
 259
 260
 261 Les doigtés des accords peuvent être saisis note par note,
 262 en les indiquant après chaque hauteur de note.
 263
 264 @lilypond[quote,verbatim,ragged-right,fragment,relative=2]
 265 < c-1 e-2 g-3 b-5 >4
 266 @end lilypond
 267
 268
 269 @commonprop
 270
 271 On peut contrôler précisément les doigtés des accords en réglant
 272 la propriété @code{fingeringOrientations}.
 273
 274 @lilypond[quote,verbatim,ragged-right,fragment,relative=1]
 275 \set fingeringOrientations = #'(left down)
 276 <c-1 es-2 g-4 bes-5 > 4
 277 \set fingeringOrientations = #'(up right down)
 278 <c-1 es-2 g-4 bes-5 > 4
 279 @end lilypond
 280
 281
 282 Cette propriété permet également, dans de la musique monophonique,
 283 d'indiquer des doigtés très proches des têtes de notes.
 284
 285 @lilypond[verbatim,ragged-right,quote,fragment]
 286 \set fingeringOrientations = #'(right)
 287 <es'-2>4
 288 @end lilypond
 289
 290
 291 @seealso
 292
 293 Référence du programme : @internalsref{Fingering}.
 294
 295 D'autres exemples : @lsr{expressive,fingering-chords.ly}.
 296
 297
 298 @node Hidden notes
 299 @unnumberedsubsubsec Hidden notes
 300
 301 @cindex Masquées, notes
 302 @cindex Invisibles, notes
 303 @cindex Transparentes, notes
 304
 305 @funindex \hideNotes
 306 @funindex \unHideNotes
 307 Les notes masquées --- ou invisibles ou encore transparentes --- sont
 308 utiles dans le cadre d'exercices de théorie ou de composition.
 309
 310 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
 311 c4 d4
 312 \hideNotes
 313 e4 f4
 314 \unHideNotes
 315 g4 a
 316 @end lilypond
 317
 318
 319 @node Coloring objects
 320 @unnumberedsubsubsec Coloring objects
 321
 322 Des objets peuvent être colorisés individuellement.  Une listes des
 323 noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
 324
 325 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
 326 \override NoteHead #'color = #red
 327 c4 c
 328 \override NoteHead #'color = #(x11-color 'LimeGreen)
 329 d
 330 \override Stem #'color = #blue
 331 e
 332 @end lilypond
 333
 334 L'intégralité de la palette des couleurs définies pour X11 est
 335 accessible par la fonction Scheme x11-color.  Cette fonction prend
 336 en argument une expression symbolique
 337
 338 @example
 339 \override Beam #'color = #(x11-color 'MediumTurquoise)
 340 @end example
 341
 342 ou une chaîne de caractères
 343
 344 @example
 345 \override Beam #'color = #(x11-color "MediumTurquoise")
 346 @end example
 347
 348 La première formulation est à la fois plus rapide à écrire et aussi
 349 plus efficace.  Néanmoins, la deuxième forme permet d'accéder aux noms
 350 composés des couleurs de X11.
 351
 352 @example
 353 \override Beam #'color = #(x11-color "medium turquoise")
 354 @end example
 355
 356 Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
 357 revient à la couleur par défaut, le noir.  Le problème ressort de
 358 façon évidente au vu de la partition finale.
 359
 360 L'exemple suivant illustre l'utilisation de la fonction
 361 @code{x11-color}.  Notez que, après avoir été définie à (x11-color
 362 'Boggle), la couleur des hampes repasse au noir.
 363
 364 @lilypond[quote,ragged-right,verbatim]
 365 {
 366   \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
 367   \set Staff.instrumentName = \markup {
 368     \with-color #(x11-color 'navy) "Clarinet"
 369   }
 370   \time 2/4
 371   gis''8 a''
 372   \override Beam #'color = #(x11-color "medium turquoise")
 373   gis'' a''
 374   \override NoteHead #'color = #(x11-color "LimeGreen")
 375   gis'' a''
 376   \override Stem #'color = #(x11-color 'Boggle)
 377   gis'' a''
 378 }
 379 @end lilypond
 380
 381
 382 @seealso
 383
 384 Annexes : @ref{List of colors}.
 385
 386
 387 @refbugs
 388 Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
 389 internet.  Aussi nous vous recommandons, dans le cadre d'une
 390 présentation multimedia, d'utiliser des couleurs de base.
 391
 392 Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
 393 normale ayant un nom similaire.
 394
 395 Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
 396 @code{\override}. si besoin est, utilisez @code{\tweak}.
 397 Pour plus de détails, consultez @ref{Objects connected to the input}.
 398
 399
 400 @node Parentheses
 401 @unnumberedsubsubsec Parentheses
 402
 403 @cindex fantômes, notes
 404 @cindex notes fantômes
 405 @cindex parenthèses, notes entre
 406
 407 Des objets peuvent être mis entre parenthèses en saisissant
 408 @code{\parenthesize} juste avant l'événement musical.
 409
 410 @lilypond[relative=2,fragment,verbatim,ragged-right]
 411 <
 412   c
 413   \parenthesize d
 414   g
 415 >4-\parenthesize -.
 416 @end lilypond
 417
 418 Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
 419 comprendre qu'une seule note.
 420
 421 @example
 422 < \parenthesize NOTE>
 423 @end example
 424
 425
 426 @node Ambitus
 427 @unnumberedsubsubsec Ambitus
 428 @cindex ambitus
 429
 430 L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
 431 partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
 432 est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
 433 partitions vocales, afin que les exécutants puissent voir au premier
 434 coup d'oeil s'ils sont en mesure de tenir la partie en question.
 435
 436 Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
 437 représentant la hauteur la plus basse et la plus haute.  Pour imprimer
 438 cet ambitus, il faut ajouter le graveur @internalsref{Ambitus_engraver}
 439 au contexte @internalsref{Voice}.  Ainsi,
 440
 441 @example
 442 \layout @{
 443   \context @{
 444     \Voice
 445     \consists Ambitus_engraver
 446   @}
 447 @}
 448 @end example
 449
 450 @noindent
 451 donne pour résultat
 452
 453 @lilypond[quote,ragged-right]
 454 \layout {
 455   \context {
 456     \Staff
 457     \consists Ambitus_engraver
 458   }
 459 }
 460
 461 \relative \new Staff {
 462   as'' c e2 cis,2
 463 }
 464 @end lilypond
 465
 466 Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
 467 graveur @internalsref{Ambitus_engraver} au contexte @internalsref{Staff}
 468 plutôt qu'au contexte @internalsref{Voice} ; l'ambitus affiché sera
 469 alors celui de toutes les voix cumulées, non d'une seule des voix
 470 actives.
 471
 472 @lilypond[verbatim,ragged-right,quote]
 473 \new Staff \with {
 474   \consists "Ambitus_engraver"
 475 }
 476 <<
 477   \new Voice \with {
 478     \remove "Ambitus_engraver"
 479   } \relative c'' {
 480     \override Ambitus #'X-offset = #-1.0
 481     \voiceOne
 482     c4 a d e f2
 483   }
 484   \new Voice \with {
 485     \remove "Ambitus_engraver"
 486   } \relative c' {
 487     \voiceTwo
 488     es4 f g as b2
 489   }
 490 >>
 491 @end lilypond
 492
 493 @noindent
 494 Cet exemple met en œuvre une fonctionnalité avancée :
 495
 496 @example
 497 \override Ambitus #'X-offset = #-1.0
 498 @end example
 499
 500 @noindent
 501 Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
 502 être obtenu avec @code{extra-offset}, mais alors le système de mise en
 503 forme n'aurait pas attribué d'espace supplémentaire pour l'objet
 504 déplacé.
 505
 506 @seealso
 507
 508 Référence du programme : @internalsref{Ambitus},
 509 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
 510 @internalsref{AmbitusAccidental}.
 511
 512 Exemples :
 513 @lsr{vocal,ambitus@/.ly}.
 514
 515 @refbugs
 516
 517 LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
 518 une même portée.
 519
 520
 521 @node Stems
 522 @unnumberedsubsubsec Stems
 523
 524 Dès qu'une note est rencontrée, un objet @internalsref{Stem} se crée
 525 automatiquement.  Pour les rondes et les silences, ils sont aussi
 526 créés, mais en mode invisible.
 527
 528 @refcommands
 529
 530 @funindex \stemUp
 531 @code{\stemUp},
 532 @funindex \stemDown
 533 @code{\stemDown},
 534 @funindex \stemNeutral
 535 @code{\stemNeutral}.
 536
 537
 538 @commonprop
 539
 540 Pour changer la direction des hampes au milieu de la portée, utilisez
 541
 542 @lilypond[quote,ragged-right,fragment,relative=2,verbatim]
 543 a4 b c b
 544 \override Stem #'neutral-direction = #up
 545 a4 b c b
 546 \override Stem #'neutral-direction = #down
 547 a4 b c b
 548 @end lilypond
 549
 550
 551 @node Outside the staff
 552 @subsection Outside the staff
 553
 554
 555 @menu
 556 * Balloon help::
 557 * Grid lines::
 558 * Blank music sheet::
 559 @end menu
 560
 561 @node Balloon help
 562 @subsection Balloon help
 563
 564 Vous pouvez marquer et nommer des éléments de notation à l'aide de
 565 bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
 566 notation.
 567
 568 En voici un exemple :
 569 @c KEEP LY
 570 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
 571 \new Voice \with { \consists "Balloon_engraver" }
 572 {
 573   \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
 574   <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
 575 }
 576 @end lilypond
 577
 578 @noindent
 579 Vous disposez de deux fonctions musicales, @code{balloonText} et
 580 @code{balloonGrobText}.  @code{balloonGrobText} prend en argument
 581 l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
 582 comme une simple articulation.  Les autres arguments sont le décalage
 583 et le texte de la bulle.
 584
 585 @cindex bulles
 586 @cindex notation, expliquer
 587
 588 @seealso
 589
 590 Référence du programme : @internalsref{text-balloon-interface}.
 591
 592
 593 @node Grid lines
 594 @subsection Grid lines
 595
 596 Vous pouvez tracer des lignes entre les portées, synchronisées avec
 597 les notes.
 598 @c KEEP LY
 599 @lilypond[ragged-right,quote,verbatim]
 600 \layout {
 601   \context {
 602     \Staff
 603     \consists "Grid_point_engraver" %% active les guides
 604     gridInterval = #(ly:make-moment 1 4)
 605   }
 606 }
 607
 608 \new Score \with {
 609   \consists "Grid_line_span_engraver"
 610   %% centre les lignes guides horizontalement sous les notes
 611   \override NoteColumn #'X-offset = #-0.5
 612 }
 613
 614 \new ChoirStaff <<
 615   \new Staff {
 616     \stemUp
 617     \relative {
 618       c'4. d8 e8 f g4
 619     }
 620   }
 621   \new Staff {
 622     %% centre les lignes guides verticalement
 623     \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
 624     \stemDown
 625     \clef bass
 626     \relative c {
 627       c4  g'  f  e
 628     }
 629   }
 630 >>
 631 @end lilypond
 632
 633 Exemples : @lsrdir{education}
 634
 635
 636 @node Blank music sheet
 637 @subsection Blank music sheet
 638
 639 @cindex Papier musique
 640 @cindex Portées, feuille blanche
 641
 642 Une feuille de papier musique s'obtient en utilisant des notes
 643 invisibles, et en invalidant le @code{Bar_number_engraver}.
 644
 645 @c KEEP LY
 646 @lilypond[quote,verbatim]
 647 \layout{ indent = #0 }
 648 emptymusic = {
 649   \repeat unfold 2 % À modifier pour plus de lignes.
 650   { s1\break }
 651   \bar "|."
 652 }
 653 \new Score \with {
 654   \override TimeSignature #'transparent = ##t
 655 % décommenter la  ligne suivante selon besoin
 656 %  \override Clef #'transparent = ##t
 657   defaultBarType = #""
 658   \remove Bar_number_engraver
 659 } <<
 660
 661 % à adapter selon les portées désirées
 662   \new Staff \emptymusic
 663   \new TabStaff \emptymusic
 664 >>
 665 @end lilypond
 666
 667