1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Free Documentation License
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of this
** file.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\example script/qstetrix
\title Qt Script Tetrix Example
The QSTetrix example is a Qt Script version of the classic Tetrix game.
\image tetrix-example.png
\section1 Overview
The program logic in this example is a fairly straight port of the
logic in the C++ \l{Tetrix Example}. You may find it useful to compare
the implementations of the \c TetrixBoard, \c TetrixPiece and
\c TetrixWindow classes to see how Qt Script is used to implement
methods, call Qt functions, and emit signals.
\section1 Setting up the GUI
The graphical user interface is defined in a UI file, created
using Qt Designer, and is set up in the example's C++ \c{main.cpp} file.
\snippet examples/script/qstetrix/main.cpp 0
We define a custom UI loader that handles our \c TetrixBoard widget; this
is the main component of the UI (where the pieces are drawn).
\snippet examples/script/qstetrix/main.cpp 1
We initialize the script engine to have the Qt namespace, so that
e.g., \l{Qt::Key_Left}{Qt.Key_Left} will be available to script code.
We also make the application object available (for the
\l{QApplication::}{quit()} slot).
\snippet examples/script/qstetrix/main.cpp 2
Several scripts are evaluated as part of the engine setup process.
The \c{tetrixpiece.js} file contains the definition of the \c TetrixPiece
class, which is used to populate the play field. The \c{tetrixboard.js}
file contains the definition of the \c TetrixBoard class, which contains
the main game logic. Finally, \c{tetrixwindow.js} contains the definition
of the \c TetrixWindow class, which wires up the top-level widget.
\snippet examples/script/qstetrix/main.cpp 3
A form is created from the UI file. A new \c TetrixWindow script object
is then constructed, passing the form as its argument.
\snippet examples/script/qstetrix/main.cpp 4
The form is shown, and the event loop is entered.
*/
|
