VR-Link API Documentation for HLA 1516
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
objClassDesc1516.h
Go to the documentation of this file.
1 /*********************************************************************
2 ** Copyright (c) 1992-2010 VT MAK
3 ** All rights reserved.
4 *********************************************************************/
5 
6 
9 
10 #pragma once
11 
12 #if DtHLA_1516
13 
14 
15 #include <vlutil/vlMachineTypes.h>
16 #include <vlutil/vlString.h>
17 #include "hlaStateEncoder.h"
18 #include "hlaStateDecoder.h"
19 #include "rtiNamespace.h"
20 #include "region.h"
21 #include "userTagModifiers.h"
22 #include <map>
23 #include <list>
24 
25 class DtExerciseConn;
27 class DtVrlRtiAmbassador;
28 
42 {
43 public:
44 
47  DtObjClassDesc(const char* className,
48  DtObjClassDesc* base,
49  RTI::ObjectClassHandle handle,
50  DtExerciseConn* exConn);
51 
53  virtual ~DtObjClassDesc();
54 
56  virtual void addAttr(const char* attrName, bool withSpace = false);
57 
59  virtual RTI::ObjectClassHandle handle() const;
60 
62  virtual RTI::AttributeHandle attributeHandleByName(const char *attrName) const;
63 
65  virtual DtString attributeNameByHandle(const RTI::AttributeHandle& hand) const;
66 
68  virtual const char* name() const;
69 
71  virtual const DtObjClassDesc* baseClass() const;
72 
74  virtual DtObjClassDesc* baseClass();
75 
77  virtual void addChildClass(DtObjClassDesc* child);
78 
81  virtual int isOfClass(RTI::ObjectClassHandle hand) const;
82 
85  virtual int numAttributes() const;
86 
88  virtual bool hasAttribute(const char* attrName) const;
89 
92  virtual const RTI::AttributeHandleSet& attrHandleSet() const;
93 
95  virtual const RTI::AttributeHandleSet& ownAttrHandles() const;
96 
103  virtual bool classNeededByFederation();
104 
109  virtual void publish();
110  virtual void publish(const RTI::AttributeHandleSet& hSet);
111 
113  virtual void unpublish();
114 
119 
121  virtual void subscribe(std::wstring const& updateRateDesignator, bool active);
122  virtual void subscribe(const DtDDMRegionSet& region,
123  std::wstring const& updateRateDesignator, bool active);
124  virtual void subscribe(const RTI::AttributeHandleSet& hSet,
125  std::wstring const& updateRateDesignator, bool active);
126  virtual void subscribe(const RTI::AttributeHandleSet& hSet, DtDDMRegionSP region,
127  std::wstring const& updateRateDesignator, bool active);
128 
130  virtual void subscribe(std::wstring const& updateRateDesignator = L"");
131  virtual void subscribe(const DtDDMRegionSet& region,
132  std::wstring const& updateRateDesignator = L"");
133  virtual void subscribe(const RTI::AttributeHandleSet& hSet,
134  std::wstring const& updateRateDesignator = L"");
135  virtual void subscribe(const RTI::AttributeHandleSet& hSet, DtDDMRegionSP region,
136  std::wstring const& updateRateDesignator = L"");
137 
138 
139  virtual void passiveSubscribe();
140 
142  virtual void unsubscribe();
143  virtual void unsubscribe(const DtDDMRegionSet& regionSet);
144 
147  virtual void requestUpdates();
148  virtual void requestUpdates(const DtDDMRegionSet& region);
149  virtual void requestUpdates(const RTI::AttributeHandleSet& hSet);
150  virtual void requestUpdates(const RTI::AttributeHandleSet& hSet,
151  DtDDMRegionSP region);
152 
156  virtual const RTI::AttributeHandleSet& publishedAttrs() const;
157 
160  virtual bool everPublished() const;
161 
165  virtual const RTI::AttributeHandleSet& subscribedAttrs() const;
166 
167  virtual const RTI::AttributeHandleSet& attributesWithSpace() const;
168  virtual const RTI::AttributeHandleSet& attributesWithoutSpace() const;
169 
170  virtual const RTI::AttributeHandleSet& subscribedAttrsWithSpace() const;
171  virtual const RTI::AttributeHandleSet& subscribedAttrsWithoutSpace() const;
172 
175  virtual DtObjClassDesc* firstSubscribed();
176 
179  virtual bool everSubscribed() const;
180 
182  virtual DtVrlRtiAmbassador* rtiAmb();
183 
185  virtual DtVrlFederateAmbassador* fedAmb();
186 
188  virtual RTI::AttributeHandle privilegeHandle() const;
189 
190  virtual void setUserTagModifier(DtObjectTagModifierSP modifier);
191  virtual DtObjectTagModifierSP userTagModifier();
192 
193 
200  virtual void setSubscribeToUnspecifiedAttributesFlag(bool subscribe);
201  virtual bool subscribeToUnspecifiedAttributesFlag();
202 
203 
210  virtual void enableUnknownAttributes();
211 
217  virtual void setUnknownAttributeEncoder(
219 
222  virtual void setUnknownAttributeChecker(
224 
227  virtual void setUnknownAttributeDecoder(
229 
231  virtual DtHlaStateEncoder::DtAttributeEncoder unknownAttributeEncoder();
232 
234  virtual DtHlaStateEncoder::DtAttributeCheckerWithHandle unknownAttributeChecker();
235 
237  virtual DtHlaStateDecoder::DtAttributeDecoder unknownAttributeDecoder();
238 
239 
240 public:
246  static void setSubscriptionTimeDelay(double delay);
247 
248 protected:
249 
251  static void startRegCb(RTI::ObjectClassHandle h,
252  void* usr);
253 
255  static void stopRegCb(RTI::ObjectClassHandle h,
256  void* usr);
257 
258 protected:
259 
261  virtual void processStartReg(RTI::ObjectClassHandle h);
262 
264  virtual void processStopReg(RTI::ObjectClassHandle h);
265 
267  virtual DtObjClassDesc* self() const;
268 
271  virtual void synchSubscribedAttributes();
272 
275  virtual void fillInAttributeHandleSetRegionHandleSetPairVector(
276  const RTI::AttributeHandleSet& hSet, DtDDMRegionSP region,
277  RTI::AttributeHandleSetRegionHandleSetPairVector& pairVector);
278 
280  virtual void addAttr(const char* attrName, RTI::AttributeHandle attrHandle,
281  RTI::DimensionHandleSet& dimSet, bool isPrivilegeToDelete, bool withSpace = false);
282 
284  virtual bool isMomAttribute(const char * attrName);
285 
286 protected:
288  RTI::ObjectClassHandle myHandle;
289  RTI::AttributeHandleSet* myAttrs;
290  RTI::AttributeHandleSet* myOwnAttrs;
291  RTI::AttributeHandleSet* mySubAttrs;
292  RTI::AttributeHandleSet* myPubAttrs;
293 
295  RTI::AttributeHandleSet* myAttrsWithSpace;
296 
298  RTI::AttributeHandleSet* myAttrsWithoutSpace;
299 
300  RTI::AttributeHandleSet* mySubAttrsWithSpace;
301  RTI::AttributeHandleSet* mySubAttrsWithoutSpace;
302 
305  std::list<DtObjClassDesc*> myChildren;
312 
314  RTI::AttributeHandle myPrivHandle;
315  RTI::AttributeHandle myMinAttrHand;
316  RTI::AttributeHandle myMaxAttrHand;
317 
318  typedef std::map<RTI::AttributeHandle, DtString> StringToAttributeHandleMap;
320 
322 
323  typedef std::vector<RTI::AttributeHandleSetRegionHandleSetPair>
326 
330 
331 protected:
332 
334 };
335 
336 inline RTI::ObjectClassHandle DtObjClassDesc::handle() const
337 {
338  return myHandle;
339 }
340 
341 inline const RTI::AttributeHandleSet& DtObjClassDesc::attrHandleSet() const
342 {
343  return *myAttrs;
344 }
345 
346 inline const RTI::AttributeHandleSet& DtObjClassDesc::ownAttrHandles() const
347 {
348  return *myOwnAttrs;
349 }
350 
351 inline const char* DtObjClassDesc::name() const
352 {
353  return myName.c_str();
354 }
355 
357 {
358  return (int)myAttrs->size();
359 }
360 
362 {
363  return myBase;
364 }
365 
367 {
368  return myBase;
369 }
370 
372 {
373  myChildren.push_back(child);
374 }
375 
377 {
378  return (DtObjClassDesc*) this;
379 }
380 
381 inline RTI::AttributeHandle DtObjClassDesc::privilegeHandle() const
382 {
383  return myPrivHandle;
384 }
385 
387 {
388  theSubscriptionTimeDelay = delay;
389 }
390 
391 #endif
392 
393 
RTI::AttributeHandleSet * myAttrs
Definition: objClassDesc1516.h:289
static void setSubscriptionTimeDelay(double delay)
Set a time delay to occur after calling RTI::RTIambassador::subscribe() The purpose of this function ...
Definition: objClassDesc1516.h:386
virtual RTI::AttributeHandle privilegeHandle() const
Returns the attribute handle of the privilegeToDelete attribute.
Definition: objClassDesc1516.h:381
RTI::AttributeHandleSet * mySubAttrs
Definition: objClassDesc1516.h:291
Instances of DtExerciseConn are used to provide an application&#39;s interface or connection to the netwo...
Definition: exerciseConnHLA.h:58
#define DT_DLL_VL
Definition: vlMachineTypes.h:108
virtual const RTI::AttributeHandleSet & ownAttrHandles() const
Get the set of non-inherited attribute handles for this class.
Definition: objClassDesc1516.h:346
Contains the DtString class declaration.
void(* DtAttributeDecoder)(DtStateRepository *stateRep, const RTI::AttributeHandleValuePairSet &avlist, unsigned long pairSetIndex)
Attribute decoding function declaration.
Definition: hlaStateDecoder.h:51
bool myClassNeeded
Definition: objClassDesc1516.h:303
Instances of DtVrlFederateAmbassador are used to manage the interface between the RTI and the VR-Link...
Definition: vrlFederateAmbassador1516.h:46
RTI::AttributeHandle myMinAttrHand
Definition: objClassDesc1516.h:315
This file contains the declaration of DtHlaStateEncoder.
void(* DtAttributeEncoder)(const DtStateRepository &stateRep, RTI::AttributeHandleValuePairSet *avList, RTI::AttributeHandle handle)
Attribute encoding function declaration.
Definition: hlaStateEncoder.h:50
DtString myName
Definition: objClassDesc1516.h:287
DtExerciseConn * myExConn
Definition: objClassDesc1516.h:306
virtual const RTI::AttributeHandleSet & attrHandleSet() const
Get the set of valid attribute handles for this class.
Definition: objClassDesc1516.h:341
DtHlaStateDecoder::DtAttributeDecoder myUnknownAttributeDecoder
Definition: objClassDesc1516.h:329
virtual const DtObjClassDesc * baseClass() const
Return a pointer to the base class&#39;s descriptor, NULL if none.
Definition: objClassDesc1516.h:361
int myNumSubscribeRequests
Definition: objClassDesc1516.h:310
DtBoost::shared_ptr< DtDDMRegion > DtDDMRegionSP
Definition: region1516.h:29
bool myEverPublished
Definition: objClassDesc1516.h:308
An instance of DtObjClassDesc is a &quot;class descriptor&quot; for an HLA Object class.
Definition: objClassDesc1516.h:41
RTI::AttributeHandleSet * myAttrsWithSpace
Attributes with a space (or dimensions in 1516) defined in the FOM.
Definition: objClassDesc1516.h:295
bool myPublished
Definition: objClassDesc1516.h:307
std::list< DtObjClassDesc * > myChildren
Definition: objClassDesc1516.h:305
RTI::AttributeHandleSet * mySubAttrsWithSpace
Definition: objClassDesc1516.h:300
DtObjClassDesc * myBase
Definition: objClassDesc1516.h:304
DtHlaStateEncoder::DtAttributeEncoder myUnknownAttributeEncoder
Definition: objClassDesc1516.h:327
RTI::ObjectClassHandle myHandle
Definition: objClassDesc1516.h:288
virtual void addChildClass(DtObjClassDesc *child)
Informs base class that it has a new child class.
Definition: objClassDesc1516.h:371
bool mySubscribeToUnspecifiedAttributesFlag
Definition: objClassDesc1516.h:311
virtual RTI::ObjectClassHandle handle() const
Get the object&#39;s class handle.
Definition: objClassDesc1516.h:336
std::map< RTI::AttributeHandle, DtString > StringToAttributeHandleMap
Definition: objClassDesc1516.h:318
virtual int numAttributes() const
Get the number of attributes associated with this object, including privilege to delete.
Definition: objClassDesc1516.h:356
DtHlaStateEncoder::DtAttributeCheckerWithHandle myUnknownAttributeChecker
Definition: objClassDesc1516.h:328
std::set< DtDDMRegionSP > DtDDMRegionSet
Definition: region1516.h:32
RegionHandleVector mySubscribedRegions
Definition: objClassDesc1516.h:325
virtual const char * name() const
Get the object&#39;s class handle.
Definition: objClassDesc1516.h:351
RTI::AttributeHandle myPrivHandle
Handle of the privilegeToDelete attribute.
Definition: objClassDesc1516.h:314
virtual const char * c_str() const
Returns a char* representation of the DtString;.
bool myEverSubscribed
Definition: objClassDesc1516.h:309
RTI::AttributeHandleSet * myOwnAttrs
Definition: objClassDesc1516.h:290
DtObjectTagModifierSP myTagModifier
Definition: objClassDesc1516.h:321
static const xmlChar * attrName
Definition: xmlFedTags.h:117
virtual DtObjClassDesc * self() const
Casts away const-ness. Use with caution.
Definition: objClassDesc1516.h:376
RTI::AttributeHandleSet * myAttrsWithoutSpace
Attributes without a space (or dimensions in 1516) defined in the FOM.
Definition: objClassDesc1516.h:298
static double theSubscriptionTimeDelay
Definition: objClassDesc1516.h:333
Instances of DtVrlRtiAmbassador are for wrapping the calls to The RTI ambassador so that we may overr...
Definition: vrlRtiAmbassador1516.h:25
RTI::AttributeHandle myMaxAttrHand
Definition: objClassDesc1516.h:316
RTI::AttributeHandleSet * myPubAttrs
Definition: objClassDesc1516.h:292
Instances of DtString are used to represent strings.
Definition: vlString.h:29
DtBoost::shared_ptr< DtObjectTagModifier > DtObjectTagModifierSP
Shared pointer typedefs for ease of use.
Definition: userTagModifiers.h:33
bool(* DtAttributeCheckerWithHandle)(const DtStateRepository &stateRep, const DtStateRepository &asSeenByRemote, RTI::AttributeHandle handle)
Attribute checking function declaration that takes a handle and checks the specific attribute pointed...
Definition: hlaStateEncoder.h:62
StringToAttributeHandleMap myStringToHandleMap
Definition: objClassDesc1516.h:319
This file contains declarations of the classes DtObjectTagModifier and DtInteractionTagModifier.
std::vector< RTI::AttributeHandleSetRegionHandleSetPair > RegionHandleVector
Definition: objClassDesc1516.h:324
This file contains typedefs for machine dependant types.
This file contains the declaration of DtHlaStateDecoder.
RTI::AttributeHandleSet * mySubAttrsWithoutSpace
Definition: objClassDesc1516.h:301

Document ID: Generated on Tue Feb 2 21:02:17 EST 2021 from SVN revision 223668
Copyright © 2005-2021 MAK Technologies. All Rights Reserved (www.mak.com)