MarbleGraphicsItem.h

// SPDX-License-Identifier: LGPL-2.1-or-later
//
// SPDX-FileCopyrightText: 2009 Bastian Holst <bastianholst@gmx.de>
//
 
#ifndef MARBLE_MARBLEGRAPHICSITEM_H
#define MARBLE_MARBLEGRAPHICSITEM_H
 
#include "marble_export.h"
 
#include <QtGlobal>
 
class QEvent;
class QObject;
class QPainter;
class QRectF;
class QSizeF;
class QPointF;
 
namespace Marble
{
 
class AbstractMarbleGraphicsLayout;
class ViewportParams;
 
class MarbleGraphicsItemPrivate;
 
class MARBLE_EXPORT MarbleGraphicsItem
{
public:
    enum CacheMode {
        NoCache,
        ItemCoordinateCache,
        DeviceCoordinateCache
    };
 
    virtual ~MarbleGraphicsItem();
 
    /**
     * Paints the item on the screen in view coordinates.
     * It is not safe to call this function from a thread other than the gui thread.
     */
    bool paintEvent(QPainter *painter, const ViewportParams *viewport);
 
    /**
     * Returns true if the Item contains @p point in parent coordinates.
     */
    bool contains(const QPointF &point) const;
 
    /**
     * Returns the layout of the MarbleGraphicsItem.
     */
    AbstractMarbleGraphicsLayout *layout() const;
 
    /**
     * Set the layout of the graphics item. The layout will now handle positions of added child
     * items. The MarbleGraphicsItem takes ownership of the layout.
     */
    void setLayout(AbstractMarbleGraphicsLayout *layout);
 
    /**
     * Returns the cache mode of the item
     */
    CacheMode cacheMode() const;
 
    /**
     * Set the cache mode of the item
     */
    void setCacheMode(CacheMode mode);
 
    /**
     * Returns if the item is visible.
     */
    bool visible() const;
 
    /**
     * Makes the item visible or invisible, depending on @p visible.
     */
    void setVisible(bool visible);
 
    /**
     * Hides the item. Equivalent to setVisible( false )
     */
    void hide();
 
    /**
     * Shows the item. Equivalent to setVisible( true )
     */
    void show();
 
    /**
     * Returns the size of the item
     */
    QSizeF size() const;
 
    /**
     * Set the size of the item
     */
    void setSize(const QSizeF &size);
 
    /**
     * Returns the size of the content of the MarbleGraphicsItem.
     * This is identical to size() for default MarbleGraphicsItems.
     */
    virtual QSizeF contentSize() const;
 
    /**
     * Set the size of the content of the item.
     */
    virtual void setContentSize(const QSizeF &size);
 
    /**
     * Returns the rect of the content in item coordinates.
     */
    virtual QRectF contentRect() const;
 
    virtual void setProjection(const ViewportParams *viewport);
 
protected:
    explicit MarbleGraphicsItem(MarbleGraphicsItemPrivate *dd);
 
    /**
     * Paints the item in item coordinates. This has to be reimplemented by the subclass
     * This function will be called by paintEvent().
     */
    virtual void paint(QPainter *painter);
 
    virtual bool eventFilter(QObject *object, QEvent *e);
 
    /**
     * Marks the item and all parent items as invalid. If caching is enabled, the next paintEvent()
     * will cause the cache to be recreated, such that the paintEvent()s after will be optimized.
     */
    void update();
 
protected:
    MarbleGraphicsItemPrivate *const d_ptr;
 
private:
    Q_DISABLE_COPY(MarbleGraphicsItem)
    Q_DECLARE_PRIVATE(MarbleGraphicsItem)
};
 
} // Namespace Marble
 
#endif