TerraLib and TerraView Wiki Page

This is an old revision of the document!


TerraLib and TerraView - Working Environment

Tools

The basic tools you have to install in your environment to work with TerraLib and TerraView are:

SoftwareVersionWebsite
Git ​ Latest http://git-scm.com/
CMake ​ 3.11 http://www.cmake.org/cmake
Qt​ 5.12.3 https://download.qt.io/archive/qt/5.12/5.12.3//1)

The following tools are optional, and their use is described below:

SoftwareWebsiteFunction
TortoiseGIThttp://code.google.com/p/tortoisegit General User Interface that makes it easier to use GIT on Windows
Git-Cola http://git-cola.github.io/downloads.html General User Interface that makes it easier to use GIT on Unix platforms
Doxygen http://sourceforge.net/projects/doxygen/ used to generate the documentation

Installing and configuring GIT

Install the latest Git version from: GIT

Follow the default settings, except at:

  • Select Components: click Windows Explorer Integration, Git Bash, Git GUI.
  • Adjusting you PATH environment: Click third option (Run Git and included Unix Tools …)
  • Configuring the line ending conversions: click the first option (Checkout Windows-style, commit Unix-style line endings)

Dependencies

The TerraLib library is splitted into several modules providing different functionality, therefore, each have a particular set of dependencies. Microsoft Visual Studio 2017 C++ users can download and unpack the suitable third-party libraries compiled for building 64-bit version of TerraLib with Qt 5.12.3 support or previous.

Copy the right one from the links below or access all of them at http://www.dpi.inpe.br/terralib5/terralib5-3rdparty/

Alternatively, software developers can be working on specific branches improving functionalities, adjusting 3rdparty or fixing any kind of small bugs. In this case, to take the right third party used by an specific branch go to one of the links bellow:

Branch3rdparty Zip Comments
DEVELOPhttp://www.dpi.inpe.br/terralib5-devel/3rdparty/bin Pick the 3rdparty here
release-5.Yhttp://www.dpi.inpe.br/terralib5-devel/3rdparty/bin/ Go to the branch directory '5.Y' to pick up the right 3rdparty(Y=1,2,3…,n)

The third party dependencies must be uncompressed in a local directory, for example C:\TL5\. After that all dependencies will be at C:\TL5\terralib5-3rdparty-msvc-2017-win64. This location should be part of CMAKE_PREFIX_PATH (CMake tool) when configuring your environment.2)

MacOS and Linux users can check the dependencies document.

Once the environment is ready you can clone terralib source code and build the library. Alternatively, you can download the source code from a zip file .

1) copy and install this file qt-opensource-windows-x86-5.12.3.exe at C:/Qt and selecting Visual 2017
2) Also, it is used to run your application inside Visual Studio, after ALL_BUILD. Set the debugging environment to terraview project, Properties→Configuration Properties→Debugging, set the Environment as PATH=C:\TL5\terralib5-3rdparty-msvc-2017-win64\lib;C:\Qt\Qt5.10.1\5.10.1\msvc2017_64\bin