exiv2extractor.h

// SPDX-License-Identifier: LGPL-3.0-or-later
 
/*
    Copyright (C) 2012-15  Vishesh Handa <vhanda@kde.org>
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.
 
    This library 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
    Lesser General Public License for more details.
 
    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
*/
 
#pragma once
 
#include <exiv2/exiv2.hpp>
 
#include <QString>
#include <QVariant>
#include <QUrl>
 
#include "imagetools_export.h"
 
typedef QMap<QString, QString> MetaDataMap;
typedef QPair<double, double> Coordinates;
 
class City;
 
/**
 * @brief Image metadata extractor. 
 */
class IMAGETOOLS_EXPORT Exiv2Extractor : public QObject
{
public:
    Exiv2Extractor(const QUrl &url, QObject * parent = nullptr);
   explicit Exiv2Extractor(QObject * parent = nullptr);
    
    void setUrl(const QUrl &url);
    
    Coordinates extractGPS() const;
 
    bool error() const;
    
    QString getExifTagString (const char *exifTagName, bool escapeCR=true) const;
    QByteArray getExifTagData (const char *exifTagName) const;
    QVariant getExifTagVariant (const char *exifTagName, bool rationalAsListOfInts=true, bool escapeCR=true, int component=0) const;
    MetaDataMap getExifTagsDataList( const QStringList & exifKeysFilter = QStringList(), bool invertSelection = false ) const;
    QString getExifComment() const;
    
    bool writeTag(const char *tagName, const QVariant &value);
    bool removeTag(const char *tagName);
    
    QString GPSString() const;
    QString cityId() const;
    City city() const;
    
private:
    double fetchGpsDouble(const char *name) const;
 
    bool m_error;
    
    QUrl m_url;
       
    #if EXIV2_TEST_VERSION(0, 27, 99)
    Exiv2::Image::UniquePtr m_image;
    #else
    Exiv2::Image::AutoPtr m_image;
    #endif
 
    Exiv2::ExifData & exifData() const;
};