Changeset 8454 for code/branches/portals/src/modules

Timestamp:

May 12, 2011, 1:17:38 PM (14 years ago)

Author:

anbueche

Message:

comments added

Location:

code/branches/portals/src/modules/portals

Files:

• PortalEndPoint.cc (modified) (4 diffs)
• PortalEndPoint.h (modified) (4 diffs)

code/branches/portals/src/modules/portals/PortalEndPoint.cc

@@ -53 +53 @@
     bool PortalEndPoint::execute(bool bTriggered, BaseObject* trigger)
     {
+        if(!this->isActive())
+            return true;
+        
         MultiTriggerContainer * cont = orxonox_cast<MultiTriggerContainer *>(trigger);
         if(cont == 0)
@@ -64 +67 @@
         }
         
-        if(this->getAttachedObjects().find(orxonox_cast<WorldEntity *>(originatingTrigger)) == this->getAttachedObjects().end())  // only necessary if events have the same name
-            return true;
-        
         MobileEntity * entity = orxonox_cast<MobileEntity *>(cont->getData());
         if(entity == 0)
@@ -73 +73 @@
         if(bTriggered)
         {
-            if(this->recentlyJumpedOut_.find(entity) == this->recentlyJumpedOut_.end())  // only enter the portal if not recently jumped out of it
+            if(this->recentlyJumpedOut_.find(entity) == this->recentlyJumpedOut_.end())  // only enter the portal if not just jumped out of it
             {
                 PortalLink::use(entity, this);
@@ -89 +89 @@
     {
         this->recentlyJumpedOut_.insert(entity);
+        
         entity->setPosition(this->getWorldPosition());
         entity->rotate(this->getWorldOrientation());
         entity->setVelocity(this->getWorldOrientation() * entity->getVelocity());
+        entity->setVelocity(entity->getVelocity() * 1.5);
     }
 

code/branches/portals/src/modules/portals/PortalEndPoint.h

@@ -21 +21 @@
             virtual ~PortalEndPoint();
             virtual void XMLPort(Element& xmlelement, XMLPort::Mode mode);
-            inline void setTargets(const std::string & targets)
+            inline void setTargets(const std::string & targets)                 //!< set types which are allowed to activate the PortalEndPoint 
             {
                 this->trigger_->addTargets(targets);
@@ -27 +27 @@
             
             void XMLEventPort(Element& xmlelement, XMLPort::Mode mode);
-            static std::map<unsigned int, PortalEndPoint *> idMap_s; //!< maps integer id values to portalendpoints
+            static std::map<unsigned int, PortalEndPoint *> idMap_s; //!< Maps the id of each PortalEndPoint to a pointer to that PortalEndPoint
             inline void setID(unsigned int id)
             {
@@ -37 +37 @@
                 return this->id_;
             }
+            
+            /// \brief Set templateName_ (the name of the design Template) and add that Template to this Object
             inline void setTemplate(const std::string & name)
             {
@@ -42 +44 @@
                 this->addTemplate(name);
             }
+
+            /// \brief Get the name of the attached design template
             inline const std::string & getTemplate()
             {
                 return this->templateName_;
             }
+
+            /*! \brief This function is called each time the DistanceMultiTrigger of this PortalEndPoint changed
+             * \param bTriggered true if the trigger was triggered on, false if the trigger has switched to off
+             * \param trigger the MultiTriggerContainer containing the triggering BaseObject (and trigger_ the portal's MultiDistanceTrigger which we already know)
+             * 
+             * if bTriggered is \c true the triggering entity enters this portal (if it is an entrance)
+             * otherwise the triggering entity is removed from the set of entities who recently jumped out of this portal */
             bool execute(bool bTriggered, BaseObject* trigger);
+
+            /*! \brief Let an Entity jump out of this portal no matter where it was before
+             * \param entity The Entity which should jump out of this portal */
             void jumpOut(MobileEntity * entity);
         protected:
             
         private:
-            static const std::string EVENTFUNCTIONNAME;
+            static const std::string EVENTFUNCTIONNAME; //!< = "execute"
             
-            unsigned int id_;
-            DistanceMultiTrigger * trigger_;
-            std::string templateName_;
+            unsigned int id_;            //!< the hopefully (depends on the writer of the levelfile) unique id, which is used to establish links between PortalEndPoints
+            DistanceMultiTrigger * trigger_;      //!< the DistanceMultiTrigger which notices near entities of the defined type
+            std::string templateName_;            //!< The name of the design template used for this endpoint
 
             std::set<MobileEntity *> recentlyJumpedOut_; //!< Entities which recently jumped out of this EndPoint, hence they shouldn't be pulled in again if the endpoint is the beginning of a link