Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

Changeset 4836 in orxonox.OLD for orxonox/trunk/src/lib/coord


Ignore:
Timestamp:
Jul 12, 2005, 12:33:16 AM (19 years ago)
Author:
bensch
Message:

orxonox/trunk: renamed all the \param → @param and so on in Doxygen tags.
Thanks a lot to the kDevelop team. this took since the last commit :)

Location:
orxonox/trunk/src/lib/coord
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • orxonox/trunk/src/lib/coord/null_parent.cc

    r4448 r4836  
    2525
    2626/**
    27    \returns the Reference to the NullParent
     27 * @returns the Reference to the NullParent
    2828*/
    2929NullParent* NullParent::getInstance ()
     
    3535
    3636/**
    37    \brief creates the one and only NullParent
    38    \param absCoordinate the cordinate of the Parent (normally Vector(0,0,0))
     37 * creates the one and only NullParent
     38 * @param absCoordinate the cordinate of the Parent (normally Vector(0,0,0))
    3939*/
    4040NullParent::NullParent (const Vector& absCoordinate) : PNode (absCoordinate, NULL)
     
    4949
    5050/**
    51    \brief standard deconstructor
     51 * standard deconstructor
    5252*/
    5353NullParent::~NullParent ()
  • orxonox/trunk/src/lib/coord/null_parent.h

    r4448 r4836  
    11/*!
    22    \file null_parent.h
    3     \brief Definition of the NullParent, the higest PNode of them all.
     3  * Definition of the NullParent, the higest PNode of them all.
    44*/
    55
  • orxonox/trunk/src/lib/coord/p_node.cc

    r4785 r4836  
    1515   co-programmer:
    1616
    17    \todo Smooth-Parent: delay, speed
     17   @todo Smooth-Parent: delay, speed
    1818*/
    1919
     
    4040
    4141/**
    42    \brief standard constructor
     42 * standard constructor
    4343*/
    4444PNode::PNode ()
     
    5050
    5151/**
    52    \param root the load-Element for the PNode
     52 * @param root the load-Element for the PNode
    5353*/
    5454PNode::PNode(const TiXmlElement* root)
     
    6262
    6363/**
    64    \brief constructor with coodinates
    65    \param absCoordinate the Absolute coordinate of the Object
    66    \param parent The parent-node of this node.
     64 * constructor with coodinates
     65 * @param absCoordinate the Absolute coordinate of the Object
     66 * @param parent The parent-node of this node.
    6767*/
    6868PNode::PNode (const Vector& absCoordinate, PNode* parent )
     
    8080
    8181/**
    82    \brief standard deconstructor
     82 * standard deconstructor
    8383*/
    8484PNode::~PNode ()
     
    9898
    9999/**
    100    \brief initializes a PNode
    101    \param parent the parent for this PNode
     100 * initializes a PNode
     101 * @param parent the parent for this PNode
    102102*/
    103103void PNode::init(PNode* parent)
     
    113113
    114114/**
    115    \brief loads parameters of the PNode
    116    \param root the XML-element to load the properties of
     115 * loads parameters of the PNode
     116 * @param root the XML-element to load the properties of
    117117*/
    118118void PNode::loadParams(const TiXmlElement* root)
     
    153153
    154154/**
    155    \brief set relative coordinates
    156    \param relCoord relative coordinates to its parent
     155 * set relative coordinates
     156 * @param relCoord relative coordinates to its parent
    157157
    158158   it is very importand, that you use this function, if you want to update the
     
    167167
    168168/**
    169    \brief set relative coordinates
    170    \param x x-relative coordinates to its parent
    171    \param y y-relative coordinates to its parent
    172    \param z z-relative coordinates to its parent
     169 * set relative coordinates
     170 * @param x x-relative coordinates to its parent
     171 * @param y y-relative coordinates to its parent
     172 * @param z z-relative coordinates to its parent
    173173   \see  void PNode::setRelCoor (const Vector& relCoord)
    174174*/
     
    179179
    180180/**
    181    \param absCoord set absolute coordinate
     181 * @param absCoord set absolute coordinate
    182182
    183183   it is very importand, that you use this function, if you want to update the
     
    192192
    193193/**
    194  * \param x x-coordinate.
    195  * \param y y-coordinate.
    196  * \param z z-coordinate.
     194 * @param x x-coordinate.
     195 * @param y y-coordinate.
     196 * @param z z-coordinate.
    197197 * \see void PNode::setAbsCoor (const Vector& absCoord)
    198198 */
     
    203203
    204204/**
    205    \brief shift coordinate (abs and rel)
    206    \param shift shift vector
     205 * shift coordinate (abs and rel)
     206 * @param shift shift vector
    207207
    208208   this function shifts the current coordinates about the vector shift. this is
     
    237237
    238238/**
    239    \brief set relative direction
    240    \param relDir to its parent
     239 * set relative direction
     240 * @param relDir to its parent
    241241
    242242   it is very importand, that you use this function, if you want to update the
     
    264264
    265265/**
    266    \brief sets the absolute direction (0,0,1)
    267    \param absDir absolute coordinates
     266 * sets the absolute direction (0,0,1)
     267 * @param absDir absolute coordinates
    268268
    269269   it is very importand, that you use this function, if you want to update the
     
    291291
    292292/**
    293    \brief shift coordinate (abs and rel)
    294    \param shift vector
     293 * shift coordinate (abs and rel)
     294 * @param shift vector
    295295
    296296   this function shifts the current coordinates about the vector shift. this is
     
    309309   yea right... shorter...
    310310
    311    \todo implement this
     311   @todo implement this
    312312*/
    313313void PNode::shiftDir (const Quaternion& shift)
     
    318318
    319319/**
    320    \brief adds a child and makes this node to a parent
    321    \param pNode child reference
    322    \param parentMode on which changes the child should also change ist state
     320 * adds a child and makes this node to a parent
     321 * @param pNode child reference
     322 * @param parentMode on which changes the child should also change ist state
    323323
    324324   use this to add a child to this node.
     
    349349
    350350/**
    351    \brief removes a child from the node
    352    \param pNode the child to remove from this pNode.
     351 * removes a child from the node
     352 * @param pNode the child to remove from this pNode.
    353353
    354354   Children from pNode will not be lost, they are referenced to NullPointer
     
    363363
    364364/**
    365    \brief remove this pnode from the tree and adds all following to NullParent
     365 * remove this pnode from the tree and adds all following to NullParent
    366366
    367367   this can be the case, if an entity in the world is been destroyed.
     
    385385
    386386/**
    387    \brief sets the parent of this PNode
    388    \param parent the Parent to set
     387 * sets the parent of this PNode
     388 * @param parent the Parent to set
    389389*/
    390390void PNode::setParent (PNode* parent)
     
    405405
    406406/**
    407    \brief set the mode of this parent manualy
    408    \param parentMode the mode of the bind-type.
     407 * set the mode of this parent manualy
     408 * @param parentMode the mode of the bind-type.
    409409*/
    410410void PNode::setParentMode (PARENT_MODE parentMode)
     
    414414
    415415/**
    416  * @brief sets the mode of this parent manually
     416 * sets the mode of this parent manually
    417417 * @param parentMode a String representing this parentingMode
    418418 */
     
    433433
    434434/**
    435    \brief has to be called, if the parent coordinate has changed
     435 * has to be called, if the parent coordinate has changed
    436436
    437437   normaly this will be done by the parent itself automaticaly. If you call this, you
     
    446446
    447447/**
    448    \brief updates the absCoordinate/absDirection
    449    \param dt The time passed since the last update
     448 * updates the absCoordinate/absDirection
     449 * @param dt The time passed since the last update
    450450
    451451   this is used to go through the parent-tree to update all the absolute coordinates
     
    568568
    569569/**
    570    \brief displays some information about this pNode
    571    \param depth The deph into which to debug the children of this PNode to.
     570 * displays some information about this pNode
     571 * @param depth The deph into which to debug the children of this PNode to.
    572572  (0: all children will be debugged, 1: only this PNode, 2: this and direct children...)
    573    \param level The n-th level of the Node we draw (this is internal and only for nice output)
     573 * @param level The n-th level of the Node we draw (this is internal and only for nice output)
    574574*/
    575575void PNode::debug(unsigned int depth, unsigned int level) const
     
    608608
    609609/**
    610   @brief displays the PNode at its position with its rotation as a cube.
     610  displays the PNode at its position with its rotation as a cube.
    611611*/
    612612void PNode::debugDraw(float size) const
  • orxonox/trunk/src/lib/coord/p_node.h

    r4771 r4836  
    11/*!
    22    \file p_node.h
    3     \brief Definition of a parenting node
     3  * Definition of a parenting node
    44
    55    parenting is how coordinates are handled in orxonox, meaning, that all coordinates
     
    6262  void setRelCoor (const Vector& relCoord);
    6363  void setRelCoor (float x, float y, float z);
    64   /** \returns the relative position */
     64  /** @returns the relative position */
    6565  inline const Vector& getRelCoor () const { return this->relCoordinate; };
    6666  void setAbsCoor (const Vector& absCoord);
    6767  void setAbsCoor (float x, float y, float z);
    68   /** \returns the absolute position */
     68  /** @returns the absolute position */
    6969  inline const Vector& getAbsCoor () const { return this->absCoordinate; };
    7070  void shiftCoor (const Vector& shift);
     
    7272  void setRelDir (const Quaternion& relDir);
    7373  void setRelDir (float x, float y, float z);
    74   /** \returns the relative Direction */
     74  /** @returns the relative Direction */
    7575  inline const Quaternion& getRelDir () const { return this->relDirection; };
    76   /** \returns a Vector pointing into the relative Direction */
     76  /** @returns a Vector pointing into the relative Direction */
    7777  inline Vector getRelDirV() const { return this->relDirection.apply(Vector(0,1,0)); };
    7878  void setAbsDir (const Quaternion& absDir);
    7979  void setAbsDir (float x, float y, float z);
    80   /** \returns the absolute Direction */
     80  /** @returns the absolute Direction */
    8181  inline const Quaternion& getAbsDir () const { return this->absDirection; };
    82   /** \returns a Vector pointing into the absolute Direction */
     82  /** @returns a Vector pointing into the absolute Direction */
    8383  inline Vector getAbsDirV() const { return this->absDirection.apply(Vector(0,1,0)); };
    8484  void shiftDir (const Quaternion& shift);
    8585
    86   /** \returns the Speed of the Node */
     86  /** @returns the Speed of the Node */
    8787  inline float getSpeed() const {return this->velocity.len();}
    88   /** \returns the Velocity of the Node */
     88  /** @returns the Velocity of the Node */
    8989  inline const Vector& getVelocity() const {return this->velocity;}
    9090
     
    100100  void setParentMode (PARENT_MODE parentMode);
    101101  void setParentMode (const char* parentingMode);
    102   /** \returns the Parenting mode of this node */
     102  /** @returns the Parenting mode of this node */
    103103  int getParentMode() const { return this->parentMode; };
    104104
     
    114114  /** \brief tells the child that the parent's Direction has changed */
    115115  inline void parentDirChanged () { this->bRelDirChanged = true; }
    116   /** \returns the last calculated coordinate */
     116  /** @returns the last calculated coordinate */
    117117  inline Vector getLastAbsCoor() {return this->lastAbsCoordinate;}
    118118
Note: See TracChangeset for help on using the changeset viewer.