Funcode实现黄金矿工

简介: Funcode实现黄金矿工


前言:
        一步步按照下面的步骤走,肯定是可以运行的。

        此文优化了文档中的一些Bug

        代码不是很重要,最重要的还是学习编程的思想。毕竟funcode并不是一个常用的软件

        如果有问题,欢迎在下面留言,我会竭尽所能进行解答

一、准备工作
(如图)

小人的属性

小人设置链接点 

钩子的属性(注意碰撞的设置,很重要,影响后面程序的运行)

钩子设置链接点 

金子的设置(同样要注意碰撞的设置)

金子设置链接点 

 文字的设置

二、程序代码
Main.cpp

include "CommonClass.h"

include "LessonX.h"

///////////////////////////////////////////////////////////////////////////////////////////
//
// 主函数入口
//
//////////////////////////////////////////////////////////////////////////////////////////
int PASCAL WinMain(HINSTANCE hInstance,

               HINSTANCE hPrevInstance,
               LPSTR     lpCmdLine,
               int       nCmdShow)

{

// 初始化游戏引擎
if( !CSystem::InitGameEngine( hInstance, lpCmdLine ) )
    return 0;

// To do : 在此使用API更改窗口标题
CSystem::SetWindowTitle("黄金矿工");

// 引擎主循环,处理屏幕图像刷新等工作
while( CSystem::EngineMainLoop() )
{
    // 获取两次调用之间的时间差,传递给游戏逻辑处理
    float    fTimeDelta    =    CSystem::GetTimeDelta();

    // 执行游戏主循环
    g_GameMain.GameMainLoop( fTimeDelta );
};

// 关闭游戏引擎
CSystem::ShutdownGameEngine();
return 0;

}

//==========================================================================
//
// 引擎捕捉鼠标移动消息后,将调用到本函数
// 参数 fMouseX, fMouseY:为鼠标当前坐标
//
void CSystem::OnMouseMove( const float fMouseX, const float fMouseY )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnMouseMove(fMouseX, fMouseY);

}
//==========================================================================
//
// 引擎捕捉鼠标点击消息后,将调用到本函数
// 参数 iMouseType:鼠标按键值,见 enum MouseTypes 定义
// 参数 fMouseX, fMouseY:为鼠标当前坐标
//
void CSystem::OnMouseClick( const int iMouseType, const float fMouseX, const float fMouseY )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnMouseClick(iMouseType, fMouseX, fMouseY);

}
//==========================================================================
//
// 引擎捕捉鼠标弹起消息后,将调用到本函数
// 参数 iMouseType:鼠标按键值,见 enum MouseTypes 定义
// 参数 fMouseX, fMouseY:为鼠标当前坐标
//
void CSystem::OnMouseUp( const int iMouseType, const float fMouseX, const float fMouseY )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnMouseUp(iMouseType, fMouseX, fMouseY);

}
//==========================================================================
//
// 引擎捕捉键盘按下消息后,将调用到本函数
// 参数 iKey:被按下的键,值见 enum KeyCodes 宏定义
// 参数 iAltPress, iShiftPress,iCtrlPress:键盘上的功能键Alt,Ctrl,Shift当前是否也处于按下状态(0未按下,1按下)
//
void CSystem::OnKeyDown( const int iKey, const bool bAltPress, const bool bShiftPress, const bool bCtrlPress )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnKeyDown(iKey, bAltPress, bShiftPress, bCtrlPress);

}
//==========================================================================
//
// 引擎捕捉键盘弹起消息后,将调用到本函数
// 参数 iKey:弹起的键,值见 enum KeyCodes 宏定义
//
void CSystem::OnKeyUp( const int iKey )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnKeyUp(iKey);

}

//===========================================================================
//
// 引擎捕捉到精灵与精灵碰撞之后,调用此函数
// 精灵之间要产生碰撞,必须在编辑器或者代码里设置精灵发送及接受碰撞
// 参数 szSrcName:发起碰撞的精灵名字
// 参数 szTarName:被碰撞的精灵名字
//
void CSystem::OnSpriteColSprite( const char szSrcName, const char szTarName )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnSpriteColSprite(szSrcName, szTarName);

}

//===========================================================================
//
// 引擎捕捉到精灵与世界边界碰撞之后,调用此函数.
// 精灵之间要产生碰撞,必须在编辑器或者代码里设置精灵的世界边界限制
// 参数 szName:碰撞到边界的精灵名字
// 参数 iColSide:碰撞到的边界 0 左边,1 右边,2 上边,3 下边
//
void CSystem::OnSpriteColWorldLimit( const char *szName, const int iColSide )
{

// 可以在此添加游戏需要的响应函数
g_GameMain.OnSpriteColWorldLimit(szName, iColSide);

}

 LessonX.cpp

include <Stdio.h>

include "CommonClass.h"

include "LessonX.h"

include

using namespace std;
////////////////////////////////////////////////////////////////////////////////
//
//
CGameMain g_GameMain;

//==============================================================================
//
// 大体的程序流程为:GameMainLoop函数为主循环函数,在引擎每帧刷新屏幕图像之后,都会被调用一次。

//==============================================================================
//
// 构造函数
CGameMain::CGameMain()
{

//1为运行,0不运行。可以用空格控制
m_iGameState            =    1;

}
//==============================================================================
//
// 析构函数
CGameMain::~CGameMain()
{
}

//==============================================================================
//
// 游戏主循环,此函数将被不停的调用,引擎每刷新一次屏幕,此函数即被调用一次
// 用以处理游戏的开始、进行中、结束等各种状态.
// 函数参数fDeltaTime : 上次调用本函数到此次调用本函数的时间间隔,单位:秒
void CGameMain::GameMainLoop( float fDeltaTime )
{

switch( GetGameState() )
{
    // 初始化游戏,清空上一局相关数据
case 1:
    {
        GameInit();
        SetGameState(2); // 初始化之后,将游戏状态设置为进行中
    }
    break;

    // 游戏进行中,处理各种游戏逻辑
case 2:
    {
        // TODO 修改此处游戏循环条件,完成正确游戏逻辑
        if( true )
        {
            GameRun( fDeltaTime );
        }
        else // 游戏结束。调用游戏结算函数,并把游戏状态修改为结束状态
        {
            SetGameState(0);
            GameEnd();
        }
    }
    break;

    // 游戏结束/等待按空格键开始
case 0:
default:
    break;
};

}
//=============================================================================
//
// 每局开始前进行初始化,清空上一局相关数据
void CGameMain::GameInit()
{

m_iGoldCount = 20;//设置为20个金块
m_fGoldBornMinX = CSystem::GetScreenLeft() - 5;//左侧的坐标
m_fGoldBornMaxX = CSystem::GetScreenRight() + 5;
m_fGoldBornMinY = CSystem::GetScreenTop() +20;
m_fGoldBornMaxY = CSystem::GetScreenBottom() - 5;

int i;
int iSize = 4;
int iPosX = 0,iPosY = 0;
for(i=0;i<m_iGoldCount;i++)
{
    //金块的规格,根据i的序号生成
    if(i < 10)
    {

        iSize = 4;
    }
    else if(i >= 10 && i < 16)
    {
        iSize = 6;
    }else{
        iSize = 8;
    }
    char *tmpName;
    tmpName = CSystem::MakeSpriteName("GoldBlock",i);
    CSprite *tmpSprite = new CSprite(tmpName);
    //生成名字


    tmpSprite->CloneSprite("goldTemplats");
    tmpSprite->SetSpriteWidth(iSize);
    tmpSprite->SetSpriteHeight(iSize);
    //生成随机的坐标
    iPosX = CSystem::RandomRange(m_fGoldBornMinX,m_fGoldBornMaxX);
    iPosY = CSystem::RandomRange(m_fGoldBornMinY,m_fGoldBornMaxY);
    //设置tmpspaite 的位置
    tmpSprite->SetSpritePosition(iPosX,iPosY);
    if(iSize == 8)
    {
        char *myName = CSystem::MakeSpriteName("myName",i);
        CSprite *nameSprite = new CSprite(myName);
        nameSprite->CloneSprite("MyTemplates");
        nameSprite->SetSpriteHeight(iSize/2);
        nameSprite->SetSpriteWidth(iSize);
        //将名字和金子挂载在一起
        nameSprite->SpriteMountToSpriteLinkPoint(tmpName,1);
    }
    m_golds.push_back(tmpSprite);
}
goldHook = new CSprite("GoldHook");
m_iHookRotToLeft = 1;
m_fHookRotation = 0.f;

goldMan = new CAnimateSprite("GoldMan");
m_iHookState = 0;
m_fHookSpeed = 15.f;
m_fHookStartPosX = goldHook->GetSpritePositionX();    //获取钩子的初始化X坐标
m_fHookStartPosY = goldHook->GetSpritePositionY();//获取钩子的初始化Y坐标

}
//=============================================================================
//
// 每局游戏进行中
void CGameMain::GameRun( float fDeltaTime )
{

if(m_iHookState==0)
{
const float fRotateSpeed = 45.f;//速度
float fThisRotate = fRotateSpeed * fDeltaTime;
if(m_iHookRotToLeft){
    m_fHookRotation += fThisRotate;
    if(m_fHookRotation >= 180.f){
        m_fHookRotation = 180.f;
        m_iHookRotToLeft = 0;//转为右
    }

}
else{
    m_fHookRotation -= fThisRotate;
    if(m_fHookRotation<=0.f){
        m_fHookRotation = 0.f;
        m_iHookRotToLeft = 1;
    }
}
    goldHook->SetSpriteRotation(m_fHookRotation);
}else if(m_iHookState == 1 || m_iHookState == 2){
    // 首先,从矿工精灵上获取一个缆绳链接点作为绳子的起始点(该链接点在编辑器里编辑好)
    float fStartX =    goldMan->GetSpriteLinkPointPosX(1);
    float fStartY = goldMan->GetSpriteLinkPointPosY(1);
    //绳子的终点在钩子上
    float fEndX    = goldHook->GetSpriteLinkPointPosX(1);
    float fEndY    = goldHook->GetSpriteLinkPointPosY(1);
    CSystem::DrawLine(fStartX, fStartY, fEndX, fEndY, 2.f, 0, 50, 50, 50, 255 );

    if(m_iHookState == 2){        //回拉过程中
        float    fSpeedX    =    goldHook->GetSpriteLinearVelocityX();    //获取钩子X方向的速度
        float    fSpeedY    =    goldHook->GetSpriteLinearVelocityY();    //获取钩子Y方向的速度
        //当速度接近为0时,即可判定其已到达初始点
        if( fSpeedX < 0.00001f && fSpeedX > -0.00001f && fSpeedY < 0.00001f && fSpeedY > -0.00001f ){
            if(m_gotGold==NULL)
            {


            }else{

                m_gotGold->SpriteDismount();    //解除金块与钩子的锚定
                m_gotGold->DeleteSprite();        //删除获取的金块
            }


            m_iHookState = 0;                //回拉结束,设定钩子状态为0,继续来回摆动
            goldMan->AnimateSpritePlayAnimation("GolderManAnimation2", false);    //播放矿工的动画,即准备拉金子的动画

            goldHook->SetSpriteCollisionSend(true);
        }

    }
}

}
//=============================================================================
//
// 本局游戏结束
void CGameMain::GameEnd()
{
}
//==========================================================================
//
// 鼠标移动
// 参数 fMouseX, fMouseY:为鼠标当前坐标
void CGameMain::OnMouseMove( const float fMouseX, const float fMouseY )
{

}
//==========================================================================
//
// 鼠标点击
// 参数 iMouseType:鼠标按键值,见 enum MouseTypes 定义
// 参数 fMouseX, fMouseY:为鼠标当前坐标
void CGameMain::OnMouseClick( const int iMouseType, const float fMouseX, const float fMouseY )
{

}
//==========================================================================
//
// 鼠标弹起
// 参数 iMouseType:鼠标按键值,见 enum MouseTypes 定义
// 参数 fMouseX, fMouseY:为鼠标当前坐标
void CGameMain::OnMouseUp( const int iMouseType, const float fMouseX, const float fMouseY )
{

}
//==========================================================================
//
// 键盘按下
// 参数 iKey:被按下的键,值见 enum KeyCodes 宏定义
// 参数 iAltPress, iShiftPress,iCtrlPress:键盘上的功能键Alt,Ctrl,Shift当前是否也处于按下状态(0未按下,1按下)
void CGameMain::OnKeyDown( const int iKey, const bool bAltPress, const bool bShiftPress, const bool bCtrlPress )
{

//如果按下了⬇且此时钩子的状态为0
if(KEY_DOWN == iKey && m_iHookState == 0)
{
    m_iHookState = 1;
    goldHook->SetSpriteLinearVelocityPolar(m_fHookSpeed,m_fHookRotation);
    goldMan->AnimateSpritePlayAnimation("GolderManAnimation1",0);

}

}
//==========================================================================
//
// 键盘弹起
// 参数 iKey:弹起的键,值见 enum KeyCodes 宏定义
void CGameMain::OnKeyUp( const int iKey )
{

}
//===========================================================================
//
// 精灵与精灵碰撞
// 参数 szSrcName:发起碰撞的精灵名字
// 参数 szTarName:被碰撞的精灵名字
void CGameMain::OnSpriteColSprite( const char szSrcName, const char szTarName )
{

if(strcmp(szSrcName,"GoldHook")== 0 && strstr(szTarName,"GoldBlock")!= NULL ){
    m_gotGold = FindGoldSpriteByName(szTarName);

    if(m_gotGold != NULL){
        m_gotGold->SpriteMountToSpriteLinkPoint("GoldHook", 2 );    //将金块锚定在钩子上
        goldHook->SpriteMoveTo(m_fHookStartPosX, m_fHookStartPosY, m_fHookSpeed, 1);    //使钩子向初始位置移动,即会拉
        //让钩子先不碰撞
        goldHook->SetSpriteCollisionSend(false);

        goldMan->AnimateSpritePlayAnimation("GolderManAnimation3", false );
        m_iHookState = 2;        //表示金块回拉的状态

    }
}

}
//===========================================================================
//
// 精灵与世界边界碰撞
// 参数 szName:碰撞到边界的精灵名字
// 参数 iColSide:碰撞到的边界 0 左边,1 右边,2 上边,3 下边
void CGameMain::OnSpriteColWorldLimit( const char *szName, const int iColSide )
{

    if(strcmp(szName,"GoldHook") == 0){        //碰到边界的为钩子时
        goldHook->SpriteMoveTo(m_fHookStartPosX, m_fHookStartPosY, m_fHookSpeed, 1);
        goldMan->AnimateSpritePlayAnimation("GolderManAnimation3", false );
        m_iHookState = 2;    //同样设置为回拉,只是没有碰到金子
}

}

CSprite CGameMain::FindGoldSpriteByName(const char szName)
{

for(int i=0;i<m_golds.size();i++)
{
    if(strcmp(szName,m_golds[i]->GetName())==0)
    {
        return m_golds[i];
    }
    //cout<<szName<<" "<<m_golds[i]->GetName()<<endl;
}


return NULL;

}
LessonX.h 
/////////////////////////////////////////////////////////////////////////////////
//
//
//
//
/////////////////////////////////////////////////////////////////////////////////

ifndef LESSON_X_H

define LESSON_X_H

//

include <Windows.h>

include

using namespace std;

/////////////////////////////////////////////////////////////////////////////////
//
// 游戏总管类。负责处理游戏主循环、游戏初始化、结束等工作
class CGameMain
{
private:

int                m_iGameState;
        // 游戏状态,0:结束或者等待开始;1:初始化;2:游戏进行中
int m_iGameBornMinx;
float m_fGoldBornMinX;
float m_fGoldBornMinY;
float m_fGoldBornMaxX;
float m_fGoldBornMaxY;
int m_iGoldCount;
vector<CSprite*>m_golds;
vector<CSprite*>m_names;
//钩子的角度
float m_fHookRotation;
 //钩子左还是右
int m_iHookRotToLeft;
CSprite *goldHook;

//钩子状态
int m_iHookState;//1、
float m_fHookSpeed;
CAnimateSprite *goldMan;

float m_fHookStartPosX;        //存储钩子的初始位置
float m_fHookStartPosY;
CSprite *m_gotGold;        //存储抓到的金块
CSprite *m_name;
CSprite* FindGoldSpriteByName(const char* szName);


public:

CGameMain();            //构造函数
~CGameMain();           //析构函数

// Get方法
int                GetGameState()                                            { return m_iGameState; }

// Set方法
void            SetGameState( const int iState )                { m_iGameState    =    iState; }

// 游戏主循环等
void            GameMainLoop( float    fDeltaTime );
void            GameInit();
void            GameRun( float fDeltaTime );
void            GameEnd();
void             OnMouseMove( const float fMouseX, const float fMouseY );
void             OnMouseClick( const int iMouseType, const float fMouseX, const float fMouseY );
void             OnMouseUp( const int iMouseType, const float fMouseX, const float fMouseY );
void             OnKeyDown( const int iKey, const bool bAltPress, const bool bShiftPress, const bool bCtrlPress );
void             OnKeyUp( const int iKey );
void             OnSpriteColSprite( const char *szSrcName, const char *szTarName );
void             OnSpriteColWorldLimit( const char *szName, const int iColSide );

};

/////////////////////////////////////////////////////////////////////////////////
//
extern CGameMain g_GameMain;

endif // LESSON_X_H

CommanClass.h

ifndef COMMON_CLASS_H

define COMMON_CLASS_H

//

include <windows.h>

/////////////////////////////////////////////////////////////////////////////////
//
// 全局变量、宏定义

define MAX_NAME_LEN 128 // 名字长度

/////////////////////////////////////////////////////////////////////////////////
//
// Sprite精灵与世界边界碰撞响应定义( 碰撞之后API OnSpriteColWorldLimit 将被调用 )
enum EWorldLimit
{

WORLD_LIMIT_OFF,            // 关闭与世界边界的碰撞
WORLD_LIMIT_NULL,            // 碰撞之后引擎不做任何处理,由各游戏自己处理响应
WORLD_LIMIT_RIGID,            // 刚性物理碰撞反应
WORLD_LIMIT_BOUNCE,            // 反弹模式
WORLD_LIMIT_CLAMP,            // 小幅反弹,逐渐停止模式(比如篮球落地)
WORLD_LIMIT_STICKY,            // 碰撞之后静止
WORLD_LIMIT_KILL,            // 碰撞之后精灵将被删除

WORLD_LIMIT_INVALID,        //    无效值

};
/////////////////////////////////////////////////////////////////////////////////
//
/// 精灵与精灵之间、精灵与地图中其它精灵之间的碰撞响应( 碰撞之后API OnSpriteColSprite 将被调用 )
enum ECollisionResponse
{

COL_RESPONSE_OFF,            //    关闭碰撞响应(不调用OnSpriteColSprite)

COL_RESPONSE_RIGID,            //    刚性物理碰撞响应
COL_RESPONSE_BOUNCE,        //    反弹模式
COL_RESPONSE_CLAMP,            //    小幅反弹,逐渐停止模式(比如篮球落地)
COL_RESPONSE_STICKY,        //    碰撞之后静止
COL_RESPONSE_KILL,            //    碰撞之后精灵将被删除
COL_RESPONSE_CUSTOM,        //    碰撞之后引擎不做任何处理,由各游戏自己处理响应

COL_RESPONSE_INVALID,        //    无效值

};
//================================================================================
//
// 鼠标按键值定义
enum MouseTypes
{

MOUSE_LEFT        =    0,        // 左键
MOUSE_RIGHT        =    1,        // 右键
MOUSE_MIDDLE    =    2        // 中键

};
/////////////////////////////////////////////////////////////////////////////////
//
// 键盘KEY值定义
enum KeyCodes
{

KEY_NULL          = 0x000,     ///< Invalid KeyCode
KEY_BACKSPACE     = 0x001,
KEY_TAB           = 0x002,
KEY_ENTER         = 0x003,
KEY_CONTROL       = 0x004,
KEY_ALT           = 0x005,
KEY_SHIFT         = 0x006,
KEY_PAUSE         = 0x007,
KEY_CAPSLOCK      = 0x008,
KEY_ESCAPE        = 0x009,
KEY_SPACE         = 0x00a,
KEY_PAGE_DOWN     = 0x00b,
KEY_PAGE_UP       = 0x00c,
KEY_END           = 0x00d,
KEY_HOME          = 0x00e,
KEY_LEFT          = 0x00f,
KEY_UP            = 0x010,
KEY_RIGHT         = 0x011,
KEY_DOWN          = 0x012,
KEY_PRINT         = 0x013,
KEY_INSERT        = 0x014,
KEY_DELETE        = 0x015,
KEY_HELP          = 0x016,

KEY_0             = 0x017,
KEY_1             = 0x018,
KEY_2             = 0x019,
KEY_3             = 0x01a,
KEY_4             = 0x01b,
KEY_5             = 0x01c,
KEY_6             = 0x01d,
KEY_7             = 0x01e,
KEY_8             = 0x01f,
KEY_9             = 0x020,

KEY_A             = 0x021,
KEY_B             = 0x022,
KEY_C             = 0x023,
KEY_D             = 0x024,
KEY_E             = 0x025,
KEY_F             = 0x026,
KEY_G             = 0x027,
KEY_H             = 0x028,
KEY_I             = 0x029,
KEY_J             = 0x02a,
KEY_K             = 0x02b,
KEY_L             = 0x02c,
KEY_M             = 0x02d,
KEY_N             = 0x02e,
KEY_O             = 0x02f,
KEY_P             = 0x030,
KEY_Q             = 0x031,
KEY_R             = 0x032,
KEY_S             = 0x033,
KEY_T             = 0x034,
KEY_U             = 0x035,
KEY_V             = 0x036,
KEY_W             = 0x037,
KEY_X             = 0x038,
KEY_Y             = 0x039,
KEY_Z             = 0x03a,

KEY_TILDE         = 0x03b,
KEY_MINUS         = 0x03c,
KEY_EQUALS        = 0x03d,
KEY_LBRACKET      = 0x03e,
KEY_RBRACKET      = 0x03f,
KEY_BACKSLASH     = 0x040,
KEY_SEMICOLON     = 0x041,
KEY_APOSTROPHE    = 0x042,
KEY_COMMA         = 0x043,
KEY_PERIOD        = 0x044,
KEY_SLASH         = 0x045,
KEY_NUMPAD0       = 0x046,
KEY_NUMPAD1       = 0x047,
KEY_NUMPAD2       = 0x048,
KEY_NUMPAD3       = 0x049,
KEY_NUMPAD4       = 0x04a,
KEY_NUMPAD5       = 0x04b,
KEY_NUMPAD6       = 0x04c,
KEY_NUMPAD7       = 0x04d,
KEY_NUMPAD8       = 0x04e,
KEY_NUMPAD9       = 0x04f,
KEY_MULTIPLY      = 0x050,
KEY_ADD           = 0x051,
KEY_SEPARATOR     = 0x052,
KEY_SUBTRACT      = 0x053,
KEY_DECIMAL       = 0x054,
KEY_DIVIDE        = 0x055,
KEY_NUMPADENTER   = 0x056,

KEY_F1            = 0x057,
KEY_F2            = 0x058,
KEY_F3            = 0x059,
KEY_F4            = 0x05a,
KEY_F5            = 0x05b,
KEY_F6            = 0x05c,
KEY_F7            = 0x05d,
KEY_F8            = 0x05e,
KEY_F9            = 0x05f,
KEY_F10           = 0x060,
KEY_F11           = 0x061,
KEY_F12           = 0x062,
KEY_F13           = 0x063,
KEY_F14           = 0x064,
KEY_F15           = 0x065,
KEY_F16           = 0x066,
KEY_F17           = 0x067,
KEY_F18           = 0x068,
KEY_F19           = 0x069,
KEY_F20           = 0x06a,
KEY_F21           = 0x06b,
KEY_F22           = 0x06c,
KEY_F23           = 0x06d,
KEY_F24           = 0x06e,

KEY_NUMLOCK       = 0x06f,
KEY_SCROLLLOCK    = 0x070,
KEY_LCONTROL      = 0x071,
KEY_RCONTROL      = 0x072,
KEY_LALT          = 0x073,
KEY_RALT          = 0x074,
KEY_LSHIFT        = 0x075,
KEY_RSHIFT        = 0x076,
KEY_WIN_LWINDOW   = 0x077,
KEY_WIN_RWINDOW   = 0x078,
KEY_WIN_APPS      = 0x079,
KEY_OEM_102       = 0x080,

KEY_MAC_OPT       = 0x090,
KEY_MAC_LOPT      = 0x091,
KEY_MAC_ROPT      = 0x092,

KEY_BUTTON0       = 0x0100,
KEY_BUTTON1       = 0x0101,
KEY_BUTTON2       = 0x0102,
KEY_BUTTON3       = 0x0103,
KEY_BUTTON4       = 0x0104,
KEY_BUTTON5       = 0x0105,
KEY_BUTTON6       = 0x0106,
KEY_BUTTON7       = 0x0107,
KEY_BUTTON8       = 0x0108,
KEY_BUTTON9       = 0x0109,
KEY_BUTTON10      = 0x010A,
KEY_BUTTON11      = 0x010B,
KEY_BUTTON12      = 0x010C,
KEY_BUTTON13      = 0x010D,
KEY_BUTTON14      = 0x010E,
KEY_BUTTON15      = 0x010F,
KEY_BUTTON16      = 0x0110,
KEY_BUTTON17      = 0x0111,
KEY_BUTTON18      = 0x0112,
KEY_BUTTON19      = 0x0113,
KEY_BUTTON20      = 0x0114,
KEY_BUTTON21      = 0x0115,
KEY_BUTTON22      = 0x0116,
KEY_BUTTON23      = 0x0117,
KEY_BUTTON24      = 0x0118,
KEY_BUTTON25      = 0x0119,
KEY_BUTTON26      = 0x011A,
KEY_BUTTON27      = 0x011B,
KEY_BUTTON28      = 0x011C,
KEY_BUTTON29      = 0x011D,
KEY_BUTTON30      = 0x011E,
KEY_BUTTON31      = 0x011F,
KEY_ANYKEY         = 0xfffe

};
//////////////////////////////////////////////////////////////////////////////
//
// 类:CSprite
// 所有精灵的基类。包括下面的静态精灵,动态精灵,文字,特效等均由此类继承下去
// 一般的图片精灵从本类继承下去即可。只有特殊的精灵,比如带动画的精灵,才需要从动态精灵继承下去
//
class CSprite
{
private:

char        m_szName[MAX_NAME_LEN];        // 精灵名字

public:

// 构造函数,需要传入一个非空的精灵名字字符串。如果传入的是地图里摆放好的精灵名字,则此类即与地图里的精灵绑定
// 如果传入的是一个新的精灵名字,则需要调用成员函数 CloneSprite,复制一份精灵对象实例,才与实际的地图精灵关联起来
// szCloneName : 预先存在于场景中,需要克隆的精灵名字
CSprite( const char *szName );
CSprite( const char *szName, const char *szCloneName );
virtual ~CSprite();


// GetName
// 返回值:返回精灵名字
const char *GetName();


// CloneSprite:复制(创建)一个精灵。精灵的创建方式:先在地图中摆放一个精灵做为模板,设置好各项参数,然后在代码里使用此函数克隆一个实例
// 返回值:true表示克隆成功,false克隆失败。失败的原因可能是在地图中未找到对应名字的精灵
// 参数 szSrcName:地图中用做模板的精灵名字
//
bool        CloneSprite( const char *szSrcName );

// DeleteSprite:在地图中删除与本对象实例关联的精灵
//
void        DeleteSprite();

// SetSpriteVisible:设置精灵隐藏或者显示(可见不可见)
// 参数 bVisible:true 可见 false不可见
//
void        SetSpriteVisible( const bool bVisible );

// IsSpriteVisible:获取该精灵当前是否可见
//
bool        IsSpriteVisible();

// SetSpriteEnable:禁止或者启用该精灵。被禁止的精灵将不参与任何响应,包括不移动,没有碰撞等,仅仅是在地图中显示
// 参数 bEnable:true启用 false禁止
//
void        SetSpriteEnable( const bool bEnable );

// SetSpriteScale:设置精灵的缩放值
// 参数 fScale:缩放值。大于0的值
//
void        SetSpriteScale( const float fScale );

// IsPointInSprite:判断某个坐标点是否位于精灵内部
// 参数 fPosX:X坐标点
// 参数 fPosY:Y坐标点
//
bool         IsPointInSprite( const float fPosX, const float fPosY );

// SetSpritePosition:设置精灵位置
// 参数 fPosX:X坐标
// 参数 fPosY:Y坐标
//
void        SetSpritePosition( const float fPosX, const float fPosY );

// SetSpritePositionX:只设置精灵X坐标
// 参数 fPosX:X坐标
//
void        SetSpritePositionX( const float fPosX );

// SetSpritePositionY:只设置精灵Y坐标
// 参数 fPosY:Y坐标
//
void        SetSpritePositionY( const float fPosY );

// GetSpritePositionX:获取精灵X坐标
// 返回值:精灵的X坐标
//
float        GetSpritePositionX();

// GetSpritePositionY:获取精灵Y坐标
// 返回值:精灵的Y坐标
//
float        GetSpritePositionY();

// GetSpriteLinkPointPosX:获取精灵链接点X坐标。链接点是依附于精灵的一个坐标点,可以在编辑器里增加或者删除
// 参数 iId:链接点序号,第一个为1,后面依次递加
//
float        GetSpriteLinkPointPosX( const int iId );

// GetSpriteLinkPointPosY:获取精灵链接点Y坐标。链接点是依附于精灵的一个坐标点,可以在编辑器里增加或者删除
// 参数 iId:链接点序号,第一个为1,后面依次递加
//
float        GetSpriteLinkPointPosY( const int iId );

// SetSpriteRotation:设置精灵的旋转角度
// 参数 fRot:旋转角度,范围0 - 360
//
void        SetSpriteRotation( const float fRot );

// GetSpriteRotation:获取精灵的旋转角度
// 返回值:精灵的旋转角度
//
float        GetSpriteRotation();

// SetSpriteAutoRot:设置精灵按照指定速度自动旋转
// 参数 fRotSpeed:旋转速度
//
void         SetSpriteAutoRot( const float fRotSpeed );

// SetSpriteWidth:设置精灵外形宽度
// 参数 fWidth:宽度值,大于0
//
void        SetSpriteWidth( const float fWidth );

// GetSpriteWidth:获取精灵外形宽度
// 返回值:精灵宽度值
//
float        GetSpriteWidth();

// SetSpriteHeight:设置精灵外形高度
// 参数 fHeight:精灵高度值
//
void        SetSpriteHeight( const float fHeight );

// GetSpriteHeight:获取精灵外形高度
// 返回值:精灵高度值
//
float        GetSpriteHeight();

// SetSpriteFlipX:设置精灵图片X方向翻转显示
// 参数 bFlipX:true 翻转 false不翻转(恢复原来朝向)
//
void        SetSpriteFlipX( const bool bFlipX );

// GetSpriteFlipX:获取当前精灵图片X方向是否是翻转显示
// 返回值:true 翻转 false不翻转
//
bool        GetSpriteFlipX();

// SetSpriteFlipY:设置精灵图片Y方向翻转显示
// 参数 bFlipY:true 翻转 false不翻转(恢复原来朝向)
//
void        SetSpriteFlipY( const bool bFlipY );

// GetSpriteFlipY:获取当前精灵图片Y方向是否是翻转显示
// 返回值:true 翻转 false不翻转
//
bool        GetSpriteFlipY();

// SetSpriteFlip:同时设置精灵翻转X及Y方向
// 参数 bFlipX:true 翻转 false不翻转(恢复原来朝向)
// 参数 bFlipY:true 翻转 false不翻转(恢复原来朝向)
//
void        SetSpriteFlip( const bool bFlipX, const bool bFlipY );

// SetSpriteLifeTime:设置精灵的生命时长,时间到了之后将自动被删除
// 参数 fLifeTime:生命时长,单位 秒
//
void        SetSpriteLifeTime( const float fLifeTime );

// GetSpriteLifeTime:获取精灵生命时长
// 返回值:生命时长,单位 秒
//
float        GetSpriteLifeTime();


// SpriteMoveTo:让精灵按照给定速度移动到给定坐标点
// 参数 fPosX:移动的目标X坐标值
// 参数 fPosY:移动的目标Y坐标值
// 参数 fSpeed:移动速度
// 参数 bAutoStop:移动到终点之后是否自动停止
//
void        SpriteMoveTo( const float fPosX, const float fPosY, const float fSpeed, const bool bAutoStop );

// SpriteRotateTo:让精灵按照给定速度旋转到给定的角度
// 参数 fRotation:给定的目标旋转值
// 参数 fRotSpeed:旋转速度
// 参数 bAutoStop:旋转到终点之后是否自动停止
//
void        SpriteRotateTo( const float fRotation, const float fRotSpeed, const bool bAutoStop );

// SetSpriteWorldLimit:设置精灵的世界边界坐标限制及碰撞模式
// 参数 Limit:碰撞到世界边界之后的响应模式,如果为OFF,则是关闭世界边界碰撞。其它值见 EWorldLimit
// 参数 fLeft:边界的左边X坐标
// 参数 fTop:边界的上边Y坐标
// 参数 fRight:边界的右边X坐标
// 参数 fBottom:边界的下边Y坐标
//
void        SetSpriteWorldLimit( const EWorldLimit Limit, const float fLeft, const float fTop, const float fRight, const float fBottom );

// SetSpriteWorldLimitMode:设置精灵的世界边界碰撞模式
// 参数 Limit:碰撞到世界边界之后的响应模式,如果为OFF,则是关闭世界边界碰撞。其它值见 EWorldLimit
//
void        SetSpriteWorldLimitMode( const EWorldLimit Limit );

// SetSpriteWorldLimitMin:设置精灵的世界边界上边及左边坐标限制
// 参数 fLeft:边界的左边X坐标
// 参数 fTop:边界的上边Y坐标
//
void        SetSpriteWorldLimitMin( const float fLeft, const float fTop );

// SetSpriteWorldLimitMax:设置精灵的世界边界下边及右边坐标限制
// 参数 fRight:边界的右边X坐标
// 参数 fBottom:边界的下边Y坐标
//
void        SetSpriteWorldLimitMax( const float fRight, const float fBottom );

// GetSpriteWorldLimitLeft:获取精灵世界边界左边界限制
//
float        GetSpriteWorldLimitLeft();

// GetSpriteWorldLimitTop:获取精灵世界边界上边界限制
//
float        GetSpriteWorldLimitTop();

// GetSpriteWorldLimitRight:获取精灵世界边界右边界限制
//
float        GetSpriteWorldLimitRight();

// GetSpriteWorldLimitBottom:获取精灵世界边界下边界限制
//
float        GetSpriteWorldLimitBottom();

// SetSpriteCollisionSend:设置精灵是否可以发送(产生)碰撞
// 精灵的碰撞方式为:当A移动中碰上B时,如果A是可以产生碰撞的,B是可以接受碰撞的,则这2个物体会产生碰撞,精灵碰撞的API将被调用。否则无碰撞发生
// 参数 bSend:true 可以产生 false 不产生
//
void         SetSpriteCollisionSend( const bool bSend );

// SetSpriteCollisionReceive:设置精灵是否可以接受碰撞
// 精灵的碰撞方式为:当A移动中碰上B时,如果A是可以产生碰撞的,B是可以接受碰撞的,则这2个物体会产生碰撞,精灵碰撞的API将被调用。否则无碰撞发生
// 参数 bReceive:true 可以接受 false 不接受
//
void         SetSpriteCollisionReceive( const bool bReceive );

// SetSpriteCollisionActive:同时设置精灵是否可以产生及接受碰撞
// 精灵的碰撞方式为:当A移动中碰上B时,如果A是可以产生碰撞的,B是可以接受碰撞的,则这2个物体会产生碰撞,精灵碰撞的API将被调用。否则无碰撞发生
// 参数 bSend:true 可以产生 false 不产生
// 参数 bReceive:true 可以接受 false 不接受
//
void         SetSpriteCollisionActive( const bool bSend, const bool bReceive );

// SetSpriteCollisionPhysicsSend:设置精灵是否可以发送(产生)物理碰撞
// 参数 bSend:true 可以产生 false 不产生
//
void         SetSpriteCollisionPhysicsSend( const bool bSend );

// SetSpriteCollisionPhysicsReceive:设置精灵是否可以接受物理碰撞
// 参数 bReceive:true 可以接受 false 不接受
//
void         SetSpriteCollisionPhysicsReceive( const bool bReceive );

// GetSpriteCollisionSend:获取精灵当前是否是可以产生碰撞
// 返回值:true 可以产生 false 不产生
//
bool         GetSpriteCollisionSend();

// GetSpriteCollisionReceive:获取精灵当前是否是可以接受碰撞
// 返回值:true 可以接受 false 不接受
//
bool         GetSpriteCollisionReceive();

// SetSpriteCollisionResponse:设置精灵与精灵的碰撞响应模式
// 参数 Response:响应模式,如果为OFF,则为关闭碰撞响应,碰撞API将不会被调用。其它值见 ECollisionResponse
//
void        SetSpriteCollisionResponse( const ECollisionResponse Response );

// SetSpriteCollisionMaxIterations:设置精灵碰撞之后的最大反弹次数
// 参数 iTimes:反弹次数
//
void        SetSpriteCollisionMaxIterations( const int iTimes );

// SetSpriteForwardMovementOnly:设置精灵是否只能朝前移动
// 参数 bForward:true 只能朝前移动 false 可以朝其他方向移动
//
void        SetSpriteForwardMovementOnly( const bool bForward );

// GetSpriteForwardMovementOnly:获取精灵当前是否只能朝前移动
// 返回值:true 只能朝前移动 false 可以朝其它方向移动
//
bool        GetSpriteForwardMovementOnly();

// SetSpriteForwardSpeed:设置精灵向前的速度
// 参数 fSpeed:速度
//
void        SetSpriteForwardSpeed( const float fSpeed );

// SetSpriteImpulseForce:设置精灵瞬间推力
// 参数 fForceX:X方向推力大小
// 参数 fForceY:Y方向推力大小
// 参数 bGravitic:是否计算重力
//
void         SetSpriteImpulseForce( const float fForceX, const float fForceY, const bool bGravitic );

// SetSpriteImpulseForcePolar:按角度朝向设置精灵瞬间推力
// 参数 fPolar:角度朝向
// 参数 fForce:推力大小
// 参数 bGravitic:是否计算重力
//
void         SetSpriteImpulseForcePolar( const float fPolar, const float fForce, const bool bGravitic );

// SetSpriteConstantForceX:设置精灵X方向常量推力
// 参数 fForceX:X方向推力大小
//
void         SetSpriteConstantForceX( const float fForceX );

// SetSpriteConstantForceY:设置精灵Y方向常量推力
// 参数 fForceY:Y方向推力大小
//
void         SetSpriteConstantForceY( const float fForceY );

// SetSpriteConstantForceGravitic:精灵在计算常量推力的时候,是否计算重力
// 参数 bGravitic:是否计算重力
//
void         SetSpriteConstantForceGravitic( const bool bGravitic );

// SetSpriteConstantForce:设置精灵常量推力
// 参数 fForceX:X方向推力大小
// 参数 fForceY:Y方向推力大小
// 参数 bGravitic:是否计算重力
//
void         SetSpriteConstantForce( const float fForceX, const float fForceY, const bool bGravitic );

// SetSpriteConstantForcePolar:按角度朝向设置精灵常量推力
// 参数 fPolar:角度朝向
// 参数 fForce:推力大小
// 参数 bGravitic:是否计算重力
//
void         SetSpriteConstantForcePolar( const float fPolar, const float fForce, const bool bGravitic );

// StopSpriteConstantForce:停止精灵常量推力
//
void         StopSpriteConstantForce();

// SetSpriteForceScale:按倍数缩放精灵当前受的推力
// 参数 fScale:缩放值
//
void         SetSpriteForceScale( const float fScale );

// SetSpriteAtRest:暂停/继续精灵的各种受力计算
// 参数 bRest:true 暂停 false 继续
//
void         SetSpriteAtRest( const bool bRest );

// GetSpriteAtRest:获取精灵当前是否在暂停中
// 返回值:true 暂停中 false 正常
//
bool         GetSpriteAtRest( );

// SetSpriteFriction:设置精灵摩擦力
// 参数 fFriction:摩擦力大小
//
void         SetSpriteFriction( const float fFriction );

// SetSpriteRestitution:设置精灵弹力
// 参数 fRestitution:弹力值大小
//
void         SetSpriteRestitution( const float fRestitution );

// SetSpriteMass:设置精灵质量
// 参数 fMass:质量大小
//
void         SetSpriteMass( const float fMass );

// GetSpriteMass:获取精灵质量
// 返回值 :质量大小
//
float         GetSpriteMass();

// SetSpriteAutoMassInertia:开启或者关闭精灵惯性
// 参数 bStatus:true 开启 false 关闭
//
void         SetSpriteAutoMassInertia( const bool bStatus );

// SetSpriteInertialMoment:设置精灵惯性大小
// 参数 fInert:惯性大小
//
void         SetSpriteInertialMoment( const float fInert );

// SetSpriteDamping:设置精灵衰减值
// 参数 fDamp:衰减值大小
//
void         SetSpriteDamping( const float fDamp );

// SetSpriteImmovable:设置精灵是否不可移动
// 参数 bImmovable:true 不可以移动 false 可以移动
//
void         SetSpriteImmovable( const bool bImmovable );

// GetSpriteImmovable:获取精灵当前是否不可以移动
// 返回值:true 不可以移动 false 可以移动
//
bool         GetSpriteImmovable();

// SetSpriteLinearVelocity:设置精灵移动速度
// 参数 fVelX:X方向速度
// 参数 fVelY:Y方向速度
//
void         SetSpriteLinearVelocity( const float fVelX, const float fVelY );

// SetSpriteLinearVelocityX:设置精灵X方向移动速度
// 参数 fVelX:X方向速度
//
void         SetSpriteLinearVelocityX( const float fVelX );

// SetSpriteLinearVelocityY:设置精灵Y方向移动速度
// 参数 fVelY:Y方向速度
//
void         SetSpriteLinearVelocityY( const float fVelY );

// SetSpriteLinearVelocityPolar:按角度朝向设置精灵移动速度
// 参数 fSpeed:移动速度
// 参数 fPolar:角度朝向
//
void         SetSpriteLinearVelocityPolar( const float fSpeed, const float fPolar );

// SetSpriteAngularVelocity:设置精灵角度旋转速度
// 参数 fAngular:角度旋转速度
//
void         SetSpriteAngularVelocity( const float fAngular );

// SetSpriteMinLinearVelocity:设置精灵最小速度
// 参数 fMin:最小速度值
//
void         SetSpriteMinLinearVelocity( const float fMin );

// SetSpriteMaxLinearVelocity:设置精灵最大速度
// 参数 fMax:最大速度值
//
void         SetSpriteMaxLinearVelocity( const float fMax );

// SetSpriteMinAngularVelocity:设置精灵最小角速度
// 参数 fMin:最小角速度
//
void         SetSpriteMinAngularVelocity( const float fMin );

// SetSpriteMaxAngularVelocity:设置精灵最大角速度
// 参数 fMax:最大角速度
//
void         SetSpriteMaxAngularVelocity( const float fMax );

// GetSpriteLinearVelocityX:获取精灵X方向速度
// 返回值:X方向速度
//
float         GetSpriteLinearVelocityX();

// GetSpriteLinearVelocityY:获取精灵Y方向速度
// 返回值:Y方向速度
//
float         GetSpriteLinearVelocityY();


// SpriteMountToSprite:将一个精灵绑定到另一个精灵上,暂时的成为另一个精灵的一部分,跟随其运动等
// 参数 szDstName:承载绑定的母体精灵名字
// 参数 fOffSetX:绑定偏移X
// 参数 fOffsetY:绑定偏移Y
// 返回值:返回一个绑定ID
//
int            SpriteMountToSprite( const char *szDstName, const float fOffSetX, const float fOffsetY );

// SpriteMountToSpriteLinkPoint:将一个精灵绑定到另一个精灵上,绑定位置为指定的链接点,暂时的成为另一个精灵的一部分,跟随其运动等
// 参数 szDstName:承载绑定的母体精灵名字
// 参数 iPointId:链接点序号
// 返回值:返回一个绑定ID
//
int            SpriteMountToSpriteLinkPoint( const char *szDstName, const int iPointId );

// SetSpriteMountRotation:设置精灵的绑定朝向,即相对于母体的朝向
// 参数 fRot:角度朝向,0 - 360
//
void        SetSpriteMountRotation( const float fRot );

// GetSpriteMountRotation:获取精灵的绑定朝向,即相对于母体的朝向
// 返回值:角度朝向
//
float        GetSpriteMountRotation();

// SetSpriteAutoMountRotation:设置精灵绑定之后自动旋转
// 参数 fRot:旋转速度
//
void        SetSpriteAutoMountRotation( const float fRot );

// GetSpriteAutoMountRotation:获取精灵绑定之后的自动旋转值
// 返回值:旋转速度
//
float        GetSpriteAutoMountRotation();

// SetSpriteMountForce:绑定至另一个精灵时,附加的作用力
// 参数 fFroce:作用力
//
void        SetSpriteMountForce( const float fForce );

// SetSpriteMountTrackRotation:绑定的精灵是否跟随母体旋转
// 参数 bTrackRotation:true 跟随 false 不跟随
//
void        SetSpriteMountTrackRotation( const bool bTrackRotation );

// SetSpriteMountOwned:母体被删除的时候,绑定的精灵是否也跟着被删除
// 参数 bMountOwned:true 跟着 false 不跟着
//
void        SetSpriteMountOwned( const bool bMountOwned );

// SetSpriteMountInheritAttributes:绑定的时候,是否继承母体的属性
// 参数 bInherAttr:true 继承 false 不继承
//
void        SetSpriteMountInheritAttributes( const bool bInherAttr );

// SpriteDismount:将已经绑定的精灵进行解绑
//
void        SpriteDismount();

// GetSpriteIsMounted:判断精灵是否绑定在另一个精灵上
// 返回值:true 绑定 false 不绑定
//
bool        GetSpriteIsMounted();

// GetSpriteMountedParent:获取绑定的母体精灵的名字
// 返回值:母体精灵名字,如果未绑定,则返回空字符串
//
const char*    GetSpriteMountedParent();


// SetSpriteColorRed:更改精灵显示颜色中的红色。默认精灵的红绿蓝三颜色的值均为255,修改其中一项将可以改变其颜色
// 参数 iCol:颜色范围 0 - 255
//
void        SetSpriteColorRed( const int iCol );

// SetSpriteColorGreen:更改精灵显示颜色中的绿色。默认精灵的红绿蓝三颜色的值均为255,修改其中一项将可以改变其颜色
// 参数 iCol:颜色范围 0 - 255
//
void        SetSpriteColorGreen( const int iCol );

// SetSpriteColorBlue:更改精灵显示颜色中的蓝色。默认精灵的红绿蓝三颜色的值均为255,修改其中一项将可以改变其颜色
// 参数 iCol:颜色范围 0 - 255
//
void        SetSpriteColorBlue( const int iCol );

// SetSpriteColorAlpha:设置精灵透明度
// 参数 iCol:透明度,值0 - 255,从完全透明至完全不透明
//
void        SetSpriteColorAlpha( const int iCol );

// GetSpriteColorRed:获取精灵显示颜色中的红色值
// 返回值:颜色值
//
int            GetSpriteColorRed();

// GetSpriteColorGreen:获取精灵显示颜色中的绿色值
// 返回值:颜色值
//
int            GetSpriteColorGreen();

// GetSpriteColorBlue:获取精灵显示颜色中的蓝色值
// 返回值:颜色值
//
int            GetSpriteColorBlue();

// GetSpriteColorAlpha:获取精灵透明度
// 返回值:透明度
//
int            GetSpriteColorAlpha();

};
//////////////////////////////////////////////////////////////////////////////
//
// 类:CStaticSprite
// 静态精灵(静态图片显示),从CSprite精灵基类继承下来,比基类多了几个控制精灵图片显示的函数
//
class CStaticSprite : public CSprite
{
public:

CStaticSprite( const char *szName );
CStaticSprite( const char *szName, const char *szCloneName );
~CStaticSprite();

// SetStaticSpriteImage:设置/更改静态精灵的显示图片
// 参数 szImageName:图片名字
// 参数 iFrame:该图片的显示帧数。为编辑器预览图里显示的1/N,范围为 0 到 N - 1
//
void        SetStaticSpriteImage( const char *szImageName, const int iFrame );

// SetStaticSpriteFrame:设置静态精灵当前图片的显示帧数
// 参数 iFrame:该图片的显示帧数。为编辑器预览图里显示的1/N,范围为 0 到 N - 1
//
void        SetStaticSpriteFrame( const int iFrame );
//

// GetStaticSpriteImage:获取精灵当前显示的图片名字
// 返回值:图片名字
//
const char* GetStaticSpriteImage();

// GetStaticSpriteFrame:获取精灵当前显示的图片帧数
// 返回值:帧数
//
int            GetStaticSpriteFrame();

};
//////////////////////////////////////////////////////////////////////////////
//
// 类:CAnimateSprite
// 动态精灵(带图片动画),从CSprite精灵基类继承下来,比基类多了几个控制图片动画的函数
//
class CAnimateSprite : public CSprite
{
public:

CAnimateSprite( const char *szName );
CAnimateSprite( const char *szName, const char *szCloneName );
~CAnimateSprite();

// SetAnimateSpriteFrame:设置动态精灵的动画帧数
// 参数 iFrame:动画帧数
//
void        SetAnimateSpriteFrame( const int iFrame );

// GetAnimateSpriteAnimationName:获取动态精灵当前动画名字
// 返回值:动画名字
//
const char* GetAnimateSpriteAnimationName();

// GetAnimateSpriteAnimationTime:获取动画精灵当前动画时间长度
// 返回值:长度,单位秒
//
float        GetAnimateSpriteAnimationTime();

// IsAnimateSpriteAnimationFinished:判断动态精灵当前动画是否播放完毕,只针对非循环动画而言
// 返回值:true 完毕 false 未完毕
//
bool        IsAnimateSpriteAnimationFinished();

// AnimateSpritePlayAnimation:动画精灵播放动画
// 参数 szAnim:动画名字
// 参数 bRestore:播放完毕后是否恢复当前动画
// 返回值:是否播放成功
//
bool        AnimateSpritePlayAnimation( const char *szAnim, const bool bRestore );

};
//////////////////////////////////////////////////////////////////////////////
//
// 类:CTextSprite
// 文字精灵,亦属于精灵中的一种。基本用法:在地图里摆放一个“文字”物体,起个名字
// 然后在代码里定义一个文字精灵的对象实例,将此名字做为构造函数的参数,然后调用对应的成员函数更新文字显示即可
//
class CTextSprite : public CSprite
{
public:

CTextSprite( const char *szName );
CTextSprite( const char *szName, const char *szCloneName );
~CTextSprite();


// SetTextValue:文字精灵显示某个数值
// 参数 iValue:要显示的数值
//
void        SetTextValue( int iValue );

// SetTextValueFloat:文字精灵显示某个浮点数值
// 参数 fValue:要显示的数值
//
void        SetTextValueFloat( float fValue );

// SetTextString:文字精灵显示某个字符串文字
// 参数 szStr:要显示的字符串
//
void        SetTextString( const char *szStr );

// SetTextChar:文字精灵显示某个字符
// 参数 szChar:要显示的字符
//
void        SetTextChar( char szChar );

};
/////////////////////////////////////////////////////////////////////////////
//
// 类:CEffect
// 特效精灵,属于精灵中的一种。用法和文字精灵一样,先在地图里摆放一个特效做为模板,并命名
// 然后在代码里定义一个特效精灵的对象实例即可使用
class CEffect : public CSprite
{

char        m_szCloneName[MAX_NAME_LEN];        // 在地图中预先摆放好的用做克隆的特效名字
float        m_fTime;                            // 非循环特效:生命时长;循环特效:循环时长

public:

// 构造函数
// 参数 szCloneName:地图里摆放好的特效名字
// 参数 szMyName:新的特效名字。注意:如果是循环特效,那么必须一个循环特效就定义一个对象实例,用不同的名字
//                否则如果一个同名的循环特效被播放多次,在删除的时候会出问题。非循环特效则可以用一个实例多次播放
// 参数 fTime:非循环特效:生命时长;循环特效:循环时长
//
CEffect( const char *szCloneName, const char *szMyName, const float fTime );
~CEffect();

// GetCloneName:获取用做克隆的特效名字
//
const char*    GetCloneName();

// GetTime:返回特效循环时长或者生命时长
//
float        GetTime();

// PlayEffect:播放一个不循环的特效,播放完毕之后该特效自动删除
// 播放非循环特效的时候,可以使用一个CEffect的对象实例,播放多个特效
// 参数 fPosX:播放的X坐标
// 参数 fPosY:播放的Y坐标
// 参数 fRotation:播放的角度朝向
//
void        PlayEffect( const float fPosX, const float fPosY, const float fRotation);

// PlayLoopEffect:播放一个循环特效,不需要该特效的时候,需要自己调用API进行删除
// 参数 fPosX:播放的X坐标
// 参数 fPosY:播放的Y坐标
// 参数 fRotation:播放的角度朝向
//
void        PlayLoopEffect( const float fPosX, const float fPosY, const float fRotation);

// DeleteEffect:删除一个正在播放的特效,只有循环特效才需要手动删除
//
void        DeleteEffect();

};
/////////////////////////////////////////////////////////////////////////////
//
// 类:CSound
// 播放声音的类,定义一个对象实例,调用播放函数即可实现声音的播放
//
class CSound
{
private:

char        m_szName[MAX_NAME_LEN];    // 声音名
int            m_iSoundId;                // 引擎播放声音的时候,返回的ID
bool        m_bLoop;                // bLoop : 是否循环播放。如果为循环音效,则在CSound实例析构的时候,自动调用StopSound停止此声音的播放
float        m_fVolume;                // 音量大小,0-1。1为声音文件的原声大小

public:

// 构造函数
// 参数 szName:声音的路径及名称,具体值请在编辑器的资源 -> 添加声音那里查看本项目里的声音资源,完整按照那个路径值填写即可
// 参数 bLoop:是否循环播放。如果是循环播放的声音,需要手动调用API停止播放
// 参数 fVolume:音量大小,0-1。1为声音文件的原声大小
//
CSound( const char *szName, const bool bLoop, const float fVolume );
~CSound();

// GetName:获取声音名字
//
const char*    GetName();

// PlaySound:播放该声音
//
void        PlaySound();

// StopSound:停止该声音的播放
// 非循环的播放完之后将自动停止,所以一般不需要调用此函数。只有循环的声音才需要调用。对于循环音效,在析构函数里也会自动调用此函数
//
void        StopSound();

// StopAllSound:停止播放所有声音
// 静态函数,可以以此种方式调用:CSound::StopAllSound,以停止游戏中所有正在播放的声音
//
static void    StopAllSound();

};

////////////////////////////////////////////////////////////////////////////////
//
// 类:CSystem
// 系统相关功能的类. 函数调用方法 CSystem::函数名();
//
class CSystem
{
public:

CSystem();
~CSystem();

// OnMouseMove:鼠标移动后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 参数 fMouseX, fMouseY:为鼠标当前坐标
//
static void        OnMouseMove( const float fMouseX, const float fMouseY );

// OnMouseClick:鼠标按下后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 参数 iMouseType:鼠标按键值,见 enum MouseTypes 定义
// 参数 fMouseX, fMouseY:为鼠标当前坐标
//
static void        OnMouseClick( const int iMouseType, const float fMouseX, const float fMouseY );

// OnMouseUp:鼠标按下后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 参数 iMouseType:鼠标按键值,见 enum MouseTypes 定义
// 参数 fMouseX, fMouseY:为鼠标当前坐标
//
static void        OnMouseUp( const int iMouseType, const float fMouseX, const float fMouseY );

// OnKeyDown:键盘被按下后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 参数 iKey:被按下的键,值见 enum KeyCodes 宏定义
// 参数 bAltPress, bShiftPress,bCtrlPress:键盘上的功能键Alt,Ctrl,Shift当前是否也处于按下状态
//
static void        OnKeyDown( const int iKey, const bool bAltPress, const bool bShiftPress, const bool bCtrlPress );

// OnKeyUp:键盘按键弹起后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 参数 iKey:弹起的键,值见 enum KeyCodes 宏定义
//
static void        OnKeyUp( const int iKey );

// OnSpriteColSprite:精灵与精灵碰撞后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 精灵之间要产生碰撞,必须在编辑器或者代码里设置精灵发送及接受碰撞
// 参数 szSrcName:发起碰撞的精灵名字
// 参数 szTarName:被碰撞的精灵名字
//
static void        OnSpriteColSprite( const char *szSrcName, const char *szTarName );

// OnSpriteColWorldLimit:精灵与世界边界碰撞后将被调用的函数,可在此函数体里(Main.cpp)增加自己的响应代码
// 精灵之间要产生碰撞,必须在编辑器或者代码里设置精灵的世界边界限制
// 参数 szName:碰撞到边界的精灵名字
// 参数 iColSide:碰撞到的边界 0 左边,1 右边,2 上边,3 下边
//
static void        OnSpriteColWorldLimit( const char *szName, const int iColSide );

// MakeSpriteName: 将前面的字符串与后面的数字整合成一个字符串。
// 参数 szPrev:一个非空字符串,最长不能超过20个英文字符。名字前面的字符。
// 参数 iId:一个数字
// 返回值:返回一个字符串,比如传入("xxx", 2),则返回"xxx2"
//
static char* MakeSpriteName(const char *szPrev, const int iId);

// CursorOff:关闭鼠标不显示。此API隐藏的是整个Windows的鼠标,除非调用开启鼠标的API dCursorOn,否则鼠标将一直不显示
//
static void        CursorOff();

// CursorOn:开启鼠标显示。将API dCursorOff关闭的鼠标重新开启显示
//
static void        CursorOn();

// IsCursorOn:当前鼠标是开启还是关闭。对应的是用API dCursorOff和dCursorOn开启或者关闭的操作
// 返回值:true为开启状态,false为关闭状态
//
static bool        IsCursorOn();

// ShowCursor:隐藏/显示鼠标。此API只是隐藏本程序窗口内的鼠标,移动到窗口外的时候,鼠标还是会显示
// 参数 bShow:true 为显示,false 为隐藏
//
static void        ShowCursor( const bool bShow );

// IsShowCursor:当前鼠标是显示还是隐藏。对应的是用API ShowCursor隐藏或者显示的操作
// 返回值:true为开启状态,false为关闭状态
//
static bool        IsShowCursor();

// SetWindowTitle:设置窗口名字/标题
// 参数 szTitle:非空字符串
//
static void        SetWindowTitle( const char *szTitle );

// ResizeWindow:更改窗口大小
// 参数 iWidth:宽度,大于0小于等于1920
// 参数 iHeight:高度,大于0小于等于1080
//
static void        ResizeWindow(int iWidth, int iHeight);

// GetHwnd:获取窗口句柄
// 返回值:窗口句柄
//
static void        *GetHwnd();

// Random:获取一个大于等于0的随机数
// 返回值:int,范围0 - 2147483648
//
static int        Random();

// RandomRange:获取一个位于参数1到参数2之间的随机数
// 返回值:int,范围iMin - iMax
// 参数 iMin:小于iMax的整数
// 参数 iMax:大于iMin的整数
//
static int        RandomRange( const int iMin, const int iMax );

// CalLineRotation:计算两点连线的直线的旋转角度
// 返回值:角度,范围0 - 360
// 参数 fStartX:起始坐标X
// 参数 fStartY:起始坐标Y
// 参数 fEndX:终点坐标X
// 参数 fEndY:终点坐标Y
//
static float    CalLineRotation( const float fStartX, const float fStartY, const float fEndX, const float fEndY );

// RotationToVectorX:计算某个角度对应的直线向量的X方向
// 参数 fRotation:角度,范围0 - 360
// 返回值 :该直线向量的X值
//
static float    RotationToVectorX( const float fRotation );

// RotationToVectorY:计算某个角度对应的直线向量的Y方向
// 参数 fRotation:角度,范围0 - 360
// 返回值 :该直线向量的Y值
//
static float    RotationToVectorY( const float fRotation );

// DrawLine:在两点之间画一条线
// 参数 fStartX:起始坐标X
// 参数 fStartY:起始坐标Y
// 参数 fEndX:终点坐标X
// 参数 fEndY:终点坐标Y
// 参数 fLineWidth:线的粗细,大于等于1
// 参数 iLayer:改线所在的层,与编辑器里设置的精灵的层级是同一个概念。范围0 - 31。
// 参数 iRed, iGreen, iBlue : 红绿蓝三原色的颜色值,范围 0 - 255
// 参数 iAlpha:线的透明度,范围0-255. 0为全透明,255为不透明
//
static void        DrawLine( const float fStartX, const float fStartY, const float fEndX, const float fEndY, const float fLineWidth, const int iLayer, const int iRed, const int iGreen, const int iBlue, const int iAlpha );

// DrawTriangle:画一个三角形
// 参数 fX1,fX2,fX3:三角形上三个点的X坐标
// 参数 fY1,fY2,fY3:三角形上三个点的Y坐标
// 参数 fLineWidth:线的粗细,大于等于1
// 参数 iLayer:该三角形所在的层,与编辑器里设置的精灵的层级是同一个概念。范围0 - 31。
// 参数 iRed, iGreen, iBlue : 红绿蓝三原色的颜色值,范围 0 - 255
// 参数 iAlpha:三角形的透明度,范围0-255. 0为全透明,255为不透明
//
static void        DrawTriangle( const float fX1, const float fY1, const float fX2, const float fY2, const float fX3, const float fY3, const float fLineWidth, const int iLayer, const int iRed, const int iGreen, const int iBlue, const int iAlpha );

// DrawRect:画一个矩形
// 参数 fUpperX:左上角坐标X
// 参数 fUpperY:左上角坐标Y
// 参数 fLowerX:右下角坐标X
// 参数 fLowerY:右下角坐标Y
// 参数 fLineWidth:线的粗细,大于等于1
// 参数 iLayer:该矩形所在的层,与编辑器里设置的精灵的层级是同一个概念。范围0 - 31。
// 参数 iRed, iGreen, iBlue : 红绿蓝三原色的颜色值,范围 0 - 255
// 参数 iAlpha:矩形的透明度,范围0-255. 0为全透明,255为不透明
//
static void        DrawRect( const float fUpperX, const float fUpperY, const float fLowerX, const float fLowerY, const float fLineWidth, const int iLayer, const int iRed, const int iGreen, const int iBlue, const int iAlpha );

// DrawCircle:画一个圆
// 参数 fCenterX:圆心坐标X
// 参数 fCenterY:圆心坐标Y
// 参数 fRadius:圆的半径
// 参数 iSegment:圆弧段数,范围4-72. 比如传入6,将得到一个6边形,段数越大越圆滑,但是画图效率越低
// 参数 fLineWidth:线的粗细,大于等于1
// 参数 iLayer:该圆所在的层,与编辑器里设置的精灵的层级是同一个概念。范围0 - 31。
// 参数 iRed, iGreen, iBlue : 红绿蓝三原色的颜色值,范围 0 - 255
// 参数 iAlpha:圆的透明度,范围0-255. 0为全透明,255为不透明
//
static void        DrawCircle( const float fCenterX, const float fCenterY, const float fRadius, const int iSegment, const float fLineWidth, const int iLayer, const int iRed, const int iGreen, const int iBlue, const int iAlpha );

// GetScreenLeft:获取世界边界之左边X坐标
// 返回值:左边界X坐标
//
static float    GetScreenLeft();

// GetScreenTop:获取世界边界之上边Y坐标
// 返回值:上边界Y坐标
//
static float    GetScreenTop();

// GetScreenRight:获取世界边界之右边X坐标
// 返回值:右边界X坐标
//
static float    GetScreenRight();

// GetScreenBottom:获取世界边界之下边Y坐标
// 返回值:下边界Y坐标
//
static float    GetScreenBottom();

// LoadMap:载入新场景。注意,载入新场景的时候,旧场景的所有精灵都将被引擎删除掉,所以所有在程序中创建、复制出来的精灵都必须在调用本API之前先删除掉
// 参数 szName:场景名字。即新建场景保存的时候取的名字,必须带小写的后缀 -- xxx.t2d。不用带路径
//
static void        LoadMap( const char *szName );

//////////////////////////////////////////////////////////////////////////////////////////
//
// 以下API为系统API,请勿自己调用
//
//////////////////////////////////////////////////////////////////////////////////////////

// GetTimeDelta:获取两次调用本函数之间的时间差
// 返回值:float,单位 秒
//
static float    GetTimeDelta();
// EngineMainLoop:引擎主循环函数。请勿自己调用
//
static bool        EngineMainLoop();
// InitGameEngine:初始化引擎,请勿自己调用
//
static bool        InitGameEngine( HINSTANCE hInstance, LPSTR lpCmdLine );
static bool        InitGameEngineEx( HINSTANCE hInstance, LPSTR lpCmdLine );
// ShutdownGameEngine:关闭引擎,请勿自己调用
//
static void        ShutdownGameEngine();

};

//

endif // COMMON_API_H

相关文章
|
7月前
|
存储 算法
【操作系统】虚拟存储管理-页面置换算法
【操作系统】虚拟存储管理-页面置换算法
562 0
|
存储 算法 调度
操作系统实验二-虚拟存储器/内存管理(一)
操作系统实验二-虚拟存储器/内存管理
856 0
操作系统实验二-虚拟存储器/内存管理(一)
|
3月前
|
存储
子网划分问题(实战超详解)_主机分配地址
本文详细介绍了子网划分的核心思想及步骤,通过实例演示如何根据所需主机数量借位生成子网,并确定每个子网的网络地址、广播地址及可用 IP 范围。以一个自治系统的具体需求为例,展示了子网划分的实际应用过程。
215 13
|
4月前
|
前端开发 Java 关系型数据库
通过HTML网页对mysql数据库进行增删改查(CRUD实例)
通过HTML网页对mysql数据库进行增删改查(CRUD实例)
242 0
|
6月前
|
机器学习/深度学习 传感器 人工智能
敢不敢和AI比猜拳?能赢算我输----基于手势识别的AI猜拳游戏【含python源码+PyqtUI界面+原理详解】-python手势识别 深度学习实战项目
敢不敢和AI比猜拳?能赢算我输----基于手势识别的AI猜拳游戏【含python源码+PyqtUI界面+原理详解】-python手势识别 深度学习实战项目
|
人工智能
天梯赛-L1-064 估值一亿的AI核心代码 (20 分)--2019全国CCCC天梯赛L1题解
天梯赛-L1-064 估值一亿的AI核心代码 (20 分)--2019全国CCCC天梯赛L1题解
371 0
|
7月前
|
关系型数据库 MySQL 数据库
一条命令解决端口占用,开启mysql
一条命令解决端口占用,开启mysql
117 0
|
存储 算法 C++
虚拟存储管理(OPT,FIFO,LRU,LFU,NUR算法的C++实现)
虚拟存储管理(OPT,FIFO,LRU,LFU,NUR算法的C++实现)
477 1
【QT】历时两个月,用QT实现超级玛丽,谁说QT不能写游戏?【附源码】
【QT】历时两个月,用QT实现超级玛丽,谁说QT不能写游戏?【附源码】
|
XML JavaScript 前端开发
SpringBoot入门到精通-SpringBoot集成WEB开发(四)
SpringBoot入门到精通-SpringBoot集成WEB开发