Home · Examples 

Qt Script Tetrix Example

The QSTetrix example is a Qt Script version of the classic Tetrix game.


The program logic in this example is a fairly straight port of the logic in the C++
Tetrix Example. You may find it useful to compare the implementations of the TetrixBoard, TetrixPiece and TetrixWindow classes to see how Qt Script is used to implement methods, call Qt functions, and emit signals.

Setting up the GUI

The graphical user interface is defined in a .ui file, creating using Qt Designer, and is set up in the example's C++ main.cpp file.

The following code example is written in c++.
class TetrixUiLoader : public QUiLoader
    TetrixUiLoader(QObject *parent = 0)
        : QUiLoader(parent)
        { }
    virtual QWidget *createWidget(const QString &className, QWidget *parent = 0,
                                  const QString &name = QString())
        if (className == QLatin1String("TetrixBoard")) {
            QWidget *board = new TetrixBoard(parent);
            return board;
        return QUiLoader::createWidget(className, parent, name);
We define a custom UI loader that handles our TetrixBoard widget; this is the main component of the UI (where the pieces are drawn).

The following code example is written in c++.
    QApplication app(argc, argv);
    QScriptEngine engine;

    QScriptValue Qt = engine.newQMetaObject(QtMetaObject::get());
    Qt.setProperty("App", engine.newQObject(&app));
    engine.globalObject().setProperty("Qt", Qt);
We initialize the script engine to have the Qt namespace, so that e.g.,
Qt.Key_Left will be available to script code. We also make the application object available (for the quit() slot).

The following code example is written in c++.
    evaluateFile(engine, ":/tetrixpiece.js");
    evaluateFile(engine, ":/tetrixboard.js");
    evaluateFile(engine, ":/tetrixwindow.js");
Several scripts are evaluated as part of the engine setup process. The tetrixpiece.js file contains the definition of the TetrixPiece class, which is used to populate the play field. The tetrixboard.js file contains the definition of the TetrixBoard class, which contains the main game logic. Finally, tetrixwindow.js contains the definition of the TetrixWindow class, which wires up the top-level widget.

The following code example is written in c++.
    TetrixUiLoader loader;
    QFile uiFile(":/tetrixwindow.ui");
    QWidget *ui = loader.load(&uiFile);

    QScriptValue ctor = engine.evaluate("TetrixWindow");
    QScriptValue scriptUi = engine.newQObject(ui, QScriptEngine::ScriptOwnership);
    QScriptValue tetrix = ctor.construct(QScriptValueList() << scriptUi);
A form is created from the UI file. A new TetrixWindow script object is then constructed, passing the form as its argument.

The following code example is written in c++.
    ui->resize(550, 370);

    return app.exec();
The form is shown, and the event loop is entered.

Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Jambi 4.5.2_01