View source for Software Installation Guide

ThIs guide provides a step-by-step guide to downloading, installing, and checking the software required to develop software for the CINDY Cognitive Architecture and write and run CINDY applications. 

== Operating System ==

I assume you are running Windows 7.

== C/C++ Compiler == 

Download the Microsoft Visual C++ Express compiler, version 10.0 (also known as Visual C++ 2010).  It is important to use this version; earlier versions are no longer supported by Microsoft and later versions cause problems with YARP. 

This is significant because you will be downloading the YARP binaries in the next step and these are version-specific. 

You can download the required compiler from [http://www.visualstudio.com/downloads/download-visual-studio-vs here].

Run the installer and follow the instructions.

Once the compiler is installed, try compiling a simple program.   Some versions of Windows 7 may need the the Microsoft Visual Studio 2010 Service Pack 1 to be installed.   If you get an error trying to compile and run a simple program, this may be the problem.   CMake (see below) will also fail in this case.

== YARP ==

Download the YARP v. 2.3.63  binaries for x86, MSVC v. 10.  Here's the [http://wiki.icub.org/wiki/Downloads#Windows  link to the instructions] and here is the 
[http://sourceforge.net/projects/yarp0/files/yarp2/yarp-2.3.63/windows/yarp_2.3.63_v10_x86_0.exe/download link] to the installer itself.

Run the installer and follow the instructions.  The installer will do everything for you including updating your path and adding all the necessary environment variables.

== CMake ==

Download CMake binaries from [http://www.cmake.org/download/ here].   

You can opt for either the WIN32 installer or the Windows zip file.  The installer has the advantage that it gives you the option to update your system path automatically (which you should take by clicking the appropriate radio button during the installation process).

== OpenCV ==

Download and install OpenCV from [http://sourceforge.net/projects/opencvlibrary/files/opencv-win/ here].  Choose the version 2.4.9 self-installer, download it, and execute it, and extract the library to <code>C:</code>.

Add <code>C:\opencv\build\x86\vc10\bin</code> to the PATH environment variable and add a new environment variable <code>OPENCV_DIR</code> with the value <code>C:\opencv\build</code>, as follows.

* From Windows 7 toolbar, select ''Control Panel > System and Security > System > Advanced System Settings''
* Click ''Environment Variables''
* Select <code>Path</code> from ''System Variables''
* Click ''Edit''
* Add <code>C:\opencv\build\x86\vc10\bin</code> (be sure to separate different paths with a semi-colon)
* Under ''User variables'', click ''New'' 
* Insert <code>OPENCV_DIR</code> in the ''Variable name'' box and <code>C:\opencv\build</code> in the ''Variable value'' box
* Click ''OK''

== FLTK ==

Download the FLTK Library from [http://www.fltk.org www.fltk.org]:

* Select the ''FLTK Library > Download'' menu item
* Download the most recent version (1.3.2)  <code>fltk-1.3.2-source.tar.gz</code>
* Unzip to get the <code>.tar</code> file

If you do not have an application to unzip, download and install 7-zip from [http://7-zip.org/ 7-zip.org].  Note that you may have to deselect the localization component to get the English version

The <code>fltk-1.3.2-source.tar</code> file contains a <code>fltk-1.3.2-source</code> directory.  This in turn contains a <code>fltk-1.3.2</code> directory.  Move this <code>fltk-1.3.2</code> directory to <code>C:\</code> and rename it to <code>C:\FLTK</code>

Go to <code>C:\FLTK\ide\VisualC2010</code> and launch <code>fltk.sln</code>

* Select ''Release'' from the drop-down ''Solution Configurations'' box (you only see this label when you hover over the box) 
* Select ''Build > Build Solution'' from the top menu (or press ''F7'')
* Select ''Debug'' from the drop-down option  ''Solution Configurations'' box
* Select ''Build > Build Solution'' (or press ''F7'')

The CMake files in the CINDY Repository (next section) are configured to use the various FLTK libraries in  <code>C:\FLTK\lib</code> and the include files in <code>C:\FLTK\FL</code>.

== CINDY Repository ==

Eventually, the CINDY project will be archived on an SVN repository.   For the moment, it is available as a simple .zip file.   Download it from [http://www.vernon.eu/CINDY.zip here] and unzip it so that you have a directory called <code>C:\CINDY</code> with the various subdirectories in the archive.  

The next step is to build a MSVC++ <code>.sln</code> solution file so that you can compile all the CINDY executable components. To do this, you need to run CMake against the <code>C:CINDY</code> directory (where you will find the main <code>CMakeLists.txt</code> file) 

* Launch the CMake GUI from the Windows 7 toolbar.

* In the ''Where is the source code:'' input (browse to)  <code>C:\CINDY</code>

* In the ''Where to build the binaries:'' input (browse to) <code>C:\CINDY\build</code>

* Select ''File > Delete Cache'' from the top menu (you '''must''' do this the first time in case there is an old invalid configuration in the CINDY directory)

* Click ''Configure''

* Select Visual Studio 10 (2010) from the drop-down menu as the generator for the project

* Click ''Finish'' and watch CMake configure your project.  The dialogue box will still highlighted in red so ...

* Click ''Configure'' again and everything should be fine (unless you have forgotten to download and install OpenCV, in which case you will get an error and you will have install OpenCV and start this process again)

* Click ''Generate''  to create the MSVC++ <code>CINDY.sln</code> file in <code>C:\CINDY\build</code>


Next, update your environment variables. 

* From Windows 7 toolbar, select ''Control Panel > System and Security > System > Advanced System Settings''

* Click ''Environment Variables''

* Select <code>Path</code> from ''System Variables''

* Click ''Edit''

* Add <code>C:\CINDY\bin</code> (be sure to separate different paths with a semi-colon)

* Under ''User variables'', click ''New'' 

* Insert <code>CINDY_ROOT</code> in the ''Variable name'' box and <code>C:\CINDY</code> in the ''Variable value'' box

* Click ''OK''
 

Now you are ready to launch MSVC++ and build the CINDY component executables.  

* Go to the <code>C:\CINDY\build</code> directory and open the <code>CINDY.sln</code> file.  This launches Microsoft Visual C++ 2010 Express.

* Select <code>Release</code> in the ''Solutions Configuration'' box.

* Select ''Build > Build Solution'' from the top menu, (if you don't see this and you see  ''Debug > Build Solution'' instead, it's probably because your IDE is set to basic settings. To change this, select ''Tools > Settings > Expert Settings'').


This will compile and link the components in the the <code>C:\CINDY\bin</code> directory.  Check to see that both component executables are there.  If it is not, then select  ''Build > Configuration Manager'' from the menu and make sure the ''INSTALL'' check-box is ticked.   Now rebuild the project again.

You are now ready to run the test applications that are included in each component directory (see directory structure below) and to begin developing your own components.

To run the test applications for the <code>protoComponent</code> and <code>protoComponentGUI</code> examples that are provided with the CINDY release, follow the instructions on the [[Software Users Guide]].


----
Return to [[The CINDY Cognitive Architecture]] main page.