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
|
// *****************************************************************************
/*
* Copyright (C) 2006 Olivier Tilloy <olivier@tilloy.net>
*
* This file is part of the pyexiv2 distribution.
*
* pyexiv2 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.
*
* pyexiv2 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 pyexiv2; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, 5th Floor, Boston, MA 02110-1301 USA.
*/
/*
File: libpyexiv2.hpp
Author(s): Olivier Tilloy <olivier@tilloy.net>
*/
// *****************************************************************************
#ifndef __libpyexiv2_wrapper__
#define __libpyexiv2_wrapper__
#include <string>
#include "exiv2/image.hpp"
#include "exiv2/exif.hpp"
#include "exiv2/iptc.hpp"
#include <boost/python.hpp>
namespace LibPyExiv2
{
class Image
{
public:
// Constructors
Image(std::string filename);
Image(const Image & image);
void readMetadata();
void writeMetadata();
// Read and write access to the EXIF tags.
// For a complete list of the available EXIF tags, see
// libexiv2's documentation (http://exiv2.org/tags.html).
// Returns a list of all the keys of available EXIF tags set in the
// image.
boost::python::list getAvailableExifTags();
// Return true if the required EXIF tag is set, false otherwise.
bool isExifTagSet(std::string key);
// Returns a tuple containing the type (as a string) and the value
// (as a string as well) of the required EXIF tag, empty strings if
// the tag does not exist.
boost::python::tuple getExifTag(std::string key);
// Returns a human-readable string containing the value of the
// required EXIF tag, empty if the tag does not exist.
std::string getExifTagToString(std::string key);
// Sets the EXIF tag's value and returns a tuple containing the
// type and previous value of the tag. If the tag was not set
// before, it is created.
boost::python::tuple setExifTag(std::string key, std::string value);
// Deletes the required EXIF tag and returns a tuple containing the
// type and previous value if it existed, empty strings otherwise.
boost::python::tuple deleteExifTag(std::string key);
// Read and write access to the IPTC tags.
// For a complete list of the available IPTC tags, see
// libexiv2's documentation (http://exiv2.org/iptc.html).
// Returns a list of all the keys of available IPTC tags set in the
// image.
boost::python::list getAvailableIptcTags();
// Return true if the required IPTC tag is set, false otherwise.
bool isIptcTagSet(std::string key);
// Returns a tuple containing the type (as a string) and the value
// (as a string as well) of the required IPTC tag, empty strings if
// the tag does not exist.
boost::python::tuple getIptcTag(std::string key);
// Sets the IPTC tag's value and returns a tuple containing the
// type and previous value of the tag. If the tag was not set
// before, it is created.
boost::python::tuple setIptcTag(std::string key, std::string value);
// Deletes the required IPTC tag and returns a tuple containing the
// type and previous value if it existed, empty strings otherwise.
boost::python::tuple deleteIptcTag(std::string key);
// Read and write access to the thumbnail embedded in the image.
// Returns a tuple containing the format of the thumbnail ("TIFF" or
// "JPEG") and the thumbnail raw data as a string buffer.
boost::python::tuple getThumbnailData();
// Sets the thumbnail of the image. The parameter is the thumbnail raw
// jpeg data as a string buffer.
void setThumbnailData(std::string data);
// Deletes the thumbnail embedded in the image.
void deleteThumbnail();
// Writes the thumbnail to an image file.
// A filename extension is appended to the given path according to the
// image type of the thumbnail, so it should not include an extension.
void dumpThumbnailToFile(const std::string path);
// Sets the image contained in the jpeg file passed as a parameter as
// the thumbnail of the image.
void setThumbnailFromJpegFile(const std::string path);
private:
std::string _filename;
Exiv2::Image::AutoPtr _image;
Exiv2::ExifData _exifData;
Exiv2::IptcData _iptcData;
// true if the image's internal metadata has already been read,
// false otherwise
bool _dataRead;
};
// Translate an Exiv2 generic exception into a Python exception
void translateExiv2Error(Exiv2::Error const& e);
} // End of namespace LibPyExiv2
#endif
|
