qwt_polar_plot.h

Go to the documentation of this file.

/* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
 * QwtPolar Widget Library
 * Copyright (C) 2008   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
 *****************************************************************************/

#ifndef QWT_POLAR_PLOT_H
#define QWT_POLAR_PLOT_H

#include "qwt_global.h"
#include "qwt_polar.h"
#include "qwt_polar_itemdict.h"
#include "qwt_interval.h"
#include "qwt_scale_map.h"
#include "qwt_point_polar.h"
#include <qframe.h>

class QwtRoundScaleDraw;
class QwtScaleEngine;
class QwtScaleDiv;
class QwtTextLabel;
class QwtPolarCanvas;
class QwtPolarLayout;
class QwtAbstractLegend;

class QWT_EXPORT QwtPolarPlot: public QFrame, public QwtPolarItemDict
{
    Q_OBJECT

    Q_PROPERTY( QBrush plotBackground READ plotBackground WRITE setPlotBackground )
    Q_PROPERTY( double azimuthOrigin READ azimuthOrigin WRITE setAzimuthOrigin )


public:
    enum LegendPosition
    {
        LeftLegend,

        RightLegend,

        BottomLegend,

        TopLegend,

        ExternalLegend
    };

    explicit QwtPolarPlot( QWidget *parent = NULL );
    QwtPolarPlot( const QwtText &title, QWidget *parent = NULL );

    virtual ~QwtPolarPlot();

    void setTitle( const QString & );
    void setTitle( const QwtText & );

    QwtText title() const;

    QwtTextLabel *titleLabel();
    const QwtTextLabel *titleLabel() const;

    void setAutoReplot( bool tf = true );
    bool autoReplot() const;

    void setAutoScale( int scaleId );
    bool hasAutoScale( int scaleId ) const;

    void setScaleMaxMinor( int scaleId, int maxMinor );
    int scaleMaxMinor( int scaleId ) const;

    int scaleMaxMajor( int scaleId ) const;
    void setScaleMaxMajor( int scaleId, int maxMajor );

    QwtScaleEngine *scaleEngine( int scaleId );
    const QwtScaleEngine *scaleEngine( int scaleId ) const;
    void setScaleEngine( int scaleId, QwtScaleEngine * );

    void setScale( int scaleId, double min, double max, double step = 0 );

    void setScaleDiv( int scaleId, const QwtScaleDiv & );
    const QwtScaleDiv *scaleDiv( int scaleId ) const;
    QwtScaleDiv *scaleDiv( int scaleId );

    QwtScaleMap scaleMap( int scaleId, double radius ) const;
    QwtScaleMap scaleMap( int scaleId ) const;

    void updateScale( int scaleId );

    double azimuthOrigin() const;

    void zoom( const QwtPointPolar&, double factor );
    void unzoom();

    QwtPointPolar zoomPos() const;
    double zoomFactor() const;

    // Canvas

    QwtPolarCanvas *canvas();
    const QwtPolarCanvas *canvas() const;

    void setPlotBackground ( const QBrush &c );
    const QBrush& plotBackground() const;

    virtual void drawCanvas( QPainter *, const QRectF & ) const;

    // Legend

    void insertLegend( QwtAbstractLegend *,
        LegendPosition = RightLegend, double ratio = -1.0 );

    QwtAbstractLegend *legend();
    const QwtAbstractLegend *legend() const;

    void updateLegend();
    void updateLegend( const QwtPolarItem * );

    // Layout
    QwtPolarLayout *plotLayout();
    const QwtPolarLayout *plotLayout() const;

    QwtInterval visibleInterval() const;
    QRectF plotRect() const;
    QRectF plotRect( const QRectF & ) const;

    int plotMarginHint() const;

    virtual QVariant itemToInfo( QwtPolarItem * ) const;
    virtual QwtPolarItem *infoToItem( const QVariant & ) const;

Q_SIGNALS:
    void itemAttached( QwtPolarItem *plotItem, bool on );

    void legendDataChanged( const QVariant &itemInfo,
        const QList<QwtLegendData> &data );

    void layoutChanged();

public Q_SLOTS:
    virtual void replot();
    void autoRefresh();
    void setAzimuthOrigin( double );

protected:
    virtual bool event( QEvent * ) QWT_OVERRIDE;
    virtual void resizeEvent( QResizeEvent * ) QWT_OVERRIDE;

    virtual void updateLayout();

    virtual void drawItems( QPainter *painter,
        const QwtScaleMap &radialMap, const QwtScaleMap &azimuthMap,
        const QPointF &pole, double radius,
        const QRectF &canvasRect ) const;

private:
    friend class QwtPolarItem;
    void attachItem( QwtPolarItem *, bool );

    void initPlot( const QwtText & );

    class ScaleData;
    class PrivateData;
    PrivateData *d_data;
};

#endif