Changeset 3600 in orxonox.OLD for orxonox/trunk/src/light.h

Timestamp:

Mar 18, 2005, 1:02:30 AM (19 years ago)

Author:

bensch

Message:

orxonox/trunk: nice doxygen-information about the LightManager

File:

• orxonox/trunk/src/light.h (modified) (3 diffs)

orxonox/trunk/src/light.h

@@ -35 +35 @@
   void setSpotCutoff(GLfloat cutoff);
 
-  Vector getPosition();
+  Vector getPosition() const;
   /** \returns the lightNumber*/
-  int getLightNumber(void) {return this->lightNumber;}
+  int getLightNumber(void) const {return this->lightNumber;}
   
   virtual void draw();
 
-  void debug(void);
+  void debug(void) const;
 
   // attributes
@@ -59 +59 @@
 /**
    A Light is a source that emits light rays (photons)
+
+   <b>Usage:</b>\n
+   First you have to get the Light Manager up and running by using LightManager::getInstance.
+   This automatically initiates the GL_LIGHTING, and sets some default stuff about the light.\n
+   Then you will create a new light using:
+   \li int addLight(void);
+   \li int addLight(int lightNumber);
+
+   now you can operate on the light as follows:
+   \li void setPosition(Vector position);
+   \li void setPosition(GLfloat x, GLfloat y, GLfloat z);
+   \li void setDiffuseColor(GLfloat r, GLfloat g, GLfloat b);
+   \li void setSpecularColor(GLfloat r, GLfloat g, GLfloat b);
+   \li void setAttenuation(float constantAttenuation, float linearAttenuation, float quadraticAttenuation);
+   \li void setSpotDirection(Vector direction);
+   \li void setSpotCutoff(GLfloat cutoff);
+
+   These functions are preatty selv-explaining, but you can read about them below.\n
+   If you want to fetch info, or the a Light use:
+   \li Vector getPosition(void) const;
+   \li Vector getPosition(int lightNumber) const;
+   \li Light* getLight(int LightNumber) const;
+
+   To redraw the light use
+   \li void draw();
+   
+   and to delete one just use
+   \li void deleteLight(void);
+
+   for some nice output just use:
+   \li void debug(void) const;
+
+   You can also operate on the single Lights themselves, by first retreaving them with 
+   \li Light* getLight(int LightNumber);
+   \n
+   and then using the same functions on this to change settings.
 */
 class LightManager : public BaseObject
@@ -97 +133 @@
 
   // get Attributes
-  Vector getPosition(void);
-  Vector getPosition(int lightNumber);
+  Vector getPosition(void) const;
+  Vector getPosition(int lightNumber) const;
   
-  void debug(void);
+  Light* getLight(int lightNumber) const;
+  
+  void debug(void) const;
 };