XRPrimer Release v0.7.0

XRPrimer 0.7.0 Release Notes:

Highlights:

• Add synbody_utils.py and exr_reader.py module to help with using SynBody dataset.
• Support points and lines visualization by OpenCV and by Matplotlib.
• Improve external dependencies by splitting external and project build.
• Update dockerfiles, build scripts and docker images.

New Features:

• Add synbody_utils.py and exr_reader.py module to help with using SynBody dataset.
• Add points and lines visualization by OpenCV and by Matplotlib, with features such as PointPalette and LinePalette for visualization backends sharing the same definition of data.
• Add fast undistortion in Python.
• Add Keypoints, Limbs and keypoints_convention from XRMoCap.
• Add world convention for 3D spaces.
• Add VideoReader to ffmpeg_utils in Python. Together with VideoWriter, now we can visualize a really long video on a machine with poor RAM.

Improvements:

• Improve external dependencies by splitting external and project build, building for source or downloading dependencies when first run. External dependencies from different sources are used in the same way.
• Upgrade OpenCV(C++dependency) to 4.6.0.
• Improve python version constraint in setup.py and requirements, making torch unnecessary and allowing classes like cameras in data_stuctures to be imported in a torch absent environment.
• Update dockerfiles, build scripts and docker images.

Documentations:

• Revise docs.
• Add Readthedocs for Python and C++.
• Use Readthedocs and Doxygen to manage C++ documentation.

CICD:

• Update workflow OS from ubt18 to ubt22/ubt20, since ubt18 is no longer supported by GitHub.
• Add build_cpp stage in GitHub workflow to build C++ code.
• Update trigger conditions for publish workflow, with either branch name or tag working.
• Improve publish process inside a new manylinux2014 docker container, building wheel file with rebuilt conan packages, repairing wheel file with auditwheel, and uploading with twine.

Bug Fixes:

• Fix incorrect image data copy.
• Fix wrong calibration input variable reported by issue-33.
• Fix wrong building directory settings in setup.py, now it copies xrprimer_cpp*.so from self.cmake_output_lib to self.build_lib.
• Update test data at aliyun-oss and fixed wrong subfolder name causing error.
• Replace twine username from __token__ to secrets.PYPI_USERNAME in github actions, which works well in forked repo.

New Contributors:

@ruitard @Maoxie

XRPrimer Release v0.6.0

Highlights

• Support iOS and Linux compilation
• Support installation via pypi, ranging from python 3.6 to 3.10
• Support various camera models (Pinhole, Fisheye, Omni etc.)
• Support basic 3D operations (Triangulator, Projector etc.)
• Support Multi-camera extrinsic calibration tools

New Features

• Add pybind to create Python bindings of C++ data structures and switch python backend to C++ code
• Add camera convention convert method
• Add camera calibrator in python to support 3 types of calibration
• Add image class and support the conversion with OpenCV
• Add external deps and use conan manager to accelerate the compilation
• Provide samples to demonstrate linking XRPrimer in other C++ projects