gpsitemcontainer.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2010-03-21
 * Description : A container to hold GPS information about an item.
 *
 * Copyright (C) 2010-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
 * Copyright (C) 2010-2014 by Michael G. Hansen <mike at mghansen dot de>
 *
 * 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 DIGIKAM_GPS_ITEM_CONTAINER_H
#define DIGIKAM_GPS_ITEM_CONTAINER_H
 
// Qt includes
 
#include <QVariant>
#include <QDateTime>
#include <QUrl>
 
// Local includes
 
#include "geoifacetypes.h"
#include "digikam_export.h"
#include "gpsdatacontainer.h"
#include "rginfo.h"
 
namespace Digikam
{
 
enum Type
{
    TypeChild    = 1,
    TypeSpacer   = 2,
    TypeNewChild = 4
};
 
typedef struct TagData
{
    TagData()
        : tagType(TypeChild)
    {
    }
 
    QString tagName;
    QString tipName;
    Type    tagType;
 
} TagData;
 
// --------------------------------------------------------------------------
 
class SaveProperties
{
public:
 
    explicit SaveProperties()
      : shouldRemoveCoordinates (false),
        shouldRemoveAltitude    (false),
        shouldWriteCoordinates  (false),
        shouldWriteAltitude     (false),
        altitude                (0.0),
        latitude                (0.0),
        longitude               (0.0)
    {
    }
 
    bool  shouldRemoveCoordinates;
    bool  shouldRemoveAltitude;
    bool  shouldWriteCoordinates;
    bool  shouldWriteAltitude;
    qreal altitude;
    qreal latitude;
    qreal longitude;
};
 
// --------------------------------------------------------------------------
 
class GPSItemModel;
class DMetadata;
 
class DIGIKAM_EXPORT GPSItemContainer
{
public:
 
    static const int RoleCoordinates             = Qt::UserRole + 1;
 
    static const int ColumnThumbnail             = 0;
    static const int ColumnFilename              = 1;
    static const int ColumnDateTime              = 2;
    static const int ColumnLatitude              = 3;
    static const int ColumnLongitude             = 4;
    static const int ColumnAltitude              = 5;
    static const int ColumnAccuracy              = 6;
    static const int ColumnTags                  = 7;
    static const int ColumnStatus                = 8;
    static const int ColumnDOP                   = 9;
    static const int ColumnFixType               = 10;
    static const int ColumnNSatellites           = 11;
    static const int ColumnSpeed                 = 12;
 
    static const int ColumnGPSItemContainerCount = 13;
 
public:
 
    explicit GPSItemContainer(const QUrl& url);
    virtual ~GPSItemContainer();
 
 
    virtual QString saveChanges();
    virtual bool loadImageData();
 
    bool isDirty()                                                              const;
    QUrl url()                                                                  const;
    QDateTime dateTime()                                                        const;
 
 
    static void setHeaderData(GPSItemModel* const model);
    bool lessThan(const GPSItemContainer* const otherItem, const int column)    const;
 
 
    void setCoordinates(const GeoCoordinates& newCoordinates);
    GeoCoordinates coordinates()                                                const;
    GPSDataContainer gpsData()                                                  const;
    void setGPSData(const GPSDataContainer& container);
    void restoreGPSData(const GPSDataContainer& container);
 
 
 
    void setTagList(const QList<QList<TagData> >& externalTagList);
 
    bool isTagListDirty()                                                       const;
 
    QList<QList<TagData> > getTagList()                                         const;
 
    void restoreRGTagList(const QList<QList<TagData> >& tagList);
 
    void writeTagsToXmp(const bool writeXmpTags) { m_writeXmpTags = writeXmpTags; }
 
protected:
 
    QVariant data(const int column, const int role)                             const;
    void setModel(GPSItemModel* const model);
    void emitDataChanged();
    DMetadata* getMetadataForFile()                                             const;
    SaveProperties saveProperties()                                             const;
 
protected:
 
    GPSItemModel*          m_model;
 
    QUrl                   m_url;
    QDateTime              m_dateTime;
 
    bool                   m_dirty;
    GPSDataContainer       m_gpsData;
    GPSDataContainer       m_savedState;
 
    bool                   m_tagListDirty;
    QList<QList<TagData> > m_tagList;
    QList<QList<TagData> > m_savedTagList;
    bool                   m_writeXmpTags;
 
    bool                   m_saveTags;
    bool                   m_saveGPS;
 
    friend class GPSItemModel;
 
private:
 
    Q_DISABLE_COPY(GPSItemContainer)
};
 
} // namespace Digikam
 
#endif // DIGIKAM_GPS_ITEM_CONTAINER_H