cb12fb78ca
Adds internal API for creating and managing OpenXR actions at the GHOST and WM layers. Does not bring about any changes for users since XR action functionality is not yet exposed in the Python API (will be added in a subsequent patch). OpenXR actions are a means to communicate with XR input devices and can be used to retrieve button/pose states or apply haptic feedback. Actions are bound to device inputs via a semantic path binding (https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#semantic-path-interaction-profiles), which serves as an XR version of keymaps. Main features: - Abstraction of OpenXR action management functions to GHOST-XR, WM-XR APIs. - New "xr_session_start_pre" callback for creating actions at appropriate point in the XR session. - Creation of name-identifiable action sets/actions. - Binding of actions to controller inputs. - Acquisition of controller button states. - Acquisition of controller poses. - Application of controller haptic feedback. - Carefully designed error handling and useful error reporting (e.g. action set/action name included in error message). Reviewed By: Julian Eisel Differential Revision: http://developer.blender.org/D10942
48 lines
1.6 KiB
C++
48 lines
1.6 KiB
C++
/*
|
|
* 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.
|
|
*/
|
|
|
|
/** \file
|
|
* \ingroup GHOST
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "GHOST_Types.h"
|
|
|
|
class GHOST_XrSession;
|
|
|
|
class GHOST_IXrContext {
|
|
public:
|
|
virtual ~GHOST_IXrContext() = default;
|
|
|
|
virtual void startSession(const GHOST_XrSessionBeginInfo *begin_info) = 0;
|
|
virtual void endSession() = 0;
|
|
virtual bool isSessionRunning() const = 0;
|
|
virtual void drawSessionViews(void *draw_customdata) = 0;
|
|
|
|
/* Needed for the GHOST C api. */
|
|
virtual GHOST_XrSession *getSession() = 0;
|
|
virtual const GHOST_XrSession *getSession() const = 0;
|
|
|
|
virtual void dispatchErrorMessage(const class GHOST_XrException *) const = 0;
|
|
|
|
virtual void setGraphicsContextBindFuncs(GHOST_XrGraphicsContextBindFn bind_fn,
|
|
GHOST_XrGraphicsContextUnbindFn unbind_fn) = 0;
|
|
virtual void setDrawViewFunc(GHOST_XrDrawViewFn draw_view_fn) = 0;
|
|
|
|
virtual bool needsUpsideDownDrawing() const = 0;
|
|
};
|