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
200 lines
4.1 KiB
CMake
200 lines
4.1 KiB
CMake
# ***** 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.
|
|
#
|
|
# The Original Code is Copyright (C) 2006, Blender Foundation
|
|
# All rights reserved.
|
|
# ***** END GPL LICENSE BLOCK *****
|
|
|
|
set(INC
|
|
.
|
|
gizmo
|
|
gizmo/intern
|
|
../blenfont
|
|
../blenkernel
|
|
../blenlib
|
|
../blenloader
|
|
../blentranslation
|
|
../compositor
|
|
../depsgraph
|
|
../editors/include
|
|
../draw
|
|
../gpu
|
|
../imbuf
|
|
../makesdna
|
|
../makesrna
|
|
../nodes
|
|
../render/extern/include
|
|
../../../intern/clog
|
|
../../../intern/ghost
|
|
../../../intern/glew-mx
|
|
../../../intern/guardedalloc
|
|
../../../intern/memutil
|
|
)
|
|
|
|
set(INC_SYS
|
|
${ZLIB_INCLUDE_DIRS}
|
|
${GLEW_INCLUDE_PATH}
|
|
)
|
|
|
|
set(SRC
|
|
intern/wm.c
|
|
intern/wm_cursors.c
|
|
intern/wm_dragdrop.c
|
|
intern/wm_draw.c
|
|
intern/wm_event_query.c
|
|
intern/wm_event_system.c
|
|
intern/wm_files.c
|
|
intern/wm_files_link.c
|
|
intern/wm_gesture.c
|
|
intern/wm_gesture_ops.c
|
|
intern/wm_init_exit.c
|
|
intern/wm_jobs.c
|
|
intern/wm_keymap.c
|
|
intern/wm_keymap_utils.c
|
|
intern/wm_menu_type.c
|
|
intern/wm_operator_props.c
|
|
intern/wm_operator_type.c
|
|
intern/wm_operator_utils.c
|
|
intern/wm_operators.c
|
|
intern/wm_panel_type.c
|
|
intern/wm_platform_support.c
|
|
intern/wm_playanim.c
|
|
intern/wm_splash_screen.c
|
|
intern/wm_stereo.c
|
|
intern/wm_subwindow.c
|
|
intern/wm_surface.c
|
|
intern/wm_toolsystem.c
|
|
intern/wm_tooltip.c
|
|
intern/wm_uilist_type.c
|
|
intern/wm_utils.c
|
|
intern/wm_window.c
|
|
gizmo/intern/wm_gizmo.c
|
|
gizmo/intern/wm_gizmo_group.c
|
|
gizmo/intern/wm_gizmo_group_type.c
|
|
gizmo/intern/wm_gizmo_map.c
|
|
gizmo/intern/wm_gizmo_target_props.c
|
|
gizmo/intern/wm_gizmo_type.c
|
|
message_bus/intern/wm_message_bus.c
|
|
message_bus/intern/wm_message_bus_rna.c
|
|
message_bus/intern/wm_message_bus_static.c
|
|
|
|
WM_api.h
|
|
WM_keymap.h
|
|
WM_message.h
|
|
WM_toolsystem.h
|
|
WM_types.h
|
|
wm.h
|
|
wm_cursors.h
|
|
wm_draw.h
|
|
wm_event_system.h
|
|
wm_event_types.h
|
|
wm_files.h
|
|
wm_surface.h
|
|
wm_window.h
|
|
intern/wm_platform_support.h
|
|
intern/wm_window_private.h
|
|
gizmo/WM_gizmo_api.h
|
|
gizmo/WM_gizmo_types.h
|
|
gizmo/wm_gizmo_fn.h
|
|
gizmo/wm_gizmo_wmapi.h
|
|
gizmo/intern/wm_gizmo_intern.h
|
|
message_bus/intern/wm_message_bus_intern.h
|
|
message_bus/wm_message_bus.h
|
|
)
|
|
|
|
set(LIB
|
|
bf_editor_screen
|
|
)
|
|
|
|
if(WITH_AUDASPACE)
|
|
add_definitions(-DWITH_AUDASPACE)
|
|
|
|
list(APPEND INC_SYS
|
|
${AUDASPACE_C_INCLUDE_DIRS}
|
|
)
|
|
list(APPEND LIB
|
|
${AUDASPACE_C_LIBRARIES}
|
|
${AUDASPACE_PY_LIBRARIES}
|
|
)
|
|
endif()
|
|
|
|
add_definitions(${GL_DEFINITIONS})
|
|
|
|
if(WITH_INTERNATIONAL)
|
|
add_definitions(-DWITH_INTERNATIONAL)
|
|
endif()
|
|
|
|
if(WITH_OPENCOLLADA)
|
|
add_definitions(-DWITH_COLLADA)
|
|
endif()
|
|
|
|
if(WITH_CODEC_FFMPEG)
|
|
list(APPEND INC_SYS
|
|
${FFMPEG_INCLUDE_DIRS}
|
|
)
|
|
list(APPEND LIB
|
|
${FFMPEG_LIBRARIES}
|
|
)
|
|
add_definitions(-DWITH_FFMPEG)
|
|
endif()
|
|
|
|
if(WITH_HEADLESS)
|
|
add_definitions(-DWITH_HEADLESS)
|
|
elseif(WITH_X11)
|
|
add_definitions(-DWITH_X11)
|
|
endif()
|
|
|
|
if(WITH_PYTHON)
|
|
list(APPEND INC
|
|
../python
|
|
)
|
|
add_definitions(-DWITH_PYTHON)
|
|
endif()
|
|
|
|
if(WITH_BUILDINFO)
|
|
add_definitions(-DWITH_BUILDINFO)
|
|
endif()
|
|
|
|
if(WITH_OPENSUBDIV)
|
|
add_definitions(-DWITH_OPENSUBDIV)
|
|
endif()
|
|
|
|
if(WITH_INPUT_NDOF)
|
|
add_definitions(-DWITH_INPUT_NDOF)
|
|
endif()
|
|
|
|
if(WIN32)
|
|
if(WITH_INPUT_IME)
|
|
add_definitions(-DWITH_INPUT_IME)
|
|
endif()
|
|
endif()
|
|
|
|
if(WITH_COMPOSITOR)
|
|
list(APPEND LIB
|
|
bf_compositor
|
|
)
|
|
add_definitions(-DWITH_COMPOSITOR)
|
|
endif()
|
|
|
|
if(WITH_XR_OPENXR)
|
|
add_definitions(-DWITH_XR_OPENXR)
|
|
list(APPEND SRC
|
|
intern/wm_xr.c
|
|
)
|
|
endif()
|
|
|
|
blender_add_lib_nolist(bf_windowmanager "${SRC}" "${INC}" "${INC_SYS}" "${LIB}")
|