particle.h

来自「《光线引擎演示程序》执行程序+源代码,《光线引擎演示程序》执行程序+源代码」· C头文件 代码 · 共 145 行

/*==========================================================================;
 *
 *  光线游戏引擎（Light Game Engine）
 *
 *  版权所有 (C) 2005-2007 康 旭。 保留所有权利。
 *  Copyright (C) KangXu.  All Rights Reserved.
 *
 *  文件:   particle.h
 *  内容:   粒子函数
 *
 ****************************************************************************/


/*! \file particle.h
 * 粒子函数.
 * 此文件是粒子函数头文件.
 */


/*! \class LightParticle
 *  \brief 粒子类 
 *
 *  本类负责粒子的创建、管理和显示。每个 LightParticle 实例都必须通过 LightEngine 类的 NewParticle 方法分配。 
 */

class LightParticle
{

public:

	/*! \fn void SetPos ( float x, float y, float z ) = 0
	 *  \brief 设置粒子发射源位置
	 *
	 *  设置粒子发射源位置。
	 *
	 *  \param float x 发射源位置的 x 坐标
	 *
	 *  \param float y 发射源位置的 y 坐标
	 *
	 *  \param float z 发射源位置的 z 坐标
	 *
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void SetPos ( float x, float y, float z ) = 0;

	/*! \fn void SetVector ( float x, float y, float z ) = 0
	 *  \brief 设置粒子发射方向
	 *
	 *  设置粒子发射方向。
	 *
	 *  \param float x 发射方向的 x 分量
	 *
	 *  \param float y 发射方向的 y 分量
	 *
	 *  \param float z 发射方向的 z 分量
	 *
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void SetVector ( float x, float y, float z ) = 0;

	/*! \fn void SetAngle ( float angle ) = 0
	 *  \brief 设置粒子发射源开口角度
	 *
	 *  设置粒子发射源开口角度。
	 *
	 *  \param float angle 发射源开口角度
	 *	 
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void SetAngle ( float angle ) = 0;

	/*! \fn void Speed ( float speed ) = 0
	 *  \brief 设置粒子初始速度
	 *
	 *  设置粒子初始速度
	 *
	 *  \param float speed 粒子初始速度
	 *	 
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void Speed ( float speed ) = 0;

	/*! \fn void Life ( int life ) = 0
	 *  \brief 设置粒子寿命
	 *
	 *  设置粒子寿命
	 *
	 *  \param int life 每个粒子的存活时间（以千分之一秒为单位）
	 *	 
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void Life ( int life ) = 0;

	/*! \fn void Sum ( int sum ) = 0
	 *  \brief 设置存活粒子数
	 *
	 *  设置存活粒子数
	 *
	 *  \param int sum 所有存活粒子的总数
	 *	 
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void Sum ( int sum ) = 0;

	/*! \fn void Size ( float width, float height ) = 0
	 *  \brief 设置单个粒子大小
	 *
	 *  设置单个粒子大小
	 *
	 *  \param float width 单个粒子的宽度
	 *
	 *  \param float height 单个粒子的高度
	 *
	 *  \return 本函数无返回值。
	 *
	 *  \see 
	 */
	virtual void Size ( float width, float height ) = 0;

	/*! \fn void Render ( void ) = 0
	 *  \brief 渲染粒子
	 *
	 *  渲染粒子。
	 *
	 *  \param 本函数无参数。
	 *
	 *  \return 本函数无返回值。如果函数调用成功，返回非零值；如果函数调用失败，返回零。
	 *
	 *  \see 
	 */
	virtual void Render ( void ) = 0;

};