qwt_scale_widget.h

/******************************************************************************
 * Qwt Widget Library
 * Copyright (C) 1997   Josef Wilgen
 * Copyright (C) 2002   Uwe Rathmann
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the Qwt License, Version 1.0
 *
 * Modified by ChenZongYan in 2024 <czy.t@163.com>
 *   Summary of major modifications (see ChangeLog.md for full history):
 *   1. CMake build system & C++11 throughout.
 *   2. Core panner/ zoomer refactored:
 *        - QwtPanner → QwtCachePanner (pixmap-cache version)
 *        - New real-time QwtPlotPanner derived from QwtPicker.
 *   3. Zoomer supports multi-axis.
 *   4. Parasite-plot framework:
 *        - QwtFigure, QwtPlotParasiteLayout, QwtPlotTransparentCanvas,
 *        - QwtPlotScaleEventDispatcher, built-in pan/zoom on axis.
 *   5. New picker: QwtPlotSeriesDataPicker (works with date axis).
 *   6. Raster & color-map extensions:
 *        - QwtGridRasterData (2-D table + interpolation)
 *        - QwtLinearColorMap::stopColors(), stopPos() API rename.
 *   7. Bar-chart: expose pen/brush control.
 *   8. Amalgamated build: single QwtPlot.h / QwtPlot.cpp pair in src-amalgamate.
 *****************************************************************************/
 
#ifndef QWT_SCALE_WIDGET_H
#define QWT_SCALE_WIDGET_H
 
#include "qwt_global.h"
#include "qwt_text.h"
#include "qwt_scale_draw.h"
#include "qwt_axis_id.h"
#include "qwt_scale_div.h"
 
#include <qwidget.h>
#include <qfont.h>
#include <qcolor.h>
#include <qstring.h>
// Qt
class QPainter;
class QEvent;
class QPaintEvent;
class QResizeEvent;
class QMouseEvent;
class QWheelEvent;
// Qwt
class QwtTransform;
class QwtColorMap;
 
class QWT_EXPORT QwtScaleWidget : public QWidget
{
    Q_OBJECT
    QWT_DECLARE_PRIVATE(QwtScaleWidget)
public:
    enum LayoutFlag
    {
        TitleInverted = 1
    };
 
    Q_DECLARE_FLAGS(LayoutFlags, LayoutFlag)
 
    
    enum TitlePosition
    {
        TitleCentered = 0,
        TitleAtStart,
        TitleAtEnd
    };
 
    enum TitlePlacement
    {
        TitleInside = 0,
        TitleOutside
    };
 
    enum BuiltinActions
    {
        ActionNone = 0x00,
        ActionWheelZoom = 0x01,
        ActionClickPan = 0x02,
        ActionAll = 0xFF
    };
    Q_DECLARE_FLAGS(BuiltinActionsFlags, BuiltinActions)
public:
    explicit QwtScaleWidget(QWidget* parent = nullptr);
    explicit QwtScaleWidget(QwtScaleDraw::Alignment, QWidget* parent = nullptr);
    ~QwtScaleWidget() override;
 
Q_SIGNALS:
 
    void scaleDivChanged();
 
    void requestScaleRangeUpdate(double min, double max);
 
    void selectionChanged(bool selected);
 
public:
    void setTitle(const QString& title);
    void setTitle(const QwtText& title);
    QwtText title() const;
 
    void setTitlePosition(TitlePosition);
    TitlePosition titlePosition() const;
 
    void setTitlePlacement(TitlePlacement);
    TitlePlacement titlePlacement() const;
 
    void setTitleAlignment(Qt::Alignment);
    Qt::Alignment titleAlignment() const;
 
    void setLayoutFlag(LayoutFlag, bool on);
    bool testLayoutFlag(LayoutFlag) const;
 
    void setBorderDist(int dist1, int dist2);
    int startBorderDist() const;
    int endBorderDist() const;
 
    void getBorderDistHint(int& start, int& end) const;
 
    void setCornerExtension(int start, int end);
 
    void getMinBorderDist(int& start, int& end) const;
    void setMinBorderDist(int start, int end);
    int startMinBorderDist() const;
    int endMinBorderDist() const;
 
    void setMargin(int);
    int margin() const;
 
    void setSpacing(int);
    int spacing() const;
 
    void setEdgeMargin(int offset);
    int edgeMargin() const;
 
    void setScaleDiv(const QwtScaleDiv&);
    void setTransformation(QwtTransform*);
 
    void setScaleDraw(QwtScaleDraw*);
    const QwtScaleDraw* scaleDraw() const;
    QwtScaleDraw* scaleDraw();
 
    void setLabelAlignment(Qt::Alignment);
    void setLabelRotation(double rotation);
 
    void setColorBarEnabled(bool);
    bool isColorBarEnabled() const;
 
    void setColorBarWidth(int);
    int colorBarWidth() const;
 
    void setColorMap(const QwtInterval&, QwtColorMap*);
 
    QwtInterval colorBarInterval() const;
    const QwtColorMap* colorMap() const;
 
    virtual QSize sizeHint() const override;
    virtual QSize minimumSizeHint() const override;
 
    int titleHeightForWidth(int width) const;
    int dimForLength(int length, const QFont& scaleFont) const;
 
    void drawColorBar(QPainter*, const QRectF&) const;
    void drawTitle(QPainter*, QwtScaleDraw::Alignment, const QRectF& rect) const;
 
    void setAlignment(QwtScaleDraw::Alignment);
    QwtScaleDraw::Alignment alignment() const;
 
    QRectF colorBarRect(const QRectF&) const;
 
    QRect scaleRect() const;
    void setTextColor(const QColor& c);
    QColor textColor() const;
 
    void setScaleColor(const QColor& c);
    QColor scaleColor() const;
 
    void layoutScale(bool update_geometry = true);
 
    QwtAxisId axisID() const;
    bool isXAxis() const;
    bool isYAxis() const;
    //===============================================
    // Built-in action methods
    //===============================================
 
    void setBuildinActions(BuiltinActionsFlags acts);
    BuiltinActionsFlags buildinActions() const;
    bool testBuildinActions(BuiltinActions ba) const;
 
    void setSelected(bool selected);
    bool isSelected() const;
 
    void setSelectionColor(const QColor& color);
    QColor selectionColor() const;
 
    void setZoomFactor(double factor);
    double zoomFactor() const;
 
    void setSelectedPenWidthOffset(qreal offset = 1);
    qreal selectedPenWidthOffset() const;
 
    bool isOnScale(const QPoint& pos) const;
 
protected:
    virtual void paintEvent(QPaintEvent*) override;
    virtual void resizeEvent(QResizeEvent*) override;
    virtual void changeEvent(QEvent*) override;
 
    void draw(QPainter*) const;
 
    void scaleChange();
 
private:
    void initScale(QwtScaleDraw::Alignment);
    QRect scaleContentsRect() const;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtScaleWidget::LayoutFlags)
 
#endif