Установка (CPP)

• Установка (CPP)
  • Требования
  • Компиляция
    • Параметры компиляции
    • Компиляция на iOS
  • Тестирование
  • Как подключить в проектах на C++

Требования

• Компилятор C++14 или более поздний
• GCC 7.5+
• CMake 3.15+
• LAPACK & BLAS
  1. Если используете conda, conda install -c conda-forge lapack
  2. Если доступен sudo, apt update & apt -y install libatlas-base-dev

Необязательно:

• Conan (для использования предварительно собранных библиотек третьих сторон)

  # 0. установка conan
  pip install conan
  
  # 1. первая запуск
  conan profile new --detect --force default
  conan profile update settings.compiler.libcxx=libstdc++11 default
  
  # 2. добавление conan артефактори
  conan remote add openxrlab http://conan.openxrlab.org.cn/artifactory/api/conan/openxrlab
  
  # 3. проверка
  conan remote list

Компиляция

git clone https://github.com/openxrlab/xrprimer.git
cd xrprimer/

# сборка и установка зависимостей
cmake -S. -Bbuild_deps -D3RT_FROM_LOCAL=ON
cmake --build build_deps -j4

# компиляция xrprimer
cmake -S. -Bbuild [Параметры компиляции]
cmake --build build --target install -j4

На данный момент тестировалось на Linux и iOS. В идеале также можно скомпилировать на macOS или Windows.

Параметры компиляции

Получение внешних зависимостей- 3RT_FROM_LOCAL Библиотека зависимостей будет собрана или найдена на локальном хосте. По умолчанию: OFF

• 3RT_FROM_CONAN Библиотека зависимостей будет загружена с удаленного репозитория openxrlab conan. По умолчанию: OFF> Настройка xrprimer

• ENABLE_TEST Включение юнит-тестов. По умолчанию: OFF

• PYTHON_BINDING Включение привязки к Python. По умолчанию: ON

# 1. Первый запуск, получение внешних зависимостей, установка внешних зависимостей в 3rdparty
cmake -S. -Bbuild_deps <-D3RT_FROM_LOCAL=ON/-D3RT_FROM_CONAN=ON>
cmake --build build_deps

# 2. сборка xrprimer
cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install
cmake --build build --target install

Компиляция на iOS

Дополнительные детали см. в build_ios.sh.

Тестирование

Библиотека на C++```bash

компиляция (Пропустите следующие две строки, если уже скомпилировано)

cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DENABLE_TEST=ON cmake --build build -j4

запуск теста

cd build pip install gdown gdown https://docs.google.com/uc?id=1MJx367I2_ezK3vKdV4eJ9d0cBzgs2jtR && tar -xzf xrprimer.tar.gz && rm xrprimer.tar.gz ln -sfn xrprimer/test test ./bin/test_calibrator

Библиотека Python

```bash
# компиляция (Пропустите следующие две строки, если уже скомпилировано)
cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release -DENABLE_TEST=ON
cmake --build build -j4

# запуск теста
cd build
pip install gdown
gdown https://docs.google.com/uc?id=1MJx367I2_ezK3vKdV4eJ9d0cBzgs2jtR && tar -xzf xrprimer.tar.gz && rm xrprimer.tar.gz
PYTHONPATH=./lib/ python ../cpp/tests/test_multi_camera_calibrator.py

Как подключить в проектах на C++

см. пример на C++

cmake_minimum_required(VERSION 3.16)

project(sample)

# установка пути для поиска пакета XRPrimer (в режиме конфигурации)
set(XRPrimer_DIR "<package_path>/lib/cmake")
find_package(XRPrimer REQUIRED)

add_executable(sample sample.cpp)

target_link_libraries(sample XRPrimer::xrprimer)