SevenSegmentDisplay.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>
 
namespace QtIndustrialWidgets {
 
class SevenSegmentDisplayPrivate;
 
class QTINDUSTRIALWIDGETS_EXPORT SevenSegmentDisplay : public QWidget
{
    Q_OBJECT
 
    Q_PROPERTY(double value READ value WRITE setValue NOTIFY valueChanged)
    Q_PROPERTY(QString text READ text WRITE setText NOTIFY textChanged)
    Q_PROPERTY(int digitCount READ digitCount WRITE setDigitCount NOTIFY appearanceChanged)
    Q_PROPERTY(int decimalPlaces READ decimalPlaces WRITE setDecimalPlaces NOTIFY appearanceChanged)
    Q_PROPERTY(bool showLeadingZeros READ showLeadingZeros WRITE setShowLeadingZeros NOTIFY appearanceChanged)
    Q_PROPERTY(bool showDecimalPoint READ showDecimalPoint WRITE setShowDecimalPoint NOTIFY appearanceChanged)
    Q_PROPERTY(double skewAngle READ skewAngle WRITE setSkewAngle NOTIFY appearanceChanged)
    Q_PROPERTY(double segmentWidthRatio READ segmentWidthRatio WRITE setSegmentWidthRatio NOTIFY appearanceChanged)
    Q_PROPERTY(QColor activeSegmentColor READ activeSegmentColor WRITE setActiveSegmentColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor inactiveSegmentColor READ inactiveSegmentColor WRITE setInactiveSegmentColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor backgroundColor READ backgroundColor WRITE setBackgroundColor NOTIFY appearanceChanged)
    Q_PROPERTY(QColor bezelColor READ bezelColor WRITE setBezelColor NOTIFY appearanceChanged)
    Q_PROPERTY(bool bezelVisible READ isBezelVisible WRITE setBezelVisible NOTIFY appearanceChanged)
 
public:
    explicit SevenSegmentDisplay(QWidget *parent = nullptr);
    ~SevenSegmentDisplay() override;
 
    [[nodiscard]] double value() const;
    [[nodiscard]] QString text() const;
    [[nodiscard]] int digitCount() const;
    [[nodiscard]] int decimalPlaces() const;
    [[nodiscard]] bool showLeadingZeros() const;
    [[nodiscard]] bool showDecimalPoint() const;
    [[nodiscard]] double skewAngle() const;
    [[nodiscard]] double segmentWidthRatio() const;
 
    [[nodiscard]] QColor activeSegmentColor() const;
    [[nodiscard]] QColor inactiveSegmentColor() const;
    [[nodiscard]] QColor backgroundColor() const;
    [[nodiscard]] QColor bezelColor() const;
    [[nodiscard]] bool isBezelVisible() const;
 
    [[nodiscard]] QSize sizeHint() const override;
    [[nodiscard]] QSize minimumSizeHint() const override;
 
public Q_SLOTS:
    void setValue(double value);
    void setText(const QString &text);
    void display(double value);
    void display(int value);
    void display(const QString &text);
 
    void setDigitCount(int count);
    void setDecimalPlaces(int places);
    void setShowLeadingZeros(bool show);
    void setShowDecimalPoint(bool show);
    void setSkewAngle(double angle);
    void setSegmentWidthRatio(double ratio);
 
    void setActiveSegmentColor(const QColor &color);
    void setInactiveSegmentColor(const QColor &color);
    void setBackgroundColor(const QColor &color);
    void setBezelColor(const QColor &color);
    void setBezelVisible(bool visible);
 
Q_SIGNALS:
    void valueChanged(double value);
    void textChanged(const QString &text);
    void appearanceChanged();
 
protected:
    void paintEvent(QPaintEvent *event) override;
 
private:
    void updateFormattedText();
    static quint8 encodeChar(QChar ch);
    void drawDigit(QPainter &painter, const QRectF &rect, quint8 mask, bool hasDecimalPoint) const;
 
    std::unique_ptr<SevenSegmentDisplayPrivate> d_ptr;
    Q_DECLARE_PRIVATE(SevenSegmentDisplay)
};
 
} // namespace QtIndustrialWidgets