Ressourcen: Sourcecode

Aus OpenMPT-Wiki
Wechseln zu: Navigation, Suche

Wie der Name OpenMPT schon andeutet, ist diese Anwendung quelloffen. Jeder kann sich den Sourcecode runterladen und nach belieben modifizieren. Das OpenMPT-Entwicklerteam ist sehr klein (momentan sind wir zwei Leute!), deswegen werden ständig neue Helfer gesucht! Du kennst dich mit GUI-Design oder dem VST-SDK aus und du beherrschst C++? Dann bist du mehr als willkommen! Erfahrungen mit GUI-Design und VST sind natürlich kein Muss, aber wir brauchen unbedingt mehr Programmierer, die das beherrschen...

Inhaltsverzeichnis

[Bearbeiten] Was brauche ich?

  • Visual Studio 2003 oder eine neuere Version
  • TortoiseSVN oder ein beliebiger anderer SVN-Client, um die jeweils aktuelle Version des Sourcecodes über das SVN-System zu beziehen

[Bearbeiten] Den Sourcecode beziehen

  • Zuerst musst du ein Verzeichnis anlegen, in dem der Sourcecode abgelegt werden soll. Mache danach einen Rechtsklick auf dieses Verzeichnis und wähle den Menüpunkt "SVN Checkout..." aus. Die "Repository URL" für das darauf erscheinende Fenster lautet: https://modplug.svn.sourceforge.net/svnroot/modplug/trunk/OpenMPT
  • Klicke auf OK. Es werden nun alle Dateien heruntergeladen.
  • Die jeweils aktuelle Version kannst du danach mit einem Rechtsklick auf das Verzeichnis über den Menüpunkt "SVN Update..." erhalten.
  • Um OpenMPT mit ASIO- und VST-Support kompilieren zu können, musst du zunächst die jeweiligen SDKs von der Steinberg-Webseite beziehen (oder du fragst einen OpenMPT-Entwickler ;-). Die folgenden Dateien aus den SDKs müssen kopiert werden:
    • VST 2.4: Die Dateien aeffect.h und aeffectx.h aus vstsdk2.4/pluginterfaces/vst2.x in den include-Ordner von OpenMPT kopieren.
    • ASIO: Die Dateien asio.h, asiosys.h und iasiodrv.h aus common/ in den include-Ordner von OpenMPT kopieren.

[Bearbeiten] Den Sourcecode kompilieren

Directx-sdk.png
  • Um den Code zu öffnen, benötigst du Visual Studio .NET 2003/2005/2008/2010.
  • Öffne die Datei mptrack/MPTRACK.sln (wenn du VS2003 und VS2005 benutzt), mptrack/MPTRACK_08.sln (VS2008) oder mptrack/MPTRACK_10.sln (VS2010) in Visual Studio, klicke auf das Menü "Build"→"Build solution" ("Erstellen"→"Projektmappe erstellen" in VS2008 Deutsch), um den Sourcecode zu kompilieren. Beachte, dass dieser Vorgang mehrere Minuten brauchen kann!
  • Je nach Visual Studio-Version wird der Sourcecode eventuell nicht direkt laufen. Bekannte Gründe hierfür sind:
    • VST 2.4- und ASIO-SDKs nicht heruntergeladen: Welche Dateien du benötigst und woher du die bekommst, wird weiter oben erklärt. Alternativ kannst du auch OpenMPT ohne VST- und ASIO-Support kompilieren. Dazu müssen die Konstanten NO_VST und NO_ASIO in der Datei StdAfx.h definiert werden.
    • Datei dsound.h nicht gefunden: Du benötigst das DirectX SDK. Siehe nächster Schritt, um den Pfad zum SDK einzutragen. Alternativ kannst du OpenMPT ohne DirectSound-Support kompilieren. Dazu muss die Konstante NO_DSOUND in der Datei StdAfx.h definiert werden. Sofern möglich, empfiehlt es sich, das DirectX-SDK vor Visual Studio zu installieren, denn so musst du dich nicht um das Eintragen der korrekten Pfade in Visual Studio kümmern.
    • Sofern du es nicht schon mit Visual Studio installiert hast, benötigst du noch das Microsoft Platform SDK. Sobald es installiert ist, musst du prüfen, ob die Platform SDK Lib- und Include-Pfade in der Lib- und Include-Verzeichnisliste unter "Tools"→"Options" und dann "Projects"→"VC++ Directories" ("Extras"→"Optionen und "Projekte und Projektmappen"→"VC++-Verzeichnisse"→"Includedateien" in VS2008 Deutsch) ganz oben stehen. Je nach Installation kann dies schon der Fall sein. Sowohl unter VS2008 als auch VS2010 war das SDK bei mir bereits installiert.

[Bearbeiten] Patches beisteuern

Falls du einen Patch für OpenMPT erstellt hast, kannst du mir diesen zusenden.

[Bearbeiten] Aktuell bleiben

Um immer automatisch über die neuesten Commits informiert zu werden, kannst du die SVN-Commit-Mailingliste abonnieren.