5.2 En quoi consiste la référence des propriétés internes

@translationof Explaining the Internals Reference

5.2.1 Navigation dans les références du programme

@translationof Navigating the program reference

Comment, par exemple, déplacer le doigté dans le fragment suivant ?

c''-2

Sur la page de la documentation relative aux doigtés, c’est-à-dire Doigtés, se trouve l’indication suivante :

Voir aussi

Référence des propriétés internes : (internals)Fingering section ‘Fingering’ dans Référence des propriétés internes.

Suivons le lien (internals)Fingering section ‘Fingering’ dans Référence des propriétés internes. En haut de la nouvelle page, on peut lire

Fingering objects are created by: (internals)Fingering_engraver section ‘Fingering_engraver’ dans Référence des propriétés internes and (internals)New_fingering_engraver section ‘New_fingering_engraver’ dans Référence des propriétés internes.

En d’autres termes, Les indications de doigtés (Fingering en anglais) sont créées par les graveurs (internals)Fingering_engraver section ‘Fingering_engraver’ dans Référence des propriétés internes et (internals)New_fingering_engraver section ‘New_fingering_engraver’ dans Référence des propriétés internes.

En suivant derechef les liens propres à la référence du programme, on suit en fait le cheminement qui aboutit à la création de la partition :

• (internals)Fingering section ‘Fingering’ dans Référence des propriétés internes: (internals)Fingering section ‘Fingering’ dans Référence des propriétés internes objects are created by: (internals)Fingering_engraver section ‘Fingering_engraver’ dans Référence des propriétés internes
• (internals)Fingering_engraver section ‘Fingering_engraver’ dans Référence des propriétés internes: Music types accepted: (internals)fingering-event section ‘fingering-event’ dans Référence des propriétés internes
• (internals)fingering-event section ‘fingering-event’ dans Référence des propriétés internes: Music event type fingering-event is in Music expressions named (internals)FingeringEvent section ‘FingeringEvent’ dans Référence des propriétés internes

Ce cheminement se produit, bien sûr, en sens inverse : nous sommes ici partis du résultat, et avons abouti aux événements (en anglais Events) engendrés par le fichier d’entrée. L’inverse est également possible : on peut partir d’un événement et suivre le cheminement de LilyPond qui aboutit à la création d’un ou plusieurs objets graphiques.

La référence des propriétés internes peut également se parcourir comme un document normal. On y trouve des chapitres tels que (internals)Music definitions section ‘Music definitions’ dans Référence des propriétés internes, (internals)Translation section ‘Translation’ dans Référence des propriétés internes, ou encore (internals)Backend section ‘Backend’ dans Référence des propriétés internes. Chaque chapitre recense toutes les définitions employées, et les propriétés sujettes à ajustements.

La Référence des propriétés internes n’est pas traduite en français – notamment du fait qu’elle est en évolution constante, tout comme LilyPond. En revanche, les termes musicaux font l’objet d’un (music-glossary)Top section ‘glossaire’ dans Glossaire fort utile pour les utilisateurs francophones.

5.2.2 Interfaces de rendu

@translationof Layout interfaces

Tous les éléments de notation sont considérés comme des objets graphiques (en anglais Graphical Object, d’où le diminutif Grob). Chaque objet est doté d’un certain nombre de propriétés (l’épaisseur du trait, l’orientation, etc.), et lié à d’autres objets. Le fonctionnement de ces objets est décrit en détail dans (internals)grob-interface section ‘grob-interface’ dans Référence des propriétés internes.

Prenons l’exemple des doigtés (en anglais Fingering). La page Fingering de la Référence des propriétés internes établit une liste de définitions propres à ce type d’objet :

padding (dimension, in staff space):

0.5

Ce qui signifie que les doigtés doivent être maintenus à une certaine distance (padding) des notes : 0,5 unités staff-space (espace de portée).

Chaque objet peut avoir plusieurs attributs, en tant qu’élément typographique ou musical. Ainsi, un doigté (objet Fingering) possède les attributs suivants :

• Sa taille ne dépend pas de l’espacement horizontal, contrairement aux liaisons ou ligatures.
• C’est du texte – un texte vraiment court, certes.
• Ce texte est imprimé au moyen d’une fonte, contrairement aux liaisons ou ligatures.
• Sur l’axe horizontal, le centre de ce symbole doit être aligné avec le centre de la note.
• Sur l’axe vertical, le symbole doit être proche de la note et de la portée.
• Sur l’axe vertical encore, il doit également s’ordonner avec les éventuels autres symboles, ponctuations ou éléments textuels.

Faire appliquer ces différents attributs est le rôle des interfaces, que l’on trouve en bas de la page (internals)Fingering section ‘Fingering’ dans Référence des propriétés internes.

This object supports the following interfaces: (internals)item-interface section ‘item-interface’ dans Référence des propriétés internes, (internals)self-alignment-interface section ‘self-alignment-interface’ dans Référence des propriétés internes, (internals)side-position-interface section ‘side-position-interface’ dans Référence des propriétés internes, (internals)text-interface section ‘text-interface’ dans Référence des propriétés internes, (internals)text-script-interface section ‘text-script-interface’ dans Référence des propriétés internes, (internals)font-interface section ‘font-interface’ dans Référence des propriétés internes, (internals)finger-interface section ‘finger-interface’ dans Référence des propriétés internes, and (internals)grob-interface section ‘grob-interface’ dans Référence des propriétés internes.

En français,

Cet objet admet les interfaces suivantes :

Suit la liste des interfaces en question, présentées comme autant de liens qui conduisent aux pages dédiées à chacune d’entre elles. Chaque interface est dotée d’un certain nombre de propriétés, dont certaines peuvent être modifiées, d’autres non (les Internal properties, ou propriétés internes).

Pour aller encore plus loin, plutôt que de simplement parler de l’objet Fingering, ce qui ne nous avance pas à grand chose, on peut aller explorer son âme même, dans les fichiers source de LilyPond (voir (learning)Autres sources de documentation section ‘Autres sources de documentation’ dans Manuel d’initiation), en l’occurrence le fichier ‘scm/define-grobs.scm’ :

(Fingering
  . ((padding . 0.5)
     (avoid-slur . around)
     (slur-padding . 0.2)
     (staff-padding . 0.5)
     (self-alignment-X . 0)
     (self-alignment-Y . 0)
     (script-priority . 100)
     (stencil . ,ly:text-interface::print)
     (direction . ,ly:script-interface::calc-direction)
     (font-encoding . fetaText)
     (font-size . -5) 		; don't overlap when next to heads.
     (meta . ((class . Item)
     (interfaces . (finger-interface
                    font-interface
                    text-script-interface
                    text-interface
                    side-position-interface
                    self-alignment-interface
                    item-interface))))))

…où l’on découvre que l’objet Fingering n’est rien de plus qu’un amas de variables et de réglages. La page de la Référence des propriétés internes est en fait directement engendrée par cette définition.

5.2.3 Détermination de la propriété d’un objet graphique (grob)

@translationof Determining the grob property

Nous voulions changer la position du chiffre 2 dans le fragment suivant :

c''-2

Dans la mesure où le 2 est placé, verticalement, à proximité de la note qui lui correspond, nous allons devoir trouver l’interface en charge de ce placement, qui se trouve être side-position-interface. Sur la page de cette interface, on peut lire :

side-position-interface

Position a victim object (this one) next to other objects (the support). The property direction signifies where to put the victim object relative to the support (left or right, up or down?)

Ce qui signifie

side-position-interface

Placer l’objet affecté à proximité d’autres objets. La propriété direction indique où positionner l’objet (à droite ou à gauche, en haut ou en bas).

En dessous de cette description se trouve décrite la variable padding :

padding

(dimension, in staff space)

Add this much extra space between objects that are next to each other.

Ce qui signifie

Ajouter tel espace supplémentaire entre des objets proches les uns des autres.

En augmentant la valeur de padding, on peut donc éloigner le doigté de la note. La commande suivante insère trois unités d’espace vide entre la note et le doigté :

\once \override Voice.Fingering.padding = #3

En ajoutant ce tampon avant la création du doigté (de l’objet Fingering), donc avant c2, on obtient le résultat suivant :

\once \override Voice.Fingering.padding = #3 c''-2

Dans le cas présent, le réglage intervient dans le contexte Voice, ce qui pouvait également se déduire de la Référence des propriétés internes, où la page du graveur (internals)Fingering_engraver section ‘Fingering_engraver’ dans Référence des propriétés internes indique :

Fingering_engraver is part of contexts: … (internals)Voice section ‘Voice’ dans Référence des propriétés internes

Ce qui signifie

Le graveur Fingering_engraver fait partie des contextes : … (internals)Voice section ‘Voice’ dans Référence des propriétés internes

5.2.4 Conventions de nommage

@translationof Naming conventions

Afin de s’y retrouver plus aisément et d’éviter les erreurs de frappe, voici quelques conventions en matière de nommage :

• fonctions scheme : minuscule-avec-trait-d-union (ce qui inclut les noms en mot-unique)
• fonctions scheme : ly:plus-style-scheme
• événements, classes et propriétés musicaux : identique-aux-fonctions-scheme
• interfaces d’objet graphique : style-scheme
• propriétés d’arrière plan : style-scheme (mais X et Y pour les axes)
• contextes (ainsi que MusicExpressions et grobs) : Capitale initiale ou Camélisation (CamelCase)
• propriétés de contexte : minusculeSuivieDeCamélisation
• graveurs : Capitale_initiale_puis_minuscules_séparées_par_un_souligné

Les questions que vous devez vous poser sont :

• Qu’est-ce qui relève des conventions, et qu’est-ce qui relève de la règle ?
• Qu’est-ce qui relève des règles du langage sous-jacent, et qu’est-ce qui est propre à LilyPond ?

Ce document a été généré le le 13 juillet 2020 par gub en utilisant texi2html 1.82.

Autres langues : English, català, deutsch, español, italiano, 日本語.
À propos de la sélection automatique de la langue.