LinearGauge.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 LinearGaugePrivate;
 
class QTINDUSTRIALWIDGETS_EXPORT LinearGauge : public QWidget
{
    Q_OBJECT
 
    Q_PROPERTY(Qt::Orientation orientation READ orientation WRITE setOrientation NOTIFY appearanceChanged)
    Q_PROPERTY(bool thermometerMode READ isThermometerMode WRITE setThermometerMode NOTIFY appearanceChanged)
    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(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 dynamicLiquidColor READ isDynamicLiquidColor WRITE setDynamicLiquidColor NOTIFY appearanceChanged)
    Q_PROPERTY(bool gradientLiquid READ isGradientLiquid WRITE setGradientLiquid NOTIFY appearanceChanged)
    Q_PROPERTY(bool digitalDisplayVisible READ digitalDisplayVisible WRITE setDigitalDisplayVisible NOTIFY appearanceChanged)
    Q_PROPERTY(bool scaleVisible READ scaleVisible WRITE setScaleVisible NOTIFY appearanceChanged)
    Q_PROPERTY(QColor liquidColor READ liquidColor WRITE setLiquidColor 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 troughColor READ troughColor WRITE setTroughColor 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 LinearGauge(QWidget *parent = nullptr);
    ~LinearGauge() override;
 
    [[nodiscard]] Qt::Orientation orientation() const;
    [[nodiscard]] bool isThermometerMode() const;
    [[nodiscard]] double minimum() const;
    [[nodiscard]] double maximum() const;
    [[nodiscard]] double value() const;
    [[nodiscard]] int precision() const;
    [[nodiscard]] QString unit() const;
    [[nodiscard]] int majorTicks() const;
    [[nodiscard]] int minorTicks() const;
    [[nodiscard]] double warningThreshold() const;
    [[nodiscard]] double errorThreshold() const;
    [[nodiscard]] bool isDynamicLiquidColor() const;
    [[nodiscard]] bool isGradientLiquid() const;
    [[nodiscard]] bool digitalDisplayVisible() const;
    [[nodiscard]] bool scaleVisible() const;
 
    [[nodiscard]] QColor liquidColor() const;
    [[nodiscard]] QColor normalColor() const;
    [[nodiscard]] QColor warningColor() const;
    [[nodiscard]] QColor errorColor() const;
    [[nodiscard]] QColor troughColor() 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 setOrientation(Qt::Orientation orientation);
    void setThermometerMode(bool thermometer);
    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 setMajorTicks(int count);
    void setMinorTicks(int count);
    void setWarningThreshold(double threshold);
    void setErrorThreshold(double threshold);
    void setDynamicLiquidColor(bool dynamic);
    void setGradientLiquid(bool gradient);
    void setDigitalDisplayVisible(bool visible);
    void setScaleVisible(bool visible);
 
    void setLiquidColor(const QColor &color);
    void setNormalColor(const QColor &color);
    void setWarningColor(const QColor &color);
    void setErrorColor(const QColor &color);
    void setTroughColor(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 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);
    [[nodiscard]] QColor determineActiveLiquidColor() const;
 
    std::unique_ptr<LinearGaugePrivate> d_ptr;
    Q_DECLARE_PRIVATE(LinearGauge)
};
 
} // namespace QtIndustrialWidgets