info_banner_widget.h

Go to the documentation of this file.

 
#ifndef INFO_BANNER_WIDGET_H
#define INFO_BANNER_WIDGET_H
 
#include <QFrame>
#include <QColor>
#include <QDate>
#include <QString>
#include <QList>
#include <QMap>
#include <QPair>
#include <QTimer>
 
class QJsonObject;
 
enum BannerSlideType {
    BannerEvents,      
    BannerSponsorship, 
    BannerTips,        
    BannerSeasonal,    
};
Q_DECLARE_METATYPE(BannerSlideType)
 
 
 
struct BannerSlide {
    BannerSlideType type;            
    QString tag;                     
    QString title;                   
    QString description;             
    QString description_sub;         
    QString body_text;               
    QString button_label;            
    QString url;                     
    QString image;                   
    int     date_month;              
    int     date_day;                
    QString application;             
    QDate   date_from;               
    QDate   date_until;              
};
 
 
struct SlideTypeConfig {
    bool          randomized    = false; 
    int           maxdisplay    = 0;     
    bool          only          = false; 
    bool          hidden        = false; 
    QColor        color_start;           
    QColor        color_end;             
    int           color_gradient;        
    QList<QColor> steps;                 
};
 
class InfoBannerWidget : public QFrame
{
    Q_OBJECT
public:
    explicit InfoBannerWidget(QWidget *parent = nullptr);
 
    void setCompactMode(bool compact);
 
    bool isCompactMode() const;
 
    void setSlideDeckFreeze(bool freeze);
 
    void setSlideTypeVisible(BannerSlideType type, bool visible);
 
    void setAutoAdvance(bool advance);
 
    void setAutoAdvanceInterval(unsigned seconds);
 
    void setSlidesTest(bool test);
 
    bool hasVisibleSlides() const;
 
    QSize sizeHint() const override;
 
    QSize minimumSizeHint() const override;
 
protected:
    void paintEvent(QPaintEvent *event) override;
 
    void mousePressEvent(QMouseEvent *event) override;
 
    void mouseMoveEvent(QMouseEvent *event) override;
 
    void leaveEvent(QEvent *event) override;
 
    void changeEvent(QEvent *event) override;
 
    bool event(QEvent *event) override;
 
private:
    QList<BannerSlide> slides_;      
    int current_slide_;              
    bool compact_mode_;              
    bool hovered_;                   
    QMap<BannerSlideType, bool> slide_type_visible_;
    QTimer *auto_advance_timer_;     
    int auto_advance_ms_;            
    bool slides_test_;               
    QMap<BannerSlideType, SlideTypeConfig> type_config_;
 
    QMap<BannerSlideType, QList<BannerSlide>> slides_by_type_;
 
    QMap<BannerSlideType, int> type_offsets_;
 
    QColor default_color_start_; 
    QColor default_color_end_;   
    void setupSlides();
 
    QString resolveI18nField(const QJsonObject &obj,
                             const QString &field,
                             bool is_custom) const;
 
    void loadSlidesFromResource(const QString &resource_path,
                                bool is_custom,
                                QMap<BannerSlideType, SlideTypeConfig> &file_config,
                                QMap<BannerSlideType, QList<BannerSlide>> &file_slides);
 
    void applySlideFilter();
 
    void buildSlideSequence();
 
    void advanceSlide();
 
    void advanceRandomSlide();
 
    void updateAccessibility();
 
    int dotHitTest(const QPoint &pos) const;
 
    QRect dotRect(int index) const;
 
    QRect buttonRect() const;
 
    static BannerSlideType typeFromString(const QString &type_str);
 
    static BannerSlideType validTypeFromString(const QString &type_str,
                                               const QString &resource_path,
                                               const QString &context,
                                               bool is_custom);
 
    // ── Layout constants ──────────────────────────────────────────────────
 
    static constexpr int kCardWidth          = 300;  
    static constexpr int kCardHeight         = 360;  
    static constexpr int kCardHeightCompact  = 180;  
    static constexpr int kIllustrationHeight = 120;  
    static constexpr int kContentLeftMargin  = 16;   
    static constexpr int kContentRightMargin = 16;   
    static constexpr int kDotRadius          = 4;    
    static constexpr int kDotSpacing         = 12;   
    static constexpr int kDotBottomMargin    = 14;   
    static constexpr int kDefaultAutoAdvanceMs = 8000; 
};
 
#endif // INFO_BANNER_WIDGET_H