A.19 Glossaire technique
Ce glossaire regroupe les termes techniques et concepts utilisés en interne par LilyPond. Ils apparaissent aussi bien dans les manuels, que sur les listes de diffusion et dans le code source.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < Glossaire technique ] | [Plus haut: Glossaire technique ] | [ callback (rappel) > ] |
alist (liste associative)
Une liste associative – alist pour association list –
est une paire Scheme qui associe une valeur à une clé :
(clé . valeur). Le fichier ‘scm/lily.scm’ contient par
exemple une alist « type-p-name-alist » qui associe certains
types de prédicat (par ex. ly:music?) à des noms (par ex.
« music ») de telle sorte qu’une erreur lors d’un contrôle de typage
puisse être rapportée en console avec mention du type de prédicat
attendu.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < alist (liste associative) ] | [Plus haut: Glossaire technique ] | [ closure (clôture) > ] |
callback (rappel)
Un rappel, callback en anglais, est une routine, fonction ou méthode qui est passée en argument à une autre fonction. Cette dernière peut alors faire usage de cette fonction de rappel comme de n’importe quelle autre fonction, alors qu’elle ne la connaît pas par avance. Cette façon de procéder permet à des couches logicielles de bas niveau d’appeler des fonctions définies à des niveaux plus élevés. LilyPond utilise abondamment les callbacks afin que le code Scheme saisi par l’utilisateur puisse définir les actions de bas niveau à opérer.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < callback (rappel) ] | [Plus haut: Glossaire technique ] | [ glyphe > ] |
closure (clôture)
En Scheme, une clôture (en anglais, closure) est créée lorsqu’une fonction, généralement une expression lambda, est passée en tant que variable. La clôture comporte, en plus du code de la fonction, des références à des variables libres dans l’environnement lexical – variables utilisées dans l’expression mais définies ailleurs. Lorsque la fonction est par la suite appliquée aux différents arguments, les références aux variables libres, capturées par la clôture, permettent d’obtenir la valeur de ces variables libres qui sera utilisée lors des calculs. L’une des propriétés intéressantes des clôtures est la rétention de la valeur de variables internes tout au long des différentes invocations, leur état étant alors persistant.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < closure (clôture) ] | [Plus haut: Glossaire technique ] | [ grob (objet graphique) > ] |
glyphe
Un glyphe est une représentation graphique particulière d’un caractère typographique ou d’une combinaison de deux caractères formant une ligature. Un jeu de glyphes aux mêmes style et allure constitue une fonte ; un jeu de fontes comprenant plusieurs styles et tailles constitue un type de caractère.
Voir aussi
Manuel de notation : Fontes, Caractères spéciaux.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < glyphe ] | [Plus haut: Glossaire technique ] | [ inaltérable > ] |
grob (objet graphique)
Dans LilyPond, les objets représentants les différents éléments de
notation, comme les têtes de note, hampes, liaisons, doigtés, clefs etc.
sont appelés « objets de rendu » ou objet graphique – en anglais
GRaphical OBjects couramment abrégé en grob. Ils sont
représentés par des instances de la classe grob.
Voir aussi
Manuel d’initiation : Objets et interfaces, Propriétés des objets de rendu.
Manuel de notation : Conventions de nommage.
Référence des propriétés internes : grob-interface, All layout objects.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < grob (objet graphique) ] | [Plus haut: Glossaire technique ] | [ interface > ] |
inaltérable
Un objet est dit inaltérable – immutable en anglais – dès lors que son état ne peut être modifié après sa création ; les objets altérables, à l’inverse, peuvent être modifiés après création.
Pour LilyPond, une propriété est inaltérable ou commune lorsqu’elle
définit les style ou le comportement par défaut d’objets graphiques ;
une telle propriété est partagée par un certain nombre de grobs.
En apparente contradiction avec ce que leur nom laisse accroire, de
telles propriétés peuvent être adaptées par \override et
\revert.
Voir aussi
Manuel de notation : altérable.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < inaltérable ] | [Plus haut: Glossaire technique ] | [ lexer (analyseur lexical) > ] |
interface
Les actions et propriétés communes à plusieurs objets graphiques sont
regroupées dans un objet appelé grob-interface, ou « interface »
pour faire court.
Voir aussi
Manuel d’initiation : Objets et interfaces, Propriétés listées par interface.
Manuel de notation : Conventions de nommage, Interfaces de rendu.
Référence des propriétés internes : Graphical Object Interfaces.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < interface ] | [Plus haut: Glossaire technique ] | [ altérable > ] |
lexer (analyseur lexical)
Un lexer est un programme chargé de convertir une séquence de
caractères en une séquence de jetons. Cette opération s’appelle
analyse lexicale. L’analyseur lexical de LilyPond convertit le
flot d’information contenu dans un fichier ‘.ly’ en flot de jetons
qui pourront être traités lors de l’étape suivant, l’analyse
grammaticale abordée à la rubrique parser (analyseur syntaxique).
L’analyseur lexical de LilyPond repose sur Flex ; les règles
lexicales sont regroupées dans le fichier ‘lily/lexer.ll’. Ce
fichier, partie intégrante des sources, n’est pas distribué avec les
programmes binaires de LilyPond.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < lexer (analyseur lexical) ] | [Plus haut: Glossaire technique ] | [ output-def (définition de sortie) > ] |
altérable
Un objet est dit altérable – mutable en anglais – lorsque son état est sujet à modification après sa création, à l’inverse des objets inaltérables dont l’état est figé dès leur création.
Les propriétés altérables contiennent, pour LilyPond, des valeurs spécifiques à un objet graphique. En particulier, les listes d’autres objets ou résultats de calculs sont enregistrés sous dorme de propriétés altérables.
Voir aussi
Manuel de notation : inaltérable.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < altérable ] | [Plus haut: Glossaire technique ] | [ parser (analyseur syntaxique) > ] |
output-def (définition de sortie)
Une instance de la classe Output-def contient les méthodes et
structures des données associées à un bloc de sortie. Ces instances
sont créées par les blocs \midi, \layout et \paper.
parser (analyseur syntaxique)
Un analyseur syntaxique – parser en anglais – est un programme qui analyse la séquence de jetons produite par l’analyseur lexical pour en déterminer la structure grammaticale. Les jetons sont, pour ce faire, regroupés progressivement en tronçons plus importants, selon des règles grammaticales. Lorsque la séquence de jetons est valide, les produit final est une arborescence de jetons ayant à sa base le symbole grammatical de début. Dès lors que cette étape n’est pas concluante, le fichier est déclaré invalide ; un message approprié est alors émis. Les différents regroupements syntaxiques ainsi que les règles de construction des regroupements relatifs à la grammaire de LilyPond sont définis dans le fichier ‘lily/parser.yy’ et présentés selon la forme de Backus-Naur (BNF) à la rubrique Grammaire de LilyPond. Ce fichier est utilisé par le générateur de parser Bison lors de la construction du programme. Partie intégrante des sources, il n’est pas distribué avec les programmes binaires de LilyPond.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < parser (analyseur syntaxique) ] | [Plus haut: Glossaire technique ] | [ prob (objet de propriété) > ] |
variable de l’analyseur grammatical
Il s’agit de variables définies directement en Scheme. Dans la mesure où leur champ sémantique peut porter à confusion, il est fortement déconseillé de les utiliser tels quels.
La modification des valeurs de l’une de ces variables dans un fichier
‘.ly’ sera effective de manière globale. Les valeurs modifiées,
sauf à être explicitement remises à leur état d’origine, affecteront
tous les blocs \score rencontrés, y compris s’ils proviennent
d’autres fichiers ajoutés par une commande \include. Ceci peut
avoir des conséquences inattendues et les erreurs qui pourraient en
découler difficiles à localiser dans le cadre d’un projet d’envergure.
LilyPond utilise les variables suivantes :
- afterGraceFraction
- musicQuotes
- mode
- output-count
- output-suffix
- partCombineListener
- pitchnames
- toplevel-bookparts
- toplevel-scores
- showLastLength
- showFirstLength
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < variable de l'analyseur grammatical ] | [Plus haut: Glossaire technique ] | [ smob (objet Scheme) > ] |
prob (objet de propriété)
Les objets de propriété – probs pour PRoperty OBjects
– sont des instances de la classe Prob, une classe de base
simple pour les objets qui disposent de de listes associatives de
propriétés altérables et inaltérables ainsi que les méthodes pour les
manipuler. Les classes Music et Stream_event dérivent
d’un prob. Les instances de la classe prob se créent
aussi pour garder trace du contenu des systèmes une fois formatés et
des blocs de titrage lors de la phase de mise en forme des pages.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < prob (objet de propriété) ] | [Plus haut: Glossaire technique ] | [ spanner (bandeau) > ] |
smob (objet Scheme)
Les objets Scheme – Smobs pour ScheMe OBjects – font partie du mécanisme utilisé par l’interpréteur Guile pour exporter en code Scheme les objets C ou C++. Dans LilyPond, les smobs sont créés, grâce à des macros, à partir d’objets C++. On peut distinguer deux types d’objets smob : des smobs simples destinés aux objets inaltérables comme les nombres par exemples, et des smobs complexes utilisés pour des objets possédant une identité. De plus amples informations sont disponibles dans les sources de LilyPond, au sein du fichier ‘lily/includes/smob.hh’.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < smob (objet Scheme) ] | [Plus haut: Glossaire technique ] | [ stencil > ] |
spanner (bandeau)
Les bandeaux (spanners) constituent une classe d’objets graphiques qui ne sont pas fixés horizontalement, mais s’étendent entre deux points. On peut citer à titre d’exemple les ligatures, les liaisons quel que soit leur type, les soufflets, et même les lignes de la portée. Contrairement aux objets ponctuels (contraire des bandeaux), qui peuvent apparaître au plus deux fois à l’occasion d’un saut, comme la duplication d’une clef en fin de ligne et au début de la suivante, les bandeaux sont sectionnés en autant de tronçons que de besoin selon leur point de départ et leur terminaison, comme un crescendo qui s’étend sur trois systèmes ou les lignes de portée qui s’étendent tout au long de la partition.
Techniquement, les bandeaux se définissent comme des objets graphiques
disposant de la spanner-interface ; du côté C++ de LilyPond,
ils constituent des instances de la sous-classe Spanner de
grob. Leurs extrémités gauche et droite peuvent se récupérer ou
définir respectivement à l’aide de ly:spanner-bound et
ly:spanner-set-bound!. Leurs extrémités sont toujours des
objets ponctuels. Le parent X d’un bandeau n’a que peu de sens en termes de
musique, mais il se détermine habituellement par son extrémité gauche.
Voir aussi
Manuel de notation : Extenseurs et prolongateurs.
Référence des propriétés internes : all-layout-objects, spanner-interface.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < spanner (bandeau) ] | [Plus haut: Glossaire technique ] | [ Fonctions musicales prédéfinies > ] |
stencil
Une instance de la classe stencil comporte l’information nécessaire à l’impression d’un objet typographique. Il s’agit d’un smob simple qui contient un espace de confinement qui définit l’envergure verticale et horizontale de l’objet ainsi qu’une expression Scheme qui imprimera l’objet après évaluation. Les stencils peuvent se combiner et adopter une forme plus complexe définie par une arborescence d’expressions Scheme des stencils qui la composent.
La propriété stencil, qui permet de connecter un grob à
son stencil, est définie par l’interface grob-interface.
Voir aussi
Référence des propriétés internes : grob-interface.
| [ << Tables du manuel de notation ] | [Racine][Table des matières][Index] | [ Aide-mémoire >> ] |
| [ < spanner (bandeau) ] | [Plus haut: Glossaire technique ] | [ Fonctions musicales prédéfinies > ] |