Test SolAR

We provide you a bundle to test our samples code. It’s just a .zip file including SolAR’s .so and executable binaries.

Table 1. Available Samples

Natural Image Marker

https://github.com/SolarFramework/NaturalImageMarker/releases

Fiducial Marker

https://github.com/SolarFramework/FiducialMarker/releases

 Sample-Slam

https://github.com/SolarFramework/Sample-Slam/releases

Sample-Triangulation

https://github.com/SolarFramework/Sample-Triangulation/releases

Print the marker included in .zip file to use it during the test.

Install development environment

The SolAR framework uses a dedicated pipeline for linking and compiling code as well as internal tools for third party downloads that should make your job a lot easier. As you will see later, the SolAR framework is based on QMake originally created by the Qt Company, but compliant with most IDE.

Install your IDE

QT Creator

As SolAR is using QMake file to setup the projects, we highly recomment to install Qt Creator. Moreover, you will have access to wizards which will help you create new SolAR modules, components and pipelines.

Download the latest version of QTCreator on the following link: QT installer download

When downloaded, right clik on the Qt installer.run file, select properties, Permissions, and check Authorize execution of the file. Then, run your installer.

Create a Qt account if not already done, select where you want to install Qt.
You don’t need to install Qt SDK, just the Qt Creator. So just check the following components:

  • Qt x.x.x (last version proposed)

    • With Desktop gcc 64-bit

    • Android (if you want to build SolAR for Android)

  • Developer and Designer Tools

and start the installation.

Install dependencies

For downloading dependencies, the SolAR framework uses the meta dependencies management tool Remaken supporting Conan, VCPKG and its native C++ packaging structure based on pkg-config description files.

Install Remaken

  • Open a terminal and install curl, git, build-essential, pkg-config and cmake package : sudo apt-get install curl git build-essential pkg-config cmake -y

  • Download Remaken installer scripts available on the following link: Remaken archive

  • Unzip archive and in Remaken directory open a terminal and run ./scripts/install_brew.sh to install and configure Homebrew a package manager, that we will use to install latest Remaken release.

  • Log out and then log in to add brew eval modification to your ${HOME}/.profile

  • Run /scripts/install.sh to install Remaken and initialize his qmake building rules in your ${HOME}./remaken/rules folder.
    By default, Remaken will install Conan which will be used afterwards.

  • Try a remaken --help command in a terminal to check installation

Use Remaken

Remaken uses a file called packagedependencies.txt to describe which depedencies to install, in which version, where to install them, and where to download them.

A global packagedepedencies.txt is available in the parent GIT repository SolAR, and can be downloaded on the following link: packagedependencies.txt

Copy this file where you want on your computer, open a terminal in the folder where you have copied the packagedependencies.txt file, and run remaken with the following command:

remaken install --cpp-std 17 -b gcc packagedependencies.txt

This command will install all SolAR dependencies in release mode in your ${HOME}/.remaken/packages folder. To download the dependencies in debug mode, run the following command:

remaken install --cpp-std 17 -b gcc -c debug packagedependencies.txt

This is done, all your dependencies are downloaded and ready to use !

Some of the module will download and build third parties using Conan which requires CMake (minimum version 3.10)

Build SolAR

Clone SolAR

SolAR is made up of a multitude of projects (SolAR Framework, SolAR pipeline manager, modules, samples, etc.). To help you, we have created a parent repository with sub-modules regrouping all source codes of SolAR. You can clone it from the following url: https://github.com/SolarFramework/SolAR.git

No space in the path of the folder where you are cloning SolAR !
git clone https://github.com/SolarFramework/SolAR.git

Do not forget to install and update recursively the submodules:

cd SolAR
git submodule update --init --recursive

If you want to move all submodules on Master, laucnh the folloing command

git submodule foreach git pull origin master

If you do not want to download all the source codes of SolAR, you can have a look to the different repositories available on Github on the Community/Git page.

Build on Qt Creator

Open the Qt project of your choice, for instance a sample. Check by clicking on the Projects tab, and then on the Manage Kits…​ button that your Qt x.x.x GCC 64 bit kit is well configured

In your project build settings of your kit, add arguments install to the Builds Steps > Make step of your kit to copy compiled module output in ${HOME}/.remaken/packages
Add install argurment
Figure 1. Add install argument

Just run qmake, and build your project.