5.2.3 Types de propriétés
Nous avons vu jusqu’à maintenant deux types de propriétés :
nombre et symbole. Pour pouvoir fonctionner, la valeur
associée à une propriété doit correspondre au type attendu et suivre les
règles liées à ce type. Le type de propriété est toujours donné entre
parenthèses après le nom de propriété dans la RPI. Voici une liste des
différents types de propriétés, avec les règles qui les régissent et
quelques exemples d’utilisation. Il faut, bien sûr, toujours ajouter un
symbole hash (#) devant ces valeurs lors de la saisie de
la commande \override, ce même si cette valeur comporte
déjà un # en premier caractère. Les exemples ici présentés
ne sont que de simples illustrations ; l’utilisation de Scheme
pour obtenir des valeurs fait l’objet de la rubrique
Scheme et les calculs.
| Type de propriété | Règles | Exemples |
|---|---|---|
| Booléenne (Boolean en anglais) | Vrai (true en anglais) ou Faux (false en anglais),
sous la forme #t ou #f | #t, #f |
| Dimension (en espaces de portée) | Un nombre décimal (en unités de lignes de portée) | 2.5, 0.34 |
| Direction | Une direction valide ou son équivalent numérique (0
ou CENTER indiquent une position neutre) | LEFT, CENTER, UP, 1, -1 |
| Entier (Integer en anglais) | Un nombre entier | 3, -1 |
| Liste | Une séquence de constantes ou symboles séparés par une espace, encadrées par des parenthèses et précédées par une apostrophe | '(left-edge staff-bar), '(1), '(),
'(1.0 0.25 0.5) |
| Markup (ou étiquette) | Toute commande \markup valide | \markup { \italic "cresc." }, "bagpipe" |
| Durée (Moment en anglais) | Une durée de note construite avec la fonction make-moment | (ly:make-moment 1/4), (ly:make-moment 3/8) |
| Nombre | Une valeur positive ou négative, qui peut être décimale | 3, -2.45 |
| Paire (de nombres) | Deux nombres séparés par « espace point espace », encadrés par des parenthèses et précédés par une apostrophe | '(2 . 3.5), '(0.1 . -3.2) |
| Symbole | L’un des symboles autorisés pour cette propriété, précédé par une apostrophe | 'italic, 'inside |
| Inconnu (Unknown en anglais) | Un processus, ou #f pour empêcher toute action | bend::print, ly:text-interface::print, #f |
| Vecteur | Des constantes encadrés par #(…) | '#(#t #t #f) |
Voir aussi
Manuel d’extension : Tutoriel Scheme.