source: trunk/doc/src/examples/collidingmice-example.qdoc@ 560

Last change on this file since 560 was 2, checked in by Dmitry A. Kuminov, 16 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.
File size: 13.1 KB
Line 
1/****************************************************************************
2**
3** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4** Contact: Qt Software Information ([email protected])
5**
6** This file is part of the documentation of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial Usage
10** Licensees holding valid Qt Commercial licenses may use this file in
11** accordance with the Qt Commercial License Agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Nokia.
14**
15** GNU Lesser General Public License Usage
16** Alternatively, this file may be used under the terms of the GNU Lesser
17** General Public License version 2.1 as published by the Free Software
18** Foundation and appearing in the file LICENSE.LGPL included in the
19** packaging of this file. Please review the following information to
20** ensure the GNU Lesser General Public License version 2.1 requirements
21** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
22**
23** In addition, as a special exception, Nokia gives you certain
24** additional rights. These rights are described in the Nokia Qt LGPL
25** Exception version 1.0, included in the file LGPL_EXCEPTION.txt in this
26** package.
27**
28** GNU General Public License Usage
29** Alternatively, this file may be used under the terms of the GNU
30** General Public License version 3.0 as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL included in the
32** packaging of this file. Please review the following information to
33** ensure the GNU General Public License version 3.0 requirements will be
34** met: http://www.gnu.org/copyleft/gpl.html.
35**
36** If you are unsure which license is appropriate for your use, please
37** contact the sales department at [email protected].
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42/*!
43 \example graphicsview/collidingmice
44 \title Colliding Mice Example
45
46 The Colliding Mice example shows how to use the Graphics View
47 framework to implement animated items and detect collision between
48 items.
49
50 \image collidingmice-example.png
51
52 Graphics View provides the QGraphicsScene class for managing and
53 interacting with a large number of custom-made 2D graphical items
54 derived from the QGraphicsItem class, and a QGraphicsView widget
55 for visualizing the items, with support for zooming and rotation.
56
57 The example consists of an item class and a main function:
58 the \c Mouse class represents the individual mice extending
59 QGraphicsItem, and the \c main() function provides the main
60 application window.
61
62 We will first review the \c Mouse class to see how to animate
63 items and detect item collision, and then we will review the \c
64 main() function to see how to put the items into a scene and how to
65 implement the corresponding view.
66
67 \section1 Mouse Class Definition
68
69 The \c mouse class inherits from QGraphicsItem. The