RadialGauge.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2026 Paolo Sereno <paolomsereno@gmail.com>
 *
 * SPDX-License-Identifier: MIT
 */
 
#pragma once
 
#include <QtIndustrialWidgets/qtindustrialwidgets_global.h>
#include <QtWidgets/QWidget>
#include <memory>
#include <QtGui/QColor>
#include <QtGui/QPixmap>
 
namespace QtIndustrialWidgets {
 
class RadialGaugePrivate;
 
class QTINDUSTRIALWIDGETS_EXPORT RadialGauge : public QWidget
{
    Q_OBJECT
 
    Q_PROPERTY(double minimum READ minimum WRITE setMinimum NOTIFY rangeChanged)
    Q_PROPERTY(double maximum READ maximum WRITE setMaximum NOTIFY rangeChanged)
    Q_PROPERTY(double value READ value WRITE setValue NOTIFY valueChanged)
    Q_PROPERTY(int precision READ precision WRITE setPrecision NOTIFY appearanceChanged)
    Q_PROPERTY(QString unit READ unit WRITE setUnit NOTIFY appearanceChanged)
    Q_PROPERTY(double startAngle READ startAngle WRITE setStartAngle NOTIFY appearanceChanged)
    Q_PROPERTY(double spanAngle READ spanAngle WRITE setSpanAngle NOTIFY appearanceChanged)
    Q_PROPERTY(int majorTicks READ majorTicks WRITE setMajorTicks NOTIFY appearanceChanged)
    Q_PROPERTY(int minorTicks READ minorTicks WRITE setMinorTicks NOTIFY appearanceChanged)
    Q_PROPERTY(double warningThreshold READ warningThreshold WRITE setWarningThreshold NOTIFY thresholdChanged)
    Q_PROPERTY(double errorThreshold READ errorThreshold WRITE setErrorThreshold NOTIFY thresholdChanged)
    Q_PROPERTY(bool thresholdBandsVisible READ thresholdBandsVisible WRITE setThresholdBandsVisible NOTIFY appearanceChanged)
    Q_PROPERTY(bool digitalDisplayVisible READ digitalDisplayVisible WRITE setDigitalDisplayVisible NOTIFY appearanceChanged)
    Q_PROPERTY(QColor needleColor READ needleColor WRITE setNeedleColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor normalColor READ normalColor WRITE setNormalColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor warningColor READ warningColor WRITE setWarningColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor errorColor READ errorColor WRITE setErrorColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor dialColor READ dialColor WRITE setDialColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor scaleColor READ scaleColor WRITE setScaleColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor bezelColor READ bezelColor WRITE setBezelColor NOTIFY appearanceChanged)
 
public:
    explicit RadialGauge(QWidget *parent = nullptr);
    ~RadialGauge() override;
 
    [[nodiscard]] double minimum() const;
    [[nodiscard]] double maximum() const;
    [[nodiscard]] double value() const;
    [[nodiscard]] int precision() const;
    [[nodiscard]] QString unit() const;
    [[nodiscard]] double startAngle() const;
    [[nodiscard]] double spanAngle() const;
    [[nodiscard]] int majorTicks() const;
    [[nodiscard]] int minorTicks() const;
    [[nodiscard]] double warningThreshold() const;
    [[nodiscard]] double errorThreshold() const;
    [[nodiscard]] bool thresholdBandsVisible() const;
    [[nodiscard]] bool digitalDisplayVisible() const;
 
    [[nodiscard]] QColor needleColor() const;
    [[nodiscard]] QColor normalColor() const;
    [[nodiscard]] QColor warningColor() const;
    [[nodiscard]] QColor errorColor() const;
    [[nodiscard]] QColor dialColor() const;
    [[nodiscard]] QColor scaleColor() const;
    [[nodiscard]] QColor textColor() const;
    [[nodiscard]] QColor bezelColor() const;
 
    [[nodiscard]] QSize sizeHint() const override;
    [[nodiscard]] QSize minimumSizeHint() const override;
 
public Q_SLOTS:
    void setValue(double value);
    void setMinimum(double min);
    void setMaximum(double max);
    void setRange(double min, double max);
    void setPrecision(int precision);
    void setUnit(const QString &unit);
    void setStartAngle(double angle);
    void setSpanAngle(double span);
    void setMajorTicks(int count);
    void setMinorTicks(int count);
    void setWarningThreshold(double threshold);
    void setErrorThreshold(double threshold);
    void setThresholdBandsVisible(bool visible);
    void setDigitalDisplayVisible(bool visible);
 
    void setNeedleColor(const QColor &color);
    void setNormalColor(const QColor &color);
    void setWarningColor(const QColor &color);
    void setErrorColor(const QColor &color);
    void setDialColor(const QColor &color);
    void setScaleColor(const QColor &color);
    void setTextColor(const QColor &color);
    void setBezelColor(const QColor &color);
 
Q_SIGNALS:
    void valueChanged(double value);
    void rangeChanged(double min, double max);
    void thresholdChanged(double warning, double error);
    void warningExceeded(bool exceeded);
    void errorExceeded(bool exceeded);
    void appearanceChanged();
 
protected:
    void paintEvent(QPaintEvent *event) override;
    void resizeEvent(QResizeEvent *event) override;
    void changeEvent(QEvent *event) override;
 
private:
    void invalidateCache();
    void renderStaticScale(const QSize &size);
    double valueToAngle(double val) const;
 
    std::unique_ptr<RadialGaugePrivate> d_ptr;
    Q_DECLARE_PRIVATE(RadialGauge)
};
 
} // namespace QtIndustrialWidgets