/* (c) 1999-2000 Tino Schwarze, see COPYING for details */
/**@pkg cObject.cVisibleObject.cInteractiveObject.cLight.cDirectionLight*/
/**
 * a class for managing a directional OpenGL light
 *
 * #include "cDirectionLight.hh"
 *
 * -lMesaGL or -lGL
 *
 * @see cInteractiveObject
 * @pkgdoc cObject.cVisibleObject.cInteractiveObject.cLight.cDirectionLight
 */

#ifndef cDirectionLight_hh
#define cDirectionLight_hh

// include class cLight to derive from
#include "cLight.hh"

// include class cColor representing an RGB(A) color for use
// with OpenGL
#include "cADSEColor.hh"

// include common project macros, definitions and headers
#include "common.hh"

/**
 * A class for an OpenGL directional light.
	* The inherited mRotation quaternion is used (in contrast to cLight)
	* - it modifies the light's direction.
	*/
class cDirectionLight 
:	public cLight
{
public:
	/**
	 * default constructor
	 	*/
	cDirectionLight (
		cEventDispatcher *disp,
		const char *name = NULL);

#if DEBUG
	/**
	 * copy constructor (inherited)
	 	*/
	cDirectionLight (const cDirectionLight &);
#endif

	/**
	 * constructor with initialization of position and name
	 	* @param dir initial direction of light source
		* @param state initial state of light source (default: on)
		* @param name name of light source (optional)
	 	*/
	cDirectionLight (
		cEventDispatcher *disp,
		const cVertex &dir, 
		const char *name = NULL);

	/**
	 * constructor with initialization of position, state and name
	 	* @param dir initial direction of light source
		* @param state initial state of light source (default: on)
		* @param name name of light source (optional)
	 	*/
	cDirectionLight (
		cEventDispatcher *disp,
		const cVertex &dir, 
		const teLightState state = LIGHT_ON, 
		const char *name = NULL);

	/**
	 * constructor with initialization of position, color, state 
	 * and name
	 	* @param dir initial direction of light source
		* @param col color of the light source (cADSEColor object)
		*        (emissive color component is not used)
		* @param state initial state of light source (default: on)
		* @param name name of light source (optional)
	 	*/
	cDirectionLight (
		cEventDispatcher *disp,
		const cVertex &dir, 
		const cADSEColor &col,
		const teLightState state = LIGHT_ON, 
		const char *name = NULL);

	/**
	 * destructor
	 	*/
	virtual ~cDirectionLight ();

// OPERATIONS
	// note: translating the light is obtained via functions inherited from
	// cVisibleObject (@see cVisibleObject::MoveBy, cVisibleObject::MoveTo)

	/**
	 * set new direction to point to
		* @param dir new direction
		*/
	virtual void SetDirection (const cVertex &dir);

protected:
	/**
	 * this one performs the actual set up of the light
		*
		* (called by Activate()); separeted to simplify
		* cDirectionLight
		*/
	virtual void ActivateLight ();

	/**
	 * A light is a visible object therefore it needs a drawing function
	 	*
		* Not used here - a DirectionLight cannot be drawn!
	 	*/
	virtual void DrawThisObject ();

	/**
	 * identify an instance of this class if it's got no name
	 	*/
	virtual const char *GetDefaultName () const
	{
		return "cLight";
	}

	/** actual direction */
	cVertex mDirection;
};

#endif	// ifndef cDirectionLight_hh