qwt_polar_item.h

Go to the documentation of this file.

/******************************************************************************
 * 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_ITEM_H
#define QWT_POLAR_ITEM_H

#include "qwt_global.h"
#include "qwt_text.h"
#include "qwt_legend_data.h"
#include "qwt_graphic.h"
#include "qwt_interval.h"

class QString;
class QRect;
class QPointF;
class QPainter;
class QwtPolarPlot;
class QwtScaleMap;
class QwtScaleDiv;

class QWT_EXPORT QwtPolarItem
{
  public:
    enum RttiValues
    {
        Rtti_PolarItem = 0,

        Rtti_PolarGrid,

        Rtti_PolarMarker,

        Rtti_PolarCurve,

        Rtti_PolarSpectrogram,

        Rtti_PolarUserItem = 1000
    };

    enum ItemAttribute
    {
        Legend    = 0x01,

        AutoScale = 0x02
    };

    Q_DECLARE_FLAGS( ItemAttributes, ItemAttribute )

    
    enum RenderHint
    {
        RenderAntialiased = 0x01
    };

    Q_DECLARE_FLAGS( RenderHints, RenderHint )

    explicit QwtPolarItem( const QwtText& title = QwtText() );
    virtual ~QwtPolarItem();

    void attach( QwtPolarPlot* plot );
    void detach();

    QwtPolarPlot* plot() const;

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

    virtual int rtti() const;

    void setItemAttribute( ItemAttribute, bool on = true );
    bool testItemAttribute( ItemAttribute ) const;

    void setRenderHint( RenderHint, bool on = true );
    bool testRenderHint( RenderHint ) const;

    void setRenderThreadCount( uint numThreads );
    uint renderThreadCount() const;

    double z() const;
    void setZ( double z );

    void show();
    void hide();
    virtual void setVisible( bool );
    bool isVisible () const;

    virtual void itemChanged();
    virtual void legendChanged();

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

    virtual QwtInterval boundingInterval( int scaleId ) const;

    virtual void updateScaleDiv( const QwtScaleDiv&,
        const QwtScaleDiv&, const QwtInterval& );

    virtual int marginHint() const;

    void setLegendIconSize( const QSize& );
    QSize legendIconSize() const;

    virtual QList< QwtLegendData > legendData() const;
    virtual QwtGraphic legendIcon( int index, const QSizeF& ) const;

  private:
    Q_DISABLE_COPY( QwtPolarItem )

    class PrivateData;
    PrivateData* m_data;
};

Q_DECLARE_OPERATORS_FOR_FLAGS( QwtPolarItem::ItemAttributes )
Q_DECLARE_OPERATORS_FOR_FLAGS( QwtPolarItem::RenderHints )

Q_DECLARE_METATYPE( QwtPolarItem* )

#endif