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 | /* ============================================================
*
* This file is a part of digiKam project
* https://www.digikam.org
*
* Date : 2006-01-16
* Description : image file IO threaded interface.
*
* SPDX-FileCopyrightText: 2006-2011 by Marcel Wiesweg <marcel dot wiesweg at gmx dot de>
*
* SPDX-License-Identifier: GPL-2.0-or-later
*
* ============================================================ */
#ifndef DIGIKAM_PREVIEW_LOAD_THREAD_H
#define DIGIKAM_PREVIEW_LOAD_THREAD_H
// Local includes
#include "managedloadsavethread.h"
#include "previewsettings.h"
namespace Digikam
{
class DIGIKAM_EXPORT PreviewLoadThread : public ManagedLoadSaveThread
{
Q_OBJECT
public:
/**
* Creates a preview load thread.
* Provides three flavors of preview loading.
* The default loading policy, for the typical usage in a preview widget,
* always stops any previous tasks and loads the new task as soon as possible.
*/
explicit PreviewLoadThread(QObject* const parent = nullptr);
~PreviewLoadThread() override = default;
/**
* Load a preview that is optimized for fast loading.
* Raw decoding and color management settings will be adjusted.
*/
void loadFast(const QString& filePath, int size);
/**
* Load a preview that is as large as possible without sacrificing speed
* for performance. Especially, raw previews are taken if larger than the given size.
* Raw decoding and color management settings will be adjusted.
*/
void loadFastButLarge(const QString& filePath, int minimumSize);
/**
* Load a preview with higher resolution, trading more quality
* for less speed.
* Raw decoding and color management settings will be adjusted.
*/
void loadHighQuality(const QString& filePath,
PreviewSettings::RawLoading rawLoadingMode = PreviewSettings::RawPreviewAutomatic);
/**
* Load a preview.
* Settings determine the loading mode.
* For fast loading, size is preview area size.
* For fast-but-large loading, it serves as a minimum size.
* For high quality loading, it is ignored
*/
void load(const QString& filePath, const PreviewSettings& settings, int size = 0);
/**
* Load a preview. Loading description will not be touched.
*/
void load(const LoadingDescription& description);<--- Derived function 'PreviewLoadThread::load'<--- Derived function 'PreviewLoadThread::load'
/**
* Optionally, set the displaying widget for color management
*/
void setDisplayingWidget(QWidget* const widget);
/**
* Synchronous versions of the above methods.
* These are safe to call from the non-UI thread, as the IccProfile either passed or deduced independent from a displaying widget
*/
static DImg loadFastSynchronously(const QString& filePath,
int size,
const IccProfile& profile = IccProfile());
static DImg loadFastButLargeSynchronously(const QString& filePath,
int minimumSize,
const IccProfile& profile = IccProfile());
static DImg loadHighQualitySynchronously(const QString& filePath,
PreviewSettings::RawLoading rawLoadingMode = PreviewSettings::RawPreviewAutomatic,
const IccProfile& profile = IccProfile());
static DImg loadSynchronously(const QString& filePath,
const PreviewSettings& previewSettings,
int size,
const IccProfile& profile = IccProfile());
static DImg loadSynchronously(const LoadingDescription& description);
protected:
static LoadingDescription createLoadingDescription(const QString& filePath,
const PreviewSettings& settings,
int size,
const IccProfile& profile);
LoadingDescription createLoadingDescription(const QString& filePath,
const PreviewSettings& settings,
int size);
protected:
QWidget* m_displayingWidget = nullptr;
private:
// Disable
PreviewLoadThread(const PreviewLoadThread&) = delete;
PreviewLoadThread& operator=(const PreviewLoadThread&) = delete;
};
} // namespace Digikam
#endif // DIGIKAM_PREVIEW_LOAD_THREAD_H
|