|{width:4000px;border-color:transparent}. !/attachments/download/19/fr_FR.png! [[Fr_quickstart|...version française]] |

h1. Initialization of a Computree development environment


{{toc}}

 

 

h1. Initialization of a Computree development environment for *Windows* (64 bits, 7, 8 ou 10)

h2. Installing the development environment

# Install "Microsoft Visual studio 2015 Express": https://www.visualstudio.com/fr/post-download-vs/?sku=xdesk
# Install "Windows SDK": https://developer.microsoft.com/fr-fr/windows/downloads/windows-10-sdk (Optional step, allowing to compile in debug mode)
# Install "Qt": https://www.qt.io/download-open-source/ (check at least Qt 5.9.1 msvc 2015 64 bits
# Install a SVN client, as for example "TortoiseSVN": https://tortoisesvn.net (During the installation, think about activating the installation of _command line client tools_)

h2. Obtaining the source code of Computree and its plugins

1. Create a _Computree_ root directory where you want

2. Dowload document#6, which contains:
* A _all.pro_ file with all projects distributed as standard (core + open-source plugins)
* A _recuperer_depots.bat_ file, containing svn statements, to retrieve the source code
* A file _LISEZ-MOI.txt_, containing these instructions

3. Unzip _kit_dev_windows_fr.zip_ at the root of the _Computree_ directory

4. Run the _recuperer_depots.bat_ script

h2. Installing Dependencies

Download and unzip document#138, and paste at the root of the computree directory. 

notice. If you want to install dependencies in different locations (for example in c:/program files), you can, for each _LIBNAME_default_path.pri_ file in computreev5 directory, duplicate it and rename it _LIBNAME_user_path.pri_. After that you just have to modidy this second file to use your local paths.

h2. Computree Compilation

1. Launch Qt Creator

2. Open the project _all.pro_, select the compiler MSVC 2015 64bits, with version release and/or debug

tip. If you have not installed PCL, delete/comment the following line in all.pro:

<pre>
Computreev5/library/ctlibpcl/ctlibpcl.pro \
</pre>

3. On the Project tab, disable shadow builds (check box), for release and/or debug

4. Run qmake on all.pro, then compile the project

warning. After updating the source code, if the core of Computree has been modified significantly, it may be necessary to run qmake on each subproject and then to do Recompile on all.pro.

h2. Execution of Computree

Once compiled, *to be run, Computree needs all the dependency dlls*, accessible from the location of the generated _CompuTreeGui.exe_ file.
For that copy dlls to ComputreeInstallRelease folder (for release version) and / or ComputreeInstallDebug folder (for debug version). 

Dll are available for download here:  document#139


Then you can run from Qt-Creator (green arrow or run on all.pro).

h2. Configure your plugin if you want to use PCL in your code

If you want to use PCL for your development some preparation steps are required:

You must configure the .pro file of your plugin (.pro) as follows (beginning of the file):

<pre>
CT_PREFIX = ../../computreev5

Include ($$ {CT_PREFIX} /shared.pri)
Include ($$ {PLUGIN_SHARED_DIR} /include.pri)

COMPUTREE + = ctlibpcl

Include ($$ {CT_PREFIX} /include_ct_library.pri)
</pre>

*Do not forget to compile the libpcl* project into the computreev5/library/ctlibpcl folder (open the ctlibpcl.pro file and compile it with QtCreator)

Just make a _qmake_ on the project of your plugin (right click -> qmake) and compile it.


&nbsp;

&nbsp;

h1. Initialization of a Computree Development Environment on Ubuntu 16.04 LTS

h2. Installing the development environment

1. Installing subversion

_In a terminal (CTRL + ALT + T):_
<pre>
sudo apt-get update
sudo apt-get install subversion
</pre>

2. Installing Qt (5.9.1)
* Download last Qt installer : https://www.qt.io/download-open-source/
** You will have to create a Qt user account
** If you are behind a proxy, you need to go in settings section to parameter it
* Install Qt

h2. Recovering the source code of Computree and its plugins

1. Create a _Computree_ root directory where you want

2. Download document#5, which contains:
* A _all.pro_ file with all projects distributed as standard (core + open-source plugins)
* A _recuperer_depots.sh_ file containing svn statements to retrieve the source code
* A file _README.txt_, containing these instructions

3. Unzip _kit_dev_linux.tar.gz_ at the root of the _Computree_ directory

4. _In a terminal (CTRL + ALT + T), run the _recuperer_depots.sh_ script

h2. Installing Dependencies

1. *OpenCV 3.3.0* (optional but highly recommended, allows to use images / rasters in Computree)

* Follow instruction given in official OpenCV site: http://docs.opencv.org/3.3.0/d7/d9f/tutorial_linux_install.html


2. *PCL 1.8.0* (optional, allows to use plugins requiring PCL)
* In a terminal (CTRL + ALT + T) :
<pre>
sudo apt-get install git build-essential linux-libc-dev cmake cmake-gui libusb-1.0-0-dev libusb-dev libudev-devmpi-default-dev openmpi-bin openmpi-common libflann1.8 libflann-dev libeigen3-dev libboost-all-dev libvtk5.10-qt4 libvtk5.10 libvtk5-dev libqhull* libgtest-dev freeglut3-dev pkg-config libxmu-dev libxi-dev mono-complete qt-sdk openjdk-8-jdk openjdk-8-jre libproj-dev
</pre>
* Download PCL 1.8.0 source code here: https://github.com/PointCloudLibrary/pcl/archive/pcl-1.8.0.tar.gz
* Unzip the file pcl-1.8.0.tar.gz (in an explorer: right click, extract here)
* In a terminal (CTRL + ALT + T) :
<pre>
cd pcl-pcl-1.8.0
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr \ -DCMAKE_INSTALL_PREFIX=/usr ..
make -j7
sudo make install
</pre>

3. *GDAL 2.2.1* (optional, gives access to GDAL/OGR vector and raster formats)
* Download version 2.2.1 of GDAL, here: http://download.osgeo.org/gdal/2.2.1/gdal-2.2.1.tar.gz
* Unzip the file gdal-2.2.1.tar.gz (in an explorer: right click, extract here)
* Open a terminal in the gdal-2.2.1 folder (in an explorer: select the folder, right click, open in a terminal)
* Launch the following commands:
<pre>
./configure
make
sudo make install
sudo ldconfig
</pre>

4. *GSL* (optional, gives access to a numerical calculation library used in some plugins)
* In a terminal (CTRL + ALT + T):
<pre>
sudo apt-get install -y gsl-bin libgsl0-dev
</pre>


notice. If you want to install dependencies in different locations (for example in c:/program files), you can, for each _LIBNAME_default_path.pri_ file, duplicate it and rename it _LIBNAME_user_path.pri_. After that you just have to modidy this second file to use your local path.

h2. Computree Compilation

1. Launch Qt Creator

2. Open the project _all.pro_

tip. If you have not installed PCL, delete/comment the following line in all.pro:
<pre>
computreev5/library/ctlibpcl/ctlibpcl.pro \
</pre>

3. On the Project tab, disable shadow builds (check box), for release and/or debug
!shadow_build.png!


4. Run qmake on all.pro, then compile the project

warning. After updating the source code, if the core of Computree has been modified significantly, it may be necessary to run qmake on each subproject and then to do Recompile on all.pro.

h2. Execution of Computree

Once compiled, you can run from Qt-Creator (green arrow or run on all.pro).

h2. Configure your plugin if you want to use PCL in your code

If you want to use PCL for your development some preparation steps are required:

You must configure the .pro file of your plugin (.pro) as follows (beginning of the file):

<pre>
CT_PREFIX = ../../computreev5

include($${CT_PREFIX}/shared.pri)
include($${PLUGIN_SHARED_DIR}/include.pri)

COMPUTREE += ctlibpcl

include($${CT_PREFIX}/include_ct_library.pri)
</pre>

*Do not forget to compile the libpcl* project into the computreev5/library/ctlibpcl folder (open the ctlibpcl.pro file and compile it with QtCreator)

Just make a _qmake_ on the project of your plugin (right click -> qmake) and compile it.

&nbsp;

&nbsp;

h1. List of svn repositories

p<>. If you want to add repositories, or do a manual installation without the scripts, you will find in the table below a list of repositories for all Computree plugins.

notice<>. To access a repository, of course, you must have adequate rights for the project.

notice<>. In general, the name of a repository is http://rdinnovation.onf.fr/svn/nom-du-projet. The name of the project being the name that appears in the address bar of the browser.

|_. Plugin                                      |_. Plugin code |_. Project                                |_. Svn Repository                                                                           | 
| *Computree (base)*               | CT                     | computree                         | http://rdinnovation.onf.fr/svn/computree                         |
| *ComputreeDevTools*          | -                        | computreedevtools         | http://rdinnovation.onf.fr/svn/computreedevtools        |
| *Plugin Onf*                            | ONF                  | plugin-onf                          | http://rdinnovation.onf.fr/svn/plugin-onf                         |
| *Plugin Arts Free*                  | ARFR                | plugin-arts-free                | http://rdinnovation.onf.fr/svn/plugin-arts-free               |
| *Plugin Onf Lsis*                    | OL                      | plugin-onf-lsis                  | http://rdinnovation.onf.fr/svn/plugin-onf-lsis                 |
| *Plugin Generate*                  | GEN                   | plugin-generate               | http://rdinnovation.onf.fr/svn/plugin-generate              |
| *Plugin ToolKit*                     | TK                      | plugin-toolkit                   | http://rdinnovation.onf.fr/svn/plugin-toolkit                   |
| *Plugin LVox*                          | LVOX                | plugin-lvox                        | http://rdinnovation.onf.fr/svn/plugin-lvox                       |



_____

| [[computree:En_wiki_v4|Back to home]]|