Changeset 7541 for code/trunk/src/modules/pickup/items/DronePickup.h

Timestamp:

Oct 14, 2010, 12:55:59 PM (14 years ago)

Author:

dafrick

Message:

Some more documentation.

File:

• code/trunk/src/modules/pickup/items/DronePickup.h (modified) (4 diffs)

code/trunk/src/modules/pickup/items/DronePickup.h

@@ -39 +39 @@
 
 #include <string>
-#include <worldentities/pawns/Pawn.h>
-#include <worldentities/Drone.h>
-
-#include "worldentities/StaticEntity.h"
 
 #include "pickup/Pickup.h"
@@ -49 +45 @@
 namespace orxonox {
 
+    /**
+    @brief
+        The DronePickup adds a Drone to the Pawn upon being picked up.
+        It can be used in XML as follows:
+        @code
+        <DronePickup droneTemplate="myDroneTemplate" />
+        @endcode
+        Where <em>droneTemplate</em> specifies a @ref orxonox::Template "Template" based on which the Drone is created.
 
+    @author
+        Lukas Gassner
+
+    @ingroup PickupItems
+    */
     class _PickupExport DronePickup : public Pickup, public Tickable
     {
@@ -62 +71 @@
             virtual void clone(OrxonoxClass*& item); //!< Creates a duplicate of the input OrxonoxClass.
 
-            void setDroneTemplate(std::string templatename);
-            const std::string& getDroneTemplate() const;
+            void setDroneTemplate(std::string templatename); //!< Set the droneTemplate.
+            const std::string& getDroneTemplate() const; //!< Get the name of the droneTemplate.
 
         protected:
@@ -70 +79 @@
         private:
             void initialize(void); //!< Initializes the member variables.
-            std::string droneTemplate_;
+            std::string droneTemplate_; //!< The name of the template, based upon which the Drone is created.
             Pawn* carrierToPawnHelper(void); //!< Helper to transform the PickupCarrier to a Pawn, and throw an error message if the conversion fails.