git.sesse.net Git - kdenlive/blob - src/abstractclipitem.h

   1 /***************************************************************************
   2  *   Copyright (C) 2008 by Marco Gittler (g.marco@freenet.de)              *
   3  *   Copyright (C) 2008 by Jean-Baptiste Mardelle (jb@kdenlive.org)        *
   4  *                                                                         *
   5  *   This program is free software; you can redistribute it and/or modify  *
   6  *   it under the terms of the GNU General Public License as published by  *
   7  *   the Free Software Foundation; either version 2 of the License, or     *
   8  *   (at your option) any later version.                                   *
   9  *                                                                         *
  10  *   This program is distributed in the hope that it will be useful,       *
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  13  *   GNU General Public License for more details.                          *
  14  *                                                                         *
  15  *   You should have received a copy of the GNU General Public License     *
  16  *   along with this program; if not, write to the                         *
  17  *   Free Software Foundation, Inc.,                                       *
  18  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA          *
  19  ***************************************************************************/
  20
  21 #ifndef ABSTRACTCLIPITEM
  22 #define ABSTRACTCLIPITEM
  23
  24 #include <QGraphicsRectItem>
  25 #include <QGraphicsWidget>
  26
  27 #if QT_VERSION >= 0x040600
  28 #include <QPropertyAnimation>
  29 #endif
  30
  31 #include "definitions.h"
  32 #include "gentime.h"
  33
  34 class CustomTrackScene;
  35 class QGraphicsSceneMouseEvent;
  36
  37 class AbstractClipItem : public QObject, public QGraphicsRectItem
  38 {
  39     Q_OBJECT
  40 #if QT_VERSION >= 0x040600
  41     Q_PROPERTY(QRectF rect READ rect WRITE setRect)
  42 #endif
  43
  44 public:
  45     AbstractClipItem(const ItemInfo &info, const QRectF& rect, double fps);
  46     virtual ~ AbstractClipItem();
  47     void updateSelectedKeyFrame();
  48
  49     /** @brief Move the selected keyframe (does not influence the effect, only the display in timeline).
  50     * @param pos new Position
  51     * @param value new Value */
  52     void updateKeyFramePos(const GenTime &pos, const double value);
  53     int addKeyFrame(const GenTime &pos, const double value);
  54     bool hasKeyFrames() const;
  55     int editedKeyFramePos() const;
  56     int selectedKeyFramePos() const;
  57     double selectedKeyFrameValue() const;
  58     double editedKeyFrameValue() const;
  59     double keyFrameFactor() const;
  60     /** @brief Returns the number of keyframes the selected effect has. */
  61     int keyFrameNumber() const;
  62     ItemInfo info() const;
  63     CustomTrackScene* projectScene();
  64     void updateRectGeometry();
  65     void updateItem();
  66     void setItemLocked(bool locked);
  67     bool isItemLocked() const;
  68     void closeAnimation();
  69
  70     virtual OPERATIONTYPE operationMode(QPointF pos) = 0;
  71     virtual GenTime startPos() const ;
  72     virtual void setTrack(int track);
  73     virtual GenTime endPos() const ;
  74     virtual int defaultZValue() const ;
  75     virtual int track() const ;
  76     virtual GenTime cropStart() const ;
  77     virtual GenTime cropDuration() const ;
  78     /** @brief Return the current item's height */
  79     static int itemHeight();
  80     /** @brief Return the current item's vertical offset
  81      *         For example transitions are drawn at 1/3 of track height */
  82     static int itemOffset();
  83
  84     /** @brief Resizes the clip from the start.
  85     * @param posx Absolute position of new in point
  86     * @param hasSizeLimit (optional) Whether the clip has a maximum size */
  87     virtual void resizeStart(int posx, bool hasSizeLimit = true);
  88
  89     /** @brief Resizes the clip from the end.
  90     * @param posx Absolute position of new out point */
  91     virtual void resizeEnd(int posx);
  92     virtual double fps() const;
  93     virtual void updateFps(double fps);
  94     virtual GenTime maxDuration() const;
  95     virtual void setCropStart(GenTime pos);
  96
  97 protected:
  98     ItemInfo m_info;
  99 //    int m_track;
 100     /** The position of the current keyframe when it has moved */
 101     int m_editedKeyframe;
 102     /** The position of the current keyframe before it was moved */
 103     int m_selectedKeyframe;
 104     /*    GenTime m_cropStart;
 105         GenTime m_cropDuration;
 106         GenTime m_startPos;*/
 107     GenTime m_maxDuration;
 108     QMap <int, int> m_keyframes;
 109     /** @brief Strech factor so that keyframes display on the full clip height. */
 110     double m_keyframeFactor;
 111     /** @brief Offset factor so that keyframes minimum value are displaed at the bottom of the clip. */
 112     double m_keyframeOffset;
 113     /** @brief Default reset value for keyframe. */
 114     double m_keyframeDefault;
 115     /** The (keyframe) parameter that is visible and editable in timeline (on the clip) */
 116     int m_visibleParam;
 117     double m_fps;
 118     /** @brief Draw the keyframes of a clip
 119       * @param painter The painter device for the clip
 120       * @param limitedKeyFrames The keyframes can be of type "keyframe" or "simplekeyframe". In the
 121       *        "simplekeyframe" type, the effect always starts on clip start and ends on clip end. With the
 122       *        "keyframe" type, the effect starts on the first keyframe and ends on the last keyframe
 123       */
 124     void drawKeyFrames(QPainter *painter, bool limitedKeyFrames);
 125     int mouseOverKeyFrames(QPointF pos, double maxOffset);
 126     virtual void mousePressEvent(QGraphicsSceneMouseEvent * event);
 127
 128 private:
 129 #if QT_VERSION >= 0x040600
 130     QPropertyAnimation *m_closeAnimation;
 131 #endif
 132 };
 133
 134 #endif