seriesstyle.h

Go to the documentation of this file.

 
#ifndef OPENSWMMVIS_PLOT_SERIESSTYLE_H
#define OPENSWMMVIS_PLOT_SERIESSTYLE_H
 
#include "plot/numberformat.h"
 
#include <QColor>
#include <QFont>
#include <QJsonObject>
#include <QPen>
#include <QString>
#include <Qt>
 
class QXYSeries;
class QScatterSeries;
 
namespace openswmmvis::plot {
 
enum class MarkerShape {
    Circle,
    Square,
    Triangle,
    Diamond,
    Cross,
    Plus
};
 
struct SeriesStyle {
    // ---- Identity -------------------------------------------------------
    QColor       color        = QColor(31, 119, 180);   // matplotlib "tab:blue"
    qreal        opacity      = 1.0;                    // 0..1
    QString      legendName;                            // empty = auto
 
    // ---- Line -----------------------------------------------------------
    bool             showLine   = true;
    qreal            lineWidth  = 1.6;
    Qt::PenStyle     dash       = Qt::SolidLine;
    Qt::PenCapStyle  capStyle   = Qt::FlatCap;
    Qt::PenJoinStyle joinStyle  = Qt::BevelJoin;
 
    // ---- Markers --------------------------------------------------------
    bool         showMarkers       = false;
    MarkerShape  shape             = MarkerShape::Circle;
    qreal        markerSize        = 5.0;
    QColor       markerFillColor;            // invalid = derive from color
    QColor       markerBorderColor;          // invalid = derive from color
    qreal        markerBorderWidth = 0.0;
 
    // ---- Point labels ---------------------------------------------------
    bool   showPointLabels      = false;
    QFont  pointLabelFont;                   // default = QFont()
    QColor pointLabelColor;                  // invalid = derive from color
    int    pointLabelPrecision  = 2;         // decimals or sig figs (see mode)
    NumberFormatMode pointLabelFormatMode = NumberFormatMode::Decimals;
    QString pointLabelFormat;                // optional printf override; empty = use mode+precision
 
    // ---- Area fill ------------------------------------------------------
    bool   showAreaFill = false;
    QColor areaFillColor;                    // invalid = derive (semi-transparent color)
 
    QJsonObject toJson() const;
    static SeriesStyle fromJson(const QJsonObject& obj);
 
    QColor effectiveMarkerFillColor()   const;
    QColor effectiveMarkerBorderColor() const;
    QColor effectivePointLabelColor()   const;
    QColor effectiveAreaFillColor()     const;  // alpha-baked fallback if invalid
};
 
SeriesStyle defaultStyleForCycle(int cycleIndex);
 
QString markerShapeToString(MarkerShape s);
MarkerShape markerShapeFromString(const QString& s);
 
QString penStyleToString(Qt::PenStyle s);
Qt::PenStyle penStyleFromString(const QString& s);
 
QString penCapStyleToString(Qt::PenCapStyle s);
Qt::PenCapStyle penCapStyleFromString(const QString& s);
QString penJoinStyleToString(Qt::PenJoinStyle s);
Qt::PenJoinStyle penJoinStyleFromString(const QString& s);
 
QPen penForStyle(const SeriesStyle& style);
 
void applySeriesStyle(const SeriesStyle& style,
                      QXYSeries* series,
                      QScatterSeries* markerOverlay = nullptr);
 
} // namespace openswmmvis::plot
 
#endif // OPENSWMMVIS_PLOT_SERIESSTYLE_H