X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Feditorial.itely;h=1e53df13d9c77d795092e95572c472c4f4882400;hb=958e95822083954cad00e0a598eb9f12ceba67b9;hp=a473c00e3db7f5310f46a1fd28f0935dfb3625df;hpb=1c859650b6ff11a7dbe829328fd5cae3816b9231;p=lilypond.git diff --git a/Documentation/fr/notation/editorial.itely b/Documentation/fr/notation/editorial.itely index a473c00e3d..1e53df13d9 100644 --- a/Documentation/fr/notation/editorial.itely +++ b/Documentation/fr/notation/editorial.itely @@ -1,476 +1,929 @@ -@c -*- coding: utf-8; mode: texinfo; -*- +@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- + @ignore - Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6 + Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4 When revising a translation, copy the HEAD committish of the - version that you are working on. See TRANSLATION for details. + 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 Editorial annotations -@section Editorial annotations +@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 -* Inside the staff:: -* Outside the staff:: +* Dans la portée:: +* Hors de la portée:: @end menu -@node Inside the staff -@subsection Inside the staff +@node Dans la portée +@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 -* Selecting notation font size:: -* Fingering instructions:: -* Hidden notes:: -* Coloring objects:: -* Parentheses:: -* Stems:: +* Indication de la taille de fonte musicale:: +* Doigtés:: +* Dictée à trous:: +* Coloration d'objets:: +* Parenthèses:: +* Hampes:: @end menu -@node Selecting notation font size -@unnumberedsubsubsec 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}. +@node Indication de la taille de fonte musicale +@unnumberedsubsubsec Indication de la taille de fonte musicale +@translationof Selecting notation font size + +@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=1] +% 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 + +@lilypond[verbatim,quote,relative=2] +\huge +c4.-> d8---3 +\large +c4.-> d8---3 +\normalsize +c4.-> d8---3 +\small +c4.-> d8---3 +\tiny +c4.-> d8---3 +\teeny +c4.-> d8---3 +@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=2] +\time 3/4 +d4---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 + +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. -@lilypond[quote,fragment,relative=1,verbatim] -c8 -\set fontSize = #-4 -c f -\set fontSize = #3 -g +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,relative=2] +% the default font-size for NoteHead is 0 +% the default font-size for Fingering is -5 +c4-3 + +\set fontSize = -3 +% the effective font size for NoteHead is now -3 +% the effective font size for Fingering is now -8 +c4-3 + +\override Fingering.font-size = 0 +% the effective font size for Fingering is now -3 +c4-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=2] +\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{Setting the staff size}. 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 + +@funindex font-interface +@funindex font-size -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}. +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{Sélection de la fonte et de la taille}, +@ref{Définition de la taille de portée}, +@ref{Mise en forme d'une citation}, +@ref{Portées d'ossia}. + +Fichiers d'initialisation : +@file{ly/music-functions-init.ly}, +@file{ly/property-init.ly}. + +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. -@node Fingering instructions -@unnumberedsubsubsec Fingering instructions +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 +@translationof Fingering instructions @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=2] +c4-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}). -@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=2] +c4-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] +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 +@lilypond[verbatim,quote,relative=2] +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. -@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 -@end lilypond - - -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}. -Exemples : @rlsr{Editorial annotations}. +Morceaux choisis : +@rlsrnamed{Editorial annotations, Annotations éditoriales}. +Référence des propriétés internes : +@rinternals{FingeringEvent}, +@rinternals{fingering-event}, +@rinternals{Fingering_engraver}, +@rinternals{New_fingering_engraver}, +@rinternals{Fingering}. -@node Hidden notes -@unnumberedsubsubsec Hidden notes -@cindex Masquées, notes -@cindex Invisibles, notes -@cindex Transparentes, notes +@node Dictée à trous +@unnumberedsubsubsec Dictée à trous +@translationof Hidden 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 +@lilypond[verbatim,quote,relative=2] +c4 d \hideNotes -e4 f4 +e4 f \unHideNotes -g4 a +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. -@node Coloring objects -@unnumberedsubsubsec Coloring objects +@lilypond[verbatim,quote,relative=2] +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{Silences invisibles}, +@ref{Visibilité des objets}, +@ref{Masquage de portées}. + +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{List of colors}. +noms des couleurs disponibles se trouvent à l'annexe +@ref{Liste des couleurs}. -@lilypond[quote,ragged-right,verbatim,fragment,relative=1] -\override NoteHead #'color = #red +@lilypond[verbatim,quote,relative=2] +\override NoteHead.color = #red c4 c -\override NoteHead #'color = #(x11-color 'LimeGreen) +\override NoteHead.color = #(x11-color 'LimeGreen) d -\override Stem #'color = #blue +\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=2] +\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) - \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'' +@lilypond[verbatim,quote,relative=2] +\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2) +\set Staff.instrumentName = \markup { + \with-color #(x11-color 'navy) "Clarinet" } -@end lilypond +\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{List of colors}. +Manuel de notation : +@ref{Liste des couleurs}, +@ref{La commande d'affinage (tweak)}. +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{The tweak command}. +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 Parentheses -@unnumberedsubsubsec Parentheses +@node Parenthèses +@unnumberedsubsubsec Parenthèses +@translationof Parentheses @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. - -@lilypond[relative=2,fragment,verbatim,ragged-right] -< - c - \parenthesize d - g ->4-\parenthesize -. +@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=2] +c2 \parenthesize d +c2 \parenthesize +c2 @end lilypond -Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne -comprendre qu'une seule note. +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. -@example -< \parenthesize NOTE> -@end example +@lilypond[verbatim,quote,relative=2] +c2-\parenthesize -. d +c2 \parenthesize r +@end lilypond + +@seealso +Morceaux choisis : +@rlsrnamed{Editorial annotations,Annotations éditoriales}. + +Référence des propriétés internes : +@rinternals{Parenthesis_engraver}, +@rinternals{ParenthesesItem}, +@rinternals{parentheses-interface}. + +@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 Stems -@unnumberedsubsubsec Stems +@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}. -@node Outside the staff -@subsection Outside the staff +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 -* Balloon help:: -* Grid lines:: -* Analysis brackets:: -* Blank music sheet:: +* Info-bulle:: +* Quadrillage temporel:: +* Crochets d'analyse:: @end menu -@node Balloon help -@unnumberedsubsubsec Balloon help + +@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,relative=2] \new Voice \with { \consists "Balloon_engraver" } { \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. -@cindex bulles -@cindex notation, expliquer +Les info-bulles n'ont aucune influence sur l'espacement des notes ; on +peut toutefois le gérer ainsi : +@c KEEP LY +@lilypond[verbatim,quote,relative=2] +\new Voice \with { \consists "Balloon_engraver" } +{ + \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 -@node Grid lines -@unnumberedsubsubsec Grid lines +@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 Analysis brackets -@unnumberedsubsubsec Analysis brackets +@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 +@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 Blank music sheet -@unnumberedsubsubsec 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}.