dpreviewimage.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2009-12-13
 * Description : a widget to preview image effect.
 *
 * Copyright (C) 2009-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
 * Copyright (C) 2008      by Kare Sars <kare dot sars at iki dot fi>
 * Copyright (C) 2012      by Benjamin Girault <benjamin dot girault at gmail dot com>
 *
 * 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_DPREVIEW_IMAGE_H
#define DIGIKAM_DPREVIEW_IMAGE_H
 
// Qt includes
 
#include <QGraphicsView>
#include <QGraphicsPixmapItem>
#include <QString>
#include <QColor>
 
// Local includes
 
#include "digikam_export.h"
 
class QResizeEvent;
class QWheelEvent;
class QMouseEvent;
class QEvent;
 
namespace Digikam
{
 
class DIGIKAM_EXPORT DSelectionItem : public QGraphicsItem
{
public:
 
    typedef enum
    {
        None,
        Top,
        TopRight,
        Right,
        BottomRight,
        Bottom,
        BottomLeft,
        Left,
        TopLeft,
        Move
    } Intersects;
 
public:
 
    explicit DSelectionItem(const QRectF& rect);
    ~DSelectionItem() override;
 
public:
 
    void setMaxRight(qreal maxRight);
    void setMaxBottom(qreal maxBottom);
 
    Intersects intersects(QPointF& point);
 
    void saveZoom(qreal zoom);
 
    void    setRect(const QRectF& rect);
    QRectF  rect()                                      const;
    QPointF fixTranslation(QPointF dp)                  const;
 
public:
 
    // Graphics Item methods
    QRectF boundingRect() const                               override;
    void paint(QPainter* painter,
               const QStyleOptionGraphicsItem* option,
               QWidget* widget)                               override;
 
private:
 
    void updateAnchors();
 
private:
 
    class Private;
    Private* const d;
};
 
// -----------------------------------------------------------------------------------------
 
class DIGIKAM_EXPORT DPreviewImage : public QGraphicsView
{
    Q_OBJECT
 
public:
 
    explicit DPreviewImage(QWidget* const parent);
    ~DPreviewImage() override;
 
public:
 
    bool load(const QUrl& file)         const;
    bool setImage(const QImage& img)    const;
    void enableSelectionArea(bool b);
 
    void   setSelectionArea(const QRectF& rectangle);
    QRectF getSelectionArea()           const;
 
public Q_SLOTS:
 
    void slotZoomIn();
    void slotZoomOut();
//  void slotZoomSel();      // TODO: add a button for that purpose
    void slotZoom2Fit();
 
    void slotSetTLX(float ratio);
    void slotSetTLY(float ratio);
    void slotSetBRX(float ratio);
    void slotSetBRY(float ratio);
 
    void slotSetSelection(float tl_x, float tl_y, float br_x, float br_y);
    void slotClearActiveSelection();
 
    void slotSetHighlightArea(float tl_x, float tl_y, float br_x, float br_y);
 
    void slotSetHighlightShown(int percentage, const QColor& highLightColor = Qt::white);
 
    void slotClearHighlight();
 
protected:
 
    void wheelEvent(QWheelEvent*)           override;
    void mousePressEvent(QMouseEvent*)      override;
    void mouseReleaseEvent(QMouseEvent*)    override;
    void mouseMoveEvent(QMouseEvent*)       override;
    void leaveEvent(QEvent*)                override;
    bool eventFilter(QObject*, QEvent*)     override;
    void resizeEvent(QResizeEvent*)         override;
 
#if (QT_VERSION > QT_VERSION_CHECK(5, 99, 0))
    void enterEvent(QEnterEvent*)          override;
#else
    void enterEvent(QEvent*)               override;
#endif
 
    void updateSelVisibility();
    void updateHighlight();
 
private:
 
    class Private;
    Private* const d;
};
 
} // namespace Digikam
 
#endif // DIGIKAM_DPREVIEW_IMAGE_H