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 BuiltinActions
    {
        ActionNone = 0x00,
        ActionWheelZoom = 0x01,
        ActionClickPan = 0x02,
        ActionAll = 0xFF
    };
    Q_DECLARE_FLAGS(BuiltinActionsFlags, BuiltinActions)
public:
    explicit QwtScaleWidget(QWidget* parent = NULL);
    explicit QwtScaleWidget(QwtScaleDraw::Alignment, QWidget* parent = NULL);
    virtual ~QwtScaleWidget();
 
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 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 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;
 
    // 坐标轴和绘图边距的偏移，这个值实际和contentMargin类似，但qwt的contentMargin只用于minimumSizeHint
    // 对于寄生轴，需要宿主轴有很大的空白位能让寄生轴显示，这个edgeOffset主要就是让坐标轴留出一个空白位
    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 QWT_OVERRIDE;
    virtual QSize minimumSizeHint() const QWT_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;
 
    // 去除了colorBar,margin,edgeMargin,BorderDistHint这些区域的矩形，也就是用来绘制刻度的区域
    QRect scaleRect() const;
    // font color of the coordinate axis/设置坐标轴的字体颜色
    void setTextColor(const QColor& c);
    QColor textColor() const;
 
    // color of the coordinate axis/坐标轴的颜色
    void setScaleColor(const QColor& c);
    QColor scaleColor() const;
 
    void layoutScale(bool update_geometry = true);
 
    // 获取此轴窗口对应的axisID
    QwtAxisId axisID() const;
    // 是否是x坐标轴
    bool isXAxis() const;
    // 是否是y坐标轴
    bool isYAxis() const;
    //===============================================
    // 以下接口用于内置动作
    //===============================================
 
    // 启用/禁用内置交互动作
    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;
 
    // 设置缩放因子(默认1.2)
    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*) QWT_OVERRIDE;
    virtual void resizeEvent(QResizeEvent*) QWT_OVERRIDE;
    virtual void changeEvent(QEvent*) QWT_OVERRIDE;
 
    void draw(QPainter*) const;
 
    void scaleChange();
 
private:
    void initScale(QwtScaleDraw::Alignment);
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtScaleWidget::LayoutFlags)
 
#endif