VR-Exchange 2.1 API Documentation
pMacros.h
Go to the documentation of this file.
1 /*********************************************************************
2  ** Copyright (c) 2012 VT MAK
3  *********************************************************************/
4 
5 // This file defines macros that make creating translation easier
6 
7 // The first 5 functions in this macro must be defined in your CXX file. the next 3 are automatically defined by the DT_DEFINE macro
8 #define DT_DECLARE_PORTAL_CALLBACKS(DtBrokerObjectNamespace,DtPortalReflectedObjType) \
9  virtual void createPortalPublisher(DtBrokerObjectNamespace::DtBrokerObject* brokerObject); \
10  virtual bool isPortalPublishable(const DtBrokerObjectNamespace::DtBrokerObject* brokerObject) const; \
11  virtual void deletePortalPublisher(DtBrokerObjectNamespace::DtBrokerObject* brokerObject); \
12  virtual void discoverPortalObject(const DtPortalReflectedObjType &obj); \
13  virtual void receivePortalUpdate(const DtPortalReflectedObjType &obj); \
14  \
15  static void portalObjectAddedCb(const DtPortalReflectedObjType &obj, void *ud); \
16  static void portalObjectUpdatedCb(const DtPortalReflectedObjType &obj, void *ud); \
17  static void portalObjectDeletedCb(const DtPortalReflectedObjType &obj, void *ud);
18 
19 
20 #define DT_DEFINE_CREATE_PORTAL_PUBLISHER(DtTranslatorClass,DtBrokerObjectNamespace,DtPortalObjectType,DtReflectedObject) \
21  void DtTranslatorClass::createPortalPublisher( DtBrokerObjectNamespace::DtBrokerObject *brokerObject ) \
22 { \
23  MAKVrExchange::DtPortalObjectPublisherTemplate<DtPortalObjectType> *publisher = \
24  new MAKVrExchange::DtPortalObjectPublisherTemplate<DtPortalObjectType>(broker()->portalConnection()); \
25  \
26  const DtReflectedObject* reflectedObj = \
27  static_cast<const DtReflectedObject*>( brokerObject->reflectedObjPtr() ); \
28  \
29  publisher->sr()->setIdentifier(reflectedObj->globalId()); \
30  brokerObject->setPublisherPtr(publisher); \
31 }
32 
33 #define DT_DEFINE_IS_PORTAL_PUBLISHABLE(DtTranslatorClass, DtBrokerObjectNamespace, Protocol) \
34 bool DtTranslatorClass::isPortalPublishable( const DtBrokerObjectNamespace::DtBrokerObject *brokerObject ) const \
35 { \
36  assert( brokerObject->protocol() == DtBrokerObjectNamespace::DtBrokerObject::Protocol );\
37  return true;\
38 }
39 
40 #define DT_DEFINE_DELETE_PORTAL_PUBLISHER(DtTranslatorClass, DtBrokerObjectNamespace, DtPortalObjectType) \
41 void DtTranslatorClass::deletePortalPublisher(DtBrokerObjectNamespace::DtBrokerObject* brokerObject) \
42 { \
43  MAKVrExchange::DtPortalObjectPublisherTemplate<DtPortalObjectType> *publisher = \
44  static_cast<MAKVrExchange::DtPortalObjectPublisherTemplate<DtPortalObjectType> *>(brokerObject->publisherPtr()); \
45  \
46  if (publisher) \
47  { \
48  DtDELETE( publisher ); \
49  brokerObject->setPublisherPtr( publisher ); \
50  } \
51 }
52 
53 #define DT_DEFINE_DISCOVER_PORTAL_OBJECT(DtTranslatorClass,DtBrokerObjectNamespace,DtPortalReflectedObjType,DtProtocol) \
54 void DtTranslatorClass::discoverPortalObject(const DtPortalReflectedObjType &refObj) \
55 { \
56  DtBrokerObjectNamespace::DtBrokerObject* brokerObject = findBrokerObject(&refObj); \
57  if (!brokerObject) \
58  { \
59  brokerObject = createBrokerObject(&refObj); \
60  } \
61  \
62  brokerObject->setLastUpdate(myBroker->simTime()); \
63  brokerObject->setObjectName(refObj.sr()->identifier()); \
64  brokerObject->setIsDiscovered(true); \
65  \
66  create##DtProtocol##Publisher( brokerObject ); \
67  \
68  refObj.addUpdateCallback(DtTranslatorClass::portalObjectUpdatedCb, this); \
69  receivePortalUpdate(refObj); \
70 }
71 
72 #define DT_DEFINE_RECEIVE_PORTAL_UPDATE(DtTranslatorClass, DtBrokerObjectNamespace, DtPortalReflectedObjType, \
73  DtPortalObjType, DtProtocolPublisher, DtProtocolStateRepository,DtProtocol) \
74 void DtTranslatorClass::receivePortalUpdate(const DtPortalReflectedObjType &refObj) \
75 { \
76  DtBrokerObjectNamespace::DtBrokerObject* brokerObject = findBrokerObject(&refObj); \
77  assert( brokerObject ); \
78  \
79  brokerObject->setLastUpdate(myBroker->simTime()); \
80  \
81  const DtPortalObjType &sr = *(refObj.sr()); \
82  \
83  if (!brokerObject->isPublishable()) \
84  { \
85  brokerObject->setIsPublishable( is##DtProtocol##Publishable( brokerObject )); \
86  } \
87  \
88  callObjectUpdateCallbacks( brokerObject ); \
89  \
90  if (brokerObject->isDropped()) \
91  { \
92  return; \
93  } \
94  \
95  DtProtocolPublisher *publisher = \
96  static_cast<DtProtocolPublisher*>( brokerObject->publisherPtr() ); \
97  assert(publisher); \
98  \
99  DtProtocolStateRepository &newSr = * \
100  static_cast<DtProtocolStateRepository*>(publisher->sr()); \
101  \
102  translate( &newSr, sr, refObj ); \
103  \
104  if (myBroker->isTranslatorDebuggingOn( virtualTranslatorName() )) \
105  { \
106  printIncomingOutgoingStateReps(sr, newSr, virtualTranslatorName()); \
107  } \
108  \
109  if ( myBroker->brokerInitializer()->oneToOneMapping()) \
110  { \
111  publisher->forceUpdate(); \
112  } \
113  if (!myBroker->isTranslatorDisabled( virtualTranslatorName() )) \
114  { \
115  publisher->tick(); \
116  } \
117 }
118 
119 
120 #define DT_DEFINE_PORTAL_CALLBACKS(DtTranslatorClass, DtPortalReflectedObjType, DtTemplates) \
121  DtTemplates \
122 void DtTranslatorClass::portalObjectAddedCb(const DtPortalReflectedObjType & reflectedObj, void *ud) \
123 { \
124  DtTranslatorClass *et = (DtTranslatorClass*)ud; \
125  et->discoverPortalObject(reflectedObj); \
126 }; \
127  \
128  DtTemplates \
129 void DtTranslatorClass::portalObjectUpdatedCb(const DtPortalReflectedObjType & reflectedObj, void *ud) \
130 { \
131  DtTranslatorClass *et = (DtTranslatorClass*)ud; \
132  et->receivePortalUpdate(reflectedObj); \
133 }; \
134  \
135  DtTemplates \
136 void DtTranslatorClass::portalObjectDeletedCb(const DtPortalReflectedObjType & reflectedObj, void *ud) \
137 { \
138  DtTranslatorClass *et = (DtTranslatorClass*)ud; \
139  et->removePortalObject(&reflectedObj); \
140 }
141 
142 
143 #define DT_TICK_ALL_PUBLISHERS(DtPublisherContainerType, DtBrokerObjectNamespace, DtPublisherContainer, DtPublisherType) \
144  for ( DtPublisherContainerType::iterator pubItr = \
145  DtPublisherContainer.begin(); pubItr != DtPublisherContainer.end(); ++pubItr) \
146 { \
147  DtBrokerObjectNamespace::DtBrokerObject* brokerObject = pubItr->second; \
148  DtPublisherType *publisher = static_cast<DtPublisherType*>( brokerObject->publisherPtr() ); \
149  if (publisher && brokerObject->isPublishable()) \
150  { \
151  publisher->tick(); \
152  } \
153 }
154 
155 #define DT_DECLARE_INTERACTION_PORTAL_CALLBACKS(DtPortalInteractionType,DtInteractionType) \
156  virtual void createPortalInteraction( const DtInteractionType& incomming ); \
157  static void receivePortalInteraction( const DtPortalInteractionType &inter, void *usr);
158 
159 
160 #define DT_DEFINE_CREATE_PORTAL_INTERACTION(DtTranslatorClass,DtPortalInteractionType,DtInteractionType,DtObjectKind) \
161 void DtTranslatorClass::createPortalInteraction( const DtInteractionType& in ) \
162 { \
163  DtPortalInteractionType out; \
164  out.setKind(DtObjectKind); \
165 \
166  translate( &out, in ); \
167 \
168  if (broker()->isTranslatorDebuggingOn( virtualTranslatorName() )) \
169  { \
170  printIncomingOutgoingInteractions( in, out); \
171  } \
172  broker()->portalConnection()->send(out); \
173 }
174 
175 #define DT_DEFINE_RECEIVE_PORTAL_INTERACTION(DtTranslatorClass,DtPortalInteractionType, DtProtocol) \
176 void DtTranslatorClass::receivePortalInteraction( \
177  const DtPortalInteractionType &inter, void *usr) \
178 { \
179  DtTranslatorClass *trans = (DtTranslatorClass*)usr; \
180  trans->create##DtProtocol##Interaction(inter); \
181 }
182 
183 
184 

Document ID: Generated on Tue Aug 7 22:07:13 EDT 2012 from SVN revision 117874
Copyright © 2005-2012 VT MÄK Inc. All Rights Reserved (www.mak.com)