include/vrvCore/DtObserver.h

Go to the documentation of this file.

/******************************************************************************
** Copyright (c) 2008 MAK Technologies, Inc.
** All rights reserved.
******************************************************************************/
/******************************************************************************
** $RCSfile: DtObserver.h,v $ $Revision: 1.43 $ $State: Exp $
******************************************************************************/


#pragma once

#include <vrvCore/vrvCore.h>
#include <vrvCore/DtElementData.h>
#include <vrvCore/DtUniqueID.h>
#include <vrvCore/DtObserverObject.h>
#include <vrvUtil/DtSignalConnectionManager.h>
#include <makArchives/DtObserverSettingsRecord.h>
#include <makArchives/DtObserverStateRecord.h>
#include <boost/signals.hpp>
#include <string>
#include <vector>

class DtTaitBryan;
class DtVector;

namespace makVrv
{   
   class DtObserverObjectAgent;
   class DtDe;
   class DtAgentManagerInterface;
   class DtObserverConfiguration;
   
   class DT_DLL_VRVCORE DtObserver
   {
   public:
      
      typedef std::vector<DtElementID> ElementList;

      DtObserver(DtDe& de, DtAgentManagerInterface& sceneInterface, 
         const DtObserverConfiguration& config );

      ~DtObserver();

      inline DtDe& de()
      {
         return myDe;
      }
      
      DtObserverObjectAgent& agent();

      const DtObserverObjectAgent& agent() const;

      bool getRecord(makArchives::DtObserverStateRecord& recOut) const;

      void setFromRecord(const makArchives::DtObserverStateRecord& rec);

      bool getRecord(makArchives::DtObserverSettingsRecord& recOut) const;

      void setFromRecord(const makArchives::DtObserverSettingsRecord& rec);

      bool hasInitialLocation() const;

      const std::string& name() const;
      void setName( const std::string& name ); 
      
      int observerMode() const;
      
      void setObserverMode( int observerMode );

      double viewResolution() const;

      void setViewResolution( double resolution );

      double viewMagnification() const;

      void setViewMagnification( double magnficationFactor );
    
      bool acceptingViewControl() const;

      DtObserverConfiguration& configuration();
      const DtObserverConfiguration& configuration() const;

      bool inUse( const std::string& channelKeyToIgnore = "" ) const;

      //@name Attachment functions.

      void attachToNextElement();

      void attachToPreviousElement();
     
      bool isAttached(DtElementID) const;

      bool isPrimaryAttached(DtElementID) const;

      bool isSecondaryAttached(DtElementID) const;

      void setPrimaryAttachment( const ElementList& element );

      void setSecondaryAttachment( const ElementList& objects );

      void setPartAttachment(int partId);

      int partAttachment() const;

      void detach();

      bool attached() const;

      bool tracking() const;

      const ElementList& primaryAttachments() const; 

      const ElementList& secondaryAttachments() const; 
      
      void setHideModelOnAttach( bool hide );
      bool hideModelOnAttach() const;
      
      void setAttachType( DtObserverObject::AttachType type );
      DtObserverObject::AttachType attachType() const;      
            
      void setOrientToTargetConstraint( bool orient );
      bool orientToTargetConstraint() const;

      DtElementID lastSingleAttached() const;

      bool haveLastSingleAttached() const;


      //@name Movement functions

      void reset();

      void setAllowReset(bool b);

      bool allowReset() const;

      void setAllowAttach(bool b);

      bool allowAttach() const;

      void setAllowDetach(bool b);

      bool allowDetach() const;

      void centerOnTerrain();

      void centerOnTerrain( const DtUniqueID& terrainPatch );
      
      void suppressConstrainToTerrain(  bool trueFalse );
      
      void setConstrainToCenter( bool trueFalse );
      void toggleConstrainToCenter();
      bool constrainToCenter() const;                      

      void getLocation( double &x, double &y, double& z ) const;

      DtVector location() const;
      
      void setLocation( double x, double y, double z );      

      void getOrientation( double& psi, double& theta, double& phi ) const;

      void setOrientation( double psi, double theta, double phi );
      
      void getOrientation( double& x, double& y, double& z, double& w ) const;

      void setOrientation( double x, double y, double z, double w );
      
      void moveUnit(const DtVector& direction);

      void rotateUnit(const DtTaitBryan& rotation);

      void getLinearVelocity(double &x, double &y, double &z)  const;

      void getRotationalVelocity( double& x, double& y, double& z ) const;     

      bool observerObjectMoving() const;

      double observerAltitude() const;

      //@name Attached Movement functions
      
      void setAttachedLocation( double x, double y, double z );

      void setAttachedOrientation( double psi, double theta, double phi );

      void setLocalModelScalingEnabled( bool enabled );

      void setLocalModelScalingAmount( float amount );


      //@name Speed functions

      void setOrbitSpeedGain( int gain, bool forwardToObserverModeManager = true );

      int orbitSpeedGain() const;

      int orbitSpeedGainFromSpeed( double speed ) const;

      void setRotationSpeedGain( int gain, bool forwardToObserverModeManager = true );
      int rotationSpeedGain() const;

      void setLinearSpeedGain( int gain );
      int linearSpeedGain() const;

      void setLinearScaledSpeedGain( int gain, bool forwardToObserverModeManager = true );
      int linearScaledSpeedGain() const;

      void setLinearUnscaledSpeedGain( int gain, bool forwardToObserverModeManager = true );
      int linearUnscaledSpeedGain() const;

      void setGainPrecision( int amt, bool forwardToObserverModeManager = true );
      int gainPrecision() const;

      void setModelScaleFactor( double modelScaleFactor, bool forwardToObserverModeManager = true );
      double modelScaleFactor() const;

      void setModelScaleType( DtObserverObject::ScaleType modelScaleType, 
         bool forwardToObserverModeManager = true );
      DtObserverObject::ScaleType modelScaleType() const;

      void setOrbitSpeed( double speed );
      double orbitSpeed() const;

      void setRotationSpeed( double speed );
      double rotationSpeed() const;

      void setLinearSpeed( double speed );
      double linearSpeed() const;


      // Called by the input driver before any mouse or keyboard input is processed for the
      // frame, to sync local and remote observers.
      virtual void synchronize();

      boost::signal<void(const std::string&, DtUniqueID)> signal_objectAttached;

      boost::signal<void(const std::string&)> signal_objectsDetached;

      boost::signal<void(DtObserver*, int)> signal_observerModeChanged;

      boost::signal<void(DtObserver*, int)> signal_linearScaledSpeedGainChanged;
      
      boost::signal<void(DtObserver*, int)> signal_linearUnscaledSpeedGainChanged;
      
      boost::signal<void(DtObserver*, int)> signal_rotationSpeedGainChanged;
      
      boost::signal<void(DtObserver*, int)> signal_orbitSpeedGainChanged;
      
      boost::signal<void(DtObserver*, int)> signal_gainPrecisionChanged;
      
      boost::signal<void(DtObserver*, double)> signal_modelScaleFactorChanged;

      boost::signal<void(DtObserver*, DtObserverObject::ScaleType)> signal_modelScaleTypeChanged;

      boost::signal<void(DtObserver*, double)> signal_viewMagnificationChanged;
           
   protected:

      void slot_terrainCleared();      

      void updateGlobalTerrainFlag(bool flag);

      double calcLinearSpeed() const;
      double calcRotationSpeed() const;
      double calcOrbitSpeed() const;     

      void getObserverOffsetVector( double& x, double& y, double& z ) const;
      void setObserverOffsetVector( double x, double y, double z );
      
      void getObserverRotationOffset( double& x, double& y, double& z, double& w ) const;
      void setObserverRotationOffset( double x, double y, double z, double w );

      void getDisplayNamesFromUniqueIds(const std::vector<DtUniqueID>& idsIn, 
         std::set<std::string>& displayNamesOut) const;
      bool getUniqueIdsFromDisplayNames(const std::set<std::string>& displayNamesIn, 
         std::vector<DtUniqueID>& idsOut) const;

      makArchives::DtObserverSettingsRecord::AttachType convertObserverAttachType(
         DtObserverObject::AttachType type) const;
      DtObserverObject::AttachType convertObserverSettingsAttachType(
         makArchives::DtObserverSettingsRecord::AttachType type) const;

      void connectToElementDataSignals();
      void disconnectFromElementDataSignals();
                
      void setModeSpecificObserverObjectData();   
         
      virtual void slot_onElementsAdded( const DtElementData::ElementList& elements );

      virtual void slot_onElementAttributesChanged( 
         const DtElementData::EntryAttributesList& attributes );
      
      void slot_observerModeModelSetChanged( int observerMode );
      void slot_observerModeIs2DChanged( int observerMode );
      void slot_observerModeKeyMapChanged( int observerMode );
      void slot_observerModeGainPrecisionChanged( int observerMode );
      void slot_observerModeOrbitSpeedGainChanged( int observerMode );
      void slot_observerModeRotationSpeedGainChanged( int observerMode );
      void slot_observerModeLinearScaledSpeedGainChanged( int observerMode );
      void slot_observerModeLinearUnscaledSpeedGainChanged( int observerMode );
      void slot_observerModeModelScaleFactorChanged( int observerMode );
      void slot_observerModeModelScaleTypeChanged( int observerMode );
      void slot_observerModeSettingChanged( int observerMode, int settingKey );
      void slot_observerModeAdded( int observerMode );

      void attachTo( bool afterTrue );

   protected:

      static const double theMoveStepSize;

      DtDe& myDe;
      DtSignalConnectionManager myConnections;
      DtObserverObjectAgent* myObserverObjectAgent;
      DtObserverConfiguration* myConfiguration;
      makArchives::DtObserverStateRecord myCachedObserverStateRecord;      
      int myObserverMode;     
      bool myHideModelOnAttach;
      DtObserverObject::AttachType myAttachType;
      std::vector<DtUniqueID> myCurrentAttachments;
      std::vector<DtUniqueID> mySecondaryAttachments;
      DtUniqueID myLastSingleAttached;
      unsigned int myPartId;
      bool myOrientToTargetConstraint;
      bool myConstrainToCenter;
      bool myConnectedToElementDataSignals;      
      bool myAllowReset;
      bool myAllowAttach;
      bool myAllowDetach;
      bool myHasInitialLocation;
      double myViewMagnification;
   };
}