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-2025 MAK Technologies, Inc
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 
80  virtual bool isLeafClass() const;
81 
84  virtual int isOfClass(RTI::ObjectClassHandle hand) const;
85 
88  virtual int numAttributes() const;
89 
91  virtual bool hasAttribute(const char* attrName) const;
92 
95  virtual const RTI::AttributeHandleSet& attrHandleSet() const;
96 
98  virtual const RTI::AttributeHandleSet& ownAttrHandles() const;
99 
106  virtual bool classNeededByFederation();
107 
112  virtual void publish();
113  virtual void publish(const RTI::AttributeHandleSet& hSet);
114 
116  virtual void unpublish();
117 
122 
124  virtual void subscribe(std::wstring const& updateRateDesignator, bool active);
125  virtual void subscribe(const DtDDMRegionSet& region,
126  std::wstring const& updateRateDesignator, bool active);
127  virtual void subscribe(const RTI::AttributeHandleSet& hSet,
128  std::wstring const& updateRateDesignator, bool active);
129  virtual void subscribe(const RTI::AttributeHandleSet& hSet, DtDDMRegionSP region,
130  std::wstring const& updateRateDesignator, bool active);
131 
133  virtual void subscribe(std::wstring const& updateRateDesignator = L"");
134  virtual void subscribe(const DtDDMRegionSet& region,
135  std::wstring const& updateRateDesignator = L"");
136  virtual void subscribe(const RTI::AttributeHandleSet& hSet,
137  std::wstring const& updateRateDesignator = L"");
138  virtual void subscribe(const RTI::AttributeHandleSet& hSet, DtDDMRegionSP region,
139  std::wstring const& updateRateDesignator = L"");
140 
141 
142  virtual void passiveSubscribe();
143 
145  virtual void unsubscribe();
146  virtual void unsubscribe(const DtDDMRegionSet& regionSet);
147 
150  virtual void requestUpdates();
151  virtual void requestUpdates(const DtDDMRegionSet& region);
152  virtual void requestUpdates(const RTI::AttributeHandleSet& hSet);
153  virtual void requestUpdates(const RTI::AttributeHandleSet& hSet,
154  DtDDMRegionSP region);
155 
159  virtual const RTI::AttributeHandleSet& publishedAttrs() const;
160 
163  virtual bool everPublished() const;
164 
168  virtual const RTI::AttributeHandleSet& subscribedAttrs() const;
169 
170  virtual const RTI::AttributeHandleSet& attributesWithSpace() const;
171  virtual const RTI::AttributeHandleSet& attributesWithoutSpace() const;
172 
173  virtual const RTI::AttributeHandleSet& subscribedAttrsWithSpace() const;
174  virtual const RTI::AttributeHandleSet& subscribedAttrsWithoutSpace() const;
175 
178  virtual DtObjClassDesc* firstSubscribed();
179 
182  virtual bool everSubscribed() const;
183 
185  virtual DtVrlRtiAmbassador* rtiAmb();
186 
188  virtual DtVrlFederateAmbassador* fedAmb();
189 
191  virtual RTI::AttributeHandle privilegeHandle() const;
192 
193  virtual void setUserTagModifier(DtObjectTagModifierSP modifier);
194  virtual DtObjectTagModifierSP userTagModifier();
195 
196 
203  virtual void setSubscribeToUnspecifiedAttributesFlag(bool subscribe);
204  virtual bool subscribeToUnspecifiedAttributesFlag();
205 
206 
213  virtual void enableUnknownAttributes();
214 
220  virtual void setUnknownAttributeEncoder(
222 
225  virtual void setUnknownAttributeChecker(
227 
230  virtual void setUnknownAttributeDecoder(
232 
234  virtual DtHlaStateEncoder::DtAttributeEncoder unknownAttributeEncoder();
235 
237  virtual DtHlaStateEncoder::DtAttributeCheckerWithHandle unknownAttributeChecker();
238 
240  virtual DtHlaStateDecoder::DtAttributeDecoder unknownAttributeDecoder();
241 
242 
243 public:
249  static void setSubscriptionTimeDelay(double delay);
250 
251 protected:
252 
254  static void startRegCb(RTI::ObjectClassHandle h,
255  void* usr);
256 
258  static void stopRegCb(RTI::ObjectClassHandle h,
259  void* usr);
260 
261 protected:
262 
264  virtual void processStartReg(RTI::ObjectClassHandle h);
265 
267  virtual void processStopReg(RTI::ObjectClassHandle h);
268 
270  virtual DtObjClassDesc* self() const;
271 
274  virtual void synchSubscribedAttributes();
275 
278  virtual void fillInAttributeHandleSetRegionHandleSetPairVector(
279  const RTI::AttributeHandleSet& hSet, DtDDMRegionSP region,
280  RTI::AttributeHandleSetRegionHandleSetPairVector& pairVector);
281 
283  virtual void addAttr(const char* attrName, RTI::AttributeHandle attrHandle,
284  RTI::DimensionHandleSet& dimSet, bool isPrivilegeToDelete, bool withSpace = false);
285 
287  virtual bool isMomAttribute(const char * attrName);
288 
289 protected:
291  RTI::ObjectClassHandle myHandle;
292  RTI::AttributeHandleSet* myAttrs;
293  RTI::AttributeHandleSet* myOwnAttrs;
294  RTI::AttributeHandleSet* mySubAttrs;
295  RTI::AttributeHandleSet* myPubAttrs;
296 
298  RTI::AttributeHandleSet* myAttrsWithSpace;
299 
301  RTI::AttributeHandleSet* myAttrsWithoutSpace;
302 
303  RTI::AttributeHandleSet* mySubAttrsWithSpace;
304  RTI::AttributeHandleSet* mySubAttrsWithoutSpace;
305 
306  RTI::DimensionHandleSet myClassDimSet;
307 
310  std::list<DtObjClassDesc*> myChildren;
317 
319  RTI::AttributeHandle myPrivHandle;
320  RTI::AttributeHandle myMinAttrHand;
321  RTI::AttributeHandle myMaxAttrHand;
322 
323  typedef std::map<RTI::AttributeHandle, DtString> StringToAttributeHandleMap;
325 
327 
328  typedef std::vector<RTI::AttributeHandleSetRegionHandleSetPair>
331 
335 
336 protected:
337 
339 };
340 
341 inline RTI::ObjectClassHandle DtObjClassDesc::handle() const
342 {
343  return myHandle;
344 }
345 
346 inline const RTI::AttributeHandleSet& DtObjClassDesc::attrHandleSet() const
347 {
348  return *myAttrs;
349 }
350 
351 inline const RTI::AttributeHandleSet& DtObjClassDesc::ownAttrHandles() const
352 {
353  return *myOwnAttrs;
354 }
355 
356 inline const char* DtObjClassDesc::name() const
357 {
358  return myName.c_str();
359 }
360 
362 {
363  return (int)myAttrs->size();
364 }
365 
367 {
368  return myBase;
369 }
370 
372 {
373  return myBase;
374 }
375 
377 {
378  myChildren.push_back(child);
379 }
380 
381 inline bool DtObjClassDesc::isLeafClass() const
382 {
383  return myChildren.size() == 0;
384 }
385 
387 {
388  return (DtObjClassDesc*) this;
389 }
390 
391 inline RTI::AttributeHandle DtObjClassDesc::privilegeHandle() const
392 {
393  return myPrivHandle;
394 }
395 
397 {
398  theSubscriptionTimeDelay = delay;
399 }
400 
401 #endif
402 
403 
RTI::AttributeHandleSet * myAttrs
Definition: objClassDesc1516.h:292
static void setSubscriptionTimeDelay(double delay)
Set a time delay to occur after calling RTI::RTIambassador::subscribe() The purpose of this function ...
Definition: objClassDesc1516.h:396
virtual RTI::AttributeHandle privilegeHandle() const
Returns the attribute handle of the privilegeToDelete attribute.
Definition: objClassDesc1516.h:391
std::shared_ptr< DtObjectTagModifier > DtObjectTagModifierSP
Shared pointer typedefs for ease of use.
Definition: userTagModifiers.h:33
RTI::AttributeHandleSet * mySubAttrs
Definition: objClassDesc1516.h:294
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
virtual const RTI::AttributeHandleSet & ownAttrHandles() const
Get the set of non-inherited attribute handles for this class.
Definition: objClassDesc1516.h:351
Contains the DtString class declaration.
void(* DtAttributeDecoder)(DtStateRepository *stateRep, const RTI::AttributeHandleValuePairSet &avlist, unsigned long pairSetIndex)
Attribute decoding function declaration.
Definition: hlaStateDecoder.h:53
bool myClassNeeded
Definition: objClassDesc1516.h:308
Instances of DtVrlFederateAmbassador are used to manage the interface between the RTI and the VR-Link...
Definition: vrlFederateAmbassador1516.h:44
RTI::AttributeHandle myMinAttrHand
Definition: objClassDesc1516.h:320
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:290
virtual bool isLeafClass() const
Return true if this class is a leaf (i.e., has no children); otherwise, false.
Definition: objClassDesc1516.h:381
DtExerciseConn * myExConn
Definition: objClassDesc1516.h:311
virtual const RTI::AttributeHandleSet & attrHandleSet() const
Get the set of valid attribute handles for this class.
Definition: objClassDesc1516.h:346
DtHlaStateDecoder::DtAttributeDecoder myUnknownAttributeDecoder
Definition: objClassDesc1516.h:334
virtual const DtObjClassDesc * baseClass() const
Return a pointer to the base class&#39;s descriptor, NULL if none.
Definition: objClassDesc1516.h:366
int myNumSubscribeRequests
Definition: objClassDesc1516.h:315
bool myEverPublished
Definition: objClassDesc1516.h:313
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:298
bool myPublished
Definition: objClassDesc1516.h:312
std::list< DtObjClassDesc * > myChildren
Definition: objClassDesc1516.h:310
RTI::AttributeHandleSet * mySubAttrsWithSpace
Definition: objClassDesc1516.h:303
DtObjClassDesc * myBase
Definition: objClassDesc1516.h:309
DtHlaStateEncoder::DtAttributeEncoder myUnknownAttributeEncoder
Definition: objClassDesc1516.h:332
RTI::ObjectClassHandle myHandle
Definition: objClassDesc1516.h:291
virtual void addChildClass(DtObjClassDesc *child)
Informs base class that it has a new child class.
Definition: objClassDesc1516.h:376
bool mySubscribeToUnspecifiedAttributesFlag
Definition: objClassDesc1516.h:316
virtual RTI::ObjectClassHandle handle() const
Get the object&#39;s class handle.
Definition: objClassDesc1516.h:341
RTI::DimensionHandleSet myClassDimSet
Definition: objClassDesc1516.h:306
std::map< RTI::AttributeHandle, DtString > StringToAttributeHandleMap
Definition: objClassDesc1516.h:323
virtual int numAttributes() const
Get the number of attributes associated with this object, including privilege to delete.
Definition: objClassDesc1516.h:361
DtHlaStateEncoder::DtAttributeCheckerWithHandle myUnknownAttributeChecker
Definition: objClassDesc1516.h:333
std::set< DtDDMRegionSP > DtDDMRegionSet
Definition: region1516.h:32
RegionHandleVector mySubscribedRegions
Definition: objClassDesc1516.h:330
virtual const char * name() const
Get the object&#39;s class handle.
Definition: objClassDesc1516.h:356
RTI::AttributeHandle myPrivHandle
Handle of the privilegeToDelete attribute.
Definition: objClassDesc1516.h:319
virtual const char * c_str() const
Returns a char* representation of the DtString;.
bool myEverSubscribed
Definition: objClassDesc1516.h:314
RTI::AttributeHandleSet * myOwnAttrs
Definition: objClassDesc1516.h:293
DtObjectTagModifierSP myTagModifier
Definition: objClassDesc1516.h:326
static const xmlChar * attrName
Definition: xmlFedTags.h:116
virtual DtObjClassDesc * self() const
Casts away const-ness. Use with caution.
Definition: objClassDesc1516.h:386
RTI::AttributeHandleSet * myAttrsWithoutSpace
Attributes without a space (or dimensions in 1516) defined in the FOM.
Definition: objClassDesc1516.h:301
static double theSubscriptionTimeDelay
Definition: objClassDesc1516.h:338
Instances of DtVrlRtiAmbassador are for wrapping the calls to The RTI ambassador so that we may overr...
Definition: vrlRtiAmbassador1516.h:23
RTI::AttributeHandle myMaxAttrHand
Definition: objClassDesc1516.h:321
std::shared_ptr< DtDDMRegion > DtDDMRegionSP
Definition: region1516.h:29
RTI::AttributeHandleSet * myPubAttrs
Definition: objClassDesc1516.h:295
Instances of DtString are used to represent strings.
Definition: vlString.h:36
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:324
This file contains declarations of the classes DtObjectTagModifier and DtInteractionTagModifier.
std::vector< RTI::AttributeHandleSetRegionHandleSetPair > RegionHandleVector
Definition: objClassDesc1516.h:329
This file contains typedefs for machine dependant types.
This file contains the declaration of DtHlaStateDecoder.
RTI::AttributeHandleSet * mySubAttrsWithoutSpace
Definition: objClassDesc1516.h:304

Document ID: Generated on Thu Oct 16 00:12:25 EDT 2025 from SVN revision 280738
Copyright © 1992-2025 MAK Technologies. All Rights Reserved (www.mak.com)