Developer Information

Public Site	Documentation

CVS

The module 'nmedit' contains the code currently being developed. Instructions on how to access CVS can be found at the SF CVS page.

Build dependencies

A C++ compiler
TCL 8.x
Flex
Bison
SWIG
SCons

Build with SCons

To build everything recursively:

./sconsbuild.sh

The parameter PREFIX can be used to set the installation path.

./sconsbuild.sh PREFIX=/usr

To install all software:

./sconsbuild.sh install

To clean all build directories:

./sconsbuild.sh -c

The same command line parameters work with scons directly if you want to build each library and program separately.

cd libs/libppf
scons install

NetMidi Server for Windows

NetMidi is a simple MIDI over TCP/IP protocol. The NETMIDI driver in libnmProtocol needs a running NetMidi server to be able to communicate with the NM.

Jan Punter has written a NetMidi server for Windows which is available at http://www.iaf.nl/Users/BlueHell/prot/netmidi.zip.

To download patches in Windows, configure and start the NetMidi server. Then run patchloader.exe from a dos prompt.

patchloader.exe -d NETMIDI -i localhost:1024 Bahia.pch

Web site

The website is stored in the CVS module 'website2' (the older website is stored in module 'website'). The Forrest framework is used to manage the site.

After checking out the site, make sure you have the skin installed, then run a forrest bot to check the site locally.

forrest install-skin
forrest run

After that the site can be build and uploaded with a command such as (change login name 'wirez' to your own):

ant
scp -r build/site/* wirez@nmedit.sf.net:/home/groups/n/nm/nmedit/htdocs/

Important: Do not build the website with the command forrest. Only use the command ant. The environment variable FORREST_HOME must be set to the forrest directory.

Nomad

Depencies

Nomad has following depencies

jNmProtocol
jPdl
jPatch, Nord Modular 3.03 implementation
jSynth, Nord Modular 3.03 implementation
jTheme
jMisc
XPP3 XmlPullParser
JGoodies looks-2.0.2, forms-1.0.7

The JAR files must be available in the directory 'nomad/lib'.

Build libraries

Installing required libraries:

Following jar files must be present in the directory nomad/lib.

have to be added by the user:
jnmprotocol.jar
jpdl.jar
jpatch.jar
jsynth.jar
xpp3_min-1.1.3_8.jar
jmisc.jar
jpatch.nordmodular.jar
jsynth.nordmodular.jar
			
provided by nomad:
looks-2.0.2.jar
forms-1.0.7.jar

The Nomad ANT script can help you compiling and installing the required libraries. First assure yourself that following directories are checked out from CVS (and are in the same folder)

nmedit/libs
nmedit/nomad

Open the nomad directory:

cd nomad

Build and install the required libraries:

ant build-libraries
ant install-libraries

You can uninstall these libraries by calling:

ant uninstall-libraries

You can clean the project directories of the libraries by calling:

ant clean-libraries

Build Nomad

Building nomad. This required the libraries to be installed (like described above).

Open the nomad directory:

cd nomad

Build the project:

ant

Run nomad:

ant nomad

Optional: Run nomad user interface editor:

ant editor

Clean up the project / Remove built files: (Note this step does clean up the directory nomad/lib)

ant clean