//------------------------------------------------------------------------------
/**
 *	@file	ishader.h
 *	@author	Paul Gregory
 *	@brief	Declare the interface which all shaders must implement.
 *
 *	Last change by:		$Author: joron $
 *	Last change date:	$Date: 2006-06-20 19:09:33 +0000 (Tue, 20 Jun 2006) $
 */
//------------------------------------------------------------------------------


#ifndef	___ishader_Loaded___
#define	___ishader_Loaded___

#include	"aqsis.h"
#include	"itransform.h"
#include	<boost/shared_ptr.hpp>


START_NAMESPACE( Aqsis )


//----------------------------------------------------------------------
/** \enum EqShaderType
 * Shader type identifier.
 */

enum EqShaderType
{
    Type_Surface,   			///< Surface shader
    Type_Lightsource,   		///< Lightsource shader.
    Type_Volume,   			///< Volume shader.
    Type_Displacement,   		///< Displacement shader.
    Type_Transformation,   	///< Transformation shader.
    Type_Imager,   			///< Image shader.
};

#define	USES(a,b)	((a)&(0x00000001<<(b))?TqTrue:TqFalse)
#define	isDONE(a,b)	((a)&(0x00000001<<(b))?TqTrue:TqFalse)
#define	DONE(a,b)	((a)=(a)|(0x00000001<<(b)))


struct IqShaderExecEnv;
struct IqSurface;
class CqParameter;

//----------------------------------------------------------------------
/** \struct IqShader
 * Abstract base class from which all shaders must be defined.
 */

struct IqShader
{
	virtual	~IqShader()
	{}
	/** Get the shader matrix, the transformation at the time this shader was instantiated.
	 */
	virtual	const CqMatrix&	matCurrent() = 0;
	virtual const IqTransform* getTransform() const = 0;
	virtual void SetTransform(IqTransformPtr pTrans) = 0;
	/** Set the naem of the shader.
	 */
	virtual	void	SetstrName( const char* strName ) = 0;
	/** Get the name of this shader.
	 */
	virtual	const CqString& strName() const = 0;
	virtual	void	PrepareShaderForUse( ) = 0;
	virtual	void	InitialiseParameters( ) = 0;
	virtual	void	SetArgument( const CqString& name, EqVariableType type, const CqString& space, void* val ) = 0;
	virtual	void	SetArgument( CqParameter* pParam, IqSurface* pSurface ) = 0;
	/** Find a named argument.
	 * \param name Character pointer to argument name.
	 * \return A pointer to the argument data if it exists, NULL otherwise.
	 */
	virtual	IqShaderData*	FindArgument( const CqString& name ) = 0;
	/** Get the value of a named shader paramter.
	 * \param name The name of the shader paramter.
	 * \param res IqShaderData pointer to store the result in, will be typechecked for suitability.
	 * \return Boolean indicating the parameter existed and res was of an appropriate type.
	 */
	virtual	TqBool	GetVariableValue( const char* name, IqShaderData* res ) = 0;
	/** Evaluate the shader code.
	 * \param pEnv The shader execution environment to evaluate within.
	 */
	virtual	void	Evaluate( const boost::shared_ptr<IqShaderExecEnv>& pEnv ) = 0;
	/** Initialise the state of any arguments with default values.
	 */
	virtual	void	PrepareDefArgs() = 0;
	/** Prepare the shader for evaluation.
	 * \param uGridRes The resolution of the grid being shaded in u.
	 * \param vGridRes The resolution of the grid being shaded in v
	 * \param pEnv Pointer to the IqShaderExecEnv to evaluate within.
	 */
	virtual void	Initialise( const TqInt uGridRes, const TqInt vGridRes, const TqInt shadingPointCount, const boost::shared_ptr<IqShaderExecEnv>& pEnv ) = 0;
	/** Determine whether this shader is an aambient ligthsource shader.
	 * i.e. A lightsource shader with no Illuminate or Solar constructs.
	 */
	virtual	TqBool	fAmbient() const = 0;
	/** Duplicate this shader.
	 * \return A pointer to a new shader.
	 */
	virtual IqShader*	Clone() const = 0;
	/** Determine whether this shader uses the specified system variable.
	 * \param Var ID of the variable from EqEnvVars.
	 */
	virtual	TqBool	Uses( TqInt Var ) const = 0;
	/** Get a bit vector representing the system variables needed by this shader.
	 */
	virtual	TqInt	Uses() const = 0;
	/** Variable creation function.
	 */
	virtual IqShaderData* CreateVariable( EqVariableType Type, EqVariableClass Class, const CqString& name, TqBool fArgument = TqFalse, TqBool fOutput = TqFalse ) = 0;
	/** Variable array creation function.
	 */
	virtual IqShaderData* CreateVariableArray( EqVariableType Type, EqVariableClass Class, const CqString& name, TqInt Count, TqBool fArgument = TqFalse, TqBool fOutput = TqFalse  ) = 0;
	/** Function to create some temporary storage which complies to the IqShaderData interface.
	 */
	virtual IqShaderData* CreateTemporaryStorage( EqVariableType type, EqVariableClass _class ) = 0;
	/** Function to destroy temporary storage created with CreateTemporaryStorage.
	 */
	virtual void DeleteTemporaryStorage( IqShaderData* pData ) = 0;

	/** Use the default surface shader for this implementation.
	 */
	virtual void DefaultSurface( ) = 0;
	/** Query if the shader is a layered shader
	 */
	virtual TqBool IsLayered() = 0;
	virtual void AddLayer(const CqString& layername, const boost::shared_ptr<IqShader>& layer) = 0;
	virtual void AddConnection(const CqString& layer1, const CqString& variable1, const CqString& layer2, const CqString& variable2) = 0;
	virtual void SetType(EqShaderType type) = 0;
};




END_NAMESPACE( Aqsis )

#endif	//	___ishader_Loaded___