1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/***************************************************************************
* Copyright (C) 2008 by Peter Penz <[email protected]> *
* *
* 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. *
* *
* This program is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., *
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA *
***************************************************************************/
#ifndef ICONMANAGER_H
#define ICONMANAGER_H
#include <kfileitem.h>
#include <kurl.h>
#include <QList>
#include <QObject>
#include <QPixmap>
class DolphinModel;
class DolphinSortFilterProxyModel;
class KJob;
class QAbstractItemView;
/**
* @brief Manages the icon state of a directory model.
*
* Per default a preview is generated for each item.
* Additionally the clipboard is checked for cut items.
* The icon state for cut items gets dimmed automatically.
*/
class IconManager : public QObject
{
Q_OBJECT
public:
IconManager(QAbstractItemView* parent, DolphinSortFilterProxyModel* model);
virtual ~IconManager();
void setShowPreview(bool show);
bool showPreview() const;
void updatePreviews();
private slots:
/**
* Generates previews for the items \a items asynchronously.
*/
void generatePreviews(const KFileItemList &items);
/**
* Adds the preview \a pixmap for the item \a item to the preview
* queue and starts a timer which will dispatch the preview queue
* later.
*/
void addToPreviewQueue(const KFileItem& item, const QPixmap& pixmap);
/**
* Is invoked when the preview job has been finished and
* set m_previewJob to 0.
*/
void slotPreviewJobFinished(KJob* job);
/** Synchronizes the item icon with the clipboard of cut items. */
void updateCutItems();
/**
* Dispatches the preview queue m_previews block by block within
* time slices.
*/
void dispatchPreviewQueue();
private:
/**
* Replaces the icon of the item \a item by the preview pixmap
* \a pixmap.
*/
void replaceIcon(const KFileItem& item, const QPixmap& pixmap);
/**
* Returns true, if the item \a item has been cut into
* the clipboard.
*/
bool isCutItem(const KFileItem& item) const;
/** Applies an item effect to all cut items. */
void applyCutItemEffect();
/**
* Applies a frame around the icon. False is returned if
* no frame has been added because the icon is too small.
*/
bool applyImageFrame(QPixmap& icon);
/**
* Resizes the icon to \a maxSize if the icon size does not
* fit into the maximum size. The aspect ratio of the icon
* is kept.
*/
void limitToSize(QPixmap& icon, const QSize& maxSize);
/** Kills all ongoing preview jobs. */
void killJobs();
private:
/**
* Remembers the original pixmap for an item before
* the cut effect is applied.
*/
struct CutItem
{
KUrl url;
QPixmap pixmap;
};
/**
* Remembers the received preview pixmap for an item.
*/
struct Preview
{
KFileItem item;
QPixmap pixmap;
};
bool m_showPreview;
QAbstractItemView* m_view;
QTimer* m_previewTimer;
QList<KJob*> m_previewJobs;
DolphinModel* m_dolphinModel;
DolphinSortFilterProxyModel* m_proxyModel;
QList<CutItem> m_cutItemsCache;
QList<Preview> m_previews;
};
inline bool IconManager::showPreview() const
{
return m_showPreview;
}
#endif
|
