CSL README file for windows.

Appended by Ryan Avery (ravery@umail.ucsb.edu) 10/19/2005:
#############################

Newest project file is for VisualCNet. Use of other project files may require manually adding project folders:
- IO, Instruments, Processors, Sources, Kernel, Utilities, Spatializers

In your project settings, you must have WIN32 in your preprocessor definitions (should be there by default in MS Visual compilers, but it would be good to check to make sure).

The instructions below for building in MSVC++ will work, but I recommend a different strategy to manage libraries, includes, and DLL files:

1. Put all of your .LIB files in a single folder on your hard drive, and reference that in your "Show Directories For: Library Files" list under Tools->Options.

2. Put all of your .H files in the same directory, again adding that to the "Show Directories For: Include Files" list.

3. Put all of your .DLL files in the C:\WINDOWS\SYSTEM or \SYSTEM32 directory

(Make sure you read the directions below - they are still helpful to get you up and running)



Building in MSVC++:
#############################

Firstly, you will need the latest libsndfile, Portaudio, pthreads, and fftw source as you will need to compile each package into a library and have the headers accessible to your MSVC++ Project.

It would be advisable to do the following to make the libraries accessible in MSVC++:
00) Put the .lib files and source code for these libraries under a new directory called "C:\_LIBRARIES".
01) In MSVC++ go to: Tools->Options.
02) Click on the Directories tab.
03a) For MSVC++ .NET only: Click "the Projects" folder and then "VC++ Directories" click "Library files".
03b) Under "Show Directories For:" click "Library files".
04) Add C:\LIBRARIES to the list.
05) Under "Show Directories For:" click "Include files".
06) Add the following three directories to the list (if your source directories have slightly different names that's fine):
		C:\_LIBRARIES\PORTAUDIO\PA_COMMON
		C:\_LIBRARIES\PTHREADS
		C:\_LIBRARIES\fftw-3.0.1\api
		C:\_LIBRARIES\LIBSNDFILE-1.0.4\SRC
		C:\_LIBRARIES\NEWRAN03

07) Make a copy of the pthreadsVC.dll and libsndfile.dll into the C:\_LIBRARIES directory.
08) Add the directory C:\_LIBRARIES to your PATH environment variable so that the dlls will load automatically. Otherwise, MSVC++ will give you an error at runtime.


The libraries should exist by default in your MSVC++ installation:
user32.lib wsock32.lib dsound.lib winmm.lib 
You will need to have these libraries in C:\LIBRARIES:
msvc_portaudio_ds.lib msvc_FFTW3.0.1_single.lib msvc_pthread.lib msvc_libsndfile.lib msvc_newran3.lib



Using CVS:
#############################
I suggest using a program called Eclipse. It does a lot more than cvs (it can also be used for java development), but it's relatively easy to set up. Download and unzip the package from the website eclipse.org and get the latest java SDK/runtime available at java.sun.com
Once Eclipse is started, go to the CVS Repository view and add a new repository.
Host: mat.ucsb.edu
Repository: /home/cvsroot
Connection type: extssh
You should be able to figure the rest out from there.


These is also a program called WinCVS at www.wincvs.org but it requires cygwin and python and a bunch of configuration.


