DtOculusEventManager.h

Go to the documentation of this file.

/******************************************************************************
** Copyright (c) 2025 MAK Technologies
** All rights reserved.
******************************************************************************/
 
//! \file DtOculusEventManager.h
//! \brief Oculus-specific implementation of VR controller event management
//! \ingroup vrvVirtualRealityController
//!
//! This file contains the Oculus-specific implementation of the virtual reality
//! event manager. It handles processing of Oculus Touch controller inputs and
//! translating them into a common VR controller event format used throughout
//! the application.
 
#pragma once
 
#include <vrvVirtualRealityController/vrvVirtualRealityController.h>
#include <vrvVirtualRealityController/DtVirtualRealityEventManager.h>
#include <vrvVirtualRealityController/DtVirtualRealityControllerState.h>
 
#include "OVR_CAPI.h"
 
namespace makVrv
{
//! \brief Oculus-specific implementation of the virtual reality event manager
//!
//! This class is responsible for processing Oculus Touch controller events and
//! translating them into the common VR controller event format. It communicates
//! with the Oculus SDK to retrieve controller state information and dispatches
//! controller events to registered event processors.
//!
//! \note This class is created automatically by the DtVirtualRealityDriver
//!       and is not intended to be instantiated directly by users.
class DT_DLL_VRVVRCTLR DtOculusEventManager : public DtVirtualRealityEventManager
{
private:
   //! \brief Unused default constructor
   DtOculusEventManager();
 
public:
   //! \brief Gets the singleton instance of the Oculus event manager
   //! \param de Reference to the display engine
   //! \return Reference to the singleton instance
   //! \throws DtCorruptedState if it is unable to get the instance
   //!
   //! Returns the singleton instance of the Oculus event manager, creating it
   //! if it doesn't already exist. This method is called by the VR driver
   //! during initialization.
   static DtVirtualRealityEventManager& instance(DtDe& de);
 
   //! \brief Virtual destructor
   //!
   //! Cleans up Oculus event manager resources and releases connections
   //! to the Oculus SDK.
   virtual ~DtOculusEventManager() override;
 
   //       //! \brief get/set the deadzone for the given axis of the given controller.
   //       virtual DtVector2f deadZone(DtVirtualRealityControllerState::Controller,
   //       DtVirtualRealityControllerState::Axis) const; virtual void
   //       setDeadZone(DtVirtualRealityControllerState::Controller, DtVirtualRealityControllerState::Axis, const
   //       DtVector2f&);
 
protected:
   //! \brief Constructor
   //! \param de Reference to the display engine
   //!
   //! Initializes the Oculus event manager with a reference to the display engine.
   //! This constructor is only called by the registerInstance method and
   //! should not be called directly.
   DtOculusEventManager(DtDe& de);
 
   //! \brief Collects and dispatches events from the Oculus VR system
   //!
   //! Polls the Oculus SDK for controller state updates, processes button and
   //! analog input events, and dispatches them to registered event processors.
   //!
   //! \note This method is called by the DtVirtualRealityDriver during the
   //!       update cycle and is not intended to be called directly by users.
   virtual void processVrEvents() override;
 
   //! \brief Updates controller positions from Oculus tracking data
   //! \param tracking The Oculus tracking state containing position and orientation data
   //!
   //! Processes the controller tracking data from the Oculus SDK and updates
   //! the internal controller state with new position and orientation information.
   virtual void updateControllerPositions(ovrTrackingState& tracking);
 
   //! \brief Updates controller input states from Oculus input data
   //! \param inputState The Oculus input state containing button and analog input data
   //!
   //! Processes the controller input data from the Oculus SDK and updates
   //! the internal controller state with button presses, touches, and
   //! analog input values.
   virtual void updateControllerInputs(ovrInputState& inputState);
 
   //! \brief Determines the device type for a given controller ID
   //! \param deviceId The controller identifier to query
   //! \return Bitfield representing the device type
   //!
   //! Maps an Oculus-specific device identifier to the common controller device
   //! type enumeration used throughout the application.
   virtual DtVirtualRealityControllerState::Bitfield findDeviceType(
      DtVirtualRealityControllerState::ControllerId deviceId) const;
 
protected:
};
} // namespace makVrv