engine.h

《光线引擎演示程序》执行程序+源代码,《光线引擎演示程序》执行程序+源代码

#define LIGHT_MUSIC_DIRECTORY    4
#define LIGHT_SOUND_DIRECTORY    5
#define LIGHT_TEXTURE_DIRECTORY  6
#define LIGHT_MAP_DIRECTORY      7
#define LIGHT_MODEL_DIRECTORY    8
#define LIGHT_IMAGE_DIRECTORY    9
#define LIGHT_SCRIPT_DIRECTORY   10

	/*! \fn bool SetString( int name, const char *string )
	 *  \brief 设置指定字符串
	 *
	 *  设置指定字符串
	 *
	 *  \param int name 要设置的字符串
	 *  \param const char *string 字符串指针
	 *
	 *  \return 如果成功返回 0, 否则返回非 0 值
	 *
	 *  \see 
	 */
	virtual bool SetString( int name, const char *string ) = 0;

	/*! \fn const char * GetString( int name ) = 0
	 *  \brief 查询指定字符串
	 *
	 *  查询指定字符串
	 *
	 *  \param int name 要查询的字符串
	 *
	 *  \return 如果成功返回一个字符串指针（该字符串以 0 结尾）， 否则返回 NULL 。
	 *
	 *  \see 
	 */
	virtual const char * GetString( int name ) = 0;

#define LIGHT_COLOR_KEY      2   /* 关键色   */
#define LIGHT_BLEND          3   /* 混合     */
#define LIGHT_TEXTURE        4   /* 纹理     */
#define LIGHT_SWAP_INTERVAL  5   /* 垂直同步 */
#define LIGHT_PROJECTION     6   /* 投影纹理 */
#define LIGHT_LIGHTING       7   /* 光照     */
#define LIGHT_LOCAL_VIEWER   8   /* 局部视点 */
#define LIGHT_TWO_SIDE       9   /* 双面光照 */

	/*! \fn void Enable( int name )
	 *  \brief 充许指定功能
	 *
	 *  充许指定功能
	 *
	 *  \param int name 要充许的功能
	 *	 
	 *  \return 无
	 *
	 *  \see 
	 */
	virtual void Enable( int name ) = 0;

	/*! \fn void Disable( int name )
	 *  \brief 禁止指定功能
	 *
	 *  禁止指定功能
	 *
	 *  \param int name 要禁止的功能
	 *	 
	 *  \return 无
	 *
	 *  \see 
	 */
	virtual void Disable( int name ) = 0;

#define LIGHT_MAX_LIGHTS          5
#define LIGHT_MAX_TEXTURE_SIZE    6

	/*! \fn int GetInteger( int name )
	 *  \brief 查询指定的整型数
	 *
	 *  查询指定的整型数
	 *
	 *  \param int name 要查询的整型数
	 *	 
	 *  \return 返回要查询的整型数
	 *
	 *  \see 
	 */
	virtual int GetInteger( int name ) = 0;


	/*! \fn LightModel * NewModel( void )
	 *  \brief 创建一个模型
	 *
	 *  创建一个模型
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的模型类指针
	 *
	 *  \see 
	 */
	//virtual LightModel * NewModel( void ) = 0;

	/*! \fn LightBsp * NewBsp( void )
	 *  \brief 创建一个地图
	 *
	 *  创建一个地图
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的地图类指针
	 *
	 *  \see 
	 */
	virtual LightBsp * NewBsp( void ) = 0;

	/*! \fn LightSolid * NewSolid( void )
	 *  \brief 创建一个实体
	 *
	 *  创建一个实体
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的实体类指针
	 *
	 *  \see 
	 */
	virtual LightSolid * NewSolid( void ) = 0;

	/*! \fn LightSound * NewSound( void )
	 *  \brief 创建一个声音
	 *
	 *  创建一个声音
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的声音类指针
	 *
	 *  \see 
	 */
	virtual LightSound * NewSound( void ) = 0;

	/*! \fn LightInput * NewInput( void )
	 *  \brief 查询输入设备句柄
	 *
	 *  查询输入设备句柄
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要查询输入的设备句柄
	 *
	 *  \see 
	 */
	virtual LightInput * NewInput( void ) = 0;

	/*! \fn LightTexture * NewTexture( void )
	 *  \brief 创建一个纹理
	 *
	 *  创建一个纹理
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的纹理类指针
	 *
	 *  \see 
	 */
	virtual LightTexture * NewTexture( void ) = 0;

	/*! \fn LightImage * NewImage( void )
	 *  \brief 创建一个图像
	 *
	 *  创建一个图像
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的图像类指针
	 *
	 *  \see 
	 */
	virtual LightImage * NewImage( void ) = 0;

	/*! \fn LightText * NewText( void )
	 *  \brief 创建一个文字显示句柄
	 *
	 *  创建一个文字显示句柄
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的文字显示句柄
	 *
	 *  \see 
	 */
	virtual LightText * NewText( void ) = 0;

	/*! \fn LightVideo * NewVideo( void )
	 *  \brief 创建一个视频（音频）接口
	 *
	 *  创建一个视频（音频）接口
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的视频（音频）接口
	 *
	 *  \see 
	 */
	virtual LightVideo * NewVideo( void ) = 0;

	/*! \fn LightCamera * NewCamera( void )
	 *  \brief 创建一个摄像机
	 *
	 *  创建一个摄像机
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的摄像机类指针
	 *
	 *  \see 
	 */
	virtual LightCamera * NewCamera( void ) = 0;

	/*! \fn LightBrush * NewBrush( void )
	 *  \brief 创建一个画笔
	 *
	 *  创建一个画笔
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的画笔类指针
	 *
	 *  \see 
	 */
	virtual LightBrush * NewBrush( void ) = 0;

	/*! \fn LightLensFlare * NewLensFlare( void )
	 *  \brief 创建一个镜头光晕
	 *
	 *  创建一个镜头光晕
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的镜头光晕类指针
	 *
	 *  \see 
	 */
	virtual LightLensFlare * NewLensFlare( void ) = 0;

	/*! \fn LightModelMD3 * NewModelMD3( void )
	 *  \brief 创建一个 MD3 模型
	 *
	 *  创建一个 MD3 模型
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的 MD3 模型类指针
	 *
	 *  \see 
	 */
	virtual LightModelMD3 * NewModelMD3( void ) = 0;

	/*! \fn LightFrustum * NewFrustum( void )
	 *  \brief 创建一个视锥体
	 *
	 *  创建一个视锥体
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的视锥体类指针
	 *
	 *  \see 
	 */
	virtual LightFrustum * NewFrustum( void ) = 0;

	/*! \fn LightLight * NewLight( void )
	 *  \brief 创建一个光源
	 *
	 *  创建一个光源
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的光源类指针
	 *
	 *  \see 
	 */
	virtual LightLight * NewLight( void ) = 0;

	/*! \fn LightShader * NewShader( void ) = 0
	 *  \brief 创建一个着色语言
	 *
	 *  创建一个着色语言
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的着色语言类指针
	 *
	 *  \see 
	 */
	virtual LightShader * NewShader( void ) = 0;

	/*! \fn LightParticle * NewParticle( void ) = 0
	 *  \brief 创建一个粒子
	 *
	 *  创建一个粒子
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的粒子类指针
	 *
	 *  \see 
	 */
	virtual LightParticle * NewParticle( void ) = 0;

	/*! \fn LightBillboard * NewBillboard( void ) = 0
	 *  \brief 创建一个布告板
	 *
	 *  创建一个布告板
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的布告板类指针
	 *
	 *  \see 
	 */
	virtual LightBillboard * NewBillboard( void ) = 0;

	/*! \fn LightCollide * NewCollide( void ) = 0
	 *  \brief 创建一个碰撞检测对象
	 *
	 *  创建一个碰撞检测对象
	 *
	 *  \param 无
	 *	 
	 *  \return 返回要创建的碰撞检测对象指针
	 *
	 *  \see 
	 */
	virtual LightCollide * NewCollide( void ) = 0;

};