Skip to content

Latest commit

 

History

History
197 lines (136 loc) · 7.3 KB

README.md

File metadata and controls

197 lines (136 loc) · 7.3 KB

Aperçus

Installation

Releases

Quand une version potable du programme est compilée sous windows elle est disponible en release ici :

Avec ces versions il suffit de décompresser et d'utiliser ! ;)

Sinon cloner le git (ou télécharger le zip de l'état actuel)

Windows

  • 64 bits : copiez bass.dll et bassasio.dll depuis le repertoire win64 vers la racine du projet et lancez Synthesizer Millenium x64.exe Si vous souhaitez recompiler vous aurez besoin de Visual Studio 11 (2012), il vous suffit d'utiliser le fichier de projet fournis dans le dossier "visual"

  • 32 bits : copiez bass.dll et bassasio.dll depuis le repertoire win32 vers la racine du projet et lancez Synthesizer Millenium.exe Si vous souhaitez recompiler vous aurez besoin de MinGW, il vous suffit ensuite d'utiliser la commande "make win32"

Attention si vous recompilez le projet une version modifié (hacké) de la sfml est utilisé (incluse dans libwin32 et libwin64) La compilation avec la version officielle fonctionnera mais le redimensionnement de la fenetre sera pénible.

Linux

  • 32 bits : compilez le projet avec la commande "make linux32" puis lancez "./test.x32". Vous devez avoir la version officielle (non compatible ENIB) de la SFML 2.1 ainsi que toutes ces dépendances (OpenGL, X11, Xrand, freetype)

  • 64 bits : compilez avec la commande "make linux64" puis lancez "./test.x64" Vous devez avoir la version officielle (non compatible ENIB) de la SFML 2.1

  • 64 bits ENIB : lancez la commande "make linux64enib" puis lancez "./test.enib" Attention la version 2.1 statique sans support des fonts (sans freetype) est utilisé lors de la compilation. Elle est incluse dans le répértoire liblinux64/ENIB Plus d'infos sur cette version modifié de la SFML 2.1 ici https://github.com/lamogui/SFML_2.1_ENIB

MACOSX

Pas de support

Utilisation

Par défaut l'instrument lancé est le NELEAD6 mais il est possible de lancer d'autres instruments Notament Puresquare en tapant en ligne de commande ./SynthesizerMillenium puresquare

Modifiez les paramètres à l'aide des potards (souris) et appuyez sur les touches : QZSEDFTGYHUJKOLPM pour jouer les différentes notes. Les instruments sont polyphoniques il est donc possible de jouer plusieurs notes en même temps.

Vous pouvez à tout moment sauvegarder/charger la configuration courante du synthétiseur via le bouton enregistrer/ouvrir PRESET, les fichiers prst n'ont pas d'information sur l'instrument correspondant il peuvent donc être utilisez sur n'importe quel instrument.

Le dossier "presets" contients quelques presets pour l'instrument NELEAD6.

Vous pouvez également charger et interpréter des fichier MIDI (seuls les MIDI format 1 et 0 à plus ou moins 140 bpm sont supportés pour l'instant). Le dossier "musics" contient quelques morceaux compatibles avec le synthétiseur. Il également possible de s'enregistrer et d'exporter le résultat dans un fichier MIDI (format 1).

Configuration

Le projet à un fichier de configuration nommé settings.ini Il suffit de modifier les valeurs des paramètre à la main via un bloc note.

Driver ASIO

Si vous avez un driver ASIO (sous windows) comme par exemple ASIO4ALL il est possible de l'utiliser en changeant la ligne UseASIODriver=False; en True...

Driver

Si vous n'utilisez pas de driver ASIO, vous pouvez changer de driver Pour l'instant il y a 3 drivers différents :

  • SFML
  • BASS
  • WINMM (Seulement pour windows)

Entrez simplement le driver a utiliser dans le fichier ini. Notez que le driver BASS est bugué et ne sera plus supporté dans les versions futures

Je recommande donc SFML sous Linux et WINMM sous windows...

FFT

Par défaut le programme est réglé sur une FFT qui utilise beaucoup d'échantillons, Cela peut causer des lags si vous utilisez à la fois : la FFT, des Releases Times très long combinés à la lecture d'un fichier MIDI. Vous pouvez augmenter les performances en diminuant le nombre d'échantillons.

Un exemple qui marche bien:

Samples = 4096;

Notez qu'il faut que la valeur soit une puissance de 2 codé sur un nombre de bit paire (Il y a un bug avec les nombres de bit impairs)

Repertoires

  • build : contient les fichiers compilés par mingw/gcc
  • img : contient les textures et captures d'écrans
  • fonts : contient les fonts utilisés par le projet
  • musics : contients quelques musiques au format MIDI
  • presets : contients des presets pour l'instrument NELEAD6
  • include : contient les déclarations (hpp) et les en-têtes des librairies
  • libXXXX : contient les librairies pour la platforme XXXX
  • mis : contient l'UML
  • src : contient les fichiers sources du projet
  • visual : contient les fichiers pour compiler avec visual studio 11 (2012) en 64bits.

UML et MODELIO

Les fichiers concernant la MIS sont dans le repertoire "mis" :

  • Les dossiers des différentes versions du projet (Uniquement V1 et V1.1 pour le moment)
  • Fichiers Modelio les plus récents

Pour ouvrir l'uml il vous faut : Modelio 3.1.0, ensuite cliquez sur File -> Switch Workspace -> Selectionner le dossier workspace dans "Documents\Github\POO\mis\workspace"

Les fichiers modelio ne contienne pas les diagrammes UML pour une version spécifique... Consultez les dossiers pour cela...

Attention ! Le code est actuellement en version 1.7 certaines classes ont été rajoutés par rapport à l'UML de la V1.1 mais le fonctionnement des classes présentes dans la V1.1 reste le même (il y a eu uniquement des ajouts)

Enfin il existe une doc du projet disponible directement sur GitHub section wiki

Textures

Background : Gabriel Gajdoš (http://pipper-svk.deviantart.com/art/Hyperdrive-411313660)

Bugs et support

La version la plus supportée est la version WIN32, si vous voulez être sur que le programme fonctionne utilisez cette version

Les versions linux ne sont que très peu testées et le son est défectueux.

La version linux64enib ne supporte pas le chargement des fontes.

S'impliquer dans le projet

Vous voulez coder quelquechose pour le projet ? permettez moi de vous rediriger vers ce merveilleux wiki pour savoir où commencer... Une fois que vous maitrisez le code vous pouvez par exemple faire un TODO voir ci-dessous Procédez par un classique Fork puis Pull Request et je vous ajouterai sur les contributeurs

TODO

  • Coder le Fader
  • Réecrire le code qui lit les fichiers midi
  • fixer une convention sur les notations des méthodes et attributs et utiliser la même PARTOUT
  • Indenter/commenter
  • Finir le NELead6
  • Coder la méthode bool readSignal(Signal& signal) dans AudioStream.