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
196
197
198
|
/* ============================================================
*
* This file is a part of digiKam project
* http://www.digikam.org
*
* Date : 2004-02-14
* Description : image data interface for image plugins
*
* Copyright (C) 2004-2005 by Renchi Raju <renchi@pooh.tam.uiuc.edu>
* Copyright (C) 2004-2009 by Gilles Caulier <caulier dot gilles at gmail dot com>
*
* 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 IMAGEIFACE_H
#define IMAGEIFACE_H
// TQt includes.
#include <tqglobal.h>
#include <tqstring.h>
// KDE includes.
#include <klocale.h>
// Local includes.
#include "dimg.h"
#include "dcolor.h"
#include "photoinfocontainer.h"
#include "digikam_export.h"
#define MAX3(a, b, c) (TQMAX(TQMAX(a,b),b))
#define MIN3(a, b, c) (TQMIN(TQMIN(a,b),b))
#define ROUND(x) ((int) ((x) + 0.5))
class TQPaintDevice;
namespace Digikam
{
class ImageIfacePriv;
class DIGIKAM_EXPORT ImageIface
{
public:
ImageIface(int w=0, int h=0);
~ImageIface();
/** Use this method to use the current selection in editor instead the full
image to render the preview.
*/
void setPreviewType(bool useSelect=false);
/** Return 'true' if the preview is rendered using the current selection in editor.
Return 'false' if the preview is rendered using the full image in editor.
*/
bool previewType();
/** Return image data for the current, scaled preview image.
The preview...() methods provide the characteristics of the data
(width, heigh, sixteen bit, alpha).
Ownership of the returned buffer is passed to the caller.
*/
uchar* getPreviewImage() const;
/** Return image data for the current original image selection.
The selectionWidth(), selectionHeight(), originalSixteenBit()
and originalHasAlpha() methods provide the characteristics of the data.
Ownership of the returned buffer is passed to the caller.
*/
uchar* getImageSelection() const;
/** Return image data for the original image.
The preview...() methods provide the characteristics of the data.
Ownership of the returned buffer is passed to the caller.
*/
uchar* getOriginalImage() const;
/** Return a pointer to the DImg object representing the original image.
This object may not be modified or stored. Make copies if you need.
*/
DImg* getOriginalImg() const;
/** Replace the image data of the original image with the given data.
The characteristics of the data must match the characteristics of
the original image as returned by the original...() methods,
respectively the given width and height parameters.
No ownership of the data pointer is assumed.
If w == -1 and h == -1, the size is unchanged.
Caller is an i18n'ed string that will be shown as the undo/redo action name.
*/
void putOriginalImage(const TQString &caller, uchar* data, int w=-1, int h=-1);
/** Embed the Color Profile we have used in ICC plugin when this option is
selected
*/
void setEmbeddedICCToOriginalImage(const TQString& profilePath);
/** Replace the data of the current original image selection with the given data.
The characteristics of the data must match the characteristics of the current
selection as returned by the selectionWidth(), selectionHeight(),
originalSixteenBit() and originalHasAlpha() methods.
No ownership of the data pointer is assumed.
Caller is an i18n'ed string that will be shown as the undo/redo action name.
*/
void putImageSelection(const TQString &caller, uchar* data);
/** Replace the stored target preview data with the given data.
The characteristics of the data must match the characteristics of the current
as returned by the preview...() methods.
The target preview data is used by the paint() and
getColorInfoFromTargetPreviewImage() methods.
The data returned by getPreviewImage() is unaffected.
No ownership of the data pointer is assumed.
*/
void putPreviewImage(uchar* data);
/** Get colors from original, (unchanged) preview
or target preview (set by putPreviewImage) image.
*/
DColor getColorInfoFromOriginalImage(const TQPoint& point);
DColor getColorInfoFromPreviewImage(const TQPoint& point);
DColor getColorInfoFromTargetPreviewImage(const TQPoint& point);
/** Original image information.*/
int originalWidth();
int originalHeight();
bool originalSixteenBit();
bool originalHasAlpha();
/** Original image metadata.*/
TQByteArray getEmbeddedICCFromOriginalImage();
TQByteArray getExifFromOriginalImage();
TQByteArray getIptcFromOriginalImage();
/** Get photograph information from original image.*/
PhotoInfoContainer getPhotographInformations() const;
/** Standard methods to get/set preview information.*/
int previewWidth();
int previewHeight();
bool previewHasAlpha();
bool previewSixteenBit();
/** Sets preview size and returns new preview data as with getPreviewImage.
The parameters are only hints, previewWidth() and previewHeight()
may differ from w and h.
*/
uchar* setPreviewImageSize(int w, int h) const;
/** Standard methods to get image selection information.*/
int selectedWidth();
int selectedHeight();
/** Get selected (X, Y) position on the top/left corner of the original image.*/
int selectedXOrg();
int selectedYOrg();
/** Set BCG correction for preview and original image */
void setPreviewBCG(double brightness, double contrast, double gamma);
void setOriginalBCG(double brightness, double contrast, double gamma);
/** Convert depth of original image */
void convertOriginalColorDepth(int depth);
/** Convert a DImg image to a pixmap for screen using color
managemed view if necessary */
TQPixmap convertToPixmap(DImg& img);
/** Paint the current target preview image (or the preview image,
if putPreviewImage has not been called) on the given paint device.
at x|y, with given maximum width and height.
*/
void paint(TQPaintDevice* device, int x, int y, int w, int h,
bool underExposure=false, bool overExposure=false);
private:
ImageIfacePriv* d;
};
} // namespace Digikam
#endif /* IMAGEIFACE_H */
|
