File indexing completed on 2024-12-22 04:13:10

 /*
  *  SPDX-FileCopyrightText: 2005 C. Boemann <cbo@boemann.dk>
  *  SPDX-FileCopyrightText: 2009 Dmitry Kazakov <dimula73@gmail.com>
  *
  *  SPDX-License-Identifier: GPL-2.0-or-later
  */
 #ifndef KIS_CURVE_WIDGET_H
 #define KIS_CURVE_WIDGET_H
 
 // Qt includes.
 
 #include <QWidget>
 #include <QColor>
 #include <QPointF>
 #include <QPixmap>
 #include <QMouseEvent>
 #include <QKeyEvent>
 #include <QEvent>
 #include <QPaintEvent>
 #include <QList>
 #include <optional>
 
 #include <kritaui_export.h>
 
 class QSpinBox;
 class KisCubicCurve;
 
 /**
  * KisCurveWidget is a widget that shows a single curve that can be edited
  * by the user. The user can grab the curve and move it; this creates
  * a new control point. Control points can be deleted by selecting a point
  * and pressing the delete key.
  *
  * (From: https://techbase.kde.org/Projects/Widgets_and_Classes#KisCurveWidget)
  * KisCurveWidget allows editing of spline based y=f(x) curves. Handy for cases
  * where you want the user to control such things as tablet pressure
  * response, color transformations, acceleration by time, aeroplane lift
  *by angle of attack.
  */
 class KRITAUI_EXPORT KisCurveWidget : public QWidget
 {
     Q_OBJECT
     Q_PROPERTY(bool pointSelected READ pointSelected NOTIFY pointSelectedChanged);
 
 public:
     friend class CurveEditorItem;
     /**
      * Create a new curve widget with a default curve, that is a straight
      * line from bottom-left to top-right.
      */
     KisCurveWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());
 
     ~KisCurveWidget() override;
 
     /**
      * Reset the curve to the default shape
      */
     void reset(void);
 
     /**
      * Set a background pixmap. The background pixmap will be drawn under
      * the grid and the curve.
      *
      * XXX: or is the pixmap what is drawn to the  left and bottom of the curve
      * itself?
      */
     void setPixmap(const QPixmap & pix);
     QPixmap getPixmap();
     
     /**
      * Whether or not there is a point selected
      * This does NOT include the first and last points
      */
     bool pointSelected() const;
 
     bool setCurrentPoint(QPointF pt);
     std::optional<QPointF> currentPoint() const;
 
 Q_SIGNALS:
 
     /**
      * Emitted whenever a control point has changed position.
      */
     void modified(void);
     void curveChanged(const KisCubicCurve &);
     /**
      * Emitted whenever the status of whether a control point is selected or not changes
      */
     void pointSelectedChanged();
     /**
      * Emitted to notify that the start() function in compressor can be activated.
      * Thanks to that, blocking signals in curve widget blocks "sending signals"
      * (calling start() function) *to* the signal compressor.
      * It effectively makes signals work nearly the same way they worked before
      * adding the signal compressor in between.
      */
     void compressorShouldEmitModified();
 
     void shouldSyncIOControls();
     void shouldFocusIOControls();
 
 
 protected Q_SLOTS:
     void notifyModified();
 
     /**
      * This function is called when compressorShouldEmitModified() is emitted.
      * For why it's needed, \see compressorShouldEmitModified()
      */
     void slotCompressorShouldEmitModified();
 
 
 
 protected:
 
     void keyPressEvent(QKeyEvent *) override;
     void paintEvent(QPaintEvent *) override;
     void mousePressEvent(QMouseEvent * e) override;
     void mouseReleaseEvent(QMouseEvent * e) override;
     void mouseMoveEvent(QMouseEvent * e) override;
     void leaveEvent(QEvent *) override;
     void resizeEvent(QResizeEvent *e) override;
 
 public:
 
     /**
      * @return get a list with all defined points. If you want to know what the
      * y value for a given x is on the curve defined by these points, use getCurveValue().
      * @see getCurveValue
      */
     KisCubicCurve curve();
 
     /**
      * Connect/disconnect external spinboxes to the curve
      * @p inMin / @p inMax - is the range for input values
      * @p outMin / @p outMax - is the range for output values
      */
     void setupInOutControls(QSpinBox *in, QSpinBox *out, int inMin, int inMax, int outMin, int outMax);
     void dropInOutControls();
 
     /**
      * Handy function that creates new point in the middle
      * of the curve and sets focus on the @p m_intIn field,
      * so the user can move this point anywhere in a moment
      */
     void addPointInTheMiddle();
 
 public Q_SLOTS:
     /**
      * Replace the current curve with a curve specified by the curve defined by the control
      * points in @p inlist.
      */
     void setCurve(KisCubicCurve inlist);
 
 private:
 
     class Private;
     Private * const d {nullptr};
 };
 
 
 #endif /* KIS_CURVE_WIDGET_H */