VR-Link API Documentation for HLA 1.3
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
exerciseConnInitializerHLA.h
Go to the documentation of this file.
1 /****************************************************************************
2  * Copyright (c) 2017 VT MAK
3  * All rights reserved.
4  ****************************************************************************/
5 
9 
10 #pragma once
11 
12 #if DtHLA
13 
14 #include <vlutil/vlString.h>
15 
17 #include <mtl/configVariable.h>
19 
20 
21 #include <cmdLine/cmdLine.h>
22 #include "fomMapper.h"
23 
24 class DtMtlEnvironment;
25 
26 
27 #if defined (DtHLA_1516_EVOLVED)
28 #define DtDefaultRpr2Fom "RPR_FOM_v2.0_1516-2010.xml"
29 #define DtDefaultRpr1Fom "MAK-RPR1-1-10_evolved.xml"
30 #elif defined(DtHLA_1516)
31 #define DtDefaultRpr2Fom "MAK-RPR2-1-10.xml"
32 #define DtDefaultRpr1Fom "MAK-RPR1-1-10.xml"
33 #else //HLA 1.3
34 #define DtDefaultRpr2Fom "MAK-RPR2-1-10.fed"
35 #define DtDefaultRpr1Fom "MAK-RPR1-1-10.fed"
36 #endif
37 
42 {
43 public:
44 
48  {
51  DtGetValuePointerWhereAvailable
52  };
53 
54 public:
57 
59  virtual ~DtExerciseConnInitializer();
60 
63 
66 
68  virtual DtString execName() const;
69 
71  virtual void setExecName(const DtString& name);
72 
75  virtual DtString federateName() const;
76 
79  virtual void setFederateName(const DtString& name);
80 
82  virtual DtString federateType() const;
83 
86  virtual void setFederateType(const DtString& type);
87 
89  virtual DtString fedFileName() const;
90 
92  virtual void setFedFileName(const DtString& name);
93 
95  virtual DtFomMapper* fomMapper() const;
96 
98  virtual void setFomMapper(DtFomMapper* mapper);
99 
102  virtual DtString fomMapperLibName() const;
103 
105  virtual void setFomMapperLibName(const DtString& name);
106 
108  virtual void* fomMapperInitData() const;
109 
111  virtual void setFomMapperInitData(void* data);
112 
119  virtual void setRprFomVersion(double version);
120 
122  virtual double rprFomVersion() const;
123 
126  virtual void setReflecting(bool onOff);
127 
129  virtual bool reflecting() const;
130 
133  virtual void setPassiveMode(bool onOff);
134 
136  virtual bool passiveMode() const;
137 
151  virtual void setReflectRemoteUpdatesIntoPub(bool onOff);
152 
154  virtual bool reflectRemoteUpdatesIntoPub() const;
155 
162  virtual void setReflectThroughRti(bool onOff);
163 
165  virtual bool reflectThroughRti() const;
166 
174  virtual void setUseAdvisories(bool onOff);
175 
177  virtual bool useAdvisories() const;
178 
184  virtual void setReplyToSynchPoints(bool onOff);
185 
187  virtual bool replyToSynchPoints() const;
188 
194  virtual void setAutoSubscribe(bool onOff);
195 
197  virtual bool autoSubscribe() const;
198 
204  virtual void setRequestClassUpdate(bool onOff);
205 
207  virtual bool requestClassUpdate() const;
208 
213  virtual void setRequestObjectUpdate(bool onOff);
214 
216  virtual bool requestObjectUpdate() const;
217 
229  virtual void setRequestWhenInitialized(bool onOff);
230 
232  virtual bool requestWhenInitialized() const;
233 
245  virtual void setDefaultRefreshWaitList(bool onOff);
246 
248  virtual bool defaultRefreshWaitList() const;
249 
254  virtual void setDefaultWaitListRefreshPeriod(double period);
255 
257  virtual double defaultWaitListRefreshPeriod() const;
258 
262  virtual void setTimeStampType(DtTimeStampType relOrAbs);
263 
265  virtual DtTimeStampType timeStampType() const;
266 
272  virtual void setDestroyFedExec(bool onOff);
273 
275  virtual bool destroyFedExec() const;
276 
281  virtual void setSendFedTime(bool onOff);
282 
284  virtual bool sendFedTime() const;
285 
287  virtual void setNotifyLevel(int level);
288 
290  virtual void setUseGeographicDdm(bool yesNo);
291 
293  virtual bool useGeographicDdm() const;
294 
300  virtual void setRprFomRevision(int val);
303  virtual int rprFomRevision() const;
304 
310  virtual void setExceptionOnRtiCompilerMismatch( bool useException );
311 
312  virtual bool exceptionOnRtiCompilerMismatch() const;
313 
325 
326  virtual void setGetValueMethod( DtGetValueMethod getValueMethodChoice );
327  virtual DtGetValueMethod getValueMethod( ) const;
329 
335 
336  virtual void setGenericAttributes(bool yesNo);
337  virtual bool enabledGenericAttributes() const;
339 
340 
342 
343  virtual bool pauseOnSaveRestore() const;
344  virtual void setPauseOnSaveRestore(bool yesNo);
346 
347 #if DtHLA_1516_EVOLVED
348 
350  virtual void setMimModule(const DtString& mimFomModule);
352  virtual DtString mimModule() const;
353 
355  virtual void addFomModule(const DtString& module);
357  virtual void setFomModules(const std::vector<DtString>& fomModules);
358 
360  virtual void fomModules(std::vector<DtString>& fomModules) const;
362  virtual void fomModules(std::vector<std::wstring>& fomModules) const;
363 
365  virtual void setLocalSettingsDesignator( const std::wstring & localSettingsDesignator );
367  virtual void setLocalSettingsDesignator( const DtString & localSettingsDesignator );
369  virtual std::wstring localSettingsDesignator() const;
370 
371 #elif DtHLA_1516
372 
374  virtual void setRtiArguments(const std::vector<std::wstring>& args);
375 
377  virtual void setRtiArguments(const std::vector<DtString>& args);
378 
380  virtual void rtiArguments(std::vector<std::wstring>& args) const;
381 
382 #endif
383 
384 public:
385 
387  static DtString vrlinkVersion();
388 
391 private:
420 
421 
422 #if DtHLA_1516_EVOLVED
423  std::wstring myLocalSettingsDesignator;
424 #elif DtHLA_1516
425  std::vector<std::wstring> myRtiArguments;
426 #endif
427 
431 
434  std::vector<DtString> myFomModules;
435 
437 
438 };
439 
452 {
453 public:
455  DtVrlApplicationInitializer(int argc, char* argv[], const DtString& appName,
457 #ifdef _WIN32
458  bool pressAnyKey = true);
459 #else
460  bool pressAnyKey = false);
461 #endif
462 
464  virtual ~DtVrlApplicationInitializer();
465 
467  virtual int argc() const;
468 
470  virtual char** argv() const;
471 
476  virtual void parseCmdLine();
477 
481  virtual void loadFile(const DtString& fileName);
482  virtual void loadMtlFile(const DtString& fileName);
483 
485  virtual void saveFile(const DtString& filename);
486 
487  //{@
489  virtual void setExecName(const DtString& name);
490  virtual DtString execName() const;
492 
493  //{@
496  virtual void setFederateName(const DtString& name);
497  virtual DtString federateName() const;
499 
500 #if DtHLA_1516_EVOLVED
501  //{@
504  virtual void setLocalSettingsDesignator(const DtString& name);
505  virtual std::wstring localSettingsDesignator() const;
506 
509  virtual void setMimModule(const DtString& mimFomModule);
510  virtual DtString mimModule() const;
512 #endif
513 
514  //{@
516  virtual void setNotifyFileLevel(int level);
517  virtual int notifyFileLevel() const;
519 
520  //{@
522  virtual void setNotifyFilename(const DtString& file);
523  virtual DtString notifyFilename() const;
525 
526  //{@
528  virtual void setFederateType(const DtString& type);
529  virtual DtString federateType() const;
531 
532  //{@
534  void setFedFileName(const DtString& name);
535  virtual DtString fedFileName() const;
537 
538  //{@
540  virtual void setFomMapperLibName(const DtString& name);
541  virtual DtString fomMapperLibName() const;
543 
544  //{@
546  virtual void setRprFomVersion(double version);
547  virtual double rprFomVersion() const;
549 
550  //{@
552  virtual void* fomMapperInitData() const;
553  virtual void setFomMapperInitData(void* data);
555 
556  //{@
558  virtual void setUseAdvisories(bool onOff);
559  virtual bool useAdvisories() const;
561 
562 
563  //{@
565  virtual void setRequestClassUpdate(bool onOff);
566  virtual bool requestClassUpdate() const;
568 
569 
570  //{@
572  virtual void setRequestObjectUpdate(bool onOff);
573  virtual bool requestObjectUpdate() const;
575 
576  //{@
578  virtual void setRequestWhenInitialized(bool onOff);
579  virtual bool requestWhenInitialized() const;
581 
582  //{@
584  virtual void setDefaultRefreshWaitList(bool onOff);
585  virtual bool defaultRefreshWaitList() const;
587 
588  //{@
590  virtual void setDefaultWaitListRefreshPeriod(double period);
591  virtual double defaultWaitListRefreshPeriod() const;
593 
597  virtual void setTimeStampType(DtTimeStampType relOrAbs);
598 
600  virtual DtTimeStampType timeStampType() const;
601 
607  virtual void setDestroyFedExec(bool onOff);
608 
610  virtual bool destroyFedExec() const;
611 
616  virtual void setSendFedTime(bool onOff);
617 
619  virtual bool sendFedTime() const;
620 
621  virtual void setUseGeographicDdm(bool yesNo);
622 
623  virtual bool useGeographicDdm() const;
624 
625  virtual void setRprFomRevision(int val);
626  virtual int rprFomRevision() const;
627 
633  virtual void setGenericAttributes(bool yesNo);
634  virtual bool enabledGenericAttributes() const;
635 
637 
638  virtual bool pauseOnSaveRestore() const;
639  virtual void setPauseOnSaveRestore(bool yesNo);
640 
641  virtual void setExceptionOnRtiCompilerMismatch(bool yesNo);
642  virtual bool exceptionOnRtiCompilerMismatch() const;
644 
649  virtual void setOutputInterval(double period);
650 
652  virtual double outputInterval() const;
653 
654 protected:
656  virtual void initializeFileLogging();
657 
658 protected:
659  int myArgc;
660  char** myArgv;
662 
663  virtual void initializeMtlParams();
664 
672 #if DtHLA_1516_EVOLVED
673  DtMultiConfigVariable<DtString> myConfigVarFomModules;
674  DtConfigVariable<DtString> myConfigVarMimModule;
675  DtConfigVariable<DtString> myConfigVarLocalSettingsDesignator;
676 #endif
687 
699 
700  // If logging is turned on, this printer will remain in memory
701  // even after this class is destroyed. Otherwise we would
702  // have to stop logging prematurely.
704 
705  // MTL doesn't support boolean
716 
717 };
718 
719 #endif // DtHLA
DtConfigVariable< bool > myConfigVarPauseOnSaveRestore
Definition: exerciseConnInitializerHLA.h:694
command line support
Definition: mtlEnvironment.h:42
virtual void setDestroyFedExec(bool onOff)
Set the destroy fed exec flag.
DtConfigVariable< double > myConfigVarRprFomVersion
Definition: exerciseConnInitializerHLA.h:679
bool myRequestObjectUpdate
Definition: exerciseConnInitializerHLA.h:405
Contains the DtApplicationSettings class declaration.
virtual void setRequestClassUpdate(bool onOff)
Set request class update flag.
virtual bool sendFedTime() const
Get the send fed time flag. See above description.
DtConfigVariable< bool > myConfigVarUseAbsoluteTimestamps
Definition: exerciseConnInitializerHLA.h:690
virtual void setFomMapperLibName(const DtString &name)
Get the FOM Mapper library name.
Definition: applicationSettings.h:24
bool myReplyToSynchPoints
Definition: exerciseConnInitializerHLA.h:402
virtual bool enabledGenericAttributes() const
Set the Generic attributes flag.
virtual bool destroyFedExec() const
Get the destroy fed exec flag. See above description.
#define DT_DLL_VL
Definition: vlMachineTypes.h:108
int myMtlRequestObjectUpdate
Definition: exerciseConnInitializerHLA.h:713
bool myPassiveMode
Definition: exerciseConnInitializerHLA.h:400
DtConfigVariable< bool > myConfigVarRtiCompilerCheck
Definition: exerciseConnInitializerHLA.h:695
Instances of DtExerciseConnInitializer are used to provide the DtExerciseConn with initialization dat...
Definition: exerciseConnInitializerHLA.h:41
Contains the DtString class declaration.
bool myReflectRemoteUpdatesIntoPub
Definition: exerciseConnInitializerHLA.h:409
DtFilePrinter is a subclass of DtPrinter which opens a file and dumps all information received from D...
Definition: vlPrint.h:80
virtual void setDefaultRefreshWaitList(bool onOff)
Set default wait list refresh flag.
DtString myMimModule
Definition: exerciseConnInitializerHLA.h:436
int myMtlSendFedTime
Definition: exerciseConnInitializerHLA.h:710
char ** myArgv
Definition: exerciseConnInitializerHLA.h:660
int myRprFomRevision
Definition: exerciseConnInitializerHLA.h:417
DtTimeStampType myTimeStampType
Definition: exerciseConnInitializerHLA.h:411
virtual void * fomMapperInitData() const
Set the FOM mapper initialization data.
int myMtlUseGeographicDdm
Definition: exerciseConnInitializerHLA.h:707
DtConfigVariable< double > myConfigVarDefaultWaitListRefreshPeriod
Definition: exerciseConnInitializerHLA.h:686
int myMtlUseAbsoluteTimeStamps
Definition: exerciseConnInitializerHLA.h:708
bool myExceptionOnRtiCompilerMismatch
Definition: exerciseConnInitializerHLA.h:418
virtual void setRequestObjectUpdate(bool onOff)
Set request object update flag.
void * myFomMapperInitData
Definition: exerciseConnInitializerHLA.h:397
virtual int rprFomRevision() const
returns the revision of the current FOM being used.
virtual DtString federateType() const
Get the federate type.
DtConfigVariable< DtString > myConfigVarFederateType
Definition: exerciseConnInitializerHLA.h:668
This file declares DtFomMapper.
bool myReflecting
Definition: exerciseConnInitializerHLA.h:399
DtConfigVariable< bool > myConfigVarRequestObjectUpdate
Definition: exerciseConnInitializerHLA.h:683
DtConfigVariable< int > myConfigVarNotifyFileLevel
Definition: exerciseConnInitializerHLA.h:696
static DtString vrlinkVersion()
Returns a string indicating the VR-Link version number.
virtual DtTimeStampType timeStampType() const
Get the time stamp type.
DtString myFederateType
Definition: exerciseConnInitializerHLA.h:393
virtual bool exceptionOnRtiCompilerMismatch() const
Contains the DtMultiConfigVariable class declaration.
DtString myFomMapperLibName
Definition: exerciseConnInitializerHLA.h:396
virtual bool requestClassUpdate() const
Get request class update flag.
DtGetValueMethod myGetValueMethod
Definition: exerciseConnInitializerHLA.h:419
DtConfigVariable< bool > myConfigVarRequestWhenInitialized
Definition: exerciseConnInitializerHLA.h:684
DtFomMapper * myFomMapper
Definition: exerciseConnInitializerHLA.h:395
double myRprFomVersion
Definition: exerciseConnInitializerHLA.h:398
DtConfigVariable< bool > myConfigVarUseGeographicDdm
Definition: exerciseConnInitializerHLA.h:689
virtual void setRprFomVersion(double version)
Set the RPR FOM Version.
virtual void setGenericAttributes(bool yesNo)
Set the Generic attributes flag.
virtual DtString fedFileName() const
Set the fed file name.
std::vector< DtString > myFomModules
myFomModules represents the set of FOM Modules to be used to establish the Object Model of the Federa...
Definition: exerciseConnInitializerHLA.h:434
bool myRequestClassUpdate
Definition: exerciseConnInitializerHLA.h:404
bool myAutoSubscribe
Definition: exerciseConnInitializerHLA.h:403
bool myReflectThroughRti
Definition: exerciseConnInitializerHLA.h:410
virtual DtString federateName() const
Set the federate name In HLA Evolved, this is the same as federateType.
DtConfigVariable< int > myConfigVarNotifyLevel
Definition: exerciseConnInitializerHLA.h:666
virtual bool useGeographicDdm() const
Get the use geographic DDM flag.
Contains the DtConfigVariable class declaration.
double myDefaultWaitListRefreshPeriod
Definition: exerciseConnInitializerHLA.h:408
DtConfigVariable< DtString > myConfigVarFomMapperInitData
Definition: exerciseConnInitializerHLA.h:678
DtMtlEnvironment * myMtlEnv
Definition: exerciseConnInitializerHLA.h:661
DtConfigVariable< int > myConfigVarRprFomRevision
Definition: exerciseConnInitializerHLA.h:680
Instances of DtVrlApplicationInitializer are used to initialize the exercise connection with command ...
Definition: exerciseConnInitializerHLA.h:451
bool myDefaultRefreshWaitList
Definition: exerciseConnInitializerHLA.h:407
virtual void setUseGeographicDdm(bool yesNo)
Sets the use geographic DDM flag.
int myMtlDefaultRefreshWaitList
Definition: exerciseConnInitializerHLA.h:715
virtual void setFedFileName(const DtString &name)
Get the fed file name.
virtual void setDefaultWaitListRefreshPeriod(double period)
Set default wait list refresh period.
bool mySendFedTime
Definition: exerciseConnInitializerHLA.h:413
virtual bool requestObjectUpdate() const
Get request object update flag.
DtString myFedFileName
The following two variables are different representations of the same concept.
Definition: exerciseConnInitializerHLA.h:430
DtConfigVariable< bool > myConfigVarSendFedTime
Definition: exerciseConnInitializerHLA.h:692
DtApplicationSettings mySettings
Definition: exerciseConnInitializerHLA.h:665
DtConfigVariable< bool > myConfigVarRequestClassUpdate
Definition: exerciseConnInitializerHLA.h:682
DtString myFederateName
Definition: exerciseConnInitializerHLA.h:394
Definition: exerciseConnInitializerHLA.h:50
This file declares the class DtCmdLine::CmdLine.
virtual DtString fomMapperLibName() const
Set the FOM Mapper library name.
DtConfigVariable< DtString > myConfigVarExecName
Definition: exerciseConnInitializerHLA.h:669
DtConfigVariable< DtString > myConfigVarNotifyFilename
Definition: exerciseConnInitializerHLA.h:697
bool myRequestWhenInitialized
Definition: exerciseConnInitializerHLA.h:406
virtual void setUseAdvisories(bool onOff)
Set use of advisories.
DtConfigVariable< double > myConfigVarOutputInterval
Definition: exerciseConnInitializerHLA.h:698
bool myPauseOnSaveRestore
Definition: exerciseConnInitializerHLA.h:414
DtConfigVariable< bool > myConfigVarDestroyFedExec
Definition: exerciseConnInitializerHLA.h:691
DtConfigVariable< DtString > myConfigVarFomMapperLibName
Definition: exerciseConnInitializerHLA.h:677
virtual double defaultWaitListRefreshPeriod() const
Get default wait list refresh period.
DtConfigVariable< bool > myConfigVarGenericAttributes
Definition: exerciseConnInitializerHLA.h:693
DtConfigVariable< bool > myConfigVarDefaultRefreshWaitList
Definition: exerciseConnInitializerHLA.h:685
Definition: exerciseConnInitializerHLA.h:49
DtVariableGroup myHlaConnection
Definition: exerciseConnInitializerHLA.h:667
bool myUseGeographicDdm
Definition: exerciseConnInitializerHLA.h:416
virtual void setFederateName(const DtString &name)
Set the federate name In HLA Evolved, this is the same as setFederateType.
int myMtlDestroyFedExec
Definition: exerciseConnInitializerHLA.h:709
virtual bool useAdvisories() const
Get use of advisories.
virtual void setTimeStampType(DtTimeStampType relOrAbs)
Set the time stamp type (DtTimeStampAbsolute or DtTimeStampRelative).
bool myUseAdvisories
Definition: exerciseConnInitializerHLA.h:401
Represents a group of variables.
Definition: variableGroup.h:21
virtual void setRprFomRevision(int val)
Sets the revision of the FOM Mapper currently used.
virtual double rprFomVersion() const
Returns the RPR FOM Version. See above description.
DtTimeStampType
Definition: vlTimeStampType.h:16
int myMtlUseAdvisories
Definition: exerciseConnInitializerHLA.h:706
bool myGenericAttributes
Definition: exerciseConnInitializerHLA.h:415
int myArgc
Definition: exerciseConnInitializerHLA.h:659
virtual void setRequestWhenInitialized(bool onOff)
Set request when initialized flag.
virtual bool defaultRefreshWaitList() const
Get request object update flag.
bool myDestroyFedExec
Definition: exerciseConnInitializerHLA.h:412
DtConfigVariable< DtString > myConfigVarFederateName
Definition: exerciseConnInitializerHLA.h:671
DtConfigVariable< bool > myConfigVarUseAdvisories
Definition: exerciseConnInitializerHLA.h:681
DtConfigVariable< bool > myConfigVarIgnoreAdvisories
Definition: exerciseConnInitializerHLA.h:688
Instances of DtString are used to represent strings.
Definition: vlString.h:29
DtFilePrinter * myLogFilePrinter
Definition: exerciseConnInitializerHLA.h:703
virtual void setExceptionOnRtiCompilerMismatch(bool useException)
Set whether DtExerciseConn throws an exception when detecting a mismatched RTI compiler version...
Instances of DtFomMapper are used to provide FOM agility in VR-Link by mapping VR-Link classes and fu...
Definition: fomMapper.h:36
int myMtlRequestClassUpdate
Definition: exerciseConnInitializerHLA.h:712
virtual bool requestWhenInitialized() const
Get request when initialized flag.
virtual void setSendFedTime(bool onOff)
Set the send fed time flag.
virtual void setFomMapperInitData(void *data)
Get the FOM mapper initialization data.
virtual void setPauseOnSaveRestore(bool yesNo)
Block the simulation if a save or a restore is in process.
virtual DtString execName() const
Set the execution name.
DtConfigVariable< DtString > myConfigVarFedFileName
Definition: exerciseConnInitializerHLA.h:670
int myMtlPauseOnSaveRestore
Definition: exerciseConnInitializerHLA.h:711
int myMtlRequestWhenInitialized
Definition: exerciseConnInitializerHLA.h:714
virtual void setFederateType(const DtString &type)
Set the federate type.
virtual bool pauseOnSaveRestore() const
Block the simulation if a save or a restore is in process.
DtString myExecName
These values are private, because derived classes will be providing types of the same functionality...
Definition: exerciseConnInitializerHLA.h:392
Definition: multiConfigVariable.h:23
DtGetValueMethod
Indicate if getValue or getValuePointer should be used to retrieve data from handleValuePairSets.
Definition: exerciseConnInitializerHLA.h:47
virtual void setExecName(const DtString &name)
Get the execution name.

Document ID: Generated on Mon Apr 25 03:39:01 EDT 2022 from SVN revision 242502
Copyright © 2005-2021 MAK Technologies. All Rights Reserved (www.mak.com)