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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
/***************************************************************************
copyright : (C) 2003-2006 by Robby Stephenson
email : [email protected]
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of version 2 of the GNU General Public License as *
* published by the Free Software Foundation; *
* *
***************************************************************************/
#ifndef IMAGEFACTORY_H
#define IMAGEFACTORY_H
#include "stringset.h"
#include <kurl.h>
#include <qcolor.h>
#include <qcache.h>
class KTempDir;
namespace Tellico {
namespace Data {
class Image;
class ImageInfo;
}
class StyleOptions {
public:
QString fontFamily;
int fontSize;
QColor baseColor;
QColor textColor;
QColor highlightedBaseColor;
QColor highlightedTextColor;
QString imgDir;
};
/**
* @author Robby Stephenson
*/
class ImageFactory {
public:
enum CacheDir {
TempDir,
DataDir,
LocalDir
};
/**
* setup some of the static members
*/
static void init();
/**
* Returns the temporary directory where image files are saved
*
* @return The full path
*/
static QString tempDir();
static QString dataDir();
/**
* Add an image, reading it from a URL, which is the case when adding a new image from the
* @ref ImageWidget.
*
* @param url The URL of the image, anything KIO can handle
* @param quiet If any error should not be reported.
* @return The image id, empty if null
*/
static QString addImage(const KURL& url, bool quiet=false,
const KURL& referrer = KURL(), bool linkOnly=false);
/**
* Add an image, reading it from a regular QImage, which is the case when dragging and dropping
* an image in the @ref ImageWidget. The format has to be included, since the QImage doesn't
* 'know' what format it came from.
*
* @param image The qimage
* @param format The image format, probably "PNG"
* @return The image id, empty if null
*/
static QString addImage(const QImage& image, const QString& format);
static QString addImage(const QPixmap& image, const QString& format);
/**
* Add an image, reading it from data, which is the case when reading from the data file. The
* @p id isn't strictly needed, since it can be reconstructed from the image data and format, but
* since it's already known, go ahead and use it.
*
* @param data The image data
* @param format The image format, from Qt's output format list
* @param id The internal id of the image
* @return The image id, empty if null
*/
static QString addImage(const QByteArray& data, const QString& format, const QString& id);
/**
* Writes an image to a file. ImageFactory keeps track of which images were already written
* if the location is the same as the tempdir.
*
* @param id The ID of the image to be written
* @param targetDir The directory to write the image to, if empty, the tempdir is used.
* @param force Force the image to be written, even if it already has been
* @return Whether the save was successful
*/
static bool writeImage(const QString& id, const KURL& targetDir, bool force=false);
static bool writeCachedImage(const QString& id, CacheDir dir, bool force = false);
/**
* Returns an image reference given its id. If none is found, a null image
* is returned.
*
* @param id The image id
* @return The image referencenter
*/
static const Data::Image& imageById(const QString& id);
static Data::ImageInfo imageInfo(const QString& id);
static void cacheImageInfo(const Data::ImageInfo& info);
// basically returns !imageById().isNull()
static bool validImage(const QString& id);
static QPixmap pixmap(const QString& id, int w, int h);
/**
* Clear the image cache and dict
* if deleteTempDirectory = true, then clean the temp dir and remove all temporary image files
*/
static void clean(bool deleteTempDirectory);
/**
* Creates the gradient images used in the entry view.
*/
static void createStyleImages(const StyleOptions& options = StyleOptions());
static void removeImage(const QString& id_, bool deleteImage);
static StringSet imagesNotInCache();
static void setLocalDirectory(const KURL& url);
// local save directory
static QString localDir();
private:
/**
* Add an image, reading it from a URL, which is the case when adding a new image from the
* @ref ImageWidget.
*
* @param url The URL of the image, anything KIO can handle
* @param quiet If any error should not be reported.
* @return The image
*/
static const Data::Image& addImageImpl(const KURL& url, bool quiet=false,
const KURL& referrer = KURL(), bool linkOnly = false);
/**
* Add an image, reading it from a regular QImage, which is the case when dragging and dropping
* an image in the @ref ImageWidget. The format has to be included, since the QImage doesn't
* 'know' what format it came from.
*
* @param image The qimage
* @param format The image format, probably "PNG"
* @return The image
*/
static const Data::Image& addImageImpl(const QImage& image, const QString& format);
/**
* Add an image, reading it from data, which is the case when reading from the data file. The
* @p id isn't strictly needed, since it can be reconstructed from the image data and format, but
* since it's already known, go ahead and use it.
*
* @param data The image data
* @param format The image format, from Qt's output format list
* @param id The internal id of the image
* @return The image
*/
static const Data::Image& addImageImpl(const QByteArray& data, const QString& format, const QString& id);
static const Data::Image& addCachedImageImpl(const QString& id, CacheDir dir);
static bool hasImage(const QString& id);
static void releaseImages();
static bool s_needInit;
static QDict<Data::Image> s_imageDict;
static QCache<Data::Image> s_imageCache;
static QCache<QPixmap> s_pixmapCache;
static QMap<QString, Data::ImageInfo> s_imageInfoMap;
static StringSet s_imagesInTmpDir; // the id's of the images written to tmp directory
static StringSet s_imagesToRelease;
static KTempDir* s_tmpDir;
static QString s_localDir;
static const Data::Image s_null;
};
} // end namespace
#endif
|
