Le w'eb : Librairie Trommler pour Python

Librairie Trommler pour Python

Mode d'emploi

Le module s'appelle Trommler et il est dans le package Trommler, donc pour l'importer :
import Trommler.Trommler, ou
from Trommler.Trommler import ...

Le package est constitué d'un module contenant la définition de classes permettant d'écrire et de lire des fichiers "song" Trommler (morceaux).

Plus précisément, le package contient les classes suivantes :

• TrommlerSong : une instance de cette classe est un morceau Trommler. Cette classe sait lire des fichiers Trommler (par l'intermédiaire de la classe TrommlerFile) et les écrire.
  • Pour lire un fichier, faites par exemple :

    sng = TrommlerSong(filename="/ou/se/trouve/le/fichier")

  • Pour créer un nouveau morceau ayant pour titre "Symphonie no3", au tempo 120 avec 300 mesures, faites :

    sng = TrommlerSong(title="Symphonie no3", tempo=120, steps=300)

  • Pour modifier le morceau, vous disposez des méthodes :
    • addDrumSample(sample), où sample est un instance de la classe TrommlerDrumSample.
    • addPattern(pattern), où pattern est un instance de la classe TrommlerPattern.
  • Pour interroger le morceau, vous disposez des méthodes :
    • getTitle() qui rend le titre du morceau
    • getTempo() qui rend le tempo du morceau
    • getSteps() qui rend le nombre de mesures dans le morceau
    • getSample(sampleNum) qui rend l'échantillon au rang sampleNum dans le morceau
    • getPattern(pattNum) qui rend le pattern au rang pattNum dans le morceau ; à ne pas confondre avec le suivant...
    • getStep(stepNum) qui rend le le pattern à la mesure stepNum dans le morceau
  • Et finalement, ce qui doit être écrit dans le fichier Trommler est simplement la représentation du morceau sous forme de chaîne. Donc, utilisez les "backquotes" ; par exemple :

    file.write(`song`)

   

• TrommlerDrumSample : une instance de cette classe est un échantillon dans un morceau Trommler. Attention: l'échantillon est toujours créé pour un morceau donné à un rang donné dans le morceau. Il ne peut donc pas être partagé entre plusieurs morceaux. Pour créer un échantillon au rang sampNum dans le morceau, contenu dans le fichier /home/samples/drums/TR909/Kick.snd, avec pour titre Deep kick et au volume 400 (un peu excessif, là, peut-être...), faites :

samp = TrommlerDrumSample(sampNum, "Deep kick", "/home/samples/drums/TR909/Kick.snd", 400)

Pour interroger un échantillon, utilisez les méthodes :

• getNumber(), qui rend le numéro d'ordre de l'échantillon
• getName(), qui rend le nom de l'échantillon
• getFile(), qui rend le nom du fichier pour l'échantillon
• getVolume(), qui rend le volume de l'échantillon

 

• TrommlerPattern : une instance de cette classe est un pattern dans un morceau Trommler. Attention: le pattern est toujours créé pour un morceau donné à un rang donné dans le morceau. Il ne peut donc pas être partagé entre plusieurs morceaux. Pour créer un pattern au rang pattNum dans le morceau, avec pour titre Basic drums et de longueur 4 unités avec 6 battements par unité, faites :

patt = TrommlerPattern(pattNum, "Basic drums", 4, 6)

Pour ajouter des notes à un pattern, utilisez la méthode addNote(sampNum, noteNum), qui ajoute la note de rang noteNum dans le pattern pour l'échantillon numéro sampNum.

Pour interroger un pattern, utilisez les méthodes :

• getNumber(), qui rend le numéro d'ordre du pattern
• getName(), qui rend le nom du pattern
• getUnits(), qui rend le nombre d'unités dans le pattern
• getBPUs(), qui rend le nombre de batte,ents par unité dans le pattern
• getBeat(sampNum, noteNum), qui rend 1 si la note de rang noteNum est jouée pour l'échantillon de rang sampNum dans le pattern.

Il existe également une méthode isSame(pattern), qui rend 1 si les notes du pattern en paramètre sont identiques à celles du pattern receveur (les autres caractéristiques ne sont pas comparées).

Téléchargement

Télécharger le package Trommler pour Python

Pour fonctionner, ce package doit être placé quelque part dans votre PYTHONPATH.