laserDesignatorVisualizer.h

Go to the documentation of this file.

/******************************************************************************
** Copyright (c) 2025 MAK Technologies
** All rights reserved.
******************************************************************************/
 
//! \file laserDesignatorVisualizer.h
//! \brief Defines specialized laser designator visualizers for VR-Engage
//!
//! This file contains VR-Engage specific implementations of laser designator
//! visualization, providing both 2D and 3D visualization capabilities for
//! targeting systems. These classes extend the core VR-Vantage visualizers
//! with functionality specific to the VR-Engage application.
 
#pragma once
 
#include "vrePlayerStation/export.h"
#include <vrvCore/Dt3DLaserDesignatorVisualizer.h>
#include <vrvCore/Dt2DLaserDesignatorVisualizer.h>
 
namespace makVre
{
//! \brief 3D laser designator visualization for VR-Engage
//!
//! DtVre3DLaserDesignatorVisualizer provides VR-Engage specific implementation
//! for 3D visualization of laser designator beams. It extends the core VR-Vantage
//! 3D laser designator visualizer with custom appearance and behavior suitable
//! for the VR-Engage application's targeting visualization needs.
class PLAYERSTATION_DLL DtVre3DLaserDesignatorVisualizer : public makVrv::Dt3DLaserDesignatorVisualizer
{
public:
   //! \brief Constructor
   //! \param simulation Reference to the simulation connection
   //! \param listener Reference to the state listener for event notifications
   //! \param sceneObject Pointer to the scene object agent representing the designator source
   //! \param modelSet Model set identifier for the visualization
   //!
   //! Creates a new 3D laser designator visualizer specific to VR-Engage with the
   //! specified simulation connection, state listener, scene object, and model set.
   DtVre3DLaserDesignatorVisualizer(makVrv::DtBaseConnection& simulation, makVrv::DtStateListener& listener,
      makVrv::DtSceneObjectAgent* sceneObject, makVrv::DtModelSetId modelSet);
 
   //! \brief Virtual destructor
   //!
   //! Ensures proper cleanup of resources used by the visualizer.
   virtual ~DtVre3DLaserDesignatorVisualizer() override;
 
   //! \brief Creates the visual representation of the laser beam
   //!
   //! Overrides the base implementation to create a laser beam visualization
   //! with VR-Engage specific appearance and behavior. This includes custom
   //! texturing, color, and effects suitable for the application's targeting needs.
   virtual void createLaserLine() override;
};
 
//! \brief Creator type definition for 3D laser designator visualizers
//!
//! This typedef creates a factory for generating DtVre3DLaserDesignatorVisualizer
//! instances. It uses the template-based creator pattern from VR-Vantage to
//! register and instantiate visualizers when needed.
using DtVre3DLaserDesignatorVisualizerCreator =
   makVrv::DtStateVisualizerCreatorTemplate<DtVre3DLaserDesignatorVisualizer>;
 
 
//! \brief 2D laser designator visualization for VR-Engage
//!
//! DtVre2DLaserDesignatorVisualizer provides VR-Engage specific implementation
//! for 2D visualization of laser designator beams. It extends the core VR-Vantage
//! 2D laser designator visualizer with custom appearance and behavior suitable
//! for the VR-Engage application's targeting visualization needs in 2D views.
class PLAYERSTATION_DLL DtVre2DLaserDesignatorVisualizer : public makVrv::Dt2DLaserDesignatorVisualizer
{
public:
   //! \brief Constructor
   //! \param simulation Reference to the simulation connection
   //! \param listener Reference to the state listener for event notifications
   //! \param sceneObject Pointer to the scene object agent representing the designator source
   //! \param modelSet Model set identifier for the visualization
   //!
   //! Creates a new 2D laser designator visualizer specific to VR-Engage with the
   //! specified simulation connection, state listener, scene object, and model set.
   //! The 2D visualization is used for tactical displays, maps, and other 2D views.
   DtVre2DLaserDesignatorVisualizer(makVrv::DtBaseConnection& simulation, makVrv::DtStateListener& listener,
      makVrv::DtSceneObjectAgent* sceneObject, makVrv::DtModelSetId modelSet);
 
   //! \brief Virtual destructor
   //!
   //! Ensures proper cleanup of resources used by the visualizer.
   virtual ~DtVre2DLaserDesignatorVisualizer() override;
 
   //! \brief Creates the visual representation of the laser beam in 2D
   //!
   //! Overrides the base implementation to create a 2D laser beam visualization
   //! with VR-Engage specific appearance and behavior. This is typically shown
   //! as a line or arrow on 2D maps and tactical displays.
   virtual void createLaserLine() override;
};
 
//! \brief Creator type definition for 2D laser designator visualizers
//!
//! This typedef creates a factory for generating DtVre2DLaserDesignatorVisualizer
//! instances. It uses the template-based creator pattern from VR-Vantage to
//! register and instantiate visualizers when needed.
using DtVre2DLaserDesignatorVisualizerCreator =
   makVrv::DtStateVisualizerCreatorTemplate<DtVre2DLaserDesignatorVisualizer>;
} // namespace makVre