Refresh lighting and culling uniforms if the camera changes in pop_state

[libs/gl.git] / source / light.h

diff --git a/source/light.h b/source/light.h
index 1c6a52272f56db8597103093c99a3050602fa7b3..ee62ce35634213f2e6af365f5169e2d2cf0e59c7 100644 (file)
--- a/source/light.h
+++ b/source/light.h
@@ -8,6 +8,14 @@
 namespace Msp {
 namespace GL {
 
+class Matrix;
+class ProgramData;
+
+/**
+Stores properties of a single light source.
+
+Lights do not cast shadows by themselves.  See ShadowMap for that.
+*/
 class Light
 {
 private:
@@ -32,18 +40,29 @@ private:
 
 public:
        Light();
+       ~Light();
 
 private:
        void update_parameter(int, int = -1) const;
 
 public:
+       /** Sets the diffuse (direction-independent) color of the Light.  Provided
+       to shaders with the name light_sources[i].diffuse. */
        void set_diffuse(const Color &c);
+
+       /** Sets the specular (direction-dependent) color of the Light.  Provided to
+       shaders with the name light_sources[i].diffuse. */
        void set_specular(const Color &c);
+
        const Color &get_diffuse() const { return diffuse; }
        const Color &get_specular() const { return specular; }
 
+       /** Sets the position of the Light.  For a directional light, set the xyz
+       components to a vector pointing towards the light and the w component to 0. */
        void set_position(const Vector4 &);
+
        const Vector4 &get_position() const { return position; }
+
        void set_spot_direction(const Vector3 &);
        void set_spot_exponent(float);
        void set_spot_cutoff(float);
@@ -53,6 +72,10 @@ public:
        void set_attenuation(float, float, float);
        const float *get_attenuation() const { return attenuation; }
 
+       /** Updates a ProgramData object with the uniforms for the Light.  A view
+       matrix and light source index must be passed in. */
+       void update_shader_data(ProgramData &, const Matrix &, unsigned) const;
+
        void bind() const { return bind_to(0); }
        void bind_to(unsigned) const;