demos/qtdemo/demoitem.h

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the demonstration applications of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** No Commercial Usage
  11 ** This file contains pre-release code and may not be distributed.
  12 ** You may use this file in accordance with the terms and conditions
  13 ** contained in the Technology Preview License Agreement accompanying
  14 ** this package.
  15 **
  16 ** GNU Lesser General Public License Usage
  17 ** Alternatively, this file may be used under the terms of the GNU Lesser
  18 ** General Public License version 2.1 as published by the Free Software
  19 ** Foundation and appearing in the file LICENSE.LGPL included in the
  20 ** packaging of this file.  Please review the following information to
  21 ** ensure the GNU Lesser General Public License version 2.1 requirements
  22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  23 **
  24 ** In addition, as a special exception, Nokia gives you certain additional
  25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
  26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  27 **
  28 ** If you have questions regarding the use of this file, please contact
  29 ** Nokia at qt-info@nokia.com.
  30 **
  31 **
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #ifndef DEMO_ITEM_H
  43 #define DEMO_ITEM_H
  44
  45 #include <QtGui>
  46
  47 class DemoItemAnimation;
  48 class Guide;
  49
  50 class SharedImage
  51 {
  52 public:
  53     SharedImage() : refCount(0), image(0), pixmap(0){};
  54     ~SharedImage()
  55     {
  56         delete image;
  57         delete pixmap;
  58     }
  59
  60     int refCount;
  61     QImage *image;
  62     QPixmap *pixmap;
  63     QMatrix matrix;
  64     QRectF unscaledBoundingRect;
  65 };
  66
  67 class DemoItem : public QGraphicsItem
  68 {
  69
  70 public:
  71     DemoItem(QGraphicsScene *scene = 0, QGraphicsItem *parent = 0);
  72     virtual ~DemoItem();
  73
  74     bool inTransition();
  75     virtual void animationStarted(int id = 0){ Q_UNUSED(id); };
  76     virtual void animationStopped(int id = 0){ Q_UNUSED(id); };
  77     virtual void prepare(){};
  78     void setRecursiveVisible(bool visible);
  79     void useSharedImage(const QString &hashKey);
  80     void setNeverVisible(bool never = true);
  81     static void setMatrix(const QMatrix &matrix);
  82     virtual QRectF boundingRect() const; // overridden
  83     void setPosUsingSheepDog(const QPointF &dest, const QRectF &sceneFence);
  84
  85     qreal opacity;
  86     bool locked;
  87     DemoItemAnimation *currentAnimation;
  88     bool noSubPixeling;
  89
  90     // Used if controlled by a guide:
  91     void useGuide(Guide *guide, float startFrame = 0);
  92     void guideAdvance(float distance);
  93     void guideMove(float moveSpeed);
  94     void setGuidedPos(const QPointF &position);
  95     QPointF getGuidedPos();
  96     float startFrame;
  97     float guideFrame;
  98     Guide *currGuide;
  99
 100 protected:
 101     virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option = 0, QWidget *widget = 0); // overridden
 102     virtual QImage *createImage(const QMatrix &) const { return 0; };
 103     virtual bool collidesWithItem(const QGraphicsItem *, Qt::ItemSelectionMode) const { return false; };
 104     bool prepared;
 105
 106 private:
 107     SharedImage *sharedImage;
 108     QString hashKey;
 109     bool neverVisible;
 110     bool validateImage();
 111
 112     // Used if controlled by a guide:
 113     void switchGuide(Guide *guide);
 114     friend class Guide;
 115     QPointF guidedPos;
 116
 117     // The next static hash is shared amongst all demo items, and
 118     // has the purpose of reusing images to save memory and time
 119     static QHash<QString, SharedImage *> sharedImageHash;
 120     static QMatrix matrix;
 121 };
 122
 123 #endif // DEMO_ITEM_H
 124