This repository contains build scripts and test files for the openxr*.hpp
headers, providing a C -friendly projection of the OpenXR API.
The authoritative public repository is located at https://github.com/KhronosGroup/OpenXR-HPP/. It hosts the public Issue tracker, and accepts patches (Pull Requests) from the general public.
If you want to simply write an application using OpenXR (the headers and
loader), with minimum dependencies, see
https://github.com/KhronosGroup/OpenXR-SDK/. That project will likely contain
the openxr*.hpp
artifact when it is ready for widespread production usage.
To build this project, you must have OpenXR-SDK-Source
cloned in a peer
directory of this one.
README.md
- This fileCOPYING.md
- Copyright and licensing informationCODE_OF_CONDUCT.md
- Code of ConductOPENXR-HPP.md
- Some basic introductory documentationinclude/
- Build system to generate theopenxr*.hpp
filesscripts/
- Python source code and Jinja2 templates for generating the headers.tests/
- some simple files that ensures the header is always compilable.
If you just want to generate the headers, run ./generate-openxr-hpp.sh
or
./generate-openxr-hpp.ps1
. If your OpenXR-SDK-Source (or internal gitlab) repo
isn't in a directory named that parallel to this one, you can set OPENXR_REPO
environment variable before running. Requires clang-format, preferably 6.0.
If you'd like to build the tests (making sure the headers can compile), use CMake to generate a build system, like:
mkdir build
cd build
cmake ..
make
To improve/maintain consistent code style and code quality, we strongly recommend setting up the pre-commit hooks, which check/correct:
- large file additions
- byte-order marker
- case conflicts
- unresolved merge conflicts
- broken symlinks
- file endings
- line endings
- trailing whitespace
- autopep8
- cmake-format
Using these hooks involves the following steps:
Install pre-commit - available thru pip or your preferred package manager.
python3 -m pip install --user pre-commit
Setup the git hook scripts by running this script. This will configure the current git repo working directory to run the hooks, as well as cloning and building (if required) the various tools used by the hooks.
pre-commit install
Optionally, you can run the hooks over all files manually, before a commit:
pre-commit run --all-files