/MagicTower

用Qt实现经典flash游戏魔塔。

Primary LanguageJavaScript

MagicTower

powered by QT 5.2.0

2013·秋·程序设计与算法基础

项目成果

  • 按21层版本魔塔地图制作；
  • 丰富多彩的图形和小动画；
  • 集成全部原版音效；
  • 完整的地图加载和存档功能；
  • 较完备的轻量级地图编辑；
  • 扩展和改编简单易行。

开发环境Alt text

  • 基于QT 5.2.0的QMainWindow(Core GUI)和QT多媒体库QMultiMedia环境，以及最新的C++11编译器；
  • 2D绘图、文字绘制均使用QPainter，配合QTimer发送重画信号，形成动画；
  • 输入事件主要为键盘，可触发或相应游戏中的相关事件。该事件由继承了QMainWindow的MainWindow类发出。

面向对象

  • 充分利用C++的面向对象特点，过程和对象几乎完全封装于类中，并且充分利用类继承的多态特性，在触发事件、对象重画、获取对象属性等方面都起到了至关重要的作用。另外构造函数的继承方式非常有助于批量设置同类项对象属性，同时避免代码重复(Don't Repeat Yourself)和低级错误。

  • 类结构简要说明及类图

    • 程序主界面由继承自QMainWindow类的MainWindow类管理，辅助两个QWidget派生类Widget（主界面）和Status（左侧状态栏）。
    • 画图的工作主要由MagicObject及其子类*MagicDisplayObject*派生出的各类地图元素类完成。
    • 程序中需要用户交互和播放动画的部分由*MagicAnimate*派生类管理，每个动画管理各自的生存周期。 Alt text

  • 对象事件触发（当主角即将与该对象碰撞时）

virtual bool MagicDisplayObject::move(MagicMap *) = 0;
  • 对象绘图方法
virtual void MagicDisplayObject::paint(QPainter *) = 0;
virtual void MagicAnimateObject::paint(QPainter *) = 0;
  • 获取对象属性（对象的所有动态属性均在QHash<QString, MagicVariant> MagicObject::property中）
virtual void MagicObject::setProperty(QString key, MagicVarient value)
{
    property[key] = value;
}

可用于劫持某些关键属性（比如物体的位置需要与画图坐标同步、用map的message变量接受弹出消息），达到特殊目的：

void MagicDisplayObject::setProperty(QString propertyName, MagicVarient propertyValue)
{
    if (propertyName == "position_x")
        x = propertyValue.getInt() * 32;
    if (propertyName == "position_y")
        y = propertyValue.getInt() * 32;
    MagicObject::setProperty(propertyName, propertyValue);
}
void MagicMap::setProperty(QString propertyName, MagicVarient propertyValue)
{
    if (propertyName == "sound")
    {
        QSound::play(propertyValue.getString());
        return;
    }
    else if (propertyName == "message")
    {
        appendAnimate(new MagicMessage(this, propertyValue.getString()), true);
        return;
    }
    MagicObject::setProperty(propertyName, propertyValue);
}

脚本语言

  • 脚本语言的语法解释和脚本语言的元编程(Metaprogramming)特性是本程序的亮点。魔塔程序具有解释固定语法的文本地图文件的能力，支持以下功能

    • C语言的基本运算符
    +, -, *, /, %, ^, &, <<, >>, ~, =, <, <=, >, >=, ==, !=
    • if分支结构，goto跳转语句（变量不用声明就可以用的哦~）
    i = 0
:for_i
print = i // print为输出至控制台
i = i + 1
if (i <= 3)
    goto for_i
    • 对象的属性获取与设置
    tom->health = 10000
emeny_3->attack = 300
    • 像CSS选择器一样好用的对象选择功能
    .hidden->enabled = 0
wall.hidden
#axe->pix = ":/images/axe"
    • 对象事件触发（主角即将到达时生效）
    on (.fragile)
{
    this->enabled = 0
}
    on (.hard)
    return = 0
    on (wall.mistery)
    message = "这堵墙看起来有机关……"
    on (merchant_exp.floor5)
{
    ret = input("You can use your extra exp to grow your power, please choose: ",
                "1. 50 exp -> 10 attack", "2. 30 exp -> 7 defend",
                "3. 100 exp -> {15 attack, 15 defend}", "4. Not this time.")
    if (ret == 1)
        if (tom->exp >= 50)
        {
            tom->exp = tom->exp - 50
            tom->attack = tom->attack + 10
        }
    if (ret == 2)
        if (tom->exp >= 30)
        {
            tom->exp = tom->exp - 30
            tom->defend = tom->defend + 7
        }
    if (ret == 3)
        if (tom->exp >= 100)
        {
            tom->exp = tom->exp - 100
            tom->attack = tom->attack + 15
            tom->defend = tom->defend + 15
        }
}
    • 输入整层地图
    at (1)
up      d_1	    k_0 	e_29   	e_28   	e_29   	.   	.   	.   	.   	.
w	    w   	w   	w   	w   	w	    w   	w   	w   	w   	.
m_1.s	.   	e_25	dr_0	.   	w	    m_1.m  	k_0 	m_1.m	w   	.
k_0	    e_25	m_3.s	w   	.	    w	    m_1.m	k_0 	m_1.m	w	    .
w   	dr_0	w   	w   	.   	w   	w   	w   	e_26	w   	.
k_0	    e_24	.   	w	    .   	dr_0	e_8 	e_29	e_21	w   	.
m_4	    .   	k_1	    w   	.   	w   	w   	w   	w   	w   	.
w   	dr_0   	w   	w   	.   	.   	.   	.   	.   	.   	.
.   	e_24   	.   	w   	w   	dr_2	w   	w   	w   	dr_0	w
m_1.m  	m_2.b  	k_0	    w	    k_2 	d_0	    .	    w   	k_0     e_23	k_1
m_1.m	wi  	k_0	    w   	.	    down    .	    w	    k_0	    k_0	    k_0

    注释：w->wall, k->key, dr->door, e->enemy, d_0->destionation_upstair, d_1->destionatoin_downstair, m->medicine

  • MagicTower的存档功能与脚本逻辑密不可分。地图的布局、事件选择器与事件、每个对象的属性哈希表可以完备地表达地图状态，所以存储时只需要存储以上信息即可。存档功能暂时还没有进行压缩和加密，所以存档文件的体积相对较大，并且容易被玩家修改。

多线程

  • 多线程在MagicTower中主要用于声音播放（合成）、界面重绘和键盘事件处理。
  • 多线程的好处在于，遇到需要阻塞的动画（比如小人行走），应保证不阻塞进程的消息队列线程。动态地添加线程去完成相应的任务，可以使程序正确处理线程阻塞，并且不引起程序假死。
    • 在处理阻塞动画时，除了同步某些关键数据时采用了QMutex互斥锁和QReadWriteLock读写锁，MagicTower还采用了QWaitCondition处理消息：当动画播放完成，即将删除MagicAnimate前，通知正在等待的线程。MagicAnimate同时继承了QMutex和QWaitCondition类，方便单独管理阻塞。

项目管理

由于我们是仅有两人组成的小型开发团队，项目管理并没有太大难度。仅用小型的项目管理工具加上足够畅通的交流方式就可以得到较好的效果。

  • Alt text使用Github进行项目管理，包括代码托管，分支合并和版本控制。
  • Alt text使用微信