#include <exif.hpp>
Collaboration diagram for Exiv2::ExifData:
Public Types | |
typedef ExifMetadata::iterator | iterator |
ExifMetadata iterator type. | |
typedef ExifMetadata::const_iterator | const_iterator |
ExifMetadata const iterator type. | |
Public Member Functions | |
Creators | |
ExifData () | |
Default constructor. | |
ExifData (const ExifData &rhs) | |
Copy constructor (Todo: copy image data also). | |
~ExifData () | |
Destructor. | |
Manipulators | |
ExifData & | operator= (const ExifData &rhs) |
Assignment operator (Todo: assign image data also). | |
int | load (const byte *buf, long len) |
Load the Exif data from a byte buffer. The data buffer must start with the TIFF header. This method is deprecated. Use ImageFactory::open() instead. | |
DataBuf | copy () |
Write the Exif data to a data buffer, which is returned. The caller owns this copy and DataBuf ensures that it will be deleted. The copied data starts with the TIFF header. | |
Exifdatum & | operator[] (const std::string &key) |
Returns a reference to the Exifdatum that is associated with a particular key. If ExifData does not already contain such an Exifdatum, operator[] adds object Exifdatum(key). | |
void | add (Entries::const_iterator begin, Entries::const_iterator end, ByteOrder byteOrder) |
Add all (IFD) entries in the range from iterator position begin to iterator position end to the Exif metadata. No duplicate checks are performed, i.e., it is possible to add multiple metadata with the same key. | |
void | add (const ExifKey &key, const Value *pValue) |
Add an Exifdatum from the supplied key and value pair. This method copies (clones) key and value. No duplicate checks are performed, i.e., it is possible to add multiple metadata with the same key. | |
void | add (const Exifdatum &exifdatum) |
Add a copy of the exifdatum to the Exif metadata. No duplicate checks are performed, i.e., it is possible to add multiple metadata with the same key. | |
iterator | erase (iterator pos) |
Delete the Exifdatum at iterator position pos, return the position of the next exifdatum. Note that iterators into the metadata, including pos, are potentially invalidated by this call. | |
void | clear () |
Delete all Exifdatum instances resulting in an empty container. Note that this also removes thumbnails. | |
void | sortByKey () |
Sort metadata by key. | |
void | sortByTag () |
Sort metadata by tag. | |
iterator | begin () |
Begin of the metadata. | |
iterator | end () |
End of the metadata. | |
iterator | findKey (const ExifKey &key) |
Find a Exifdatum with the given key, return an iterator to it. If multiple metadata with the same key exist, it is undefined which of the matching metadata is found. | |
iterator | findIfdIdIdx (IfdId ifdId, int idx) |
Find the Exifdatum with the given ifdId and idx, return an iterator to it. | |
void | setJpegThumbnail (const std::string &path, URational xres, URational yres, uint16_t unit) |
Set the Exif thumbnail to the Jpeg image path. Set XResolution, YResolution and ResolutionUnit to xres, yres and unit, respectively. | |
void | setJpegThumbnail (const byte *buf, long size, URational xres, URational yres, uint16_t unit) |
Set the Exif thumbnail to the Jpeg image pointed to by buf, and size size. Set XResolution, YResolution and ResolutionUnit to xres, yres and unit, respectively. | |
void | setJpegThumbnail (const std::string &path) |
Set the Exif thumbnail to the Jpeg image path. | |
void | setJpegThumbnail (const byte *buf, long size) |
Set the Exif thumbnail to the Jpeg image pointed to by buf, and size size. | |
long | eraseThumbnail () |
Delete the thumbnail from the Exif data. Removes all Exif.Thumbnail.*, i.e., IFD1 metadata. | |
Accessors | |
const_iterator | begin () const |
Begin of the metadata. | |
const_iterator | end () const |
End of the metadata. | |
const_iterator | findKey (const ExifKey &key) const |
Find an exifdatum with the given key, return a const iterator to it. If multiple metadata with the same key exist, it is undefined which of the matching metadata is found. | |
const_iterator | findIfdIdIdx (IfdId ifdId, int idx) const |
Find the exifdatum with the given ifdId and idx, return an iterator to it. | |
bool | empty () const |
Return true if there is no Exif metadata. | |
long | count () const |
Get the number of metadata entries. | |
ByteOrder | byteOrder () const |
Returns the byte order. Default is little endian. | |
int | writeThumbnail (const std::string &path) const |
Write the thumbnail image to a file. A filename extension is appended to path according to the image type of the thumbnail, so path should not include an extension. This will overwrite an existing file of the same name. | |
DataBuf | copyThumbnail () const |
Return the thumbnail image in a DataBuf. The caller owns the data buffer and DataBuf ensures that it will be deleted. | |
const char * | thumbnailFormat () const |
Return a short string describing the format of the Exif thumbnail ("TIFF", "JPEG"). | |
const char * | thumbnailExtension () const |
Return the file extension for the Exif thumbnail depending on the format (".tif", ".jpg"). | |
Thumbnail::AutoPtr | getThumbnail () const |
Return a thumbnail object of the correct type, corresponding to the current Exif data. Caller owns this object and the auto pointer ensures that it will be deleted. |
Provide high-level access to the Exif data of an image:
|
Add a copy of the exifdatum to the Exif metadata. No duplicate checks are performed, i.e., it is possible to add multiple metadata with the same key.
|
|
Write the Exif data to a data buffer, which is returned. The caller owns this copy and DataBuf ensures that it will be deleted. The copied data starts with the TIFF header.
Tries to update the original data buffer and write it back with minimal changes, in a 'non-intrusive' fashion, if possible. In this case, tag data that ExifData does not understand stand a good chance to remain valid. (In particular, if the Exif data contains a Makernote in IFD format, the offsets in its IFD will remain valid.)
|
|
Delete the thumbnail from the Exif data. Removes all Exif.Thumbnail.*, i.e., IFD1 metadata.
|
|
Find the exifdatum with the given ifdId and idx, return an iterator to it. This method can be used to uniquely identify a Exifdatum that was created from an IFD or from the makernote (with idx greater than 0). Metadata created by an application (not read from an IFD or a makernote) all have their idx field set to 0, i.e., they cannot be uniquely identified with this method. If multiple metadata with the same key exist, it is undefined which of the matching metadata is found. |
|
Find the Exifdatum with the given ifdId and idx, return an iterator to it. This method can be used to uniquely identify an exifdatum that was created from an IFD or from the makernote (with idx greater than 0). Metadata created by an application (not read from an IFD or a makernote) all have their idx field set to 0, i.e., they cannot be uniquely identified with this method. If multiple metadata with the same key exist, it is undefined which of the matching metadata is found. |
|
Load the Exif data from a byte buffer. The data buffer must start with the TIFF header. This method is deprecated. Use ImageFactory::open() instead.
|
|
Returns a reference to the Exifdatum that is associated with a particular key. If ExifData does not already contain such an Exifdatum, operator[] adds object Exifdatum(key).
|
|
Set the Exif thumbnail to the Jpeg image pointed to by buf, and size size. This sets only the Compression, JPEGInterchangeFormat and JPEGInterchangeFormatLength tags, which is not all the thumbnail Exif information mandatory according to the Exif standard. (But it's enough to work with the thumbnail.)
|
|
Set the Exif thumbnail to the Jpeg image path. This sets only the Compression, JPEGInterchangeFormat and JPEGInterchangeFormatLength tags, which is not all the thumbnail Exif information mandatory according to the Exif standard. (But it's enough to work with the thumbnail.)
|
|
Set the Exif thumbnail to the Jpeg image pointed to by buf, and size size. Set XResolution, YResolution and ResolutionUnit to xres, yres and unit, respectively. This results in the minimal thumbnail tags being set for a Jpeg thumbnail, as mandated by the Exif standard.
|
|
Set the Exif thumbnail to the Jpeg image path. Set XResolution, YResolution and ResolutionUnit to xres, yres and unit, respectively. This results in the minimal thumbnail tags being set for a Jpeg thumbnail, as mandated by the Exif standard.
|
|
Write the thumbnail image to a file. A filename extension is appended to path according to the image type of the thumbnail, so path should not include an extension. This will overwrite an existing file of the same name.
|