Введение

Английский | Упрощенный китайский

XRPrimer — это базовая библиотека для алгоритмов, связанных с XR. XRPrimer предоставляет многократно используемые структуры данных, эффективные операторы и расширяемые интерфейсы как на C++, так и на Python.

Основные возможности

• Различные модели камер и инструменты для преобразования (Pinhole, Fisheye, Omni и т.д.)
• Основные 3D-операции (Триангуляция, Проекция и т.д.)
• Инструменты для калибровки внешних параметров многокамерных систем
• Инструменты для рендеринга и визуализации

Операционные системы

На данный момент поддерживаются следующие системы.

• Linux
• iOS

Установка

Python

Если вы используете xrprimer в проекте на Python, его можно установить следующим образом:

pip install xrprimer

Если вы хотите использовать последние обновления xrprimer, ознакомьтесь с Установкой Python для подробной информации.### C++

Если вы используете xrprimer в проекте на C++, ознакомьтесь с Установкой C++ для компиляции и тестирования.

Начало работы

Использование XRPrimer в проектах на Python

Приведенный ниже код должен выполняться успешно после завершения установки.

python -c "import xrprimer; print(xrprimer.__version__)"

Использование XRPrimer в проектах на C++

Пример ниже показывает, как подключить xrprimer в проектах на 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)

Часто задаваемые вопросы

Если вы столкнулись с проблемами при установке, сначала ознакомьтесь с этим Часто задаваемыми вопросами.

Лицензия

Лицензия на наш код — Apache-2.0. Обратите внимание, что эта лицензия применяется только к коду в нашей библиотеке, зависимости которой лицензированы отдельно. Мы хотели бы выразить благодарность за использование открытых источников, на которых мы основываемся. Пожалуйста, учтите, что использование содержимого зависимостей может повлиять на лицензию нашего кода. Ознакомьтесь с LICENSE, чтобы просмотреть полную лицензию.## Цитирование

Если вы считаете этот проект полезным для вашего исследования, пожалуйста, рассмотрите возможность цитирования:

@misc{xrprimer,
    title={OpenXRLab Foundational Library for XR-related Algorithms},
    author={XRPrimer Contributors},
    howpublished = {\url{https://github.com/openxrlab/xrprimer}},
    year={2022}
}

Вклад

Мы ценим все вклады, направленные на улучшение XRPrimer. Ознакомьтесь с CONTRIBUTING.md для руководства по вкладу.

Благодарности

XRPrimer — это открытый проект, к которому вносят свой вклад исследователи и инженеры как из академической, так и из промышленной среды. Мы благодарим всех участников, реализующих свои методы или добавляющих новые функции, а также пользователей, предоставляющих ценные отзывы. Мы надеемся, что этот набор инструментов и бенчмарки будут служить растущему научному сообществу, предоставляя гибкий инструментарий для воспроизведения существующих методов и разработки новых моделей.

Проекты в OpenXRLab- XRPrimer: Основная библиотека OpenXRLab для алгоритмов, связанных с XR.

• XRSLAM: Набор инструментов и бенчмарки OpenXRLab для визуально-инерциальной SLAM.
• XRSfM: Набор инструментов и бенчмарки OpenXRLab для структуры из движения.
• XRLocalization: Набор инструментов и сервер для визуальной локализации от OpenXRLab.
• XRMoCap: Набор инструментов и бенчмарки OpenXRLab для многокамерного мотодвигательного захвата.
• XRMoGen: Набор инструментов и бенчмарки OpenXRLab для генерации человеческого движения.
• XRNeRF: Набор инструментов и бенчмарки OpenXRLab для нейронных радиационных полей (NeRF).