Logo Search packages:      
Sourcecode: kdenlive version File versions

docclipbase.h

/***************************************************************************
                          docclipbase.h  -  description
                             -------------------
    begin                : Fri Apr 12 2002
    copyright            : (C) 2002 by Jason Wood
    email                : jasonwood@blueyonder.co.uk
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef DOCCLIPBASE_H
#define DOCCLIPBASE_H

/**DocClip is a class for the various types of clip
  *@author Jason Wood
  */

#include <qdom.h>
#include <qobject.h>
#include <qvaluevector.h>
#include <qpixmap.h>

#include <kurl.h>
#include <klocale.h>

#include "gentime.h"
#include "kthumb.h"

class ClipManager;
class DocTrackBase;
class DocClipAVFile;
class DocClipTextFile;
class DocClipVirtual;
class EffectDescriptionList;
class KdenliveDoc;

class CommentedTime
    {
    public:
        CommentedTime(): t(GenTime(0)) {}
        CommentedTime( const GenTime time, QString comment)
            : t( time ), c( comment )
        { }

        QString comment()   const          { return (c.isEmpty() ? i18n("Marker") : c);}
        GenTime time() const          { return t; }
        void    setComment( QString comm) { c = comm; }
    private:
        GenTime t;
        QString c;
    };


class DocClipBase:public QObject {
  Q_OBJECT public:
      /** this enum determines the types of "feed" available within this clip. types must be non-exclusive
       * - e.g. if you can have audio and video seperately, it should be possible to combin the two, as is
       *   done here. If a new clip type is added then it should be possible to combine it with both audio
       *   and video. */
    enum CLIPTYPE { NONE = 0, AUDIO = 1, VIDEO = 2, AV = 3, COLOR =
          4, IMAGE = 5, TEXT = 6, SLIDESHOW = 7, VIRTUAL = 8, PLAYLIST = 9};

     DocClipBase();
     virtual ~ DocClipBase();

      /** sets the name of this clip. */
    void setName(const QString name);

      /** returns the name of this clip. */
    const QString & name() const;

      /** Sets the description for this clip. */
    void setDescription(const QString & descripton);

      /** Returns the description of this clip. */
    const QString & description() const;

    /** Returns the internal unique id of the clip. */
    uint getId() const;
    void setId( const uint &newId);

    KThumb *thumbCreator;
    bool audioThumbCreated;
    
      /** returns the duration of this clip */
    virtual const GenTime & duration() const = 0;

      /** returns clip type (audio, text, image,...) */
    virtual const DocClipBase::CLIPTYPE & clipType() const = 0;

      /** remove tmp file if the clip has one (for example text clips) */
    virtual void removeTmpFile() const = 0;

      /** Returns a url to a file describing this clip. Exactly what this url is,
      whether it is temporary or not, and whether it provokes a render will
      depend entirely on what the clip consists of. */
    virtual const KURL & fileURL() const = 0;

      /** Returns true if the clip duration is known, false otherwise. */
    virtual bool durationKnown() const = 0;
    // Returns the number of frames per second that this clip should play at.
    virtual double framesPerSecond() const = 0;

    virtual bool isDocClipAVFile() const {
      return false;
    } 
    
    virtual DocClipAVFile *toDocClipAVFile() {
      return 0;
    }

    virtual DocClipTextFile *toDocClipTextFile() {
        return 0;
    }
    
    virtual bool isDocClipTextFile() const {
        return false;
    }

    virtual bool isDocClipVirtual() const {
        return false;
    } 
    
    virtual DocClipVirtual *toDocClipVirtual() {
        return 0;
    }
    
      /** Returns true if this clip is a project clip, false otherwise. Overridden in DocClipProject,
       * where it returns true. */ 
    virtual bool isProjectClip() const {
      return false;
    }
    // Appends scene times for this clip to the passed vector.
      virtual void populateSceneTimes(QValueVector < GenTime >
      &toPopulate) const = 0;

      /** Reads in the element structure and creates a clip out of it.*/
    // Returns an XML document that describes part of the current scene.
    virtual QDomDocument sceneToXML(const GenTime & startTime,
      const GenTime & endTime) const = 0;
      /** returns a QString containing all of the XML data required to recreate this clip. */
    virtual QDomDocument toXML() const;
    virtual QDomDocument generateSceneList(bool addProducers = true, bool rendering = false) const;

      /** Returns true if the xml passed matches the values in this clip */
    virtual bool matchesXML(const QDomElement & element) const = 0;

    void addReference() {
      ++m_refcount;
    }
    void removeReference() {
      --m_refcount;
    }
    uint numReferences() const {
      return m_refcount;
    }
      /** Returns true if this clip has a meaningful filesize. */
      virtual bool hasFileSize() const = 0;

      /** Returns the filesize, or 0 if there is no appropriate filesize. */
    virtual uint fileSize() const = 0;

      /** Returns true if this clip refers to the clip passed in. A clip refers to another clip if
       * it uses it as part of it's own composition. */
    virtual bool referencesClip(DocClipBase * clip) const = 0;

      /** Sets the thumbnail to be used by this clip */
    void setThumbnail(const QPixmap & pixmap);

      /** Returns the thumbnail used by this clip */
    const QPixmap & thumbnail() const;

    static DocClipBase *createClip(KdenliveDoc *doc, const QDomElement & element);
    /** Cache for every audio Frame with 10 Bytes */
    /** format is frame -> channel ->bytes */
    QMap<int,QMap<int,QByteArray> > audioFrameChache;

      /** return english name for clip type */
    static QString getTypeName(CLIPTYPE type);

  private:              // Private attributes
      /** The name of this clip */
    QString m_name;
      /** A description of this clip */
    QString m_description;
      /** The number of times this clip is used in the project - the number of references to this clip
       * that exist. */
    uint m_refcount;

      /** A list of snap markers; these markers are added to a clips snap-to points, and are displayed as necessary. */
    QValueVector < CommentedTime > m_snapMarkers;


      /** A thumbnail for this clip */
    QPixmap m_thumbnail;
    
    /** a unique numeric id */
    uint m_id;
    uint m_projectThumbFrame;
    void setAudioThumbCreated(bool isDone);

  public slots:
      void updateAudioThumbnail(QMap<int,QMap<int,QByteArray> > data);
      QValueVector < CommentedTime > commentedSnapMarkers() const;
      void setSnapMarkers(QValueVector < CommentedTime > markers);
      GenTime findNextSnapMarker(const GenTime & currTime);
      GenTime findPreviousSnapMarker(const GenTime & currTime);
      GenTime hasSnapMarkers(const GenTime & time);
      QString deleteSnapMarker(const GenTime & time);
      void editSnapMarker(const GenTime & time, QString comment);
      void addSnapMarker(const GenTime & time, QString comment);
      QValueVector < GenTime > snapMarkers() const;
      QString markerComment(GenTime t);
      void setProjectThumbFrame( const uint &ix);
      uint getProjectThumbFrame() const;
};

#endif

Generated by  Doxygen 1.6.0   Back to index