vs2008编译QT开源项目--太阳神三国杀源码分析（一） 项目编译及整体分析

请参看 http://tieba.baidu.com/f?kz=1508964881

按照上面的网址教程,下载三国杀源码,swig工具,并下载最新的QT4.8.2 for vs2008.我本机已经安装好了vs2008和QT4.7,因此下载QT4.8.2后直接安装,并在vs2008的QT菜单中点击QT Options子菜单,设置默认的QT/Win版本为4.8.2.使用vs2008打开QSanguosha.pro工程文件,转换为QSanguosha.sln.这时编译程序报无法找到fmodex.lib文件,这个文件是directx的声音文件库.搜索三国杀源码目录,可以找到,直接在项目属性中设置lib搜索路径,添加"./lib"即可成功编译.

后面逐步分析源码。

一、启动界面

  从main函数中开始跟踪,找到如下代码

    MainWindow *main_window = new MainWindow;

    Sanguosha->setParent(main_window);
    main_window->show();

  在MainWindow类的构造函数中,创建连接对话框和配置对话框实例,并将其exec()/show()槽与Action的triggered信号关联,Action触发时显示对话框,并将对话框的信号与相应处理槽函数关联,一行代码搞定,代码简洁高效.

    connection_dialog = new ConnectionDialog(this);
    connect(ui->actionStart_Game, SIGNAL(triggered()), connection_dialog, SLOT(exec()));
    connect(connection_dialog, SIGNAL(accepted()), this, SLOT(startConnection()));

    config_dialog = new ConfigDialog(this);
    connect(ui->actionConfigure, SIGNAL(triggered()), config_dialog, SLOT(show()));
    connect(config_dialog, SIGNAL(bg_changed()), this, SLOT(changeBackground()));

    connect(ui->actionAbout_Qt, SIGNAL(triggered()), qApp, SLOT(aboutQt()));

  接着创建启动场景(start_scene),并创建启动画面中的10个启动按钮,将10个Action对象存入一个QList中,其中每个Action都对应创建一个按钮(Button类,继承与QGraphicsObject),并添加到启动场景(start_scene)中.

    StartScene *start_scene = new StartScene;

    QList<QAction*> actions;
    actions << ui->actionStart_Game
            << ui->actionStart_Server
            << ui->actionPC_Console_Start
            << ui->actionReplay
            << ui->actionConfigure
            << ui->actionGeneral_Overview
            << ui->actionCard_Overview
            << ui->actionScenario_Overview
            << ui->actionAbout
            << ui->actionAcknowledgement;

    foreach(QAction *action, actions)
        start_scene->addButton(action);

  创建一个QGraphicView对象,并显示在主窗体的中心位置,设置view的场景为启动场景.

    view = new FitView(scene);

    setCentralWidget(view);
    restoreFromConfig();
 //让view显示start_scene
    gotoScene(start_scene);

 二、Button类

  启动界面的按钮效果很酷,鼠标滑过有动画效果,并且有声音,和大型网游效果很像.其实现很简单,Button类是从QGraphicObject继承的,在其内部处理鼠标事件和自绘.首先看Button的构造函数,里面直接调用了一个Init成员函数,Init函数中设置Button可接收焦点,可接收鼠标悬停事件,并根据构造函数的title参数创建一个QGraphicsPixmapItem对象,在其上drawText按钮的标题文字,在当前对象的位置之上显示这个图像,注意这个图像对象是在Button的构造函数中show出来的,因此其总会在Button实例的上方,但其不能接受焦点和鼠标事件,因此不影响Button对象对鼠标事件的处理.接着加载指定的按钮图像,并缩放为目标大小,存储在outimg成员中.

  setFlags(ItemIsFocusable);

    setAcceptHoverEvents(true);
    setAcceptedMouseButtons(Qt::LeftButton);

    title = new QPixmap(size.toSize());
    title->fill(QColor(0,0,0,0));//填充完全透明的黑色,这样只能显示绘制的文字,其他部分不会覆盖底层图元
    QPainter pt(title);
    pt.setFont(font);
    pt.setPen(Config.TextEditColor);
    pt.setRenderHint(QPainter::TextAntialiasing);
    pt.drawText(boundingRect(), Qt::AlignCenter, label);

    title_item = new QGraphicsPixmapItem(this);
    title_item->setPixmap(*title);
    title_item->show();

    ......

  QImage bgimg("image/system/button/button.png");
    outimg = new QImage(size.toSize(),QImage::Format_ARGB32);

    qreal pad = 10;

    int w = bgimg.width();
    int h = bgimg.height();

    int tw = outimg->width();
    int th  =outimg->height();

    qreal xc = (w - 2*pad)/(tw - 2*pad);
    qreal yc = (h - 2*pad)/(th - 2*pad);

    for(int i=0;i<tw;i++)
        for(int j=0;j<th;j++)
        {
            int x = i;
            int y = j;

            if( x>=pad && x<=(tw - pad) ) x = pad + (x - pad)*xc;
            else if(x>=(tw-pad))x = w - (tw - x);

            if( y>=pad && y<=(th - pad) ) y = pad + (y - pad)*yc;
            else if(y>=(th-pad))y = h - (th - y);

            QRgb rgb = bgimg.pixel(x,y);
            outimg->setPixel(i,j,rgb);
        }

  Button类的paint虚方法重载实现很简单,直接绘制outimg图像,并根据动画效果需要在图像上方绘制一个白色半透明的矩形区域.

  QRectF rect = boundingRect();

    painter->drawImage(rect,*outimg);
    painter->fillRect(rect,QColor(255,255,255,glow*10));

为了实现动画效果,鼠标划入时触发的hoverEnterEvent事件中设置按钮拥有焦点,播放声音,并调用QObject::startTimer函数启动定时器,在timerEvent事件中调用update函数触发重绘,并增减glow变量,调整按钮上方绘制的矩形区域的透明度----当按钮拥有焦点时增加可见度,呈现淡白色朦胧效果,失去焦点则减少可见度,直到使按钮图片完全显示出来.

void Button::hoverEnterEvent(QGraphicsSceneHoverEvent *){
    setFocus(Qt::MouseFocusReason);

#ifdef AUDIO_SUPPORT

    if(!mute)
        Sanguosha->playAudio("button-hover");

#endif

    if(!timer_id)timer_id = QObject::startTimer(40);
}

void Button::timerEvent(QTimerEvent *)
{
    update();
    if(hasFocus())
    {
        if(glow<5)glow++;
    }else
    {
        if(glow>0)glow--;
        else if(timer_id)
        {
            QObject::killTimer(timer_id);
            timer_id = 0;
        }
    }
}

三、声音

  太阳神三国杀中声音很流畅亮丽.实现采用开源跨平台的游戏声音引擎fmod,详细内容请参见:http://baike.baidu.com/view/656662.htm.内部将fmod操作封装在Sound类中,这个类很简单,数行代码而已.

class Sound;

static FMOD_SYSTEM *System;
static FMOD_SOUND *BGM;
static FMOD_CHANNEL *BGMChannel;

class Sound{
public:
    Sound(const QString &filename)
        :sound(NULL), channel(NULL)
    {
        FMOD_System_CreateSound(System, filename.toAscii(), FMOD_DEFAULT, NULL, &sound);
    }

    ~Sound(){
        if(sound)
            FMOD_Sound_Release(sound);
    }

    void play(){
        if(sound){
            FMOD_RESULT result = FMOD_System_PlaySound(System, FMOD_CHANNEL_FREE, sound, false, &channel);

            if(result == FMOD_OK){
                FMOD_Channel_SetVolume(channel, 1.000/*Config.EffectVolume*/);
                FMOD_System_Update(System);
            }
        }
    }

    bool isPlaying() const{
        if(channel == NULL)
            return false;

        FMOD_BOOL is_playing = false;
        FMOD_Channel_IsPlaying(channel, &is_playing);
        return is_playing;
    }

private:
    FMOD_SOUND *sound;
    FMOD_CHANNEL *channel;
};

在项目启动时初始化fmod:

    FMOD_RESULT result = FMOD_System_Create(&System);

    if(result == FMOD_OK){
        FMOD_System_Init(System, 100, 0, NULL);
    }

在项目结束时释放fmod:

    if(System){
        SoundCache.clear();
        FMOD_System_Release(System);

        System = NULL;
    }

注意,fmod需要6个头文件:fmod.h,fmod_codec.h,fmod_dsp.h,fmod_errors.h,fmod_memoryinfo.h,fmod_output.h,以及一个lib文件fmodex.lib,一个dll文件fmodex.dll.可以直接将上面的类和8个文件移植到自己的项目中使用,测试通过.唯一需要注意的是Sound对象的析构函数中会结束音频播放,因此如果声明了一个临时变量,需要等待声音播放完毕才能跳出Sound对象的作用域,否则声音未等播放已经结束了.

  四、如何进入到RoomScene

  进入游戏后需要首先点击Start Server按钮建立服务端,再点击Start game菜单,重新启动一个进程,在新进程中点击Start game按钮,弹出连接窗体,输入服务器IP地址及用户名后可以加入到游戏中,直接进入正式游戏界面.这里创建了两个进程,第一个是服务端,第二个是客户端.为了跟踪第二个exe进程,需要首先直接启动一个exe进程,在启动第二个进程后,点击vs2008的调试菜单--附加到进程,找到第二个三国杀进程,即可在源码中设置断点跟踪了.这里描述一下客户端建立游戏的过程.

  点击Start game按钮后,弹出一个连接窗体,窗口对象的accepted信号与startConnection槽相关联,点击连接按钮后,触发这个函数,创建Client类的实例,在其version_checked信号的响应函数checkVersion中,判断客户端与服务端的版本号是否匹配,如果匹配则与服务端建立连接,客户端对象的server_connected信号触发enterRoom函数,进入到游戏界面.

connect(connection_dialog, SIGNAL(accepted()), this, SLOT(startConnection()));  //构造函数中连接窗体返回触发startConnection
//startConnection函数启动Client对象,并设置信号与槽的连接
void MainWindow::startConnection(){
    Client *client = new Client(this);
    connect(client, SIGNAL(version_checked(QString,QString)), SLOT(checkVersion(QString,QString)));
    connect(client, SIGNAL(error_message(QString)), SLOT(networkError(QString)));
}
//checkVersion中比较版本号,并进入到游戏界面
void MainWindow::checkVersion(const QString &server_version, const QString &server_mod){
    QString client_mod = Sanguosha->getMODName();
    if(client_mod != server_mod){
        QMessageBox::warning(this, tr("Warning"), tr("Client MOD name is not same as the server!"));
        return;
    }
    Client *client = qobject_cast<Client *>(sender());
    QString client_version = Sanguosha->getVersionNumber();
    if(server_version == client_version){
        client->signup();
        connect(client, SIGNAL(server_connected()), SLOT(enterRoom()));
        if(qApp->arguments().contains("-hall")){
            HallDialog *dialog = HallDialog::GetInstance(this);
            connect(client, SIGNAL(server_connected()), dialog, SLOT(accept()));
        }
        return;
    }
......

  再看一下核心函数enterRoom.设置好服务端IP地址并登陆成功后,触发这个函数.首先将这个IP地址保存在Config中.设置相关Action的Enabled属性使相应按钮和菜单失效变灰.创建RoomScene对象,进行相关设置.最后调用gotoScene(room_scene);切换到游戏界面.

  五、游戏界面的创建

  游戏界面的元素完全创建在RoomScene场景类中,只要打开游戏查看效果并对照代码和image\system目录中的图片,即可分析出对应界面是如何创建出来的.下面逐一解读.首先根据从游戏服务端获取的玩家总数,生成代表每个异地玩家的图标.

    //创建代表其他玩家的头像，不用创建当前玩家
    int i;
    for(i = 0; i < player_count - 1;i++){
        Photo *photo = new Photo;
        photos << photo;
        addItem(photo);
        photo->setZValue(-0.5);
    }

  接着创建操作面板,这个操作面板包括界面上的按钮区域,还有当前玩家的装备区和手牌区域.

 //添加右下方的操作面板及按钮
    {
        createControlButtons();
        QGraphicsItem *button_widget = NULL;
        if(ClientInstance->getReplayer() == NULL){
            QString path = "image/system/button/irregular/background.png";
            button_widget = new QGraphicsPixmapItem(QPixmap(path));
   //四个不规则按钮
            ok_button->setParentItem(button_widget);
            cancel_button->setParentItem(button_widget);
            discard_button->setParentItem(button_widget);
            trust_button->setParentItem(button_widget);
        }
  
        // create dashboard 仪表盘 包括玩家装备和手牌区域
        dashboard = new Dashboard(button_widget);
        dashboard->setObjectName("dashboard");
        //dashboard->setZValue(0.8);
        addItem(dashboard);

  调用createStateItem();函数创建选择反贼和英雄的两个按钮.

  创建聊天区域控件:

        chat_box = new QTextEdit;
        QSize chat_box_size = room_layout->chat_box_size;
        chat_box_size.rwidth() += widen_width;
        chat_box->resize(chat_box_size);
        chat_box->setObjectName("chat_box");

        chat_box_widget = addWidget(chat_box);

  输入聊天信息的textEdit控件:

        chat_edit = new QLineEdit;
        chat_edit->setFixedWidth(chat_box->width());
        chat_edit->setObjectName("chat_edit");
  右边的系统信息显示框:

        chat_widget = new ChatWidget();
        chat_widget->setX(chat_box_widget->x()+chat_edit->width() - 77);
        chat_widget->setY(chat_box_widget->y()+chat_box->height() + 9);
        chat_widget->setZValue(-0.2);
        addItem(chat_widget);

  最底部的两个ComboBox:

        sort_combobox = new QComboBox;

        sort_combobox->addItem(tr("No sort"));
        sort_combobox->addItem(tr("Sort by color"));
        sort_combobox->addItem(tr("Sort by suit"));
        sort_combobox->addItem(tr("Sort by type"));
        sort_combobox->addItem(tr("Sort by availability"));

        connect(sort_combobox, SIGNAL(currentIndexChanged(int)), dashboard, SLOT(sortCards(int)));
    }

    connect(Self, SIGNAL(pile_changed(QString)), this, SLOT(updatePileButton(QString)));

    // add role combobox
    role_combobox = new QComboBox;
    role_combobox->addItem(tr("Your role"));
    role_combobox->addItem(tr("Unknown"));
    connect(Self, SIGNAL(role_changed(QString)), this, SLOT(updateRoleComboBox(QString)));

  进入游戏界面的生成基本上介绍完毕,下面将分多个文章分别介绍各个类的作用和实现机制.