File indexing completed on 2025-01-05 03:59:44

 /* ============================================================
  *
  * This file is a part of digiKam project
  * https://www.digikam.org
  *
  * Date        : 2013-07-15
  * Description : a widget to draw an image clip region.
  *
  * SPDX-FileCopyrightText: 2013-2014 by Yiou Wang <geow812 at gmail dot com>
  * SPDX-FileCopyrightText: 2010-2012 by Marcel Wiesweg <marcel dot wiesweg at gmx dot de>
  * SPDX-FileCopyrightText: 2011-2024 by Gilles Caulier <caulier dot gilles at gmail dot com>
  *
  * SPDX-License-Identifier: GPL-2.0-or-later
  *
  * ============================================================ */
 
 #ifndef DIGIKAM_IMAGE_REGION_WIDGET_H
 #define DIGIKAM_IMAGE_REGION_WIDGET_H
 
 // Qt includes
 
 #include <QPoint>
 #include <QRect>
 #include <QEvent>
 #include <QPolygon>
 #include <QPixmap>
 #include <QResizeEvent>
 #include <QWheelEvent>
 
 // Local includes
 
 #include "dimg.h"
 #include "graphicsdimgview.h"
 #include "imagezoomsettings.h"
 #include "digikam_export.h"
 
 namespace Digikam
 {
 
 class DIGIKAM_EXPORT ImageRegionWidget : public GraphicsDImgView
 {
     Q_OBJECT
 
 public:
 
     explicit ImageRegionWidget(QWidget* const parent = nullptr, bool paintExtras = true);
     ~ImageRegionWidget() override;
 
     /**
      * To get target image region area to render.
      */
     QRect  getOriginalImageRegionToRender() const;
 
     /**
      * To get target image region image to use for render operations
      * If the bool parameter is true a downscaled version of the image
      * region at screen resolution will be sent.
      * Should be use to increase preview speed for the effects whose
      * behaviour is a function of each pixel.
      */
     DImg   getOriginalRegionImage(bool useDownscaledImage = false) const;
 
     DImg   getOriginalImage() const;
 
     void   setPreviewImage(const DImg& img);
     void   updateImage(const DImg& img);
 
     void   setCapturePointMode(bool b);
     bool   capturePointMode() const;
 
     void   setHighLightPoints(const QPolygon& pointsList);
 
     void   ICCSettingsChanged();
     void   exposureSettingsChanged();
 
 Q_SIGNALS:
 
     void signalOriginalClipFocusChanged();
     void signalCapturedPointFromOriginal(const Digikam::DColor&, const QPoint&);
 
 public Q_SLOTS:
 
     void slotPreviewModeChanged(int mode);
     void slotOriginalImageRegionChanged(bool targetDone=true);
 
 protected:
 
     void mousePressEvent(QMouseEvent*) override;
     void mouseReleaseEvent(QMouseEvent*) override;
 
 private:
 
     void emitCapturedPointFromOriginal(const QPointF&);
 
 private Q_SLOTS:
 
     void slotOriginalImageRegionChangedDelayed();
 
 private:
 
     class Private;
     Private* const d_ptr;
 };
 
 } // namespace Digikam
 
 #endif // DIGIKAM_IMAGE_REGION_WIDGET_H