=======================================
Enable Viacam Installation Instructions
=======================================

This document describes how to compile and install Enable Viacam for
GNU/Linux and Windows platforms.

Linux
=====

- Pre-requisites
  --------------
  wxWidgets >= 2.8
  opencv >= 1.0
  gtk+-2.0
  libxtst
  libxext 

  For Debian/Ubuntu see file debian/control for exact dependencies.
 
- Generic compilation and installation
  ------------------------------------
  If you downloaded a release tarball:
  ./configure
  make 
  make install

  If you got sources from repositories, first you need to install 
  libtool
  automake
  autoconf

  then run:
  ./autogen.sh
  ./configure
  make
  make install

- Generic compilation and installation (debug mode)
  -------------------------------------------------
  ./configure --enable-debug
  make 
  make install  

- Source package generation
  -------------------------
  ./configure 
  make dist

- DEB Packages
  -------------
  
  Before generating any .deb package make sure file debian/changelog is up
  to date. Run the following command and check that contents are correct:
    dch -i

  * DEB source package generation
      ./configure
      make deb-src
	  
  * changes file generation
      Useful when generating packages for several distros. Assumes previous 
	  step has been done. For each distro edit debian/changes with 
		dch -i
      add the right information then run
	    make deb-src-changes
	  
  * DEB binary package generation
      ./configure
      make deb
	  
    Old way:
      1.- Ensure that config.status doesn't exists (i.e. make distclean)
      2.- Run: fakeroot debian/rules binary
      3.- Clean tree:fakeroot debian/rules clean
  	  
- RPM package generation
  ----------------------

  ./configure
  make rpm

Windows
=======

- Pre-requisites
  --------------

  Visual Studio 2013
  wxWidgets >= 2.8.x (tested with 3.0.1)
  opencv >= 1.0 (tested with 2.4.9, custom compilation recommended)
  Windows SDK for Windows 7 and .NET Framework 4 7.1 (tested 7.1.7600.0.30514)

- Building using Visual Studio 2013
  ---------------------------------

  Set the following environment variables:
	WXWIN to point to wxWidgets folder
	CVPATH to point to opencv folder
	DSHOW_SAMPLES to point DirectShow samples directory usually at:
        %PROGRAMFILES%\Microsoft SDKs\Windows\v7.1\Samples\multimedia

  Once the program is compiled, you may wish to create the installer. 
  Inno Setup is used for installer generation on Windows