VR-Forces 5.0.2 Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
DtCigiConnection.h
Go to the documentation of this file.
1 /*********************************************************************
2 ** Copyright (c) 2021 MaK Technologies, Inc.
3 ** All rights reserved.
4 *********************************************************************/
5 
9 
10 #pragma once
11 
19 
22 
23 #include <matrix/vlVector.h>
24 #include <vlutil/vlPerformanceStats.h>
26 
27 #include <CigiVersionID.h>
28 
29 
30 class CigiIGSession;
31 class CigiBasePacket;
32 
33 
34 namespace makVrv
35 {
36  class DtDe; // for the creator class
37  class DtCigiConnectionInitializer;
38  class DtCigiNetworkIO;
39  class DtAgentManagerInterface;
40  class DtCigiEntityVisualizer;
41  class DtCoordinateSystem;
42  class DtSharedSettingsManager;
43  class DtVirtualBaseClass;
44  class DtCigiIgControlProcessor;
45  class DtHatHotResponder;
46  class DtLosResponder;
47  class DtSensorResponder;
48  class DtCigiLosBasicResponse;
49  class DtCigiLosExtendedResponse;
50  class DtCigiViewManager;
51 
58  {
59  public:
60  enum DtIgMode
61  {
62  ResetStandby = 0,
63  Operate = 1,
64  Debug = 2
65  };
66 
68 
70  virtual ~DtCigiConnection();
71 
73  virtual void init();
74 
76  virtual bool tick( double elapsedTime );
77 
79  virtual bool connect();
80 
82  virtual bool disconnect();
83 
90  virtual void restart();
91 
93  virtual void setConnectionInitializer(const DtCigiConnectionInitializer& init);
94 
96  virtual void sendCigiMessages();
97 
99  virtual const DtCigiEntityVisualizer& entityManager() const;
101  virtual DtCigiEntityVisualizer& entityManager();
103 
105  virtual const DtCigiIgControlProcessor& igControlProcessor() const;
107  virtual DtCigiIgControlProcessor& igControlProcessor();
109 
111  virtual const DtCigiNetworkIO& networkIO() const;
113  virtual DtCigiNetworkIO& networkIO();
115 
117  virtual const DtCigiViewManager& viewManager() const;
119  virtual DtCigiViewManager& viewManager();
121 
123  virtual const makArchives::DtCigiSettingsRecord& cigiSettings() const;
124 
126  virtual void setLastHostFrameNumber(unsigned int frameNumber);
127 
129  virtual unsigned int lastHostFrameNumber() const;
130 
132  inline bool useSynchronousMode() const
133  {
134  return myUseSynchronousMode;
135  }
136 
138  virtual void setIgMode(DtIgMode mode);
139 
141  inline DtIgMode igMode() const
142  {
143  return myMode;
144  }
145 
147  virtual void setDatabaseNumber(int number);
148 
150  virtual int databaseNumber() const;
151 
154  virtual void setLoadingDatabase();
155 
158  virtual void setDatabaseLoaded();
159 
161  virtual void setExtrapolationEnabled(bool enabled);
162 
164  virtual bool extrapolationEnabled() const;
165 
167  virtual void setTimestampValid(bool valid);
168 
170  virtual bool timestampValid() const;
171 
173  virtual void setLastTimestamp(unsigned int timestamp);
174 
176  virtual unsigned int lastTimestamp() const;
177 
179  virtual void sendHatHotResponse( const DtHatHotResponder::DtHatHotResponseData& hatHotResponse );
180 
182  virtual void sendLosBasicResponse(DtCigiLosBasicResponse* losResponse);
183 
185  virtual void sendLosExtendedResponse(DtCigiLosExtendedResponse* losResponse);
186 
188  virtual void sendPositionResponse( DtPositionResponder::DtPositionResponseData& posResponse );
189 
191  virtual void sendCollisionSegmentResponse( DtCollisionResponder::DtCollisionSegmentResponseData& collResponse );
192 
194  virtual void sendSensorResponse( DtSensorResponder::DtSensorResponseData& sensorResponse );
195 
200  virtual void sendUserPacket( CigiBasePacket* packet );
201 
203  virtual const DtHatHotResponder& hatHotResponder() const;
205  virtual DtHatHotResponder& hatHotResponder();
207 
209  virtual const DtLosResponder& losResponder() const;
211  virtual DtLosResponder& losResponder();
213 
215  virtual const DtPositionResponder& positionResponder() const;
217  virtual DtPositionResponder& positionResponder();
219 
221  virtual const DtCollisionResponder& collisionResponder() const;
223  virtual DtCollisionResponder& collisionResponder();
225 
227  virtual const DtSensorResponder& sensorResponder() const;
229  virtual DtSensorResponder& sensorResponder();
231 
233  virtual unsigned int currentIgFrame() const;
234 
236  virtual DtComponentSignaler& componentSignaler();
237 
239  virtual CigiIGSession& session();
242  virtual const CigiIGSession& session() const;
244 
246  bool cigiSessionExists() const;
247 
249  virtual bool registerUserPacket(CigiBasePacket *packet,
250  unsigned int packetId, bool hostSend, bool igSend);
251 
253  virtual bool useThreadFlag() const;
254 
256  virtual void queueDriverFunction(boost::function<void ()> func);
257 
261  virtual void queueConnectionFunction(boost::function<void ()> func);
262 
265  virtual DtCigiDriver& cigiDriver();
266 
268 
275  virtual void startOverloadTimer();
276 
278  virtual void stopOverloadTimer();
279 
281  virtual bool overloaded();
282 
285  virtual void setWarnOnOverload( bool b );
286 
288  virtual bool warnOnOverload() const;
289 
293  virtual void setDropMessagesOnOverload( bool b );
294 
296  virtual bool dropMessagesOnOverload() const;
297 
300  virtual double hostFrequency() const;
302 
304  boost::signalslib::signal<void (DtViewStateProcessor::ObserverAction&)>
306 
308  boost::signalslib::signal<void (int, DtUniqueID)> signal_alphaChanged;
309 
311  boost::signalslib::signal<void (int, int, int, int, int)> signal_timeSet;
312 
315  boost::signalslib::signal<void (bool)> signal_ephemerisEnableSet;
316 
318  boost::signalslib::signal<void (const std::string&)> signal_loadDatabase;
319 
321  boost::signalslib::signal<void ()> signal_connected;
322 
324  boost::signalslib::signal<void ()> signal_toBeDisconnected;
325 
327  boost::signalslib::signal<void (bool)> signal_deadReckoningAllowedChanged;
328 
330  boost::signalslib::signal<void ()> signal_preTick;
331 
333  boost::signalslib::signal<void ()> signal_postTick;
334 
338  boost::signalslib::signal<void( int entityId )> signal_entityToBeDeleted;
339 
341  virtual const CigiVersionID getCigiVersion() const;
342 
347  virtual const bool connectionObjectId() const;
348 
351  virtual void getConnectionObjectIDFromString( unsigned int& connectionID, std::string connectionObjectIDString);
352  protected:
355  DtAgentManagerInterface& sceneInterface,
356  DtSharedSettingsManager& settingsManager,
357  DtCigiDriver& driver);
358 
359 
360 
361  protected:
362  typedef std::map<std::string,DtVirtualBaseClass*> InstanceMap;
363 
370 
376 
381 
382  unsigned int myIgFrame;
383  unsigned int myLastHostFrameNumber;
390  unsigned int myLastTimestamp;
391 
396 
397  CigiVersionID myCigiVersion;
398  };
399 
403  {
404  public:
407 
409  virtual ~DtCigiConnectionCreator();
410 
412  static DtCigiConnectionCreator& instance( DtDe& de );
413 
415  virtual DtCigiConnection* create(const DtCigiConnectionInitializer& init,
416  DtAgentManagerInterface& sceneInterface,
417  DtSharedSettingsManager& settingsManager,
418  DtCigiDriver& driver) const;
419  };
420 }
DT_DLL_EXAMPLESCENEROOTPLUGIN void init(DtDe &anIG)
DtCigiDriver & myCigiDriver
Definition: DtCigiConnection.h:364
This class initializes the CIGI driver.
Definition: DtCigiConnectionInitializer.h:18
Virtual base class. Allows for RTTI and proper virtual destruction. Used by Creators, Factories, Providers, Assemblers and User Interfaces.
Definition: DtVirtualBaseClass.h:19
This class is responsible for processing various CIGI messages that pertain to CIGI entities and sett...
Definition: DtCigiEntityVisualizer.h:69
boost::signalslib::signal< void(const std::string &)> signal_loadDatabase
Emitted when the host tells the IG to load a database.
Definition: DtCigiConnection.h:318
boost::signalslib::signal< void()> signal_postTick
Signal emitted at the end of the tick function.
Definition: DtCigiConnection.h:333
A DtHatHotResponder receives HAT/HOT requests from CIGI and either initiates an immediate request or ...
Definition: DtHatHotResponder.h:35
double myHostFrequency
Definition: DtCigiConnection.h:380
bool myDropMessagesOnOverload
Definition: DtCigiConnection.h:395
bool myDatabaseLoading
Definition: DtCigiConnection.h:387
DtIgMode myMode
Definition: DtCigiConnection.h:385
unsigned int myLastHostFrameNumber
Definition: DtCigiConnection.h:383
This class is responsible for processing CIGI messages that &#39;control&#39; settings in the IG...
Definition: DtCigiIgControlProcessor.h:40
Contains makVrv::DtComponentSignaler class.
DtLosResponder * myLosResponder
Definition: DtCigiConnection.h:372
A DtComponentSignaler holds various signals that can be caught by the DtCigiDriver so that it can cha...
Definition: DtComponentSignaler.h:26
The shared settings manager, is the global object responsible for managing any shared settings object...
Definition: DtSharedSettingsManager.h:42
unsigned int myLastTimestamp
Definition: DtCigiConnection.h:390
Struct for HatHotResponseData. Unused in this class, used by intersection handler and the networkIO...
Definition: DtHatHotResponder.h:70
CigiVersionID myCigiVersion
Definition: DtCigiConnection.h:397
boost::signalslib::signal< void(bool)> signal_deadReckoningAllowedChanged
Emitted when CIGI extrapolation is enabled.
Definition: DtCigiConnection.h:327
A DtCigiIntersectionHandler processes CIGI LOS Requests and packages the results into instances of th...
Definition: DtCigiLosExtendedResponse.h:29
Struct for all Position response data In degrees.
Definition: DtPositionResponder.h:99
This class holds the CIGI settings used by the DtCigiConnection object. A named settings object is he...
Definition: DtCigiConnSettingsHandler.h:31
boost::signalslib::signal< void(int, DtUniqueID)> signal_alphaChanged
Emitted when an entity&#39;s alpha has changed.
Definition: DtCigiConnection.h:308
The DtBaseConnection is an abstract class.
Definition: DtBaseConnection.h:38
boost::signalslib::signal< void(DtViewStateProcessor::ObserverAction &)> signal_viewChanged
Emitted when a view control change is received.
Definition: DtCigiConnection.h:305
int myDatabaseNumber
Definition: DtCigiConnection.h:386
Contains makVrv::DtCollisionResponder &amp; creator class.
DtIgMode
Definition: DtCigiConnection.h:60
bool myUseSynchronousMode
Definition: DtCigiConnection.h:379
Contains makVrv::DtVirtualBaseClass class.
boost::signalslib::signal< void()> signal_preTick
Signal emitted at the beginning of the tick function.
Definition: DtCigiConnection.h:330
A DtPositionResponder processes CIGI Position request messages This class catches signals from the Dt...
Definition: DtPositionResponder.h:48
bool myExtrapolationEnabled
Definition: DtCigiConnection.h:388
Structure containing the data for the Sensor Response Packet.
Definition: DtSensorResponder.h:87
DtSensorResponder * mySensorResponder
Definition: DtCigiConnection.h:375
DtPositionResponder * myPositionResponder
Definition: DtCigiConnection.h:373
boost::signalslib::signal< void()> signal_connected
Emitted when the connection finished connecting.
Definition: DtCigiConnection.h:321
bool useSynchronousMode() const
Get whether the connection is using synchronous communications.
Definition: DtCigiConnection.h:132
The DtDriver for CIGI. Provides communication between the IG (DtDe) and the DtCigiConnection which do...
Definition: DtCigiDriver.h:46
Struct for Collision Response Data.
Definition: DtCollisionResponder.h:76
DtCigiEntityVisualizer * myEntityManager
Definition: DtCigiConnection.h:366
Contains makVrv::DtCigiViewController class.
Creator class for the DtCigiConnection.
Definition: DtCigiConnection.h:402
double myFrameTimeSoFar
Definition: DtCigiConnection.h:393
boost::signalslib::signal< void(int entityId)> signal_entityToBeDeleted
Emitted when this entity is about to be deleted. This is here rather than the entity visualiser as it...
Definition: DtCigiConnection.h:338
Class to manage disconnection of boost connections on deletion.
Definition: DtSignalConnectionManager.h:20
Contains makVrv::DtHatHotResponder class.
DtCigiConnSettingsHandler mySettingsHandler
Definition: DtCigiConnection.h:378
DtComponentSignaler myComponentSignaler
Definition: DtCigiConnection.h:377
DtCigiConnectionInitializer myInitializer
Definition: DtCigiConnection.h:367
boost::signalslib::signal< void()> signal_toBeDisconnected
Emitted when the connection will be disconnecting.
Definition: DtCigiConnection.h:324
A DtCigiIntersectionHandler processes CIGI LOS Requests and packages the results into instances of th...
Definition: DtCigiLosBasicResponse.h:27
This class is responsible for the actual processing of CIGI data. This holds the entity visualizer...
Definition: DtCigiConnection.h:57
DtCigiViewManager * myViewManager
Definition: DtCigiConnection.h:369
This class catches Sesnor Control signals from the Cigi Signal handler, and processes them into V3 an...
Definition: DtSensorResponder.h:36
This class handles the processing of Collision Segment Defintion packets It catches signals from DtCi...
Definition: DtCollisionResponder.h:54
DtIgMode igMode() const
Gets the IG mode.
Definition: DtCigiConnection.h:141
Contains makVrv:DtBaseConnection class.
bool myWarnOnOverload
Definition: DtCigiConnection.h:394
Contains the declaration for makVrv::DtCigiConnSettingsHandler.
DtCigiNetworkIO * myNetworkIO
Definition: DtCigiConnection.h:365
boost::signalslib::signal< void(bool)> signal_ephemerisEnableSet
Emitted when the ephemeris model is enabled / disabled via CIGI Celestial Sphere Control message...
Definition: DtCigiConnection.h:315
unsigned int myIgFrame
Definition: DtCigiConnection.h:382
Contains makVrv::DtPositionResponderclass.
const char int mode
Definition: ioapi.h:38
DtCigiIgControlProcessor * myIgController
Definition: DtCigiConnection.h:368
boost::signalslib::signal< void(int, int, int, int, int)> signal_timeSet
Emitted when the time is set via CIGI Celestial Sphere Control message.
Definition: DtCigiConnection.h:311
The abstract interface necessary for agents.
Definition: DtAgentManagerInterface.h:33
A DtLosResponder processes CIGI LOS Segment Request and LOS Vector Request messages, and either immediately signals the DtCigiIntersectionHandler of a request or adds a periodic request to its queue.
Definition: DtLosResponder.h:41
The DtDe is the core component of any VR-Vantage application. It owns a DtRenderer, DtDeCommunicator, as well as a DtDisplay and other things.
Definition: DtDe.h:70
std::map< std::string, DtVirtualBaseClass * > InstanceMap
Definition: DtCigiConnection.h:362
bool myTimestampValid
Definition: DtCigiConnection.h:389
#define DT_DLL_VRVCIGI
Definition: vrvCigi.h:19
Record of miscellaneous CIGI settings.
Definition: DtCigiSettingsRecord.h:28
This class manages mapping between CIGI views and VRV observers / channels.
Definition: DtCigiViewManager.h:36
DtTimedSection myOverloadTimer
Definition: DtCigiConnection.h:392
This class performs all of the network I/O for CIGI messages. This includes setting up the CIGI sessi...
Definition: DtCigiNetworkIO.h:76
DtSignalConnectionManager mySignals
Definition: DtCigiConnection.h:384
DtHatHotResponder * myHatHotResponder
Definition: DtCigiConnection.h:371
DtCollisionResponder * myCollisionResponder
Definition: DtCigiConnection.h:374

Document ID: Generated on Sun Dec 4 20:22:03 EST 2022 from SVN revision 249613
Copyright © 2005-2021 MAK Technologies. All Rights Reserved (www.mak.com)