FREEVERB3_VST
=============
This is freeverb3_vst, 3.x.x .

Freeverb3_vst is a VST plugins package utilizing freeverb3 library
which performs many types of audio signal data processing.

Please see the tutorial page of the freeverb3 website for general information.

LIBRARY DLL (for Windows)
=========================

All libraries on which freeverb3_vst depends are statically linked by default and there are
no need to install some dlls. But some binary distribution packages may be built on
MinGW versions which do not support static library linking.
So, you may have to install the MinGW-w64 runtime DLL files to Windows system directory
or program directory containing programs' exe file if you get some "DLL not found" error messages.
You do not need to install dlls if you do not get those DLL error messages.

There are 32bit and 64bit version of the MinGW-w64 runtime dll files.
The 32bit distribution binary package contains the 32bit dll files and
the 64bit one contains the 64bit ones. So, do not mix those dll files.

- On 32bit system
The 32bit dll files should be installed to %SystemRoot%\System32.
The 64bit dll files cannot be installed.
- On 64bit system
The 32bit dll files should be installed to %SystemRoot%\SysWOW64.
The 64bit dll files should be installed to %SystemRoot%\System32.

You can use the SetupMinGWRuntime-*.exe to install the MinGW-w64 runtime DLL files
to system directory, which can be retrieved from freeverb3 sourceforge download page.
You should use the SetupMinGWRuntime-*.exe if you are not sure where to install those
MinGW-w64 runtime dll files. The setup program supports both 32bit and 64bit system.

How to build binaries
=====================

This VST plugin can be built on the following environment.

- MinGW-w64 (32bit/64bit) cross compiler on Linux (or most UNIX platforms)
  [http://mingw-w64.sourceforge.net/]

- Apple GCC cross compiler with Mac OS X SDK

The versions over MinGW-w64-1.0/gcc-4.5.0 Apple_gcc-4.0.1/odcctools-698,758/SDK-10.4u/SDK-10.5 are supported.
The configure example shell scripts are in the cross-sh directory.

If you build these binary packages normally on MinGW, the VST plugin dlls and exes
will depend on some dlls of MinGW-w64. These MinGW-w64 dlls can be installed
using the installer on the freeverb3's SF.net download page.
You can delete these depedencies by replacing some files in MinGW described below,
but you will be warned that this way may cause some problems on multithreaded programs.
The -static-libgcc and -static-libstdc++ options should be used to solve this problem,
but these options are not working correctly on some cases.

 1. replace libstdc++.dll dependency

 move $ARCH/lib/libstdc++.dll.a -> $ARCH/lib/libstdc++.dll.a.orig
 link $ARCH/lib/libstdc++.a -> $ARCH/lib/libstdc++.dll.a

 2. replace libgcc.dll dependency

 move $ARCH/lib/libgcc_s.a -> $ARCH/lib/libgcc_s.a.orig
 link lib/gcc/$ARCH/$VERSION/libgcc.a -> $ARCH/lib/libgcc_s.a

SOURCES
=======

The source distribution package contains libsndfile/libsamlerate
sources and fftw3 libraries. Original sources are available from following sites.

- FFTW3
  [http://www.fftw.org/]

- libsamplerate
  [http://www.mega-nerd.com/SRC/]

- libsndfile
  [http://www.mega-nerd.com/libsndfile/]

- libexpat
  [http://expat.sf.net/]

This distribution package contains VSTGUI/VST sources patched for MinGW.

Please report any bugs or advices.

lib and include directory will be used to build binaries.

MINGW
=====

- Minimalist GNU for Windows [http://www.mingw.org/]

- Minimalist GNU for Windows 64 [http://sourceforge.net/projects/mingw-w64/]

LICENSE
=======

See the AUTHORS.txt

CONTACTS AND SUPPORT
====================

freeverb3 was written by Teru KAMOGASHIRA.
The freeverb3 homepage is at:

	http://freeverb3.sourceforge.net/
	http://sourceforge.net/projects/freeverb3/

