VR-Link API Documentation for HLA 1.3
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
interactionHLA.h
Go to the documentation of this file.
1 /*********************************************************************
2 ** Copyright (c) 1992-2010 MAK Technologies, Inc
3 ** All rights reserved.
4 *********************************************************************/
5 
6 #ifndef interactionHLA_H_
7 #define interactionHLA_H_
8 
11 #if DtHLA
12 
13 
14 
16 
17 #include <vlutil/vlTimeStampType.h>
18 #include <vlutil/vlTime.h>
19 #include <vlutil/vlString.h>
20 #include <vl/interClassDesc.h>
21 
22 
25 class DT_DLL_VL DtList;
26 
34 {
35 public:
36 
38  DtInteraction();
39 
41  virtual ~DtInteraction();
42 
44  DtInteraction(const DtInteraction& orig);
45 
47  DtInteraction& operator=(const DtInteraction& orig);
48 
49 #if DtHLA_1516
50  virtual const RTI::ParameterHandleValueMap& phvm() const = 0;
52 #else
53  virtual const RTI::ParameterHandleValuePairSet& phvps() const = 0;
55 #endif
56 
57 #if DtHLA_1516
58  virtual void setFromPhvm(const RTI::ParameterHandleValueMap& pvList)=0;
60 #else
61  virtual void setFromPhvps(const RTI::ParameterHandleValuePairSet& pvList)=0;
63 #endif
64 
73  virtual void setExConn(DtExerciseConn* exConn,
74  DtInterClassDesc* classDesc = 0);
75 
77  virtual RTI::InteractionClassHandle interactionClassHandle() const;
78 
80  virtual char* interactionClassName() const;
81 
83  virtual int numParameters() const;
84 
87  virtual bool neededByFederation() const;
88 
90  virtual void print() const;
91 
93  virtual void printToStream(std::ostream& stream) const;
94 
96  virtual void printHeader() const;
97 
99  virtual void printHeaderToStream(std::ostream& stream) const;
100 
102  virtual void printData() const;
103 
105  virtual void printDataToString(DtString& buff) const;
106 
108  virtual void printDataToStream(std::ostream& stream) const;
109 
111  virtual void printParams(bool withHex) const;
112 
114  virtual void printParamsToStream(std::ostream& stream, bool withHex) const;
115 
117  virtual const char* name() const = 0;
118 
120  virtual DtExerciseConn* exerciseConn() const;
121 
124  virtual DtInterClassDesc* classDesc() const;
125 
127  virtual bool customTagSet() const;
128 
129 
130 #if DtHLA_1516
131  virtual void setCustomTag(const RTI::VariableLengthData& a_tag);
134  virtual void setTag(const RTI::VariableLengthData& tag);
136  virtual const RTI::VariableLengthData &tag() const;
137 #else
138  virtual void setCustomTag(const DtString& a_tag);
141  virtual void setTag(const DtString& tag);
143  virtual const DtString& tag() const;
144 #endif
145 
151 #if DtHLA_1516
152  virtual const RTI::RegionHandleSet* conveyedRegion() const;
153  virtual void setConveyedRegion(const RTI::RegionHandleSet* sentRegionHandleSet);
154 #else
155  virtual const RTI::Region* conveyedRegion() const;
156  virtual void setConveyedRegion(const RTI::Region* region);
157 #endif
158 
159 #if DtHLA_1516_EVOLVED
160  virtual void setProducingFederateHandle(RTI::FederateHandle federateHandle);
166 
168  virtual RTI::FederateHandle producingFederateHandle() const;
169 
172  virtual const DtString& producingFederateName() const;
173 #endif
174 
175 
179  virtual void setTimeStamp(DtTime time,
181 
184  virtual DtTime timeStamp() const;
185 
187  virtual DtTimeStampType timeStampType() const;
188 
193  virtual DtTime guessTimeValid(DtTime referenceTime) const;
194 
199 #if DtHLA_1516
200  virtual void setFedTime(const RTI::LogicalTime &ft);
201 #else
202  virtual void setFedTime(const RTI::FedTime &ft);
203 #endif
204 
208 #if DtHLA_1516
209  virtual const RTI::LogicalTime *fedTime() const;
210 #else
211  virtual const RTI::FedTime *fedTime() const;
212 #endif
213 
214 #if DtHLA_1516
215  virtual void setMessageRetractionHandle(const RTI::MessageRetractionHandle &handle);
218 
220  virtual RTI::MessageRetractionHandle messageRetractionHandle() const;
221 
222 #else
223  virtual void setEventRetractionHandle(const RTI::EventRetractionHandle &handle);
226 
228  virtual RTI::EventRetractionHandle eventRetractionHandle() const;
229 #endif
230 
231 
232 public:
233 
237  static void setTagIsAsciiTime(bool val);
238  static bool tagIsAsciiTime();
239 
242  static void addCallback(DtExerciseConn* conn,
243  const std::vector<DtString>* classes, DtReceiveInteractionCb cb, void* usr,
244  DtDDMRegionSP region = DtDDMRegionSP());
245  static void removeCallback(DtExerciseConn* conn,
246  const std::vector<DtString>* classes, DtReceiveInteractionCb cb, void* usr,
247  DtDDMRegionSP region = DtDDMRegionSP());
248 
250  static void addCallback(DtExerciseConn* conn,
251  const char* className, DtReceiveInteractionCb cb, void* usr,
252  DtDDMRegionSP region = DtDDMRegionSP());
253  static void removeCallback(DtExerciseConn* conn,
254  const char* className, DtReceiveInteractionCb cb, void* usr,
255  DtDDMRegionSP region = DtDDMRegionSP());
256 
257 protected:
258 
261  virtual const char* interactionClassToUse(DtExerciseConn* exConn) const;
262 
266 #if DtHLA_1516
267  virtual RTI::ParameterHandleValueMap &privPvList() const;
268 #else
269  virtual RTI::ParameterHandleValuePairSet* privPvList() const;
270 #endif
271 
279  DtInteraction* self() const;
280 
281 protected:
282 
287 
288 #if DtHLA_1516
289  RTI::LogicalTime *myFedTime;
290  RTI::ParameterHandleValueMap myPvList;
291  RTI::MessageRetractionHandle myRetractionHandle;
292  RTI::VariableLengthData myTag;
293  const RTI::RegionHandleSet* myConveyedRegion;
294 #if DtHLA_1516_EVOLVED
295  mutable DtString myProducingFederateName;
296  RTI::FederateHandle myProducingFederateHandle;
297 #endif
298 #else
300  RTI::ParameterHandleValuePairSet* myPvList;
302  RTI::FedTime *myFedTime;
303  RTI::EventRetractionHandle myRetractionHandle;
304  const RTI::Region* myConveyedRegion;
305 #endif
306 
308 
309 
310 protected:
311 
312  static bool theTagIsAsciiTime;
313 };
314 
315 DT_DLL_VL std::ostream & operator << (std::ostream &str, const DtInteraction &inter);
316 
317 inline RTI::InteractionClassHandle
319 {
320  return myClassDesc->handle();
321 }
322 
324 {
325  return (char*) (myClassDesc ? myClassDesc->name() : 0);
326 }
327 
329 {
330  return myClassDesc ? myClassDesc->numParameters() : 0;
331 }
332 
334 {
335  return (DtInteraction*) this;
336 }
337 
339 {
340  return myExConn;
341 }
342 
344 {
345  return myClassDesc;
346 }
347 
348 inline void DtInteraction::printData() const
349 {
350 }
351 
353 {
354 }
355 
356 inline void DtInteraction::printDataToStream(std::ostream& stream) const
357 {
358 }
359 
360 #if DtHLA_1516
361 inline void DtInteraction::setMessageRetractionHandle(
362  const RTI::MessageRetractionHandle &handle)
363 {
364  myRetractionHandle = handle;
365 }
366 
367 inline RTI::MessageRetractionHandle DtInteraction::messageRetractionHandle() const
368 {
369  return myRetractionHandle;
370 }
371 
372 #else
374  const RTI::EventRetractionHandle &handle)
375 {
376  myRetractionHandle = handle;
377 }
378 
379 inline RTI::EventRetractionHandle DtInteraction::eventRetractionHandle() const
380 {
381  return myRetractionHandle;
382 }
383 #endif
384 
385 #endif
386 #endif
387 
388 
DtInteraction is an abstract base class for representing HLA interactions (or events) (as opposed to ...
Definition: interactionHLA.h:33
Instances of DtExerciseConn are used to provide an application&#39;s interface or connection to the netwo...
Definition: exerciseConnHLA.h:61
#define DT_DLL_VL
Definition: vlMachineTypes.h:108
Contains the DtString class declaration.
DtExerciseConn * myExConn
Definition: interactionHLA.h:284
std::ostream & operator<<(std::ostream &os, const Dt3dChord &chord)
Instances of DtInterClassDesc are used to represent HLA Object and Interaction classes.
Definition: interClassDesc.h:33
This file contains the declaration of DtClock and DtTime.
RTI::EventRetractionHandle myRetractionHandle
Definition: interactionHLA.h:303
Definition: vlTimeStampType.h:18
virtual DtInterClassDesc * classDesc() const
Get the current class descriptor we&#39;re using for this interaction.
Definition: interactionHLA.h:343
const RTI::Region * myConveyedRegion
Definition: interactionHLA.h:304
DtTimeStampType myTimeType
Definition: interactionHLA.h:286
virtual RTI::InteractionClassHandle interactionClassHandle() const
Get the interaction class handle. Returns 0 if no classDesc.
Definition: interactionHLA.h:318
virtual int numParameters() const
Get the number of parameters associated with this object.
Definition: interClassDesc.h:250
virtual char * interactionClassName() const
Get the interaction class name. Returns NULL if no classDesc.
Definition: interactionHLA.h:323
virtual DtExerciseConn * exerciseConn() const
Get the current exercise connection.
Definition: interactionHLA.h:338
This file contains the declaration of DtInterClassDesc.
static bool theTagIsAsciiTime
Definition: interactionHLA.h:312
virtual void printData() const
Print the interaction&#39;s data to DtInfo.
Definition: interactionHLA.h:348
DtList is deprecated, please use std::list&lt;T&gt;.
Definition: vlList.h:71
void(* DtReceiveInteractionCb)(DtInteraction *inter, void *usr)
Definition: receiveInteractionCbInfo.h:23
virtual RTI::EventRetractionHandle eventRetractionHandle() const
Get the event retraction handle. For more info see setEventRetractionHandle.
Definition: interactionHLA.h:379
#define LogicalTime
Definition: hlaLogicalTime.h:18
virtual void printDataToStream(std::ostream &stream) const
Print the interaction&#39;s data to the stream.
Definition: interactionHLA.h:356
bool myCustomTagSet
Definition: interactionHLA.h:307
DtBoost::shared_ptr< DtDDMRegion > DtDDMRegionSP
Definition: region13.h:31
DtInteraction * self() const
Get rid of const-ness on the &quot;this&quot; pointer in order to access non-const functions from const member ...
Definition: interactionHLA.h:333
DtInterClassDesc * myClassDesc
Definition: interactionHLA.h:283
int myPvListMaxSize
Definition: interactionHLA.h:301
DtTimeStampType
Definition: vlTimeStampType.h:16
RTI::ParameterHandleValuePairSet * myPvList
Definition: interactionHLA.h:300
Instances of DtString are used to represent strings.
Definition: vlString.h:29
RTI::FedTime * myFedTime
Definition: interactionHLA.h:302
virtual int numParameters() const
Get the number of parameters. Returns 0 if no classDesc.
Definition: interactionHLA.h:328
virtual RTI::InteractionClassHandle handle() const
Get the object&#39;s class handle.
Definition: interClassDesc.h:245
virtual void setEventRetractionHandle(const RTI::EventRetractionHandle &handle)
Get/Set the EventRetractionHandle.
Definition: interactionHLA.h:373
DtTime myTime
Definition: interactionHLA.h:285
DtString myTag
Definition: interactionHLA.h:299
virtual void printDataToString(DtString &buff) const
Print the interaction&#39;s data to the string provided.
Definition: interactionHLA.h:352
virtual const char * name() const
Get the object&#39;s class name.
Definition: interClassDesc.h:282

Document ID: Generated on Wed Mar 27 02:04:30 EDT 2024 from SVN revision 264570
Copyright © 2005-2024 MAK Technologies. All Rights Reserved (www.mak.com)