From: pin Date: Mon, 17 May 2010 08:38:32 +0000 (+0000) Subject: Ajout commentaires. X-Git-Url: https://scm.cri.mines-paristech.fr/git/minwii.git/commitdiff_plain/d2d0e07ee1695d69a6954133c7997974b55c62c8?ds=inline;hp=3349512a69489bc7679799d05f21fb11abaec90d Ajout commentaires. git-svn-id: https://svn.cri.ensmp.fr/svn/minwii/trunk@165 fe552daf-6dbe-4428-90eb-1537e0879342 --- diff --git a/src/app/logfilereader.py b/src/app/logfilereader.py index 2df5653..f5f5d54 100755 --- a/src/app/logfilereader.py +++ b/src/app/logfilereader.py @@ -16,8 +16,14 @@ import pygame SUPPORTED_FILE_HEADER = 'ENV winwii log format version : 1.0' class LogFileReader(object) : + """ + classe utilitaire pour l'accès aux données d'un fichier de log MinWii. + """ def __init__(self, logfile) : + """ logfile : chemin d'accès au fichier de log MinWii. + le format supporté est actuellement la version 1.0 uniquement. + """ if isinstance(logfile, str) : self.logfile = open(logfile, 'r') else : @@ -28,6 +34,7 @@ class LogFileReader(object) : def getSongFile(self) : + "retourne le chemin d'accès au fichier musicxml de la chanson" f = self.logfile pos = f.tell() @@ -40,6 +47,7 @@ class LogFileReader(object) : return songfile def getSoundFontFile(self) : + "retourne le chemin d'accès au fichier de la soundfont (*.sf2)" f = self.logfile pos = f.tell() f.seek(0) @@ -51,6 +59,7 @@ class LogFileReader(object) : return soundFontFile def getBank(self) : + "retourne le paramètre bank du synthétiseur (entier)" f = self.logfile pos = f.tell() f.seek(0) @@ -62,6 +71,7 @@ class LogFileReader(object) : return int(bank) def getPreset(self) : + "retourne le paramètre preset du synthétiseur (entier)" f = self.logfile pos = f.tell() f.seek(0) @@ -73,6 +83,7 @@ class LogFileReader(object) : return int(preset) def getScreenResolution(self) : + "retourne la résolution écran (tuple de deux entiers)" f = self.logfile pos = f.tell() f.seek(0) @@ -84,6 +95,7 @@ class LogFileReader(object) : return screenResolution def getFirstEventTicks(self) : + "retourne le timecode du premier événement (entier)" f = self.logfile pos = f.tell() f.seek(0) @@ -105,6 +117,11 @@ class LogFileReader(object) : return line def getEventsIterator(self) : + """ Retourne un itérateur sur les événements. + Chaque itération retourne un tuple de 3 éléments : + (timecode, nom_événement, données) avec le typage : + (entier, chaîne, chaîne) + """ self.logfile.seek(0) while True : try : @@ -116,9 +133,11 @@ class LogFileReader(object) : continue try : ticks, eventName, message = l.split(None, 3)[1:] + ticks = int(ticks) yield ticks, eventName, message except ValueError : ticks, eventName = l.split(None, 3)[1:] + ticks = int(ticks) yield ticks, eventName, '' @@ -154,7 +173,6 @@ class LogFilePlayer(PlayingScreenBase) : for ticks, eventName, message in eIter : t0 = pygame.time.get_ticks() - ticks = int(ticks) if eventName == 'COLSTATECHANGE' : parts = message.split(None, 4) if len(parts) == 4 : @@ -179,8 +197,7 @@ class LogFilePlayer(PlayingScreenBase) : self.cursor.setPosition(pos) - pygame.event.clear() # à virer - #EventDispatcher.dispatchEvents() + pygame.event.clear() dirty = self.draw(pygame.display.get_surface()) pygame.display.update(dirty) @@ -191,12 +208,5 @@ class LogFilePlayer(PlayingScreenBase) : pygame.time.wait(delay) previousTicks = ticks - #print ticks, eventName, message - - #while self._running : - # EventDispatcher.dispatchEvents() - # dirty = self.draw(pygame.display.get_surface()) - # pygame.display.update(dirty) - # clock.tick() \ No newline at end of file