/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2009-12-01
 * Description : Base-class for backends for geolocation interface
 *
 * SPDX-FileCopyrightText: 2010-2026 by Gilles Caulier <caulier dot gilles at gmail dot com>
 * SPDX-FileCopyrightText: 2009-2011 by Michael G. Hansen <mike at mghansen dot de>
 * SPDX-FileCopyrightText: 2014      by Justus Schwartz <justus at gmx dot li>
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 *
 * ============================================================ */

#pragma once

// Qt includes

#include <QModelIndex>

// Local includes

#include "geoifacecommon.h"
#include "digikam_export.h"

class QMenu;
class QWidget;

class KConfigGroup;

#ifdef HAVE_GEOLOCATION

namespace Marble
{
    class GeoDataLatLonBox;
}

#endif

namespace Digikam
{

class DIGIKAM_EXPORT MapBackend : public QObject
{

Q_OBJECT

public:

    explicit MapBackend(const QExplicitlySharedDataPointer<GeoIfaceSharedData>& sharedData, QObject* const parent);
    ~MapBackend() override = default;

    virtual QString backendName()                                           const = 0;
    virtual QString backendHumanName()                                      const = 0;
    virtual QWidget* mapWidget()                                                  = 0;
    virtual void releaseWidget(GeoIfaceInternalWidgetInfo* const info)            = 0;
    virtual void mapWidgetDocked(const bool state)                                = 0;

    virtual GeoCoordinates getCenter()                                      const = 0;
    virtual void setCenter(const GeoCoordinates& coordinate)                      = 0;

    virtual bool isReady()                                                  const = 0;

    virtual void zoomIn()                                                         = 0;
    virtual void zoomOut()                                                        = 0;

    virtual void saveSettingsToGroup(KConfigGroup* const group)                   = 0;
    virtual void readSettingsFromGroup(const KConfigGroup* const group)           = 0;

    virtual void addActionsToConfigurationMenu(QMenu* const configurationMenu)    = 0;

    virtual void updateMarkers()                                                  = 0;
    virtual void updateClusters()                                                 = 0;

    virtual bool screenCoordinates(const GeoCoordinates& coordinates,
                                   QPoint* const point)                           = 0;
    virtual bool geoCoordinates(const QPoint& point,
                                GeoCoordinates* const coordinates)          const = 0;
    virtual QSize mapSize()                                                 const = 0;

    virtual void setZoom(const QString& newZoom)                                  = 0;
    virtual QString getZoom()                                               const = 0;

    virtual int getMarkerModelLevel()                                             = 0;
    virtual GeoCoordinates::PairList getNormalizedBounds()                        = 0;
/*
    virtual void updateDragDropMarker(const QPoint& pos,
                                      const GeoIfaceDragData* const dragData)     = 0;
    virtual void updateDragDropMarkerPosition(const QPoint& pos)                  = 0;
*/
    virtual void updateActionAvailability()                                       = 0;

    virtual void regionSelectionChanged()                                         = 0;
    virtual void mouseModeChanged()                                               = 0;

    const QExplicitlySharedDataPointer<GeoIfaceSharedData> s;

    virtual void setActive(const bool state)                                      = 0;

#ifdef HAVE_GEOLOCATION

    virtual void centerOn(const Marble::GeoDataLatLonBox& box,
                          const bool useSaneZoomLevel = true)                     = 0;

#endif

    virtual void reload()                                                         = 0;

public Q_SLOTS:

    virtual void slotClustersNeedUpdating()                                       = 0;
    virtual void slotThumbnailAvailableForIndex(const QVariant& index,
                                                const QPixmap& pixmap);
    virtual void slotTrackManagerChanged();

protected:

    void addCommonOptions(QMenu* const configurationMenu);

protected Q_SLOTS:

    void slotExportScreenshot();

Q_SIGNALS:

    void signalBackendReadyChanged(const QString& backendName);
    void signalClustersMoved(const QIntList& clusterIndices,
                             const QPair<int, QModelIndex>& snapTarget);
    void signalClustersClicked(const QIntList& clusterIndices);
    void signalMarkersMoved(const QIntList& markerIndices);
    void signalZoomChanged(const QString& newZoom);
    void signalSelectionHasBeenMade(const Digikam::GeoCoordinates::Pair& coordinates);
};

} // namespace Digikam
