1/***************************************************************************
2 kthumb.h - description
3 -------------------
4 begin : Fri Nov 22 2002
5 copyright : (C) 2002 by Jason Wood
6 email : jasonwood@blueyonder.co.uk
7***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#ifndef KTHUMB_H
19#define KTHUMB_H
20
21#include <QPixmap>
22#include <QFile>
23#include <QDomElement>
24#include <QFuture>
25
26#include <KUrl>
27#include <kdeversion.h>
28
29#include <mlt++/Mlt.h>
30
31
32/**KRender encapsulates the client side of the interface to a renderer.
33From Kdenlive's point of view, you treat the KRender object as the
34renderer, and simply use it as if it was local. Calls are asyncrhonous -
35you send a call out, and then receive the return value through the
36relevant signal that get's emitted once the call completes.
37 *@author Jason Wood
38 */
39
40
41namespace Mlt
42{
43class Producer;
44class Frame;
45}
46
47class ClipManager;
48
49typedef QMap <int, QMap <int, QByteArray> > audioByteArray;
50
51class KThumb: public QObject
52{
53 Q_OBJECT
54public:
55
56 explicit KThumb(ClipManager *clipManager, const KUrl &url, const QString &id, const QString &hash, QObject * parent = 0);
57 ~KThumb();
58 void setProducer(Mlt::Producer *producer);
59 bool hasProducer() const;
60 void clearProducer();
61 void updateThumbUrl(const QString &hash);
62 void extractImage(const QList<int> &frames);
63 QImage extractImage(int frame, int width, int height);
64#if KDE_IS_VERSION(4,5,0)
65 /** @brief Request thumbnails for the frame range. */
66 void queryIntraThumbs(const QList <int> &missingFrames);
67 /** @brief Query cached thumbnail. */
68 QImage findCachedThumb(const QString &path);
69#endif
70 void getThumb(int frame);
71 void getGenericThumb(int frame, int height, int type);
72
73public slots:
74 void updateClipUrl(const KUrl &url, const QString &hash);
75 void slotCreateAudioThumbs();
76
77public:
78 static QPixmap getImage(const KUrl &url, int width, int height);
79// static QPixmap getImage(QDomElement xml, int frame, int width, int height);
80 /* void getImage(KUrl url, int frame, int width, int height);
81 void getThumbs(KUrl url, int startframe, int endframe, int width, int height);*/
82 static QPixmap getImage(const KUrl& url, int frame, int width, int height);
83 static QImage getFrame(Mlt::Producer *producer, int framepos, int frameWidth, int displayWidth, int height);
84 static QImage getFrame(Mlt::Frame *frame, int frameWidth, int displayWidth, int height);
85 /** @brief Calculates image variance, useful to know if a thumbnail is interesting.
86 * @return an integer between 0 and 100. 0 means no variance, eg. black image while bigger values mean contrasted image
87 * */
88 static uint imageVariance(const QImage &image);
89
90private slots:
91#if KDE_IS_VERSION(4,5,0)
92 /** @brief Fetch all requested frames. */
93 void slotGetIntraThumbs();
94#endif
95
96private:
97 KUrl m_url;
98 QString m_thumbFile;
99 double m_dar;
100 double m_ratio;
101 Mlt::Producer *m_producer;
102 ClipManager *m_clipManager;
103 QString m_id;
104 /** @brief Controls the intra frames thumbnails process (cached thumbnails). */
105 QFuture<void> m_intra;
106 /** @brief List of frame numbers from which we want to extract thumbnails. */
107 QList <int> m_intraFramesQueue;
108 QMutex m_mutex;
109 QImage getProducerFrame(int framepos, int frameWidth, int displayWidth, int height);
110
111signals:
112 void thumbReady(int, const QImage&);
113 void mainThumbReady(const QString &, const QPixmap&);
114 void audioThumbReady(const audioByteArray&);
115 /** @brief We have finished caching all requested thumbs. */
116 void thumbsCached();
117};
118
119#endif
120