...version française

Initialization of a Computree development environment¶

• Table of contents
• Initialization of a Computree development environment
• Initialization of a Computree development environment for Windows (64 bits, 7, 8 ou 10)
  • Installing the development environment
  • Obtaining the source code of Computree and its plugins
  • Installing Dependencies
  • Computree Compilation
  • Execution of Computree
  • Configure your plugin if you want to use PCL in your code
• Initialization of a Computree Development Environment on Ubuntu 16.04 LTS
  • Installing the development environment
  • Recovering the source code of Computree and its plugins
  • Installing Dependencies
  • Computree Compilation
  • Execution of Computree
  • Configure your plugin if you want to use PCL in your code
• List of svn repositories

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

Installing the development environment¶

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

Obtaining the source code of Computree and its plugins¶

1. Create a Computree root directory where you want

• 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

Installing Dependencies¶

Download and unzip Computree v5 dependencies folder, and paste at the root of the computree directory.

Computree Compilation¶

1. Launch Qt Creator

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

Computreev5/library/ctlibpcl/ctlibpcl.pro \

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

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: Computree v5 DLL

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

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):

CT_PREFIX = ../../computreev5

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

COMPUTREE + = ctlibpcl

Include ($$ {CT_PREFIX} /include_ct_library.pri)

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.

Initialization of a Computree Development Environment on Ubuntu 16.04 LTS¶

Installing the development environment¶

1. Installing subversion

In a terminal (CTRL + ALT + T):

sudo apt-get update
sudo apt-get install subversion

• 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

Recovering the source code of Computree and its plugins¶

1. Create a Computree root directory where you want

• 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

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

• In a terminal (CTRL + ALT + T) :
  

  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
  

• 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) :
  

  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
  

• 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:
  

  ./configure
  make
  sudo make install
  sudo ldconfig
  

• In a terminal (CTRL + ALT + T):
  

  sudo apt-get install -y gsl-bin libgsl0-dev
  

Computree Compilation¶

1. Launch Qt Creator

2. Open the project all.pro

computreev5/library/ctlibpcl/ctlibpcl.pro \

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

Execution of Computree¶

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

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):

CT_PREFIX = ../../computreev5

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

COMPUTREE += ctlibpcl

include($${CT_PREFIX}/include_ct_library.pri)

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.

List of svn repositories¶

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.