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

Timestamp:

Oct 25, 2005, 1:13:50 AM (19 years ago)

Author:

bensch

Message:

orxonox/trunk: some documentation in the PNode-debugDraw function

File:

• trunk/src/lib/coord/p_node.cc (modified) (4 diffs)

trunk/src/lib/coord/p_node.cc

@@ -763 +763 @@
 void PNode::debugDraw(unsigned int depth, float size, const Vector& color, unsigned int level) const
 {
+  // if this is the first Element we draw
   if (level == 0)
   {
-    glPushAttrib(GL_ENABLE_BIT);
-    glMatrixMode(GL_MODELVIEW);
-
-    glDisable(GL_LIGHTING);
-    glDisable(GL_BLEND);
-    glDisable(GL_TEXTURE_2D);
-  }
-
-  glPushMatrix();
+    glPushAttrib(GL_ENABLE_BIT); // save the Enable-attributes
+    glMatrixMode(GL_MODELVIEW);  // goto the ModelView Matrix
+
+    glDisable(GL_LIGHTING);      // disable lighting (we do not need them for just lighting)
+    glDisable(GL_BLEND);         // ''
+    glDisable(GL_TEXTURE_2D);    // ''
+  }
+
+  glPushMatrix();                // repush the Matrix-stack
   /* translate */
   glTranslatef (this->getAbsCoor ().x,
                 this->getAbsCoor ().y,
                 this->getAbsCoor ().z);
+//  this->getAbsDir ().matrix (matrix);
+
   /* rotate */
-//  this->getAbsDir ().matrix (matrix);
-//  glMultMatrixf((float*)matrix);
-
   Vector tmpRot = this->getAbsDir().getSpacialAxis();
+  glRotatef (this->getAbsDir().getSpacialAxisAngle(), tmpRot.x, tmpRot.y, tmpRot.z );
+  /* set the new Color */
   glColor3f(color.x, color.y, color.z);
-
-  glRotatef (this->getAbsDir().getSpacialAxisAngle(), tmpRot.x, tmpRot.y, tmpRot.z );
-  {
+  { /* draw a cube of size size */
     glBegin(GL_LINE_STRIP);
     glVertex3f(-.5*size, -.5*size,  -.5*size);
@@ -817 +817 @@
   if (depth >= 2 || depth == 0)
   {
+    /* rotate the current color in HSV space around 20 degree */
     Vector childColor =  Color::HSVtoRGB(Color::RGBtoHSV(color)+Vector(20,0,.0));
     tIterator<PNode>* iterator = this->children->getIterator();
@@ -836 +837 @@
         glEnd();
       }
-      if (depth == 0)
+      /* if we want to draw the children too */
+      if (depth == 0) /* -> all of them */
         pn->debugDraw(0, size, childColor, level+1);
-      else
+      else            /* -> only the Next one */
         pn->debugDraw(depth - 1, size, childColor, level +1);
       pn = iterator->nextElement();
@@ -845 +847 @@
   }
   if (level == 0)
-    glPopAttrib();
+    glPopAttrib(); /* pop the saved attributes back out */
 }