Building Jazz++

Jazz++ Midi Sequencer

Building Jazz++

Jazz++ uses a non-stock build of the wxWidgets library. See the wxWidgets build instructions to create and install the non-stock wxWidgets build. This non-stock wxWidgets build must be available before using the instructions on this page.

Building Jazz++ for Windows

There are Visual Studio .NET 2005 (VC8) and Visual Studio .NET 2008 (VC9) solution and project files available for building on a Windows based PC. These solution and project files have been tested on Windows XP and Vista.

Use a subversion client to check out the trunk version of Jazz++. TortoiseSVN is a good Subversion client for Windows and is integrated with the Windows Explorer.
The Visual Studio .NET 2005 solution file (JazzPlusPlus-VC8.sln), can be found in the jazzplusplus/trunk/jazz/vc8 directory.
The Visual Studio .NET 2008 solution file (JazzPlusPlus-VC9.sln), can be found in the jazzplusplus/trunk/jazz/vc9 directory.

Each of these solutions rely on the existence of an environment variable called EXT_PKGS. This environment variable indicates the location of external packages used by Jazz++. wxWidgets is an example of an external package used by Jazz++. If you followed the wxWidgets build instructions found on this web site, you should set this environment variable to C:\ExternalPackages. The project settings rely on the wxWidgets subdirectories following the naming convention suggested in the wxWidgets build instructions (wxMSW-2.8.7-VC8 for Visual Studio .NET 2005 and wxMSW-2.8.7-VC9 for Visual Studio .NET 2008).

Building Jazz++ for Linux

I'm going to assume you do not have root privileges on your Linux box. Given this assumption, we'll create a directory called Jazz++ under your home directory. This directory will hold the source tree that will be obtained using Subversion, a build directory call Build and a test installation directory called TestInstall that will be generated by the build sequence. The need for the source directory is obvious. Separating the build directory from the source tree will allow you to remove the build output without damaging the source tree. The installation directory will be created during the build process, and its location will remove the need for root privileges on your Linux box.

Create a Jazz++ directory under your home directory and change directory to the newly created directory.
```
cd
mkdir Jazz++
cd Jazz++
```
Checkout the HEAD version of Jazz++ using the following command. You must have a Subversion client loaded on your machine.
```
svn checkout https://jazzplusplus.svn.sourceforge.net/svnroot/jazzplusplus/trunk/jazz jazz
```
Change directory to the created jazz directory and run the bootstrap script.
```
cd jazz
./bootstrap
```
Change directory to Jazz++ under your home directory and create a directory called Build that is in parallel with the jazz source tree directory, and change directory to that location.
```
cd ..
mkdir Build
cd Build
```
Run the configure command generated by the ./bootstrap script with the following options.
```
../jazz/configure \
  --prefix=$HOME/Jazz++/TestInstall \
  --enable-debug \
  --enable-alsa \
  --enable-sequencer2
```
The prefix option is used so that the make install step found later in these instructions, will not require root privileges. It is also useful to run make install with this prefix option, so that the resulting install will create a copy of the jazz.cfg file that is independent of the one distributed in the source tree. The configuration file is modified by the Jazz++ binary. If the version of the jazz.cfg file in your svn working directory was altered, this could lead to update conflicts when updating the code using Subversion. This may lead to problems using Jazz++ as a result.
Run make using the following command. This will write a file called BuildLog that may be useful if you run into trouble.
```
make 2>&1 | tee BuildLog
```
If all goes well with the build, install Jazz++ using the following command.
```
make install
```

You should now have a jazz binary in $HOME/Jazz++/TestInstall/bin. If the code prompts you for a Jazz++ configuration file, select the jazz.cfg file found in $HOME/Jazz++/TestInstall/share/Jazz++.

Building Jazz++ for Mac OS X 10.5.2

Checkout the HEAD version of Jazz++ using the following command.

svn checkout https://jazzplusplus.svn.sourceforge.net/svnroot/jazzplusplus/trunk/jazz jazz

Change directory to the created jazz directory and run the bootstrap script.
```
cd jazz
./bootstrap
```
Change directory to Jazz++ and create a directory called Build in parallel with the jazz directory and change directory to that location.
```
cd ..
mkdir Build
cd Build
```
Run the configure command generated by the ./bootstrap script with the following options.
```
../jazz/configure \
  --prefix=$HOME/Jazz++/TestInstall \
  --enable-static=yes \
  --enable-shared=no
```
The prefix option is used so that the resulting install will not use the jazz.cfg file from the svn repository. The configuration file is modified by the Jazz++ binary. If the version in your svn working directory was altered, this could lead to update conflicts when updating the code. This may lead to problems using Jazz++.
Run make using the following command. This will write a file called BuildLog that may be useful if you run into trouble.
```
make 2>&1 | tee BuildLog
```
If all goes well with the build, install Jazz++ using the following command.
```
make install
```

This project is hosted by SourceForge. Special thanks for SourceForge and the OSDN.

Jazz++ MIDI Sequencer

Building Jazz++

Building Jazz++ for Windows

Building Jazz++ for Linux

Building Jazz++ for Mac OS X 10.5.2