Building MRIConvert/mcverter From Source
========================================
This document details the packages and configuration needed to build MRIConvert and mcverter from source. It applies to versions prior to 2.1.0.


Requirements
============
The MRIConvert source package
A C++ development system
CMake 2.8.2 or greater
wxWidgets 2.8.12, or 2.9.4 for OS X
Boost 1.52.0


CMake
=====
The generic installation is suitable in most cases. If your platform application manager does not provide version 2.8.2 or greater, installation from source is recommended.


wxWidgets
=========
We recommend building this package from source. This must be built with Unicode support. Building as a static library is also recommended. Configuration details for different platforms are listed below.

Linux
-----
Install with the wxGTK source package.
./configure --prefix=/usr --disable-shared --enable-unicode --with-libjpeg=builtin --with-libregex=builtin --with-libexpat=builtin --with-libtiff=builtin --with-libpng=builtin --with-zlib=builtin
make
make install

OS X
----
Install with the wxWidgets source package.
./configure --disable-shared --enable-universal_binary=x86_64 --enable-cmdline --enable-dnd --enable-checkbox --enable-checklst --enable-button --with-osx_cocoa --prefix=/usr
make
make install

Windows
-------
1) Run installer wxMSW-2.8.12-Setup.exe. Recommended location is the root of the system drive.
2) Create wxWidgets-2.8.12/include/wx/setup.h, add a single line:

#include <wx/msw/setup.h>

3) Modify wxWidgets-2.8.12/include/wx/msw/setup.h to set appropriate options:

#define WXWIN_COMPATIBILITY_2_6 0

and 

#ifndef wxUSE_UNICODE
    #define wxUSE_UNICODE 1
#endif

4) Load project wxWidgets-2.8.12/build/msw/wx.dsw into Visual Studio.
5) Use Configuration Manager to change the Configuration for all sub-projects to Unicode Release.
6) Run Build->Build Solution.


Boost
=====
Installation from source is recommended for all platforms. A g++ development environment is assumed for the steps below.

Download and extract the boost_1_52_0 archive to a convenient location. Then run commands to accomplish the following tasks:

cd <convenient location>
run the bootstrap script
run "b2 --with-program_options"


MRIConvert and mcverter
=======================
Extract the tarball to a convenient location:

tar xzf MRIConvert-n.n.n-src.tar.gz
cd MRIConvert-n.n.n
cmake
make

To install the files for general use, copy them to the location for your binaries, e.g. /usr/bin or /usr/local/bin.  You will need administrator privileges for this step. 

