X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Feditorial.itely;h=edca59ae98a3d92451d56c219a94a04229509ceb;hb=0a34e892b31530e87380bffaac0bb9cf9a1c8a91;hp=9e5a8a46abd71bf16d437d9fca2a6458521f3b56;hpb=794dcbdb52faf4292036cd1b0270a956cf4316a3;p=lilypond.git diff --git a/Documentation/fr/notation/editorial.itely b/Documentation/fr/notation/editorial.itely index 9e5a8a46ab..edca59ae98 100644 --- a/Documentation/fr/notation/editorial.itely +++ b/Documentation/fr/notation/editorial.itely @@ -1,24 +1,29 @@ -@c -*- coding: utf-8; mode: texinfo; -*- +@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- + @ignore - Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6 + Translation of GIT committish: caa4700b4acbc870158d70ee257efaa723c550f0 - When revising a translation, copy the HEAD committish of the - version that you are working on. See TRANSLATION for details. + When revising a translation, copy the HEAD committish of the + version that you are working on. For details, see the Contributors' + Guide, node Updating translation committishes.. @end ignore -@c \version "2.12.0" +@c \version "2.19.21" @c Translators: Jean-Charles Malahieude -@node Notation éditoriale -@section Notation éditoriale +@node Annotations éditoriales +@section Annotations éditoriales @translationof Editorial annotations @lilypondfile[quote]{editorial-headword.ly} +Ce chapitre traite de la manière de modifier l'apparence des notes dans +un but pédagogique ou d'analyse. + @menu -* Dans la portée:: -* Hors de la portée:: +* Dans la portée:: +* Hors de la portée:: @end menu @@ -26,76 +31,315 @@ @subsection Dans la portée @translationof Inside the staff +Nous allons voir ici comment mettre en exergue certains éléments à +l'intérieur même de la portée. @menu -* Indication de la taille de fonte musicale:: -* Doigtés:: -* Dictée à trous:: -* Coloration d'objets:: -* Parenthèses:: -* Hampes:: +* Indication de la taille de fonte musicale:: +* Doigtés:: +* Dictée à trous:: +* Coloration d'objets:: +* Parenthèses:: +* Hampes:: @end menu + @node Indication de la taille de fonte musicale @unnumberedsubsubsec Indication de la taille de fonte musicale @translationof Selecting notation font size -Le plus sûr moyen de régler la taille de la police, quelque soit le -contexte, consiste à définir la propriété @code{fontSize}. +@cindex sélection de la taille (notation) +@cindex notes, taille +@cindex taille des notes +@cindex têtes de note + +@funindex fontSize +@funindex font-size +@funindex magnification->font-size +@funindex magstep +@funindex magnifyMusic +@funindex \teeny +@funindex \tiny +@funindex \small +@funindex \normalsize +@funindex \large +@funindex \huge +@funindex teeny +@funindex tiny +@funindex small +@funindex normalsize +@funindex large +@funindex huge + +@warning{@* +Pour les tailles de police textuelle, voir +@ref{Sélection de la fonte et de la taille}.@* +Pour la taille des portées, voir +@ref{Définition de la taille de portée}.@* +Pour les petites notes, voir +@ref{Mise en forme d'une citation}.@* +Pour les variantes, voir @ref{Portées d'ossia}.} + +Le plus sûr moyen de régler la taille des éléments de notation sans +modifier la taille de la portée consiste à utiliser la commande +@code{\magnifyMusic} : + +@c Grieg Piano Concerto (mvt.1 cadenza) +@lilypond[verbatim,quote] +\new Staff << + \new Voice \relative { + \voiceOne + 4 8. 16 8 4 r8 + } + \new Voice \relative { + \voiceTwo + \magnifyMusic 0.63 { + \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63) + r32 c'' a c a c a c r c a c a c a c + r c a c a c a c a c a c a c a c + } + } +>> +@end lilypond + +La présence d'un @code{\override} dans cet exemple permet de +contourner une bogue -- voir « Problèmes connus et avertissements » en +fin de section. + +Dans le cas de fusion d'une tête de note normale avec une autre de +taille inférieure, la taille de la petite note peut nécessiter une +réinitialisation -- à l'aide d'un @w{@samp{\once@tie{}\normalsize}} -- +de telle sorte que les hampes et altérations s'alignent correctement : + +@c Chopin Prelude op.28 no.8 +@lilypond[verbatim,quote] +\new Staff << + \key fis \minor + \mergeDifferentlyDottedOn + \new Voice \relative { + \voiceOne + \magnifyMusic 0.63 { + \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63) + \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d' + \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis' + \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis' + \once \normalsize a, a' bis, d cis b \once \normalsize gis gis') + } + } + \new Voice \relative { + \voiceTwo + cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16 + } +>> +@end lilypond + +La commande @code{\magnifyMusic} n'est pas conçue pour gérer les +citations, notes d'ornement ou portées d'ossia -- des moyens +spécifiques sont déjà disponibles en la matière. Elle est par contre +tout à fait adaptée dans le cas d'un instrument particulier disposant de +sa propre portée là où des notes d'ornement seraient inappropriées, +comme pour une pseudo-cadence ou les exemples ci-dessus. L'attribution +d'une valeur de 0,63 à @code{\magnifyMusic} duplique les dimensions d'un +contexte @code{CueVoice}. + +@warning{La commande @code{@bs{}magnifyMusic} n'est pas censée +intervenir en complément d'une modification de la taille de portée -- +voir @ref{Définition de la taille de portée}.} + + +@subsubsubheading Redimmensionnement individuel d'objets de rendu +@c VO Resizing individual layout objects + +L'ajustement de la propriété @code{font-size} à l'aide des commandes +@code{\tweak} ou @code{\override} permet de retailler un objet de rendu +particulier : + +@lilypond[quote,verbatim] +\relative { + % resize a note head + -5 + % resize a fingering + bes-\tweak font-size 0 -3 + % resize an accidental + \once \override Accidental.font-size = -4 bes!-^ + % resize an articulation + \once \override Script.font-size = 4 bes!-^ +} +@end lilypond + +La valeur par défaut de @code{font-size} est mentionnée, pour chaque +objet de rendu, dans la référence des propriétés internes. La propriété +@code{font-size} ne peut intervenir que pour les objets qui utilisent +des polices, autrement dit ceux qui disposent de l'interface de rendu +@code{font-interface}. L'abence de @code{font-size} dans la liste des +« réglages par défaut » d'un objet signifie qu'elle est de 0 -- voir +@rinternals{All layout objects} @emph{(Tous les objets de rendu)}. + + +@subsubsubheading La propriété @code{fontSize} +@c VO Understanding the @code{fontSize} property + +La propriété @code{fontSize} d'un contexte a pour effet de définir la +taille proportionnelle de tout élément de notation basé sur un +glyphe dans ce contexte : + +@lilypond[verbatim,quote] +\relative { + \time 3/4 + d''4---5 c8( b a g) | + \set fontSize = -6 + e'4-- c!8-4( b a g) | + \set fontSize = 0 + fis4---3 e8( d) fis4 | + g2. +} +@end lilypond -@lilypond[quote,fragment,relative=1,verbatim] -c8 -\set fontSize = #-4 -c f -\set fontSize = #3 -g +La valeur de @code{fontSize} est un nombre indiquant la taille +relative par rapport à la hauteur standard de la portée en cours. +La valeur par défaut de @code{fontSize} est de 0. Un pas de six +aboutit exactement au doublement de la taille ; un pas de moins +six la réduit de moitié. Chaque incrément correspond à une +augmentation d'environ 12 % de la taille de la police. + +La fonction Scheme @code{magnification->font-size} permet de +s'affranchir de l'échelle logarithmique peu intuitive des unités +de la propriété @code{font-size}. Ainsi, l'ajustement à 75 % de +la notation musicale par rapport à la taille de la portée peut se +libeller : + +@example +\set fontSize = #(magnification->font-size 0.75) +@end example + +La fonction Scheme @code{magstep} quant à elle effectue +l'inverse : elle convertit le nombre affecté à @code{font-size} en +facteur d'échelle. + +La propriété @code{fontSize} affecte uniquement les éléments de +notation reposant sur des glyphes, tels les têtes de note, +altérations, scripts, etc. Elle n'aura aucun effet sur la taille +de la portée, la hauteur des hampes ou la longueur des ligatures +ni sur l'espacement horizontal. L'échelonnement des hampes, +ligature et espacement horizontal, couplé à la taille de la +notation (sans modification de la taille de la portée), s'obtient +à l'aide de la commande @code{\magnifyMusic} comme nous venons de +le voir. La modification de l'ensemble, y compris la taille de +portée, est abordé dans @ref{Définition de la taille de portée}. + +Dès lors que la @strong{propriété de contexte} @code{fontSize} est +définie, sa valeur est ajoutée individuellement à la valeur de la +@strong{propriété de @emph{grob}} @code{font-size} des objets de +rendu. Ceci peut être source de confusion lorsque des propriétés +@code{font-size} individuelles sont réglées alors que +@code{fontSize} est déjà fixé : + +@lilypond[verbatim,quote,fragment] +% the default font-size for NoteHead is 0 +% the default font-size for Fingering is -5 +c''4-3 + +\set fontSize = -3 +% the effective font size for NoteHead is now -3 +% the effective font size for Fingering is now -8 +c''4-3 + +\override Fingering.font-size = 0 +% the effective font size for Fingering is now -3 +c''4-3 @end lilypond -@noindent -Ceci ne modifiera en rien la taille des différents symboles tels que -ligatures ou liaisons. - -En interne, la propriété @code{fontSize} d'un contexte aura pour effet -de définir la propriété @code{font-size} pour tous les objets de -rendu. La valeur de @code{font-size} est un entier représentant la -taille proportionnellement à la hauteur standard de la portée en -cours. Chaque incrément correspond à une augmentation d'environ -12@tie{}% de la taille de la police. Un pas de six aboutit exactement -au doublement de la taille. La fonction Scheme @code{magstep} -convertit le nombre affecté à @code{font-size} en facteur d'échelle. -Vous pouvez aussi définir directement la propriété @code{font-size} de -manière à n'affecter seulement que certains objets de rendu. - -@lilypond[quote,fragment,relative=1,verbatim] -c8 -\override NoteHead #'font-size = #-4 -c f -\override NoteHead #'font-size = #3 -g +LilyPond dispose d'un certain nombre de raccourcis : + +@multitable @columnfractions .2 .4 .4 +@item @b{Commande} @tab @b{Équivalent} @tab @b{Taille relative} +@item @code{\teeny} @tab @code{\set fontSize = -3} @tab 71 % +@item @code{\tiny} @tab @code{\set fontSize = -2} @tab 79 % +@item @code{\small} @tab @code{\set fontSize = -1} @tab 89 % +@item @code{\normalsize} @tab @code{\set fontSize = 0} @tab 100 % +@item @code{\large} @tab @code{\set fontSize = 1} @tab 112 % +@item @code{\huge} @tab @code{\set fontSize = 2} @tab 126 % +@end multitable + +@lilypond[verbatim,quote] +\relative c'' { + \teeny + c4.-> d8---3 + \tiny + c4.-> d8---3 + \small + c4.-> d8---3 + \normalsize + c4.-> d8---3 + \large + c4.-> d8---3 + \huge + c4.-> d8---3 +} @end lilypond -Pour changer la taille des symboles musicaux (police Feta), LilyPond met -à l'échelle la fonte dont la taille est la plus proche de la taille voulue --- -cf. @ref{Définition de la taille de portée}. La taille standard, pour laquelle -@code{font-size} vaut 0, dépend de la hauteur de la portée. À une -portée de 20 points correspond une police de 10 points. +@cindex standard, taille des notes +@cindex notes, taille standard -La propriété @code{font-size} ne peut intervenir que pour les objets -qui utilisent des polices, autrement dit ceux qui disposent de -l'interface de rendu @rinternals{font-interface}. +@funindex font-interface +@funindex font-size + +Pour changer la taille des caractères, LilyPond met à l'échelle la fonte +dont la taille est la plus proche de la taille voulue. La taille +standard (pour laquelle @code{font-size = 0}) dépend de la hauteur +de la portée. À une portée de 20 points correspond une police de +11 points. @predefined -Les commandes suivantes définissent @code{fontSize} pour la voix en -cours : -@funindex \tiny +@code{\magnifyMusic}, +@code{\teeny}, @code{\tiny}, -@funindex \small @code{\small}, -@funindex \normalsize -@code{\normalsize}. +@code{\normalsize}, +@code{\large}, +@code{\huge}. @endpredefined +@seealso +Manuel de notation : +@ref{Définition de la taille de portée}, +@ref{Mise en forme d'une citation}, +@ref{Portées d'ossia}, +@ref{Sélection de la fonte et de la taille}. + +Fichiers d'initialisation : +@file{ly/music-functions-init.ly}, +@file{ly/property-init.ly}. + +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{font-interface}. + +@c The two issues mentioned below: +@c http://code.google.com/p/lilypond/issues/detail?id=3987 +@c http://code.google.com/p/lilypond/issues/detail?id=3990 +@knownissues +Deux bogues actuellement répertoriés font obstacle à un espacement +horizontal correct avec @code{\magnifyMusic}. La seule façon de les +contourner n'est cependant pas garantie dans toutes les situations. +Dans l'exemple suivant, il vous faudra adapter la valeur de la variable +@var{mag}. Vous pourriez aussi tenter de supprimer une ou les deux +commandes @code{\newSpacingSection}, ou les commandes @code{\override} +et @code{\revert} : + +@example +\magnifyMusic @var{mag} @{ + \newSpacingSection + \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag}) + @var{[musique]} + \newSpacingSection + \revert Score.SpacingSpanner.spacing-increment +@} +@end example + @node Doigtés @unnumberedsubsubsec Doigtés @@ -104,172 +348,267 @@ cours : @cindex doigté @cindex substitution de doigt +@funindex \finger +@funindex finger -Les doigtés peuvent être indiqués comme suit : -@example +Les doigtés peuvent être indiqués comme suit : @var{note}-@var{chiffre_du_doigt} -@end example + +@lilypond[verbatim,quote] +\relative { c''4-1 d-2 f-4 e-3 } +@end lilypond + Pour les substitutions de doigts, on a recours à une indication -textuelle (commande @code{\markup}) de doigté -(commande @code{\finger}). +textuelle (commande @code{\markup}) de doigté (commande @code{\finger}). -@lilypond[quote,verbatim,ragged-right,fragment,relative=1] -c4-1 c-2 c-3 c-4 -c^\markup { \finger "2 - 3" } +@lilypond[verbatim,quote] +\relative { + c''4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3" +} @end lilypond +@cindex pouce, doigté + +@funindex \thumb +@funindex thumb La commande @code{\thumb} peut être utilisée pour indiquer, par exemple dans une partition de violoncelle, si une note doit être jouée avec le -pouce (@q{thumb} en anglais). +pouce (@emph{thumb} en anglais). -@lilypond[quote,verbatim,ragged-right,fragment,relative=2] -8 +@lilypond[verbatim,quote] +\relative { 2 } @end lilypond +@cindex doigtés des accords +@cindex accords, doigtés Les doigtés des accords peuvent être saisis note par note, en les indiquant après chaque hauteur de note. -@lilypond[quote,verbatim,ragged-right,fragment,relative=2] -< c-1 e-2 g-3 b-5 >4 -@end lilypond - - -@commonprop - -On peut contrôler précisément les doigtés des accords en réglant -la propriété @code{fingeringOrientations}. - -@lilypond[quote,verbatim,ragged-right,fragment,relative=1] -\set fingeringOrientations = #'(left down) - 4 -\set fingeringOrientations = #'(up right down) - 4 +@lilypond[verbatim,quote] +\relative { + 2 +} @end lilypond +Les indications de doigtés peuvent se placer au-dessus ou en dessous de +la portée -- voir @ref{Direction et positionnement} à ce sujet. -Cette propriété permet également, dans de la musique monophonique, -d'indiquer des doigtés très proches des têtes de notes. +@snippets -@lilypond[verbatim,ragged-right,quote,fragment] -\set fingeringOrientations = #'(right) -4 -@end lilypond +@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] +{controlling-the-placement-of-chord-fingerings.ly} -@snippets +@lilypondfile[verbatim,quote,texidoc,doctitle] +{allowing-fingerings-to-be-printed-inside-the-staff.ly} -@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +@lilypondfile[verbatim,quote,texidoc,doctitle] {avoiding-collisions-with-chord-fingerings.ly} - @seealso -Référence du programme : @rinternals{Fingering}. +Manuel de notation : +@ref{Direction et positionnement}. + +Morceaux choisis : +@rlsrnamed{Editorial annotations, Annotations éditoriales}. -Exemples : @rlsr{Editorial annotations}. +Référence des propriétés internes : +@rinternals{FingeringEvent}, +@rinternals{fingering-event}, +@rinternals{Fingering_engraver}, +@rinternals{New_fingering_engraver}, +@rinternals{Fingering}. @node Dictée à trous @unnumberedsubsubsec Dictée à trous @translationof Hidden notes -@cindex Masquées, notes -@cindex Invisibles, notes -@cindex Transparentes, notes +@cindex masquées, notes +@cindex invisibles, notes +@cindex transparentes, notes +@cindex note invisible +@cindex note masquée @funindex \hideNotes +@funindex hideNotes @funindex \unHideNotes -Les notes masquées --- ou invisibles ou encore transparentes --- sont +@funindex unHideNotes + +Les notes masquées -- ou invisibles ou encore transparentes -- sont utiles dans le cadre d'exercices de théorie ou de composition. -@lilypond[quote,ragged-right,verbatim,relative=2,fragment] -c4 d4 -\hideNotes -e4 f4 -\unHideNotes -g4 a +@lilypond[verbatim,quote] +\relative { + c''4 d + \hideNotes + e4 f + \unHideNotes + g a + \hideNotes + b + \unHideNotes + c +} +@end lilypond + +Têtes de note, hampes, crochets et silences sont invisibles. Une +ligature sera invisible si elle démarre sur une note invisible. +Les objets de notation attachés à une note invisible ne seront pas +masqués pour autant. + +@lilypond[verbatim,quote] +\relative c'' { + e8(\p f g a)-- + \hideNotes + e8(\p f g a)-- +} @end lilypond +@predefined +@code{\hideNotes}, +@code{\unHideNotes}. +@endpredefined + +@seealso +Manuel d'initiation : +@rlearning{Visibilité et couleur des objets}. + +Manuel de notation : +@ref{Masquage de portées}, +@ref{Silences invisibles}, +@ref{Visibilité des objets}. + +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Note_spacing_engraver}, +@rinternals{NoteSpacing}. + @node Coloration d'objets @unnumberedsubsubsec Coloration d'objets @translationof Coloring objects +@cindex objets en couleur +@cindex couleurs +@cindex colorisation d'objets +@cindex coloration d'objets +@cindex coloration de notes +@cindex colorisation de notes +@cindex notes en couleur +@cindex x11, couleurs +@cindex couleurs x11 + +@funindex color +@funindex \with-color +@funindex with-color +@funindex x11-color + Des objets peuvent être colorisés individuellement. Une listes des -noms des couleurs disponibles se trouvent à l'annexe @ref{Liste des couleurs}. - -@lilypond[quote,ragged-right,verbatim,fragment,relative=1] -\override NoteHead #'color = #red -c4 c -\override NoteHead #'color = #(x11-color 'LimeGreen) -d -\override Stem #'color = #blue -e +noms des couleurs disponibles se trouvent à l'annexe +@ref{Liste des couleurs}. + +@lilypond[verbatim,quote,fragment] +\override NoteHead.color = #red +c''4 c'' +\override NoteHead.color = #(x11-color 'LimeGreen) +d'' +\override Stem.color = #blue +e'' @end lilypond L'intégralité de la palette des couleurs définies pour X11 est -accessible par la fonction Scheme x11-color. Cette fonction prend -en argument une expression symbolique - -@example -\override Beam #'color = #(x11-color 'MediumTurquoise) -@end example - -ou une chaîne de caractères +accessible par la fonction Scheme @code{x11-color}. Cette fonction +prend en argument une expression symbolique de la forme +@code{@var{'TaraTata}} ou bien une chaîne de caractères comme +@code{@var{"TaraTata"}}. La première formulation est à la fois plus +rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme +permet d'accéder aux noms composés des couleurs de X11. + +Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni, +elle revient à la couleur par défaut, le noir. Le problème ressort de +façon évidente au vu de la partition finale. -@example -\override Beam #'color = #(x11-color "MediumTurquoise") -@end example +@lilypond[verbatim,quote] +\relative c'' { + \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2) + \set Staff.instrumentName = \markup { + \with-color #(x11-color 'navy) "Clarinet" + } -La première formulation est à la fois plus rapide à écrire et aussi -plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms -composés des couleurs de X11. + gis8 a + \override Beam.color = #(x11-color "medium turquoise") + gis a + \override Accidental.color = #(x11-color 'DarkRed) + gis a + \override NoteHead.color = #(x11-color "LimeGreen") + gis a + % this is deliberate nonsense; note that the stems remain black + \override Stem.color = #(x11-color 'Boggle) + b2 cis +} +@end lilypond -@example -\override Beam #'color = #(x11-color "medium turquoise") -@end example +@cindex rgb-color +@cindex couleur rgb +@cindex couleur rvb +@cindex rgb, couleur +@cindex rvb, couleur -Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle -revient à la couleur par défaut, le noir. Le problème ressort de -façon évidente au vu de la partition finale. +@funindex rgb-color -L'exemple suivant illustre l'utilisation de la fonction -@code{x11-color}. Notez que, après avoir été définie à (x11-color -'Boggle), la couleur des hampes repasse au noir. +Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color} +les composantes de la couleur exacte au format rouge-vert-bleu +(@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de +l'exemple suivant correspond à 128). -@lilypond[quote,ragged-right,verbatim] -{ - \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2) +@lilypond[verbatim,quote] +\relative c'' { + \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2) \set Staff.instrumentName = \markup { \with-color #(x11-color 'navy) "Clarinet" } - \time 2/4 - gis''8 a'' - \override Beam #'color = #(x11-color "medium turquoise") - gis'' a'' - \override NoteHead #'color = #(x11-color "LimeGreen") - gis'' a'' - \override Stem #'color = #(x11-color 'Boggle) - gis'' a'' + + \override Stem.color = #(rgb-color 0 0 0) + gis8 a + \override Stem.color = #(rgb-color 1 1 1) + gis8 a + \override Stem.color = #(rgb-color 0 0 0.5) + gis4 a } @end lilypond - @seealso -Annexes : @ref{Liste des couleurs}. +Manuel de notation : +@ref{La commande d'affinage (tweak)}, +@ref{Liste des couleurs}. +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. -@knownissues -Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur -internet. Aussi nous vous recommandons, dans le cadre d'une -présentation multimedia, d'utiliser des couleurs de base. +@cindex x11, couleur +@cindex couleur, notes d'un accord +@cindex notes colorisées dans un accord +@cindex accords et couleur + +@funindex x11-color +@knownissues Une couleur x11 n'aura pas forcément le même rendu qu'une couleur normale ayant un nom similaire. -Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec -@code{\override}. si besoin est, utilisez @code{\tweak}. -Pour plus de détails, consultez @ref{La commande d'affinage (@emph{tweak})}. +Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur +internet. Aussi nous vous recommandons, dans le cadre d'une +présentation multimédia, d'utiliser des couleurs de base @code{blue}, +@code{green}, @code{red} -- bleu, vert, rouge. + +Vous ne pouvez pas coloriser individuellement des notes à l'intérieur +d'un accord avec @code{\override}. Si besoin est, utilisez +@code{\tweak} ou @code{\single\override} devant la note en question. +Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}. @node Parenthèses @@ -279,211 +618,319 @@ Pour plus de détails, consultez @ref{La commande d'affinage (@emph{tweak})}. @cindex fantômes, notes @cindex notes fantômes @cindex parenthèses, notes entre +@cindex crochets, notes entre + +@funindex \parenthesize +@funindex parenthesize Des objets peuvent être mis entre parenthèses en saisissant -@code{\parenthesize} juste avant l'événement musical. +@code{\parenthesize} juste avant l'événement musical. Si l'instruction +préfixe un accord, chaque note le composant se présentera entre +parenthèses. Vous pouvez aussi mettre individuellement entre +parenthèses les notes d'un accord. + +@lilypond[verbatim,quote] +\relative { + c''2 \parenthesize d + c2 \parenthesize + c2 +} +@end lilypond -@lilypond[relative=2,fragment,verbatim,ragged-right] -< - c - \parenthesize d - g ->4-\parenthesize -. +Les objets autres que des notes peuvent aussi être entre parenthèses. +En ce qui concerne les articulations, l'instruction @code{\parenthesize} +doit cependant être précédée d'un tiret. + +@lilypond[verbatim,quote] +\relative { + c''2-\parenthesize -. d + c2 \parenthesize r +} @end lilypond -Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne -comprendre qu'une seule note. +@seealso +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Parenthesis_engraver}, +@rinternals{ParenthesesItem}, +@rinternals{parentheses-interface}. -@example -< \parenthesize NOTE> -@end example +@knownissues +Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent +individuellement à chacune des notes le composant, alors qu'on +attendrait une seule paire de parenthèses encadrant tout l'accord. @node Hampes @unnumberedsubsubsec Hampes @translationof Stems -Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée +@cindex hampes +@cindex hampes invisibles +@cindex visibilité des hampes +@cindex masquage des hampes +@cindex hampe, orientation +@cindex hampe montante +@cindex hampe descendante +@cindex hampe neutre + +@funindex \stemUp +@funindex stemUp +@funindex \stemDown +@funindex stemDown +@funindex \stemNeutral +@funindex stemNeutral + +Dès qu'une note est rencontrée, un objet @code{Stem} se crée automatiquement. Pour les rondes et les silences, ils sont aussi créés, mais en mode invisible. +L'orientation des hampes peut être définie manuellement -- voir +@ref{Direction et positionnement} à ce sujet. @predefined -@funindex \stemUp @code{\stemUp}, -@funindex \stemDown @code{\stemDown}, -@funindex \stemNeutral @code{\stemNeutral}. @endpredefined +@snippets -@commonprop +@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] +{default-direction-of-stems-on-the-center-line-of-the-staff.ly} -Pour changer la direction des hampes au milieu de la portée, utilisez +@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] +{automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly} -@lilypond[quote,ragged-right,fragment,relative=2,verbatim] -a4 b c b -\override Stem #'neutral-direction = #up -a4 b c b -\override Stem #'neutral-direction = #down -a4 b c b -@end lilypond +@seealso +Manuel de notation : +@ref{Direction et positionnement}. + +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Stem_engraver}, +@rinternals{Stem}, +@rinternals{stem-interface}. @node Hors de la portée @subsection Hors de la portée @translationof Outside the staff +Nous allons nous intéresser ici à souligner des éléments inscrits dans +la portée par des éléments qui lui seront externes. @menu -* Info-bulle:: -* Quadrillage temporel:: -* Crochets d'analyse:: -* Papier à musique:: +* Info-bulle:: +* Quadrillage temporel:: +* Crochets d'analyse:: @end menu + @node Info-bulle @unnumberedsubsubsec Info-bulle @translationof Balloon help +@cindex bulle +@cindex notation, explication +@cindex info-bulle + +@funindex \balloonGrobText +@funindex \balloonText +@funindex Balloon_engraver +@funindex balloonGrobText +@funindex balloonText +@funindex \balloonLengthOn +@funindex balloonLengthOn +@funindex \balloonLengthOff +@funindex balloonLengthOff + Vous pouvez marquer et nommer des éléments de notation à l'aide de bulles. L'objectif premier de cette fonctionnalité est d'expliquer la -notation. +notation. En voici un exemple : @c KEEP LY -@lilypond[quote,verbatim,fragment,ragged-right,relative=2] +@lilypond[verbatim,quote] \new Voice \with { \consists "Balloon_engraver" } -{ +\relative c'' { \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" } - 8 + a8 + \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" } + r + 2. } @end lilypond -@noindent -Vous disposez de deux fonctions musicales, @code{balloonText} et -@code{balloonGrobText}. @code{balloonGrobText} prend en argument -l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise -comme une simple articulation. Les autres arguments sont le décalage -et le texte de la bulle. +Vous disposez de deux fonctions musicales, @code{balloonGrobText} et +@code{balloonText}. @code{balloonGrobText} prend en argument l'objet +graphique à agrémenter et s'utilise comme @code{\once \override}. +@code{balloonText}, quant à lui, s'utilise comme une simple articulation +et fonctionne comme @code{\tweak} pour attacher du texte à l'une des +notes d'un accord. Les autres arguments sont le décalage et le texte de +la bulle. + +Les info-bulles n'ont aucune influence sur l'espacement des notes ; on +peut toutefois le gérer ainsi : -@cindex bulles -@cindex notation, expliquer +@c KEEP LY +@lilypond[verbatim,quote] +\new Voice \with { \consists "Balloon_engraver" } +\relative c'' { + \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" } + a8 + \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" } + r + \balloonLengthOn + 2. +} +@end lilypond +@predefined +@code{\balloonLengthOn}, +@code{\balloonLengthOff}. +@endpredefined @seealso -Référence du programme : @rinternals{balloon-interface}. +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Balloon_engraver}, +@rinternals{BalloonTextItem}, +@rinternals{balloon-interface}. @node Quadrillage temporel @unnumberedsubsubsec Quadrillage temporel @translationof Grid lines +@cindex quadrillage temporel +@cindex temporel, quadrillage + +@funindex Grid_point_engraver +@funindex Grid_line_span_engraver +@funindex gridInterval + Vous pouvez tracer des lignes entre les portées, synchronisées avec les notes. + +LilyPond a recours à deux graveurs distincts afin d'afficher le +quadrillage : le @code{Grid_point_engraver} se charge de déterminer +l'envergure du crochet, alors que le @code{Grid_line_span_engraver} se +consacrera au tracé des lignes. Les lignes sont par défaut centrées +horizontalement sous les notes et alignées sur la gauche des têtes. La +propriété @code{gridInterval} spécifie quant à elle l'espace de temps +entre chaque ligne. + @c KEEP LY -@lilypond[ragged-right,quote,verbatim] +@lilypond[verbatim,quote] \layout { \context { \Staff \consists "Grid_point_engraver" %% active les guides - gridInterval = #(ly:make-moment 1 4) + gridInterval = #(ly:make-moment 1/4) + } + \context { + \Score + \consists "Grid_line_span_engraver" + %% centre les lignes guides horizontalement sous les notes } } -\new Score \with { - \consists "Grid_line_span_engraver" - %% centre les lignes guides horizontalement sous les notes - \override NoteColumn #'X-offset = #-0.5 -} - -\new ChoirStaff << - \new Staff { - \stemUp - \relative { - c'4. d8 e8 f g4 +\score { + \new ChoirStaff << + \new Staff \relative { + \stemUp + c''4. d8 e8 f g4 } - } - \new Staff { + \new Staff \relative { %% centre les lignes guides verticalement - \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 ) - \stemDown - \clef bass - \relative c { + \clef bass + \stemDown c4 g' f e } - } ->> + >> +} @end lilypond -Exemples : @rlsr{Editorial annotations}. +@snippets + +@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] +{grid-lines--changing-their-appearance.ly} + +@seealso +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Grid_line_span_engraver}, +@rinternals{Grid_point_engraver}, +@rinternals{GridLine}, +@rinternals{GridPoint}, +@rinternals{grid-line-interface}, +@rinternals{grid-point-interface}. @node Crochets d'analyse @unnumberedsubsubsec Crochets d'analyse @translationof Analysis brackets + @cindex crochets @cindex crochets de phrasé @cindex analyse musicologique @cindex crochet de regroupement de notes +@cindex musicologie, crochets d'analyse + +@funindex Horizontal_bracket_engraver +@funindex \startGroup +@funindex startGroup +@funindex \stopGroup +@funindex stopGroup On utilise des crochets en analyse musicale, pour indiquer la -structure d'une pièce. LilyPond permet d'utiliser une forme -simplifiée de crochets horizontaux imbriqués, dans la mesure où le -contexte @rinternals{Staff} comporte le graveur -@rinternals{Horizontal_bracket_engraver}. Un crochet s'ouvre avec -@code{\startGroup}, et se ferme avec @code{\stopGroup}. +structure d'une pièce. -@lilypond[quote,ragged-right,verbatim] -\score { - \relative c'' { - c4\startGroup\startGroup - c4\stopGroup - c4\startGroup - c4\stopGroup\stopGroup +@lilypond[verbatim,quote] +\layout { + \context { + \Voice + \consists "Horizontal_bracket_engraver" } - \layout { - \context { - \Staff \consists "Horizontal_bracket_engraver" -}}} +} +\relative { + c''2\startGroup + d\stopGroup +} @end lilypond +Les crochets d'analyses sont susceptibles d'être imbriqués : -@seealso -Référence du programme : @rinternals{HorizontalBracket}. - - -@node Papier à musique -@unnumberedsubsubsec Papier à musique -@translationof Blank music sheet - -@cindex Papier musique -@cindex Portées, feuille blanche - -Une feuille de papier musique s'obtient en utilisant des notes -invisibles, et en invalidant le @code{Bar_number_engraver}. - -@c KEEP LY -@lilypond[quote,verbatim] -\layout{ indent = #0 } -emptymusic = { - \repeat unfold 2 % À modifier pour plus de lignes. - { s1\break } - \bar "|." +@lilypond[verbatim,quote] +\layout { + \context { + \Voice + \consists "Horizontal_bracket_engraver" + } +} +\relative { + c''4\startGroup\startGroup + d4\stopGroup + e4\startGroup + d4\stopGroup\stopGroup } -\new Score \with { - \override TimeSignature #'transparent = ##t -% décommenter la ligne suivante selon besoin -% \override Clef #'transparent = ##t - defaultBarType = #"" - \remove Bar_number_engraver -} << - -% à adapter selon les portées désirées - \new Staff \emptymusic - \new TabStaff \emptymusic ->> @end lilypond - +@seealso +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Horizontal_bracket_engraver}, +@rinternals{HorizontalBracket}, +@rinternals{horizontal-bracket-interface}, +@rinternals{Staff}.