Build System: Add OpenXR-SDK dependency and WITH_XR_OPENXR build option
authorJulian Eisel <eiseljulian@gmail.com>
Wed, 4 Mar 2020 15:39:00 +0000 (16:39 +0100)
committerJulian Eisel <eiseljulian@gmail.com>
Wed, 4 Mar 2020 15:45:07 +0000 (16:45 +0100)
commita22573e243d7eeda7c10c9afc59377d474c74e5e
treecd50df07df955f1186c604aedc2222c1c0479638
parente7f1de5e110a925cfa11bb7824c4fe2695e274ba
Build System: Add OpenXR-SDK dependency and WITH_XR_OPENXR build option

The OpenXR-SDK contains utilities for using the OpenXR standard
(https://www.khronos.org/openxr/). Namely C-headers and a so called
"loader" to manage runtime linking to OpenXR platforms ("runtimes")
installed on the user's system.

The WITH_XR_OPENXR build option is disabled by default for now, as there
is no code using it yet. On macOS it will remain disabled for now, it's
untested and there's no OpenXR runtime in sight for it.

Some points on the OpenXR-SDK dependency:
* The repository is located at
  https://github.com/KhronosGroup/OpenXR-SDK (Apache 2).
* Notes on updating the dependency:
  https://wiki.blender.org/wiki/Source/OpenXR_SDK_Dependency
* It contains a bunch of generated files, for which the sources are in a
  separate repository
  (https://github.com/KhronosGroup/OpenXR-SDK-Source).
* We could use that other repo by default, but I'd rather go with the
  simpler solution and allow people to opt in if they want advanced dev
  features.
* We currently use the OpenXR loader lib from it and the headers.
* To use the injected OpenXR API-layers from the SDK (e.g. API
  validation layers), the SDK needs to be compiled from this other
  repository.

The extra "XR_" prefix in the build option is to avoid mix-ups of OpenXR
with OpenEXR.

Most of this comes from the 2019 GSoC project, "Core Support of Virtual
Reality Headsets through OpenXR"
(https://wiki.blender.org/wiki/User:Severin/GSoC-2019/).

Differential Revision: https://developer.blender.org/D6188

Reviewed by: Campbell Barton, Sergey Sharybin, Bastien Montagne, Ray
Molenkamp
15 files changed:
CMakeLists.txt
build_files/build_environment/CMakeLists.txt
build_files/build_environment/cmake/harvest.cmake
build_files/build_environment/cmake/versions.cmake
build_files/build_environment/cmake/xr_openxr.cmake [new file with mode: 0644]
build_files/build_environment/install_deps.sh
build_files/cmake/Modules/FindXR-OpenXR-SDK.cmake [new file with mode: 0644]
build_files/cmake/config/blender_full.cmake
build_files/cmake/config/blender_lite.cmake
build_files/cmake/config/blender_release.cmake
build_files/cmake/platform/platform_apple.cmake
build_files/cmake/platform/platform_unix.cmake
build_files/cmake/platform/platform_win32.cmake
source/blender/python/intern/CMakeLists.txt
source/blender/python/intern/bpy_app_build_options.c