// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2009 Andrew Manson <g.real.ate@gmail.com>
// SPDX-FileCopyrightText: 2013 Thibaut Gridel <tgridel@free.fr>
// SPDX-FileCopyrightText: 2014 Calin Cruceru <crucerucalincristian@gmail.com>
//

#ifndef SCENEGRAPHICSITEM_H
#define SCENEGRAPHICSITEM_H

#include <QMouseEvent>

#include "GeoGraphicsItem.h"


namespace Marble
{

class GeoDataPlacemark;
class GeoDataCoordinates;

/**
 * @brief This is the base class for all scene graphics included within the
 * annotate plugin. It is not instantiated by itself but it is always used
 * as a part of a derived object.
 */
class SceneGraphicsItem : public GeoGraphicsItem
{
public:
    explicit SceneGraphicsItem( GeoDataPlacemark *placemark );
    ~SceneGraphicsItem() override;

    enum ActionState {
        // General action states
        Editing,

        // Polygon specific
        DrawingPolygon,
        AddingPolygonHole,

        // Polygon/Placemark specific
        MergingNodes,
        AddingNodes,

        // Polyline specific
        DrawingPolyline
    };

    /**
     * @brief Some events may lead to particular requests to the widget, so it is the
     * AnnotatePlugin which has to test whether there is any request from this polygon.
     */
    enum MarbleWidgetRequest {
        NoRequest,

        // Polygon specific
        OuterInnerMergingWarning,
        InnerInnerMergingWarning,
        InvalidShapeWarning,
        ShowPolygonRmbMenu,
        ShowNodeRmbMenu,
        StartPolygonAnimation,
        RemovePolygonRequest,
        ChangeCursorPolygonNodeHover,
        ChangeCursorPolygonBodyHover,

        // Placemark specific
        ShowPlacemarkRmbMenu,
        ChangeCursorPlacemarkHover,

        // Polyline specific
        RemovePolylineRequest,
        ShowPolylineRmbMenu,
        StartPolylineAnimation,
        ChangeCursorPolylineNodeHover,
        ChangeCursorPolylineLineHover,

        // GroundOverlay specific
        ChangeCursorOverlayVerticalHover,
        ChangeCursorOverlayHorizontalHover,
        ChangeCursorOverlayBDiagHover,
        ChangeCursorOverlayFDiagHover,
        ChangeCursorOverlayBodyHover,
        ChangeCursorOverlayRotateHover
    };

    /**
     * @copydoc
     */
    const GeoDataLatLonAltBox &latLonAltBox() const override;

    /**
     * @brief Pure virtual method which is implemented by concrete scene graphic items
     * and returns true if the item contains the @p eventPos.
     */
    virtual bool containsPoint( const QPoint &eventPos ) const = 0;

    /**
     * @brief Pure virtual method which is implemented by concrete scene graphic items
     * and deals with changes that occur when this item is no longer the item we interact
     * with (by means of mouse events - so far).
     */
    virtual void dealWithItemChange( const SceneGraphicsItem *other ) = 0;

    /**
     * @brief Pure virtual method which is implemented by concrete scene graphic items
     * and deals with moving it from the @param source coordinates to the @param
     * destination coordinates.
     * FIXME: Maybe move this to the model classes since the classes derived from this
     * abstract class should only deal with painting and event handling.
     */
    virtual void move( const GeoDataCoordinates &source, const GeoDataCoordinates &destination ) = 0;

    /**
     * @brief Returns the current state.
     */
    ActionState state() const;

    /**
     * @brief Sets the ActionState of this item. This also calls dealWithStateChange() with
     * a parameter: the previous state.
     */
    void setState( ActionState state );

    /**
     * @brief Returns whether this item has the focus or not.
     */
    bool hasFocus() const;

    /**
     * @brief Sets the focus of this item according to the @p enabled.
     *
     * @param enabled whether the item is to be focused
     */
    void setFocus( bool enabled );

    /**
     * @brief Returns the widget request.
     */
    MarbleWidgetRequest request() const;

    /**
     * @brief SceneGraphicItem class, when called from one of its derived classes'
     * constructors, takes as a parameter a pointer to the placemark of the graphic
     * element.
     * @return The pointer to the placemark mentioned above.
     */
    const GeoDataPlacemark *placemark() const;

    GeoDataPlacemark *placemark();

    /**
     * @brief This function is used to call the event distributer and makes use of
     * the re-implemented virtual functions which handle the mouse events.
     */
    bool sceneEvent( QEvent *event );

    /**
     * @brief It is used for downcasting a SceneGraphicItem. It returns a const char
     * which is the name of the element's class and is defined within the
     * SceneGraphicsTypes namespace.
     */
    virtual const char *graphicType() const = 0;

protected:
    /**
     * @brief Pure virtual functions which handle the mouse events, all of which are
     * re-implemented in every SceneGraphicItem derived classes.
     */
    virtual bool mousePressEvent( QMouseEvent *event ) = 0;
    virtual bool mouseMoveEvent( QMouseEvent *event ) = 0;
    virtual bool mouseReleaseEvent( QMouseEvent *event ) = 0;

    virtual void dealWithStateChange( SceneGraphicsItem::ActionState previousState ) = 0;

    /**
     * @brief Sets the widget request.
     */
    void setRequest( MarbleWidgetRequest request );

private:
    ActionState         m_state;
    bool                m_hasFocus;
    MarbleWidgetRequest m_request;
    GeoDataPlacemark   *m_placemark;
};

}

#endif // SCENEGRAPHICSITEM_H
