
NOTE: While most of the milestone 1 goals are there, a few smaller features and improvements are still to be done. Big picture of this milestone: Initial, OpenXR-based virtual reality support for users and foundation for advanced use cases. Maniphest Task: https://developer.blender.org/T71347 The tasks contains more information about this milestone. To be clear: This is not a feature rich VR implementation, it's focused on the initial scene inspection use case. We intentionally focused on that, further features like controller support are part of the next milestone. - How to use? Instructions on how to use this are here: https://wiki.blender.org/wiki/User:Severin/GSoC-2019/How_to_Test These will be updated and moved to a more official place (likely the manual) soon. Currently Windows Mixed Reality and Oculus devices are usable. Valve/HTC headsets don't support the OpenXR standard yet and hence, do not work with this implementation. --------------- This is the C-side implementation of the features added for initial VR support as per milestone 1. A "VR Scene Inspection" Add-on will be committed separately, to expose the VR functionality in the UI. It also adds some further features for milestone 1, namely a landmarking system (stored view locations in the VR space) Main additions/features: * Support for rendering viewports to an HMD, with good performance. * Option to sync the VR view perspective with a fully interactive, regular 3D View (VR-Mirror). * Option to disable positional tracking. Keeps the current position (calculated based on the VR eye center pose) when enabled while a VR session is running. * Some regular viewport settings for the VR view * RNA/Python-API to query and set VR session state information. * WM-XR: Layer tying Ghost-XR to the Blender specific APIs/data * wmSurface API: drawable, non-window container (manages Ghost-OpenGL and GPU context) * DNA/RNA for management of VR session settings * `--debug-xr` and `--debug-xr-time` commandline options * Utility batch & config file for using the Oculus runtime on Windows. * Most VR data is runtime only. The exception is user settings which are saved to files (`XrSessionSettings`). * VR support can be disabled through the `WITH_XR_OPENXR` compiler flag. For architecture and code documentation, see https://wiki.blender.org/wiki/Source/Interface/XR. --------------- A few thank you's: * A huge shoutout to Ray Molenkamp for his help during the project - it would have not been that successful without him! * Sebastian Koenig and Simeon Conzendorf for testing and feedback! * The reviewers, especially Brecht Van Lommel! * Dalai Felinto for pushing and managing me to get this done ;) * The OpenXR working group for providing an open standard. I think we're the first bigger application to adopt OpenXR. Congratulations to them and ourselves :) This project started as a Google Summer of Code 2019 project - "Core Support of Virtual Reality Headsets through OpenXR" (see https://wiki.blender.org/wiki/User:Severin/GSoC-2019/). Some further information, including ideas for further improvements can be found in the final GSoC report: https://wiki.blender.org/wiki/User:Severin/GSoC-2019/Final_Report Differential Revisions: D6193, D7098 Reviewed by: Brecht Van Lommel, Jeroen Bakker
155 lines
4.2 KiB
Python
155 lines
4.2 KiB
Python
# ##### BEGIN GPL LICENSE BLOCK #####
|
|
#
|
|
# This program is free software; you can redistribute it and/or
|
|
# modify it under the terms of the GNU General Public License
|
|
# as published by the Free Software Foundation; either version 2
|
|
# of the License, or (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software Foundation,
|
|
# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
#
|
|
# ##### END GPL LICENSE BLOCK #####
|
|
|
|
# <pep8 compliant>
|
|
|
|
# simple script to enable all addons, and disable
|
|
|
|
"""
|
|
./blender.bin --background -noaudio --factory-startup --python tests/python/bl_load_addons.py
|
|
"""
|
|
|
|
import bpy
|
|
import addon_utils
|
|
|
|
import os
|
|
import sys
|
|
import importlib
|
|
|
|
BLACKLIST_DIRS = (
|
|
os.path.join(bpy.utils.resource_path('USER'), "scripts"),
|
|
) + tuple(addon_utils.paths()[1:])
|
|
BLACKLIST_ADDONS = set()
|
|
|
|
|
|
def _init_addon_blacklist():
|
|
|
|
# in case we built without cycles
|
|
if not bpy.app.build_options.cycles:
|
|
BLACKLIST_ADDONS.add("cycles")
|
|
|
|
# in case we built without freestyle
|
|
if not bpy.app.build_options.freestyle:
|
|
BLACKLIST_ADDONS.add("render_freestyle_svg")
|
|
|
|
# netrender has known problems re-registering
|
|
BLACKLIST_ADDONS.add("netrender")
|
|
|
|
if not bpy.app.build_options.xr_openxr:
|
|
BLACKLIST_ADDONS.add("viewport_vr_preview")
|
|
|
|
for mod in addon_utils.modules():
|
|
if addon_utils.module_bl_info(mod)['blender'] < (2, 80, 0):
|
|
BLACKLIST_ADDONS.add(mod.__name__)
|
|
|
|
|
|
def addon_modules_sorted():
|
|
modules = addon_utils.modules({})
|
|
modules[:] = [
|
|
mod for mod in modules
|
|
if not (mod.__file__.startswith(BLACKLIST_DIRS))
|
|
if not (mod.__name__ in BLACKLIST_ADDONS)
|
|
]
|
|
modules.sort(key=lambda mod: mod.__name__)
|
|
return modules
|
|
|
|
|
|
def disable_addons():
|
|
# first disable all
|
|
addons = bpy.context.preferences.addons
|
|
for mod_name in list(addons.keys()):
|
|
addon_utils.disable(mod_name, default_set=True)
|
|
assert(bool(addons) is False)
|
|
|
|
|
|
def test_load_addons():
|
|
modules = addon_modules_sorted()
|
|
|
|
disable_addons()
|
|
|
|
addons = bpy.context.preferences.addons
|
|
|
|
addons_fail = []
|
|
|
|
for mod in modules:
|
|
mod_name = mod.__name__
|
|
print("\tenabling:", mod_name)
|
|
addon_utils.enable(mod_name, default_set=True)
|
|
if (mod_name not in addons) and (mod_name not in BLACKLIST_ADDONS):
|
|
addons_fail.append(mod_name)
|
|
|
|
if addons_fail:
|
|
print("addons failed to load (%d):" % len(addons_fail))
|
|
for mod_name in addons_fail:
|
|
print(" %s" % mod_name)
|
|
else:
|
|
print("addons all loaded without errors!")
|
|
print("")
|
|
|
|
|
|
def reload_addons(do_reload=True, do_reverse=True):
|
|
modules = addon_modules_sorted()
|
|
addons = bpy.context.preferences.addons
|
|
|
|
disable_addons()
|
|
|
|
# Run twice each time.
|
|
for _ in (0, 1):
|
|
for mod in modules:
|
|
mod_name = mod.__name__
|
|
print("\tenabling:", mod_name)
|
|
addon_utils.enable(mod_name, default_set=True)
|
|
assert(mod_name in addons)
|
|
|
|
for mod in modules:
|
|
mod_name = mod.__name__
|
|
print("\tdisabling:", mod_name)
|
|
addon_utils.disable(mod_name, default_set=True)
|
|
assert(not (mod_name in addons))
|
|
|
|
# now test reloading
|
|
if do_reload:
|
|
sys.modules[mod_name] = importlib.reload(sys.modules[mod_name])
|
|
|
|
if do_reverse:
|
|
# in case order matters when it shouldn't
|
|
modules.reverse()
|
|
|
|
|
|
def main():
|
|
|
|
_init_addon_blacklist()
|
|
|
|
# first load addons, print a list of all addons that fail
|
|
test_load_addons()
|
|
|
|
reload_addons(do_reload=False, do_reverse=False)
|
|
reload_addons(do_reload=False, do_reverse=True)
|
|
reload_addons(do_reload=True, do_reverse=True)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
|
|
# So a python error exits(1)
|
|
try:
|
|
main()
|
|
except:
|
|
import traceback
|
|
traceback.print_exc()
|
|
sys.exit(1)
|