Changeset 3517 in orxonox.OLD for orxonox/branches/trackManager/src/lib

Timestamp:

Mar 12, 2005, 12:34:15 PM (20 years ago)

Author:

bensch

Message:

orxonox/branches/trackManager: some doxygen-tags.

Location:

orxonox/branches/trackManager/src/lib/math

Files:

• curve.cc (modified) (4 diffs)
• curve.h (modified) (3 diffs)

orxonox/branches/trackManager/src/lib/math/curve.cc

@@ -46 +46 @@
 }
 
+/**
+   \brief adds a new Node to the bezier Curve ath Position insertPosition
+   \param insertPosition The Position on the Path to insert the node.
+   \param newNode a Vector to the position of the new node
+*/
 void Curve::addNode(const Vector& newNode, unsigned int insertPosition)
 {
@@ -253 +258 @@
 /**
    \brief Calulates the direction of the Curve at time t.
-   \param The time at which to evaluate the curve.
-   \returns The vvaluated Vector.
+   \param t The time at which to evaluate the curve.
+   \returns The Directional Vector.
 */
 Vector BezierCurve::calcDir (float t)
@@ -261 +266 @@
 }
 
+/**
+   \brief Calulates the acceleration of the Curve at time t.
+   \param t The time at which to evaluate the curve.
+   \returns The acceleration-Vector.
+*/
 Vector BezierCurve::calcAcc (float t)
 {
@@ -416 +426 @@
 /**
    \brief Calulates the direction of the Curve at time t.
-   \param The time at which to evaluate the curve.
+   \param t The time at which to evaluate the curve.
    \returns The vvaluated Vector.
 */

orxonox/branches/trackManager/src/lib/math/curve.h

@@ -17 +17 @@
 
 //! An abstract class to handle curves. Needed for the Tracking system in orxonox.
+/**
+   A Curve is a smooth line which tries to approximate a path through the nodes given to it.
+   <br>
+
+   <b>Usage of Curves:</b><br>
+   \li Creation: Curve* newCurve = new BezierCurve();
+   \li Adding some Points: newCurve->addNode([Vector to the point to add]);
+   \li Get Point on Curve: newCurve->calcPos(timeIndex);    // where timeindex is in the interval [0,1]
+   <br>
+   More Fuctionality is:
+   \li debug():  outputs some info about this curve.
+   \li getNode(i): returns a Vector to the n'th node of the Curve.
+   \li getNodeCount(): returns the count of nodes.
+   <br>
+   General Info:
+   \li Curves take rather much power to be created/altered, but are fast calculated at runtime.
+*/
 class Curve
 {
@@ -39 +56 @@
 
  private:
+  //! rebuilds the Curve with the right algorithm
   virtual void rebuild(void) = 0;
  public:
@@ -45 +63 @@
   void addNode(const Vector& newNode, unsigned int insertPosition);
   Vector getNode(unsigned int nodeToFind);
+  /** \returns the Count of nodes of this Curve */
   inline int getNodeCount(void) { return this->nodeCount;}
 
-  virtual Vector calcPos(float t) = 0;
+  /**
+     \brief A virtual function to calculate the Position on the Curve
+     \returns positionVector
+     \param t the timeindex on this curve [0,1]f
+  */
+  virtual Vector calcPos(float t) = 0; 
+  /**
+     \brief A virtual function to calculate the Direction of the Curve
+     \returns directionVector
+     \param t the timeindex on this curve [0,1]f
+  */
   virtual Vector calcDir(float t) = 0;
+  /**
+     \brief A virtual function to calculate the acceleration on the Curve
+     \returns accelerationVector
+     \param t the timeindex on this curve [0,1]f
+  */
   virtual Vector calcAcc(float t) = 0;
+  /**
+     \brief A virtual function to calculate the Quaternion on the Curve
+     \returns directional Quaternion
+     \param t the timeindex on this curve [0,1]f
+  */
   virtual Quaternion calcQuat(float t) = 0;