billboard.h

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

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


/*! \file billboard.h
 * 布告板函数.
 * 此文件是布告板函数头文件.
 */


/*! \class LightBillboard
 *  \brief 布告板类 
 *
 *  本类负责布告板的管理和显示，支持点和轴两种类型的布告板。
 *  每个 LightBillboard 实例都必须通过 LightEngine 类的 NewBillboard 方法分配。
 */

class LightBillboard
{

public:

	/*! \fn void Reversal ( bool s, bool t ) = 0
	 *  \brief 翻转布告板纹理
	 *
	 *  翻转布告板纹理。
	 *
	 *  \param bool s 水平翻转纹理
	 *
	 *  \param bool t 垂直翻转纹理
	 *
	 *  \return 本函数没有返回值。
	 *
	 *  \see 
	 */
	virtual void Reversal ( bool s, bool t ) = 0;

	/*! \fn void Point ( float x, float y, float z, float width, float height, int frame ) = 0
	 *  \brief 增加一个点布告板
	 *
	 *  增加一个点布告板。
	 *
	 *  \param float x 布告板位置的 x 坐标
	 *
	 *  \param float y 布告板位置的 y 坐标
	 *
	 *  \param float z 布告板位置的 z 坐标
	 *
	 *  \param float width 布告板宽度
	 *
	 *  \param float height 布告板高度
	 *
	 *  \param int frame 动画纹理的帧数
	 *
	 *  \return 本函数没有返回值。
	 *
	 *  \see 
	 */
	virtual void Point ( float x, float y, float z, float width, float height, int frame ) = 0;

	/*! \fn void void Axis ( float x, float y, float z, float width, float height, int frame ) = 0
	 *  \brief 增加一个轴布告板
	 *
	 *  增加一个轴布告板，该布告板始终垂直于地面。
	 *
	 *  \param float x 布告板位置的 x 坐标
	 *
	 *  \param float y 布告板位置的 y 坐标
	 *
	 *  \param float z 布告板位置的 z 坐标
	 *
	 *  \param float width 布告板宽度
	 *
	 *  \param float height 布告板高度
	 *
	 *  \param int frame 动画纹理的帧数
	 *
	 *  \return 本函数没有返回值。
	 *
	 *  \see 
	 */
	virtual void Axis ( float x, float y, float z, float width, float height, int frame ) = 0;

	/*! \fn void Render ( void ) = 0
	 *  \brief 渲染布告板
	 *
	 *  渲染布告板。
	 *
	 *  \param  本函数没有参数。
	 *
	 *  \return 本函数没有返回值。
	 *
	 *  \see 
	 */
	virtual void Render ( void ) = 0;

};