Changeset 8522 in orxonox.OLD

Timestamp:

Jun 16, 2006, 11:16:01 AM (18 years ago)

Author:

bensch

Message:

tags

File:

• branches/gui/src/lib/gui/gl/specials/glgui_notifier.cc (modified) (3 diffs)

branches/gui/src/lib/gui/gl/specials/glgui_notifier.cc

@@ -25 +25 @@
 
   /**
-   * standard constructor
+   * @brief standard constructor
    */
   GLGuiNotifier::GLGuiNotifier ()
@@ -57 +57 @@
   }
 
+  /**
+   * @brief push a message onto the notifier.
+   * @param message the message to be pushed.
+   *
+   * @note it is not guaranteed, that the message is delivered instantaniously
+   * The possibility may arise, that the DisplayLines are all in use, then one
+   * has to wait until a line gets hidden, until a new one can be pushed to be
+   * displayed.
+   */
   void GLGuiNotifier::pushNotifyMessage(const std::string& message)
   {
     if (!this->hiddenText.empty())
     {
-      printf("%s\n", message.c_str());
-      DisplayLine dl;
+      DisplayLine dl; // put everything in here, and then display it
+
+      // retrieve a Text.
       dl.text = this->hiddenText.top();
-
+      this->hiddenText.pop();
+
+      // setup Text
       dl.text->setBlending(1.0f);
       dl.text->setText(message);
-      this->hiddenText.pop();
+      dl.text->setVisibility(true);
+      dl.text->setRelCoor2D(this->calculateLinePosition(0));
+
       dl.age = 0.0f;
       this->displayLines.push_front(dl);
-
-      dl.text->setVisibility(true);
-      dl.text->setRelCoor2D(this->calculateLinePosition(0));
       this->repositionText();
     }
     else
     {
+      // push it onto the List of messages we still need.
       this->inputBuffer.push_front(message);
-      //printf("grumble... must be fixed\n");
-    }
-  }
-
-
+    }
+  }
+
+
+  /**
+   * @brief sets the Dipsplay Line Count of the Notifier.
+   * @param coun the count of displayLines.
+   */
   void GLGuiNotifier::setDisplayLineCount(unsigned int count)
   {
@@ -129 +144 @@
 
 
+  /**
+   * @brief ticks the entire Notifier.
+   * @param dt the time passed since the last Tick
+   */
   void GLGuiNotifier::tick(float dt)
   {