vreObserverModeMapper.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2025 MAK Technologies
** All rights reserved.
*******************************************************************************/
 
//! \file vreObserverModeMapper.h
//! \brief Defines a mapper for translating between observer mode identifiers
//!
//! This file contains the DtVreObserverModeMapper class which provides a way to
//! refer to VR-Vantage observer modes independently of whether the application
//! is running in CameraFX or SensorFX mode. It maps generic observer mode
//! identifiers used in VR-Engage to the specific mode names required by the
//! VR-Vantage API based on the current sensor library configuration.
 
#include "vrePlayerStation/export.h"
 
#include "vrePlayerStation/playerStationApp.h"
 
#include <string>
#include <map>
 
namespace makVre
{
//! \brief Structure to hold observer mode names for different sensor libraries
//!
//! DtVrvObserverModes stores the corresponding observer mode names for both
//! CameraFX and SensorFX libraries. These names match the <myName> entries
//! found in the default_ObserverModes.omcx configuration file in VR-Vantage.
using DtVrvObserverModes = struct _DtVrvObserverModes
{
   std::string observerModeCameraFX; //!< Observer mode name for CameraFX library
   std::string observerModeSensorFX; //!< Observer mode name for SensorFX library
};
 
//! \brief Type definition for a map of observer mode identifiers to mode names
using DtVreObserveModeTable = std::map<std::string, DtVrvObserverModes>;
 
//! \brief Mapper for translating between observer mode identifiers and actual mode names
//!
//! DtVreObserverModeMapper provides a way to use generic identifiers for observer
//! modes in VR-Engage while properly translating them to the specific observer mode
//! names required by VR-Vantage, which differ between CameraFX and SensorFX modes.
//! This allows VR-Engage configuration to remain independent of the underlying
//! visualization engine's sensor library implementation.
class PLAYERSTATION_DLL DtVreObserverModeMapper
{
public:
   //! \brief Constructor
   //! \param sensorLibrary The sensor library currently in use (CAMERA_FX or SENSOR_FX)
   //!
   //! Creates a new observer mode mapper configured for the specified sensor library.
   //! Any observer mode lookups will return the corresponding VR-Vantage observer
   //! mode name for this sensor library.
   DtVreObserverModeMapper(DtSensorLibrary sensorLibrary);
 
   //! \brief Destructor
   //!
   //! Cleans up resources used by the observer mode mapper.
   ~DtVreObserverModeMapper();
 
   //! \brief Initializes the mapper with observer mode mappings
   //! \param initTable LUA table containing observer mode mappings
   //! \return True if initialization succeeded, false otherwise
   //!
   //! Initializes the table of key strings and their corresponding CameraFX/SensorFX
   //! VR-Vantage observer mode names from the provided LUA table. The initTable
   //! parameter is typically the 'vreObserverModeMapper' table defined in
   //! playerStation.lua. Note that not every entry will have both CameraFX and
   //! SensorFX mappings, as there is not a perfect one-to-one correspondence
   //! between the observer modes available in each library.
   virtual bool initialize(DtInitTable& initTable);
 
   //! \brief Looks up the VR-Vantage observer mode name for a generic identifier
   //! \param key Generic observer mode identifier
   //! \return VR-Vantage observer mode name, or empty string if not found
   //!
   //! Translates a generic observer mode identifier to the appropriate VR-Vantage
   //! observer mode name based on the current sensor library configuration. For example,
   //! if the key string passed in is "IR" and the sensor library is SENSOR_FX, then
   //! the returned observer mode might be "LWIR (SensorFX)". If the requested mode
   //! is not available in the current sensor library, an empty string is returned.
   virtual std::string lookup(std::string key) const;
 
private:
   //! \brief Copy constructor (deleted)
   //!
   //! Copy construction is not supported for this class.
   DtVreObserverModeMapper(const DtVreObserverModeMapper& orig);
 
   //! \brief Assignment operator (deleted)
   //!
   //! Assignment is not supported for this class.
   DtVreObserverModeMapper& operator=(const DtVreObserverModeMapper& orig);
 
protected:
   //! \brief Current sensor library configuration
   //!
   //! Stores which sensor library (CAMERA_FX or SENSOR_FX) is currently in use
   //! in the application. This determines which set of observer mode names
   //! will be used during lookup operations.
   DtSensorLibrary mySensorLibrary;
 
   //! \brief Table mapping generic identifiers to observer mode names
   //!
   //! Table of DtVrvObserverMode entries, indexed by generic string identifiers.
   //! These identifiers provide an abstraction layer for configuring observer
   //! modes in VR-Engage independent of whether CameraFX or SensorFX is being used.
   DtVreObserveModeTable myObserverModeTable;
};
} // namespace makVre