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
|
/* ============================================================
*
* This file is a part of digiKam project
* http://www.digikam.org
*
* Date : 2006-01-16
* Description : image file IO threaded interface.
*
* Copyright (C) 2006-2007 by Marcel Wiesweg <marcel.wiesweg@gmx.de>
*
* 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, 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.
*
* ============================================================ */
#ifndef LOADING_DESCRIPTION_H
#define LOADING_DESCRIPTION_H
// Digikam includes.
#include "dimg.h"
#include "digikam_export.h"
namespace Digikam
{
class DIGIKAM_EXPORT LoadingDescription
{
public:
class PreviewParameters
{
public:
PreviewParameters()
{
isPreview = false;
size = 0;
exifRotate = false;
}
bool isPreview;
int size;
bool exifRotate;
bool operator==(const PreviewParameters &other) const;
};
/**
* An invalid LoadingDescription
*/
LoadingDescription()
{
}
/**
* Use this for files that are not raw files.
* Stores only the filePath.
*/
LoadingDescription(const QString &filePath);
/**
* For raw files:
* Stores filePath and RawDecodingSettings
*/
LoadingDescription(const QString &filePath, DRawDecoding settings);
/**
* For preview jobs:
* Stores preview max size and exif rotation.
* Exif Rotation:
* The exif rotation is only a hint.
* Call LoadSaveThread::exifRotate to make sure that the image is really
* rotated. It is safe to call this method even if the image is rotated.
* Raw files:
* If size is not 0, the embedded preview will be loaded if available.
* If size is 0, DImg based loading will be used with default raw decoding settings.
*/
LoadingDescription(const QString &filePath, int size, bool exifRotate);
QString filePath;
DRawDecoding rawDecodingSettings;
PreviewParameters previewParameters;
/**
* Return the cache key this description shall be stored as
*/
QString cacheKey() const;
/**
* Return all possible cache keys, starting with the best choice,
* for which a result may be found in the cache for this description.
* Included in the list are better quality versions, if this description is reduced.
*/
QStringList lookupCacheKeys() const;
/**
* Returns whether this description describes a loading operation which
* loads the image in a reduced version (quality, size etc.)
*/
bool isReducedVersion() const;
/**
* Returns whether the other loading task equals this one
*/
bool operator==(const LoadingDescription &other) const;
bool operator!=(const LoadingDescription &other) const
{ return !operator==(other); }
/**
* Returns whether the other loading task equals this one
* ignoring parameters used to specify a reduced version.
*/
bool equalsIgnoreReducedVersion(const LoadingDescription &other) const;
/**
* Returns whether this loading task equals the other one
* or is superior to it, if the other one is a reduced version
*/
bool equalsOrBetterThan(const LoadingDescription &other) const;
/**
* Returns all possible cacheKeys for the given file path
* (all cache keys under which the given file could be stored in the cache).
*/
static QStringList possibleCacheKeys(const QString &filePath);
};
} // namespace Digikam
#endif // LOADING_DESCRIPTION_H
|