|  | Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |

[Previous: Chapter 10] [Qt Tutorial] [Next: Chapter 12]

# Qt Tutorial 11 - Giving It a Shot

Files:

- tutorial/t11/cannonfield.cpp
- tutorial/t11/cannonfield.h
- tutorial/t11/lcdrange.cpp
- tutorial/t11/lcdrange.h
- tutorial/t11/main.cpp

In this example we introduce a timer to implement animated shooting.

## Line by Line Walkthrough

### t11/cannonfield.h

The `CannonField` now has shooting capabilities.

         void shoot();

Calling this slot will make the cannon shoot if a shot is not in the air.

     private slots:
         void moveShot();

This private slot is used to move the shot while it is in the air, using a QTimer.

     private:
         void paintShot(QPainter &painter);

This private function paints the shot.

         QRect shotRect() const;

This private function returns the shot's enclosing rectangle if one is in the air; otherwise the returned rectangle is undefined.

         int timerCount;
         QTimer *autoShootTimer;
         float shootAngle;
         float shootForce;
     };

These private variables contain information that describes the shot. The `timerCount` keeps track of the time passed since the shot was fired. The `shootAngle` is the cannon angle and `shootForce` is the cannon force when the shot was fired.

### t11/cannonfield.cpp

     #include <math.h>

We include `<math.h>` because we need the `sin()` and `cos()` functions. (An alternative would be to include the more modern `<cmath>` header file. Unfortunately, some Unix platforms still don't support these properly.)

     CannonField::CannonField(QWidget *parent)
         : QWidget(parent)
     {
         currentAngle = 45;
         currentForce = 0;
         timerCount = 0;
         autoShootTimer = new QTimer(this);
         connect(autoShootTimer, SIGNAL(timeout()), this, SLOT(moveShot()));
         shootAngle = 0;
         shootForce = 0;
         setPalette(QPalette(QColor(250, 250, 200)));
         setAutoFillBackground(true);
     }

We initialize our new private variables and connect the QTimer::timeout() signal to our `moveShot()` slot. We'll move the shot every time the timer times out.

     void CannonField::shoot()
     {
         if (autoShootTimer->isActive())
             return;
         timerCount = 0;
         shootAngle = currentAngle;
         shootForce = currentForce;
         autoShootTimer->start(5);
     }

This function shoots a shot unless a shot is in the air. The `timerCount` is reset to zero. The `shootAngle` and `shootForce` variables are set to the current cannon angle and force. Finally, we start the timer.

     void CannonField::moveShot()
     {
         QRegion region = shotRect();
         ++timerCount;

         QRect shotR = shotRect();

         if (shotR.x() > width() || shotR.y() > height()) {
             autoShootTimer->stop();
         } else {
             region = region.unite(shotR);
         }
         update(region);
     }

`moveShot()` is the slot that moves the shot, called every 5 milliseconds when the QTimer fires.

Its tasks are to compute the new position, update the screen with the shot in the new position, and if necessary, stop the timer.

First we make a QRegion that holds the old `shotRect()`. A QRegion is capable of holding any sort of region, and we'll use it here to simplify the painting. `shotRect()` returns the rectangle where the shot is now. It is explained in detail later.

Then we increment the `timerCount`, which has the effect of moving the shot one step along its trajectory.

Next we fetch the new shot rectangle.

If the shot has moved beyond the right or bottom edge of the widget we stop the timer, or we add the new `shotRect()` to the QRegion.

Finally, we repaint the QRegion. This will send a single paint event for just the one or two rectangles that need updating.

     void CannonField::paintEvent(QPaintEvent * /* event */)
     {
         QPainter painter(this);

         paintCannon(painter);
         if (autoShootTimer->isActive())
             paintShot(painter);
     }

The paint event function has been simplified since the previous chapter. Most of the logic has been moved to the new `paintShot()` and `paintCannon()` functions.

     void CannonField::paintShot(QPainter &painter)
     {
         painter.setPen(Qt::NoPen);
         painter.setBrush(Qt::black);
         painter.drawRect(shotRect());
     }

This private function paints the shot by drawing a black filled rectangle.

We leave out the implementation of `paintCannon()`; it is the same as the QWidget::paintEvent() reimplementation from the previous chapter.

     QRect CannonField::shotRect() const
     {
         const double gravity = 4;

         double time = timerCount / 20.0;
         double velocity = shootForce;
         double radians = shootAngle * 3.14159265 / 180;

         double velx = velocity * cos(radians);
         double vely = velocity * sin(radians);
         double x0 = (barrelRect.right() + 5) * cos(radians);
         double y0 = (barrelRect.right() + 5) * sin(radians);
         double x = x0 + velx * time;
         double y = y0 + vely * time - 0.5 * gravity * time * time;

         QRect result(0, 0, 6, 6);
         result.moveCenter(QPoint(qRound(x), height() - 1 - qRound(y)));
         return result;
     }

This private function calculates the center point of the shot and returns the enclosing rectangle of the shot. It uses the initial cannon force and angle in addition to `timerCount`, which increases as time passes.

The formula used is the standard Newtonian formula for frictionless movement in a gravity field. For simplicity, we've chosen to disregard any Einsteinian effects.

We calculate the center point in a coordinate system where y coordinates increase upward. After we have calculated the center point, we construct a QRect with size 6 x 6 and move its center point to the point calculated above. In the same operation we convert the point into the widget's coordinate system (see The Coordinate System).

The qRound() function is an inline function defined in `<QtGlobal>` (included by all other Qt header files). qRound() rounds a double to the closest integer.

### t11/main.cpp

     ** This file is part of the example classes of the Qt Toolkit.
     **
     ** This file may be used under the terms of the GNU General Public
     ** License version 2.0 as published by the Free Software Foundation
     ** and appearing in the file LICENSE.GPL included in the packaging of
     ** this file.  Please review the following information to ensure GNU
     ** General Public Licensing requirements will be met:
     ** http://trolltech.com/products/qt/licenses/licensing/opensource/
     **
     ** If you are unsure which license is appropriate for your use, please
     ** review the following information:
     ** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
     ** or contact the sales department at sales@trolltech.com.
     **
     ** In addition, as a special exception, Trolltech gives you certain
     ** additional rights. These rights are described in the Trolltech GPL
     ** Exception version 1.0, which can be found at
     ** http://www.trolltech.com/products/qt/gplexception/ and in the file
     ** GPL_EXCEPTION.txt in this package.
     **
     ** In addition, as a special exception, Trolltech, as the sole copyright
     ** holder for Qt Designer, grants users of the Qt/Eclipse Integration
     ** plug-in the right for the Qt/Eclipse Integration to link to
     ** functionality provided by Qt Designer and its related libraries.
     **
     ** Trolltech reserves all rights not expressly granted herein.
     **
     ** Trolltech ASA (c) 2007
     **
     ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
     ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
     **
     ****************************************************************************/

     #include <QApplication>
     #include <QFont>
     #include <QGridLayout>
     #include <QHBoxLayout>
     #include <QPushButton>
     #include <QVBoxLayout>

     #include "cannonfield.h"
     #include "lcdrange.h"

     class MyWidget : public QWidget
     {
     public:
         MyWidget(QWidget *parent = 0);
     };

The only addition is the Shoot button.

         QPushButton *shoot = new QPushButton(tr("&Shoot"));
         shoot->setFont(QFont("Times", 18, QFont::Bold));

In the constructor we create and set up the Shoot button exactly like we did with the Quit button.

         connect(shoot, SIGNAL(clicked()), cannonField, SLOT(shoot()));

Connects the clicked() signal of the Shoot button to the `shoot()` slot of the `CannonField`.

## Running the Application

The cannon can shoot, but there's nothing to shoot at.

## Exercises

Make the shot a filled circle. [Hint: QPainter::drawEllipse() may help.]

Change the color of the cannon when a shot is in the air.

[Previous: Chapter 10] [Qt Tutorial] [Next: Chapter 12]