osgSensorViewDateTimeOverlaySection.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2025 MAK Technologies
** All rights reserved.
*******************************************************************************/
 
//! \file osgSensorViewDateTimeOverlaySection.h
//! \brief Defines the date and time overlay section for sensor views
//!
//! This file contains the DtOsgSensorViewDateTimeOverlaySection class which
//! provides a sensor view overlay that displays the current date and time.
//! This information helps users track when sensor data was captured or viewed.
 
#pragma once
 
#include "vrePlayerStation/export.h"
 
#include <vrvOsg/DtOsgSensorViewOverlaySection.h>
 
namespace makVrv
{
//! \brief Forward declaration of the display engine class
class DtDe;
 
//! \brief Forward declaration of the text proxy class
class DtTextProxy;
 
//! \brief Forward declaration of the overlay renderer class
class DtOverlayRenderer;
} // namespace makVrv
 
//! \brief Overlay section that displays current date and time in sensor views
//!
//! DtOsgSensorViewDateTimeOverlaySection provides a sensor view overlay that
//! displays the current date and time in a specified location. This information
//! is useful for situational awareness, data logging, and mission planning.
//! The overlay is positioned in the upper right corner of the sensor view by default.
class PLAYERSTATION_DLL DtOsgSensorViewDateTimeOverlaySection : public makVrv::DtOsgSensorViewOverlaySection
{
   //! \brief Horizontal position of the text as a fraction of display width (0.0-1.0)
   //!
   //! Value of 0.98 positions the text near the right edge of the display
   const double TextHorizLocation = 0.98;
 
   //! \brief Vertical position of the text as a fraction of display height (0.0-1.0)
   //!
   //! Value of 0.95 positions the text near the top edge of the display
   const double TextVertLocation = 0.95;
 
   //! \brief Default font size for the date/time text in points
   const double DefaultFontSize = 12;
 
   //! \brief Width of the text box as a fraction of display width
   const double TextBoxWidth = 0.3;
 
   //! \brief Height of the text box as a fraction of display height
   const double TextBoxHeight = 0.3;
 
public:
   //! \brief Friend declaration for creator class
   //!
   //! Only the creator class can construct instances of this section.
   friend class DtOsgSensorViewDateTimeOverlaySectionCreator;
 
   //! \brief Destructor
   //!
   //! Cleans up resources used by the date/time overlay section,
   //! particularly the text display objects.
   virtual ~DtOsgSensorViewDateTimeOverlaySection() override;
 
   //! \brief Initializes the overlay section
   //! \param overlayRenderer Renderer for creating overlay elements
   //! \param windowWidth Width of the window in pixels
   //! \param windowHeight Height of the window in pixels
   //! \param channelXOffset X offset of the channel in pixels
   //! \param channelYOffset Y offset of the channel in pixels
   //!
   //! Initializes the overlay section by creating the text element that displays
   //! the date and time. This must be called prior to any update calls. The position
   //! of the text is calculated based on the window dimensions and channel offsets.
   virtual void initialize(makVrv::DtOverlayRenderer& overlayRenderer, unsigned int windowWidth,
      unsigned int windowHeight, unsigned int channelXOffset, unsigned int channelYOffset) override;
 
   //! \brief Updates the overlay when the channel size changes
   //! \param windowWidth New width of the window in pixels
   //! \param windowHeight New height of the window in pixels
   //! \param channelXOffset New X offset of the channel in pixels
   //! \param channelYOffset New Y offset of the channel in pixels
   //!
   //! Adjusts the position and size of the text element when the channel
   //! dimensions or position change. This ensures the date/time display
   //! maintains its relative position in the view.
   virtual void setChannelSize(unsigned int windowWidth, unsigned int windowHeight, unsigned int channelXOffset,
      unsigned int channelYOffset) override;
 
   //! \brief Updates the date and time display
   //! \param observer Observer object representing the viewer's position and orientation
   //! \param state Current state of the sensor field of view
   //!
   //! Updates the overlay text with the current system date and time during each
   //! frame update. The date and time format is based on system settings.
   virtual void update(const makVrv::DtOsgObserverObject& observer,
      const makVrv::DtSensorFieldOfViewData& state) override;
 
   //! \brief Gets the unique name of this overlay section
   //! \return Reference to the section name string
   //!
   //! Returns the name of this section with which it may be retrieved from
   //! the DtOsgSensorViewOverlay. Each section type has a unique name.
   virtual const std::string& sectionName() const override;
 
public:
   //! \brief Static constant defining the section name
   //!
   //! This string identifier is used to register and retrieve this overlay section.
   static const std::string SectionName;
 
protected:
   //! \brief Protected constructor
   //! \param de Reference to the display engine
   //!
   //! Creates a new date/time overlay section. This constructor is protected
   //! because instances should only be created through the creator class.
   DtOsgSensorViewDateTimeOverlaySection(makVrv::DtDe& de)
      : DtOsgSensorViewOverlaySection(de)
      , myText(0)
   {
   }
 
   //! \brief Text element displaying the date and time
   //!
   //! Pointer to the text proxy object that renders the date and time text.
   //! This is created during initialization and updated during each update call.
   makVrv::DtTextProxy* myText;
};
 
//! \brief Factory class for creating date/time overlay sections
//!
//! DtOsgSensorViewDateTimeOverlaySectionCreator is responsible for creating
//! instances of DtOsgSensorViewDateTimeOverlaySection. It implements the
//! factory pattern, allowing the overlay system to create specialized sections
//! without knowing their implementation details.
class PLAYERSTATION_DLL DtOsgSensorViewDateTimeOverlaySectionCreator
   : public makVrv::DtOsgSensorViewOverlaySectionCreator
{
public:
   //! \brief Creates a new date/time overlay section
   //! \param de Reference to the display engine
   //! \return Pointer to the newly created overlay section
   //!
   //! Factory method that creates a new DtOsgSensorViewDateTimeOverlaySection
   //! instance with the specified display engine.
   virtual makVrv::DtOsgSensorViewOverlaySection* create(makVrv::DtDe& de) override
   {
      return new DtOsgSensorViewDateTimeOverlaySection(de);
   }
 
   //! \brief Creates a clone of this creator
   //! \return Pointer to a new instance of this creator
   //!
   //! Creates and returns a new instance of this creator class. This is used
   //! by the overlay system for creator registration and management.
   virtual makVrv::DtOsgSensorViewOverlaySectionCreator* clone() const override
   {
      return new DtOsgSensorViewDateTimeOverlaySectionCreator;
   }
};