qwt_abstract_scale.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_ABSTRACT_SCALE_H
#define QWT_ABSTRACT_SCALE_H
 
#include "qwt_global.h"
#include <qwidget.h>
 
class QwtScaleEngine;
class QwtAbstractScaleDraw;
class QwtScaleDiv;
class QwtScaleMap;
class QwtInterval;
 
class QWT_EXPORT QwtAbstractScale : public QWidget
{
    Q_OBJECT
 
    Q_PROPERTY( double lowerBound READ lowerBound WRITE setLowerBound )
    Q_PROPERTY( double upperBound READ upperBound WRITE setUpperBound )
 
    Q_PROPERTY( int scaleMaxMajor READ scaleMaxMajor WRITE setScaleMaxMajor )
    Q_PROPERTY( int scaleMaxMinor READ scaleMaxMinor WRITE setScaleMaxMinor )
 
    Q_PROPERTY( double scaleStepSize READ scaleStepSize WRITE setScaleStepSize )
 
  public:
    // Constructor for QwtAbstractScale
    explicit QwtAbstractScale( QWidget* parent = nullptr );
    
    // Destructor for QwtAbstractScale
    virtual ~QwtAbstractScale();
 
    // Set scale by lower and upper bounds
    void setScale( double lowerBound, double upperBound );
    
    // Set scale by interval
    void setScale( const QwtInterval& );
    
    // Set scale by scale division
    void setScale( const QwtScaleDiv& );
 
    // Return the current scale division
    const QwtScaleDiv& scaleDiv() const;
 
    // Set the lower bound of the scale
    void setLowerBound( double value );
    
    // Return the lower bound of the scale
    double lowerBound() const;
 
    // Set the upper bound of the scale
    void setUpperBound( double value );
    
    // Return the upper bound of the scale
    double upperBound() const;
 
    // Set the step size for scale calculation
    void setScaleStepSize( double stepSize );
    
    // Return the current step size hint
    double scaleStepSize() const;
 
    // Set the maximum number of major tick intervals
    void setScaleMaxMajor( int ticks );
    
    // Return the maximum number of minor tick intervals
    int scaleMaxMinor() const;
 
    // Set the maximum number of minor tick intervals
    void setScaleMaxMinor( int ticks );
    
    // Return the maximum number of major tick intervals
    int scaleMaxMajor() const;
 
    // Set the scale engine
    void setScaleEngine( QwtScaleEngine* );
    
    // Return the scale engine (const version)
    const QwtScaleEngine* scaleEngine() const;
    
    // Return the scale engine (non-const version)
    QwtScaleEngine* scaleEngine();
 
    // Transform a scale value to widget coordinates
    int transform( double ) const;
    
    // Transform a widget coordinate to scale value
    double invTransform( int ) const;
 
    // Return true if scale is inverted
    bool isInverted() const;
 
    // Return the minimum boundary value
    double minimum() const;
    
    // Return the maximum boundary value
    double maximum() const;
 
    // Return the scale map
    const QwtScaleMap& scaleMap() const;
 
  protected:
    virtual void changeEvent( QEvent* ) override;
 
    void rescale( double lowerBound,
        double upperBound, double stepSize );
 
    void setAbstractScaleDraw( QwtAbstractScaleDraw* );
 
    const QwtAbstractScaleDraw* abstractScaleDraw() const;
    
    QwtAbstractScaleDraw* abstractScaleDraw();
 
    void updateScaleDraw();
    
    virtual void scaleChange();
 
  private:
    class PrivateData;
    PrivateData* m_data;
};
 
#endif