2017-12-16 03:57:20 +11:00
|
|
|
/*
|
|
|
|
|
* 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.
|
|
|
|
|
*/
|
|
|
|
|
|
2019-02-18 08:08:12 +11:00
|
|
|
/** \file
|
|
|
|
|
* \ingroup spview3d
|
2017-12-16 03:57:20 +11:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#include "BLI_math.h"
|
|
|
|
|
#include "BLI_utildefines.h"
|
|
|
|
|
|
|
|
|
|
#include "BKE_context.h"
|
|
|
|
|
#include "BKE_object.h"
|
|
|
|
|
|
|
|
|
|
#include "DNA_object_types.h"
|
|
|
|
|
|
2018-07-14 23:16:34 +02:00
|
|
|
#include "ED_gizmo_library.h"
|
2020-03-19 09:33:03 +01:00
|
|
|
#include "ED_screen.h"
|
2017-12-16 03:57:20 +11:00
|
|
|
|
2018-04-28 16:00:41 +02:00
|
|
|
#include "UI_interface.h"
|
2017-12-16 03:57:20 +11:00
|
|
|
#include "UI_resources.h"
|
|
|
|
|
|
|
|
|
|
#include "MEM_guardedalloc.h"
|
|
|
|
|
|
|
|
|
|
#include "RNA_access.h"
|
|
|
|
|
|
|
|
|
|
#include "WM_api.h"
|
|
|
|
|
#include "WM_types.h"
|
|
|
|
|
|
|
|
|
|
#include "view3d_intern.h" /* own include */
|
|
|
|
|
|
|
|
|
|
/* -------------------------------------------------------------------- */
|
2018-07-14 23:49:00 +02:00
|
|
|
/** \name View3D Navigation Gizmo Group
|
2017-12-16 03:57:20 +11:00
|
|
|
* \{ */
|
|
|
|
|
|
|
|
|
|
/* Offset from screen edge. */
|
2018-10-01 12:47:37 +02:00
|
|
|
#define GIZMO_OFFSET_FAC 1.2f
|
2017-12-16 03:57:20 +11:00
|
|
|
/* Size of main icon. */
|
2018-07-15 11:28:28 +02:00
|
|
|
#define GIZMO_SIZE 80
|
2018-10-01 12:47:37 +02:00
|
|
|
/* Factor for size of smaller button. */
|
|
|
|
|
#define GIZMO_MINI_FAC 0.35f
|
2017-12-16 03:57:20 +11:00
|
|
|
/* How much mini buttons offset from the primary. */
|
2018-10-01 12:47:37 +02:00
|
|
|
#define GIZMO_MINI_OFFSET_FAC 0.38f
|
2017-12-16 03:57:20 +11:00
|
|
|
|
|
|
|
|
enum {
|
2019-01-02 15:43:58 +11:00
|
|
|
GZ_INDEX_MOVE = 0,
|
|
|
|
|
GZ_INDEX_ROTATE = 1,
|
|
|
|
|
GZ_INDEX_ZOOM = 2,
|
2018-01-15 20:46:42 +11:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
/* just buttons */
|
2019-01-02 15:43:58 +11:00
|
|
|
/* overlaps GZ_INDEX_ORTHO (switch between) */
|
|
|
|
|
GZ_INDEX_PERSP = 3,
|
|
|
|
|
GZ_INDEX_ORTHO = 4,
|
|
|
|
|
GZ_INDEX_CAMERA = 5,
|
2018-01-15 20:46:42 +11:00
|
|
|
|
2019-01-02 15:43:58 +11:00
|
|
|
GZ_INDEX_TOTAL = 6,
|
2018-01-15 20:46:42 +11:00
|
|
|
};
|
2017-12-16 03:57:20 +11:00
|
|
|
|
2018-07-14 23:49:00 +02:00
|
|
|
struct NavigateGizmoInfo {
|
2017-12-16 03:57:20 +11:00
|
|
|
const char *opname;
|
2018-07-14 23:49:00 +02:00
|
|
|
const char *gizmo;
|
2018-09-27 19:15:18 +02:00
|
|
|
uint icon;
|
2017-12-16 03:57:20 +11:00
|
|
|
};
|
|
|
|
|
|
2019-01-02 15:43:58 +11:00
|
|
|
static struct NavigateGizmoInfo g_navigate_params[GZ_INDEX_TOTAL] = {
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
|
|
|
|
.opname = "VIEW3D_OT_move",
|
2018-07-15 14:24:10 +02:00
|
|
|
.gizmo = "GIZMO_GT_button_2d",
|
2018-09-27 19:15:18 +02:00
|
|
|
ICON_VIEW_PAN,
|
2017-12-16 03:57:20 +11:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
.opname = "VIEW3D_OT_rotate",
|
2018-07-15 14:24:10 +02:00
|
|
|
.gizmo = "VIEW3D_GT_navigate_rotate",
|
2018-09-27 19:15:18 +02:00
|
|
|
0,
|
2017-12-16 03:57:20 +11:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
.opname = "VIEW3D_OT_zoom",
|
2018-07-15 14:24:10 +02:00
|
|
|
.gizmo = "GIZMO_GT_button_2d",
|
2018-09-27 19:15:18 +02:00
|
|
|
ICON_VIEW_ZOOM,
|
2018-01-15 20:46:42 +11:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
.opname = "VIEW3D_OT_view_persportho",
|
2018-07-15 14:24:10 +02:00
|
|
|
.gizmo = "GIZMO_GT_button_2d",
|
2018-09-27 19:15:18 +02:00
|
|
|
ICON_VIEW_PERSPECTIVE,
|
2017-12-16 03:57:20 +11:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
.opname = "VIEW3D_OT_view_persportho",
|
2018-07-15 14:24:10 +02:00
|
|
|
.gizmo = "GIZMO_GT_button_2d",
|
2018-09-27 19:15:18 +02:00
|
|
|
ICON_VIEW_ORTHO,
|
2017-12-16 03:57:20 +11:00
|
|
|
},
|
|
|
|
|
{
|
2018-07-05 16:54:30 +02:00
|
|
|
.opname = "VIEW3D_OT_view_camera",
|
2018-07-15 14:24:10 +02:00
|
|
|
.gizmo = "GIZMO_GT_button_2d",
|
2018-09-27 19:15:18 +02:00
|
|
|
ICON_VIEW_CAMERA,
|
2017-12-16 03:57:20 +11:00
|
|
|
},
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
struct NavigateWidgetGroup {
|
2019-01-02 15:43:58 +11:00
|
|
|
wmGizmo *gz_array[GZ_INDEX_TOTAL];
|
2018-01-23 17:11:13 +11:00
|
|
|
/* Store the view state to check for changes. */
|
|
|
|
|
struct {
|
2018-05-16 08:46:40 +02:00
|
|
|
rcti rect_visible;
|
2018-01-23 17:11:13 +11:00
|
|
|
struct {
|
|
|
|
|
char is_persp;
|
2018-06-01 10:16:01 +02:00
|
|
|
char is_camera;
|
2018-01-23 17:11:13 +11:00
|
|
|
char viewlock;
|
|
|
|
|
} rv3d;
|
|
|
|
|
} state;
|
2017-12-16 03:57:20 +11:00
|
|
|
int region_size[2];
|
|
|
|
|
};
|
|
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
static bool WIDGETGROUP_navigate_poll(const bContext *C, wmGizmoGroupType *UNUSED(gzgt))
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
2018-06-05 14:24:58 +02:00
|
|
|
View3D *v3d = CTX_wm_view3d(C);
|
2019-06-25 21:34:21 +10:00
|
|
|
if ((((U.uiflag & USER_SHOW_GIZMO_NAVIGATE) == 0) &&
|
|
|
|
|
(U.mini_axis_type != USER_MINI_AXIS_TYPE_GIZMO)) ||
|
2018-07-15 14:24:10 +02:00
|
|
|
(v3d->gizmo_flag & (V3D_GIZMO_HIDE | V3D_GIZMO_HIDE_NAVIGATE))) {
|
2018-06-05 14:24:58 +02:00
|
|
|
return false;
|
|
|
|
|
}
|
2018-07-11 10:38:01 +02:00
|
|
|
return true;
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
|
|
|
|
|
2019-05-28 02:14:31 +10:00
|
|
|
static void WIDGETGROUP_navigate_setup(const bContext *C, wmGizmoGroup *gzgroup)
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
|
|
|
|
struct NavigateWidgetGroup *navgroup = MEM_callocN(sizeof(struct NavigateWidgetGroup), __func__);
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
navgroup->region_size[0] = -1;
|
|
|
|
|
navgroup->region_size[1] = -1;
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2018-07-05 16:54:30 +02:00
|
|
|
wmOperatorType *ot_view_axis = WM_operatortype_find("VIEW3D_OT_view_axis", true);
|
|
|
|
|
wmOperatorType *ot_view_camera = WM_operatortype_find("VIEW3D_OT_view_camera", true);
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-01-02 15:43:58 +11:00
|
|
|
for (int i = 0; i < GZ_INDEX_TOTAL; i++) {
|
2018-07-14 23:49:00 +02:00
|
|
|
const struct NavigateGizmoInfo *info = &g_navigate_params[i];
|
2018-07-15 14:24:10 +02:00
|
|
|
navgroup->gz_array[i] = WM_gizmo_new(info->gizmo, gzgroup, NULL);
|
|
|
|
|
wmGizmo *gz = navgroup->gz_array[i];
|
2018-09-06 12:13:01 +02:00
|
|
|
gz->flag |= WM_GIZMO_MOVE_CURSOR | WM_GIZMO_DRAW_MODAL;
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-01-02 15:43:58 +11:00
|
|
|
if (i == GZ_INDEX_ROTATE) {
|
2018-08-16 12:47:24 +10:00
|
|
|
gz->color[3] = 0.0f;
|
2019-03-04 00:11:07 +11:00
|
|
|
copy_v3_fl(gz->color_hi, 0.5f);
|
|
|
|
|
gz->color_hi[3] = 0.5f;
|
2018-08-16 12:47:24 +10:00
|
|
|
}
|
|
|
|
|
else {
|
2019-03-03 11:27:36 +11:00
|
|
|
uchar icon_color[3];
|
|
|
|
|
UI_GetThemeColor3ubv(TH_TEXT, icon_color);
|
|
|
|
|
int color_tint, color_tint_hi;
|
|
|
|
|
if (icon_color[0] > 128) {
|
|
|
|
|
color_tint = -40;
|
|
|
|
|
color_tint_hi = 60;
|
|
|
|
|
gz->color[3] = 0.5f;
|
|
|
|
|
gz->color_hi[3] = 0.5f;
|
|
|
|
|
}
|
|
|
|
|
else {
|
|
|
|
|
color_tint = 60;
|
|
|
|
|
color_tint_hi = 60;
|
|
|
|
|
gz->color[3] = 0.5f;
|
|
|
|
|
gz->color_hi[3] = 0.75f;
|
|
|
|
|
}
|
|
|
|
|
UI_GetThemeColorShade3fv(TH_HEADER, color_tint, gz->color);
|
|
|
|
|
UI_GetThemeColorShade3fv(TH_HEADER, color_tint_hi, gz->color_hi);
|
2018-08-16 12:47:24 +10:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
/* may be overwritten later */
|
2018-10-01 12:47:37 +02:00
|
|
|
gz->scale_basis = (GIZMO_SIZE * GIZMO_MINI_FAC) / 2;
|
2018-09-27 19:15:18 +02:00
|
|
|
if (info->icon != 0) {
|
|
|
|
|
PropertyRNA *prop = RNA_struct_find_property(gz->ptr, "icon");
|
|
|
|
|
RNA_property_enum_set(gz->ptr, prop, info->icon);
|
2018-10-01 12:47:37 +02:00
|
|
|
RNA_enum_set(
|
|
|
|
|
gz->ptr, "draw_options", ED_GIZMO_BUTTON_SHOW_OUTLINE | ED_GIZMO_BUTTON_SHOW_BACKDROP);
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
wmOperatorType *ot = WM_operatortype_find(info->opname, true);
|
2018-07-15 14:24:10 +02:00
|
|
|
WM_gizmo_operator_set(gz, 0, ot, NULL);
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
2019-01-02 15:43:58 +11:00
|
|
|
wmGizmo *gz = navgroup->gz_array[GZ_INDEX_CAMERA];
|
2018-07-15 14:24:10 +02:00
|
|
|
WM_gizmo_operator_set(gz, 0, ot_view_camera, NULL);
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2018-01-24 23:29:17 +11:00
|
|
|
/* Click only buttons (not modal). */
|
|
|
|
|
{
|
2019-01-02 15:43:58 +11:00
|
|
|
int gz_ids[] = {GZ_INDEX_PERSP, GZ_INDEX_ORTHO, GZ_INDEX_CAMERA};
|
2018-07-15 14:24:10 +02:00
|
|
|
for (int i = 0; i < ARRAY_SIZE(gz_ids); i++) {
|
|
|
|
|
wmGizmo *gz = navgroup->gz_array[gz_ids[i]];
|
|
|
|
|
RNA_boolean_set(gz->ptr, "show_drag", false);
|
2018-01-24 23:29:17 +11:00
|
|
|
}
|
|
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2018-01-29 17:40:19 +11:00
|
|
|
/* Modal operators, don't use initial mouse location since we're clicking on a button. */
|
|
|
|
|
{
|
2019-01-02 15:43:58 +11:00
|
|
|
int gz_ids[] = {GZ_INDEX_MOVE, GZ_INDEX_ROTATE, GZ_INDEX_ZOOM};
|
2018-07-15 14:24:10 +02:00
|
|
|
for (int i = 0; i < ARRAY_SIZE(gz_ids); i++) {
|
|
|
|
|
wmGizmo *gz = navgroup->gz_array[gz_ids[i]];
|
2018-10-16 22:08:43 +11:00
|
|
|
wmGizmoOpElem *gzop = WM_gizmo_operator_get(gz, 0);
|
2019-05-31 19:53:24 +10:00
|
|
|
RNA_boolean_set(&gzop->ptr, "use_cursor_init", false);
|
2018-01-29 17:40:19 +11:00
|
|
|
}
|
|
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
2019-01-02 15:43:58 +11:00
|
|
|
wmGizmo *gz = navgroup->gz_array[GZ_INDEX_ROTATE];
|
2018-07-15 14:24:10 +02:00
|
|
|
gz->scale_basis = GIZMO_SIZE / 2;
|
2019-09-14 08:10:50 +10:00
|
|
|
const char mapping[6] = {
|
2017-12-16 03:57:20 +11:00
|
|
|
RV3D_VIEW_LEFT,
|
|
|
|
|
RV3D_VIEW_RIGHT,
|
|
|
|
|
RV3D_VIEW_FRONT,
|
|
|
|
|
RV3D_VIEW_BACK,
|
|
|
|
|
RV3D_VIEW_BOTTOM,
|
|
|
|
|
RV3D_VIEW_TOP,
|
|
|
|
|
};
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-19 14:36:22 +11:00
|
|
|
for (int part_index = 0; part_index < 6; part_index += 1) {
|
2018-07-15 14:24:10 +02:00
|
|
|
PointerRNA *ptr = WM_gizmo_operator_set(gz, part_index + 1, ot_view_axis, NULL);
|
2017-12-19 14:36:22 +11:00
|
|
|
RNA_enum_set(ptr, "type", mapping[part_index]);
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-05-28 13:26:50 +10:00
|
|
|
/* When dragging an axis, use this instead. */
|
2019-05-28 02:14:31 +10:00
|
|
|
wmWindowManager *wm = CTX_wm_manager(C);
|
2019-05-29 13:01:38 +10:00
|
|
|
gz->keymap = WM_gizmo_keymap_generic_click_drag(wm);
|
2019-05-28 13:26:50 +10:00
|
|
|
gz->drag_part = 0;
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
gzgroup->customdata = navgroup;
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
|
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
static void WIDGETGROUP_navigate_draw_prepare(const bContext *C, wmGizmoGroup *gzgroup)
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
2018-07-15 14:24:10 +02:00
|
|
|
struct NavigateWidgetGroup *navgroup = gzgroup->customdata;
|
2020-03-06 16:56:42 +01:00
|
|
|
ARegion *region = CTX_wm_region(C);
|
|
|
|
|
const RegionView3D *rv3d = region->regiondata;
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2017-12-16 03:57:20 +11:00
|
|
|
for (int i = 0; i < 3; i++) {
|
2019-01-02 15:43:58 +11:00
|
|
|
copy_v3_v3(navgroup->gz_array[GZ_INDEX_ROTATE]->matrix_offset[i], rv3d->viewmat[i]);
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2020-03-06 16:56:42 +01:00
|
|
|
const rcti *rect_visible = ED_region_visible_rect(region);
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-08-16 05:41:43 +10:00
|
|
|
if ((navgroup->state.rect_visible.xmax == rect_visible->xmax) &&
|
|
|
|
|
(navgroup->state.rect_visible.ymax == rect_visible->ymax) &&
|
2018-01-23 17:11:13 +11:00
|
|
|
(navgroup->state.rv3d.is_persp == rv3d->is_persp) &&
|
2018-06-01 10:16:01 +02:00
|
|
|
(navgroup->state.rv3d.is_camera == (rv3d->persp == RV3D_CAMOB)) &&
|
VR: Initial Virtual Reality support - Milestone 1, Scene Inspection
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
2020-03-17 20:20:55 +01:00
|
|
|
(navgroup->state.rv3d.viewlock == RV3D_LOCK_FLAGS(rv3d))) {
|
2017-12-16 03:57:20 +11:00
|
|
|
return;
|
|
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-08-16 05:41:43 +10:00
|
|
|
navgroup->state.rect_visible = *rect_visible;
|
2018-01-23 17:11:13 +11:00
|
|
|
navgroup->state.rv3d.is_persp = rv3d->is_persp;
|
2018-06-01 10:16:01 +02:00
|
|
|
navgroup->state.rv3d.is_camera = (rv3d->persp == RV3D_CAMOB);
|
VR: Initial Virtual Reality support - Milestone 1, Scene Inspection
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
2020-03-17 20:20:55 +01:00
|
|
|
navgroup->state.rv3d.viewlock = RV3D_LOCK_FLAGS(rv3d);
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-06-25 21:34:21 +10:00
|
|
|
const bool show_navigate = (U.uiflag & USER_SHOW_GIZMO_NAVIGATE) != 0;
|
|
|
|
|
const bool show_rotate_gizmo = (U.mini_axis_type == USER_MINI_AXIS_TYPE_GIZMO);
|
2018-07-14 23:49:00 +02:00
|
|
|
const float icon_size = GIZMO_SIZE;
|
|
|
|
|
const float icon_offset = (icon_size * 0.52f) * GIZMO_OFFSET_FAC * UI_DPI_FAC;
|
|
|
|
|
const float icon_offset_mini = icon_size * GIZMO_MINI_OFFSET_FAC * UI_DPI_FAC;
|
2018-06-13 10:51:52 +02:00
|
|
|
const float co_rotate[2] = {
|
2019-08-16 05:41:43 +10:00
|
|
|
rect_visible->xmax - icon_offset,
|
|
|
|
|
rect_visible->ymax - icon_offset,
|
2018-06-13 10:51:52 +02:00
|
|
|
};
|
2019-06-25 21:34:21 +10:00
|
|
|
|
|
|
|
|
float icon_offset_from_axis = 0.0f;
|
|
|
|
|
switch ((eUserpref_MiniAxisType)U.mini_axis_type) {
|
|
|
|
|
case USER_MINI_AXIS_TYPE_GIZMO:
|
2019-09-06 06:19:45 +10:00
|
|
|
icon_offset_from_axis = icon_offset * 2.1f;
|
2019-06-25 21:34:21 +10:00
|
|
|
break;
|
|
|
|
|
case USER_MINI_AXIS_TYPE_MINIMAL:
|
|
|
|
|
icon_offset_from_axis = (UI_UNIT_X * 2.5) + ((U.rvisize * U.pixelsize * 2.0f));
|
|
|
|
|
break;
|
|
|
|
|
case USER_MINI_AXIS_TYPE_NONE:
|
|
|
|
|
icon_offset_from_axis = icon_offset_mini * 0.75f;
|
|
|
|
|
break;
|
|
|
|
|
}
|
|
|
|
|
|
2018-06-13 10:51:52 +02:00
|
|
|
const float co[2] = {
|
2020-02-02 19:26:46 +11:00
|
|
|
roundf(rect_visible->xmax - icon_offset_mini * 0.75f),
|
|
|
|
|
roundf(rect_visible->ymax - icon_offset_from_axis),
|
2018-06-13 10:51:52 +02:00
|
|
|
};
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
wmGizmo *gz;
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
for (uint i = 0; i < ARRAY_SIZE(navgroup->gz_array); i++) {
|
|
|
|
|
gz = navgroup->gz_array[i];
|
|
|
|
|
WM_gizmo_set_flag(gz, WM_GIZMO_HIDDEN, true);
|
2018-01-23 17:11:13 +11:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-06-25 21:34:21 +10:00
|
|
|
if (show_rotate_gizmo) {
|
2019-01-02 15:43:58 +11:00
|
|
|
gz = navgroup->gz_array[GZ_INDEX_ROTATE];
|
2020-09-02 23:05:35 +10:00
|
|
|
gz->matrix_basis[3][0] = roundf(co_rotate[0]);
|
|
|
|
|
gz->matrix_basis[3][1] = roundf(co_rotate[1]);
|
2018-07-15 14:24:10 +02:00
|
|
|
WM_gizmo_set_flag(gz, WM_GIZMO_HIDDEN, false);
|
2018-06-13 10:51:52 +02:00
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
2019-06-25 21:34:21 +10:00
|
|
|
if (show_navigate) {
|
|
|
|
|
int icon_mini_slot = 0;
|
VR: Initial Virtual Reality support - Milestone 1, Scene Inspection
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
2020-03-17 20:20:55 +01:00
|
|
|
if ((RV3D_LOCK_FLAGS(rv3d) & RV3D_LOCK_ZOOM_AND_DOLLY) == 0) {
|
|
|
|
|
gz = navgroup->gz_array[GZ_INDEX_ZOOM];
|
|
|
|
|
gz->matrix_basis[3][0] = roundf(co[0]);
|
|
|
|
|
gz->matrix_basis[3][1] = roundf(co[1] - (icon_offset_mini * icon_mini_slot++));
|
|
|
|
|
WM_gizmo_set_flag(gz, WM_GIZMO_HIDDEN, false);
|
|
|
|
|
}
|
2019-04-17 06:17:24 +02:00
|
|
|
|
VR: Initial Virtual Reality support - Milestone 1, Scene Inspection
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
2020-03-17 20:20:55 +01:00
|
|
|
if ((RV3D_LOCK_FLAGS(rv3d) & RV3D_LOCK_LOCATION) == 0) {
|
|
|
|
|
gz = navgroup->gz_array[GZ_INDEX_MOVE];
|
2020-03-09 17:08:35 +01:00
|
|
|
gz->matrix_basis[3][0] = roundf(co[0]);
|
|
|
|
|
gz->matrix_basis[3][1] = roundf(co[1] - (icon_offset_mini * icon_mini_slot++));
|
2018-07-15 14:24:10 +02:00
|
|
|
WM_gizmo_set_flag(gz, WM_GIZMO_HIDDEN, false);
|
VR: Initial Virtual Reality support - Milestone 1, Scene Inspection
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
2020-03-17 20:20:55 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if ((RV3D_LOCK_FLAGS(rv3d) & RV3D_LOCK_ROTATION) == 0) {
|
|
|
|
|
gz = navgroup->gz_array[GZ_INDEX_CAMERA];
|
2020-04-03 11:29:45 +02:00
|
|
|
gz->matrix_basis[3][0] = roundf(co[0]);
|
|
|
|
|
gz->matrix_basis[3][1] = roundf(co[1] - (icon_offset_mini * icon_mini_slot++));
|
VR: Initial Virtual Reality support - Milestone 1, Scene Inspection
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
2020-03-17 20:20:55 +01:00
|
|
|
WM_gizmo_set_flag(gz, WM_GIZMO_HIDDEN, false);
|
2019-06-25 21:34:21 +10:00
|
|
|
|
|
|
|
|
if (navgroup->state.rv3d.is_camera == false) {
|
|
|
|
|
gz = navgroup->gz_array[rv3d->is_persp ? GZ_INDEX_PERSP : GZ_INDEX_ORTHO];
|
2020-04-03 11:29:45 +02:00
|
|
|
gz->matrix_basis[3][0] = roundf(co[0]);
|
|
|
|
|
gz->matrix_basis[3][1] = roundf(co[1] - (icon_offset_mini * icon_mini_slot++));
|
2019-06-25 21:34:21 +10:00
|
|
|
WM_gizmo_set_flag(gz, WM_GIZMO_HIDDEN, false);
|
|
|
|
|
}
|
2018-06-01 10:16:01 +02:00
|
|
|
}
|
2018-01-23 17:11:13 +11:00
|
|
|
}
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
|
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
void VIEW3D_GGT_navigate(wmGizmoGroupType *gzgt)
|
2017-12-16 03:57:20 +11:00
|
|
|
{
|
2018-07-15 14:24:10 +02:00
|
|
|
gzgt->name = "View3D Navigate";
|
|
|
|
|
gzgt->idname = "VIEW3D_GGT_navigate";
|
2017-12-16 03:57:20 +11:00
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
gzgt->flag |= (WM_GIZMOGROUPTYPE_PERSISTENT | WM_GIZMOGROUPTYPE_SCALE |
|
2018-07-14 23:49:00 +02:00
|
|
|
WM_GIZMOGROUPTYPE_DRAW_MODAL_ALL);
|
2017-12-16 03:57:20 +11:00
|
|
|
|
2018-07-15 14:24:10 +02:00
|
|
|
gzgt->poll = WIDGETGROUP_navigate_poll;
|
|
|
|
|
gzgt->setup = WIDGETGROUP_navigate_setup;
|
|
|
|
|
gzgt->draw_prepare = WIDGETGROUP_navigate_draw_prepare;
|
2017-12-16 03:57:20 +11:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** \} */
|