Liste alphabétique des fonctions du module moduletabla.py :
Fonctions du module moduletabla.py
Certains arguments des fonctions sont des tablatures écrites avec les conventions proches du langage abc, que vous trouverez dans la page :
Conventions d'écriture des tablatures
Cela permet de saisir une note sur 4 octaves avec c, pour la note do la plus basse et B' pour la plus haute.
c, c#, d...A' a#' B' représentent les notes des 4 gammes chromatiques écrites avec des dièses.
c, d-, d...B-' B' représentent les notes des 4 octaves chromatiques écrites avec des bémols
On peut écrire des notes avec double dièses et double bémol.
0 représente le bécare.
La fonction retourne l'entier degnote, qui caractérise la note.
Ce nombre vaut 36 pour c, 37 pour c#,...70 pour A#' 71 pour B'
La notation chiffrée des notes permet d'obtenir facilement la notation des intervalles,des accords, des gammes dans toutes les tonalités...
Elle rend immédiate la transposition des tablatures.
Par contre, elle n'est pas bien adaptée à la lecture musicale.
On reviendra à la notation anglosaxonne des notes avec des lettres par la fonction decode.La fonction decode est l'inverse de la fonction code.
Elle retourne la note qui correspond à l'entier degnote,écrite en notation anglosaxonne avec des dièses.
La fonction decodebemol(degnote) renvoie la note codée avec des bémols.
D'une manière générale, les fonctions dont le nom commence par de comme decode, correspondront à des traductions des notes chiffrées en notes codées en lettres.
Une tablature est une chaîne de caractères qui contient une suite de notes écrites en notation anglosaxonne.
Son code est placé dans le tableau d'entier degree.
Ainsi, la fonction decodedegree(degree) retournera la chaîne tabla de notes chiffrées en une suite de notes écrite avec des dièses.
De même, decodedegreebémol(degree) retournera la tablature tabla écrite avec des bémols.
La suite des entiers 32 33...70 71 représente le codage de 4 gammes chromatiques.
Elle permet de construire facilement des gammes majeures, mineures harmonique et milodique...dans tous les tons.
Par exemple, la tablature de la gamme cdefgab a pour code le tableau gamme qui contient les entiers 60 62 64 65 67 69 71
Sa transposition s'obtient immédiatement en ajoutant aux notes du tableau gamme, le nombre de demi-tons de la transposition.
Plus généralement, la fonction transpo(degree, idemiton) transpose le tableau degree en ajoutant idemiton à chaque élément du tableau degree.
Les accords constitutifs d'une tonalité s'obtiennent immédiatement comme suites de tierces, en prenant les éléments du tableau gamme de deux en deux.
Ainsi, l'accord situé sur le premier degré de la gamme de Do majeur est le tableau degree qui contient les entiers 60 64 67
Les renversements des accords s'obtiennent immédiatement par permutation circulaire des éléments du tableau degree.
Les arpèges sont donnés par combinaisons des éléments du tableau degree. Plus généralement,on peut répéter une combinaisons de notes avec un motif, en se donnant un ensemble d'indices du tableau degree que l'on peut répéter et translater.
Par exemple, la fonction gammemotif(ton,mode,motif) permet de jouer des motifs de gamme de la tonalité définie par son ton et son mode.
Elle permet de créer des exemples pour travailler la technique d'un instrument.
On peut indiquer le rythme en écrivant une durée à la suite de chaque note d'une tablature, comme c/2d/4e/4g
4 désigne la ronde, 2 la blanche...1/2 la croche, 1/8 la double croche...
Pour simplifier l'écriture, la noire correspond au chiffre 1 que l'on n'écrit pas à la suite d'une note.
Pour la création du fichier .mid de la tablature, on doit séparer le rythme des notes.
La fonction voix(tabla) retourne le tableau degree de la tablature sans son rythme et durvoix(tabla) retourne le tableau dur des durées des notes.
La séparation des notes et du rythme permet de changer facilement de rythme, sans changer la tablature des notes.
On indiquera un motif de rythme dans une chaîne de caractères, en écrivant une suite de durées séparée par des espaces, comme par exemple 1/2 1/4 1/4 1 3:
L'indication 3: signifie qu'il faut répéter 3 fois le motif 1/2 1/4 1/4 1
On peut préciser le nombre de voix entre 1 et 4, par l'indication v1 v2 v3 ou v4, suivie par la tablature de la voix concernée.
Par exemple, v1cegv2C/2D/2GE représente une portion de tablature à 2 voix, qui peut correspondre aux 2 mains pour le piano.
On peut aussi jouer des notes simultanées en les plaçant entre crochet comme [ce] par exemple.
On indique un choix d'un instrument midi par i: suivi d'un nombre inférieur à 129 comme i:65cde par exemple.
On indique un tempo par t: suivi d'un nombre inférieur à 240 comme t:120 par exemple.
Les fonctions instru(tabla) et temp(tabla) retourne les paramètres entiers program et tempo, qui seront utilisés pour la création du fichier .mid de la tablature.
La fonction voixtabla(tabla) et la fonction musichord(tabla,rythme, intervalle) produisent un fichier dont le nom est tabla.mid par défaut.
Elles utilisent respectivement des fonctions des modules midiutil et musicpy.
La chaîne de caractères rythme contient la suite des durées des notes.
La chaîne intervalle contient la suite des intervalles entre les notes, qui permet de les séparer ou de les superposer.