mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-05 00:09:32 -04:00
33fc476d89
* require qwt >=6.2 (and fallback to internal 6.3 if system's qwt doesn't suffice) * debian doesn't have qwt for Qt6 and won't have it for trixie
311 lines
8.2 KiB
C++
311 lines
8.2 KiB
C++
/******************************************************************************
|
|
* 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
|
|
*****************************************************************************/
|
|
|
|
#ifndef QWT_PLOT_ITEM_H
|
|
#define QWT_PLOT_ITEM_H
|
|
|
|
#include "qwt_global.h"
|
|
#include "qwt_axis_id.h"
|
|
#include <qmetatype.h>
|
|
|
|
class QwtScaleMap;
|
|
class QwtScaleDiv;
|
|
class QwtPlot;
|
|
class QwtText;
|
|
class QwtGraphic;
|
|
class QwtLegendData;
|
|
class QRectF;
|
|
class QPainter;
|
|
class QString;
|
|
template< typename T > class QList;
|
|
|
|
/*!
|
|
\brief Base class for items on the plot canvas
|
|
|
|
A plot item is "something", that can be painted on the plot canvas,
|
|
or only affects the scales of the plot widget. They can be categorized as:
|
|
|
|
- Representator\n
|
|
A "Representator" is an item that represents some sort of data
|
|
on the plot canvas. The different representator classes are organized
|
|
according to the characteristics of the data:
|
|
- QwtPlotMarker
|
|
Represents a point or a horizontal/vertical coordinate
|
|
- QwtPlotCurve
|
|
Represents a series of points
|
|
- QwtPlotSpectrogram ( QwtPlotRasterItem )
|
|
Represents raster data
|
|
- ...
|
|
|
|
- Decorators\n
|
|
A "Decorator" is an item, that displays additional information, that
|
|
is not related to any data:
|
|
- QwtPlotGrid
|
|
- QwtPlotScaleItem
|
|
- QwtPlotSvgItem
|
|
- ...
|
|
|
|
Depending on the QwtPlotItem::ItemAttribute flags, an item is included
|
|
into autoscaling or has an entry on the legend.
|
|
|
|
Before misusing the existing item classes it might be better to
|
|
implement a new type of plot item
|
|
( don't implement a watermark as spectrogram ).
|
|
Deriving a new type of QwtPlotItem primarily means to implement
|
|
the YourPlotItem::draw() method.
|
|
|
|
\sa The cpuplot example shows the implementation of additional plot items.
|
|
*/
|
|
|
|
class QWT_EXPORT QwtPlotItem
|
|
{
|
|
public:
|
|
/*!
|
|
\brief Runtime type information
|
|
|
|
RttiValues is used to cast plot items, without
|
|
having to enable runtime type information of the compiler.
|
|
*/
|
|
enum RttiValues
|
|
{
|
|
//! Unspecific value, that can be used, when it doesn't matter
|
|
Rtti_PlotItem = 0,
|
|
|
|
//! For QwtPlotGrid
|
|
Rtti_PlotGrid,
|
|
|
|
//! For QwtPlotScaleItem
|
|
Rtti_PlotScale,
|
|
|
|
//! For QwtPlotLegendItem
|
|
Rtti_PlotLegend,
|
|
|
|
//! For QwtPlotMarker
|
|
Rtti_PlotMarker,
|
|
|
|
//! For QwtPlotCurve
|
|
Rtti_PlotCurve,
|
|
|
|
//! For QwtPlotSpectroCurve
|
|
Rtti_PlotSpectroCurve,
|
|
|
|
//! For QwtPlotIntervalCurve
|
|
Rtti_PlotIntervalCurve,
|
|
|
|
//! For QwtPlotHistogram
|
|
Rtti_PlotHistogram,
|
|
|
|
//! For QwtPlotSpectrogram
|
|
Rtti_PlotSpectrogram,
|
|
|
|
//! For QwtPlotGraphicItem, QwtPlotSvgItem
|
|
Rtti_PlotGraphic,
|
|
|
|
//! For QwtPlotTradingCurve
|
|
Rtti_PlotTradingCurve,
|
|
|
|
//! For QwtPlotBarChart
|
|
Rtti_PlotBarChart,
|
|
|
|
//! For QwtPlotMultiBarChart
|
|
Rtti_PlotMultiBarChart,
|
|
|
|
//! For QwtPlotShapeItem
|
|
Rtti_PlotShape,
|
|
|
|
//! For QwtPlotTextLabel
|
|
Rtti_PlotTextLabel,
|
|
|
|
//! For QwtPlotZoneItem
|
|
Rtti_PlotZone,
|
|
|
|
//! For QwtPlotVectorField
|
|
Rtti_PlotVectorField,
|
|
|
|
/*!
|
|
Values >= Rtti_PlotUserItem are reserved for plot items
|
|
not implemented in the Qwt library.
|
|
*/
|
|
Rtti_PlotUserItem = 1000
|
|
};
|
|
|
|
/*!
|
|
\brief Plot Item Attributes
|
|
|
|
Various aspects of a plot widget depend on the attributes of
|
|
the attached plot items. If and how a single plot item
|
|
participates in these updates depends on its attributes.
|
|
|
|
\sa setItemAttribute(), testItemAttribute(), ItemInterest
|
|
*/
|
|
enum ItemAttribute
|
|
{
|
|
//! The item is represented on the legend.
|
|
Legend = 0x01,
|
|
|
|
/*!
|
|
The boundingRect() of the item is included in the
|
|
autoscaling calculation as long as its width or height
|
|
is >= 0.0.
|
|
*/
|
|
AutoScale = 0x02,
|
|
|
|
/*!
|
|
The item needs extra space to display something outside
|
|
its bounding rectangle.
|
|
\sa getCanvasMarginHint()
|
|
*/
|
|
Margins = 0x04
|
|
};
|
|
|
|
Q_DECLARE_FLAGS( ItemAttributes, ItemAttribute )
|
|
|
|
/*!
|
|
\brief Plot Item Interests
|
|
|
|
Plot items might depend on the situation of the corresponding
|
|
plot widget. By enabling an interest the plot item will be
|
|
notified, when the corresponding attribute of the plot widgets
|
|
has changed.
|
|
|
|
\sa setItemAttribute(), testItemAttribute(), ItemInterest
|
|
*/
|
|
enum ItemInterest
|
|
{
|
|
/*!
|
|
The item is interested in updates of the scales
|
|
\sa updateScaleDiv()
|
|
*/
|
|
ScaleInterest = 0x01,
|
|
|
|
/*!
|
|
The item is interested in updates of the legend ( of other items )
|
|
This flag is intended for items, that want to implement a legend
|
|
for displaying entries of other plot item.
|
|
|
|
\note If the plot item wants to be represented on a legend
|
|
enable QwtPlotItem::Legend instead.
|
|
|
|
\sa updateLegend()
|
|
*/
|
|
LegendInterest = 0x02
|
|
};
|
|
|
|
Q_DECLARE_FLAGS( ItemInterests, ItemInterest )
|
|
|
|
//! Render hints
|
|
enum RenderHint
|
|
{
|
|
//! Enable antialiasing
|
|
RenderAntialiased = 0x1
|
|
};
|
|
|
|
Q_DECLARE_FLAGS( RenderHints, RenderHint )
|
|
|
|
explicit QwtPlotItem();
|
|
explicit QwtPlotItem( const QString& title );
|
|
explicit QwtPlotItem( const QwtText& title );
|
|
|
|
virtual ~QwtPlotItem();
|
|
|
|
void attach( QwtPlot* plot );
|
|
void detach();
|
|
|
|
QwtPlot* 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 setItemInterest( ItemInterest, bool on = true );
|
|
bool testItemInterest( ItemInterest ) const;
|
|
|
|
void setRenderHint( RenderHint, bool on = true );
|
|
bool testRenderHint( RenderHint ) const;
|
|
|
|
void setRenderThreadCount( uint numThreads );
|
|
uint renderThreadCount() const;
|
|
|
|
void setLegendIconSize( const QSize& );
|
|
QSize legendIconSize() const;
|
|
|
|
double z() const;
|
|
void setZ( double z );
|
|
|
|
void show();
|
|
void hide();
|
|
virtual void setVisible( bool );
|
|
bool isVisible () const;
|
|
|
|
void setAxes( QwtAxisId xAxis, QwtAxisId yAxis );
|
|
|
|
void setXAxis( QwtAxisId );
|
|
QwtAxisId xAxis() const;
|
|
|
|
void setYAxis( QwtAxisId );
|
|
QwtAxisId yAxis() const;
|
|
|
|
virtual void itemChanged();
|
|
virtual void legendChanged();
|
|
|
|
/*!
|
|
\brief Draw the item
|
|
|
|
\param painter Painter
|
|
\param xMap Maps x-values into pixel coordinates.
|
|
\param yMap Maps y-values into pixel coordinates.
|
|
\param canvasRect Contents rect of the canvas in painter coordinates
|
|
*/
|
|
virtual void draw( QPainter* painter,
|
|
const QwtScaleMap& xMap, const QwtScaleMap& yMap,
|
|
const QRectF& canvasRect ) const = 0;
|
|
|
|
virtual QRectF boundingRect() const;
|
|
|
|
virtual void getCanvasMarginHint(
|
|
const QwtScaleMap& xMap, const QwtScaleMap& yMap,
|
|
const QRectF& canvasRect,
|
|
double& left, double& top, double& right, double& bottom) const;
|
|
|
|
virtual void updateScaleDiv(
|
|
const QwtScaleDiv&, const QwtScaleDiv& );
|
|
|
|
virtual void updateLegend( const QwtPlotItem*,
|
|
const QList< QwtLegendData >& );
|
|
|
|
QRectF scaleRect( const QwtScaleMap&, const QwtScaleMap& ) const;
|
|
QRectF paintRect( const QwtScaleMap&, const QwtScaleMap& ) const;
|
|
|
|
virtual QList< QwtLegendData > legendData() const;
|
|
|
|
virtual QwtGraphic legendIcon( int index, const QSizeF& ) const;
|
|
|
|
protected:
|
|
QwtGraphic defaultIcon( const QBrush&, const QSizeF& ) const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QwtPlotItem)
|
|
|
|
class PrivateData;
|
|
PrivateData* m_data;
|
|
};
|
|
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS( QwtPlotItem::ItemAttributes )
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS( QwtPlotItem::ItemInterests )
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS( QwtPlotItem::RenderHints )
|
|
|
|
Q_DECLARE_METATYPE( QwtPlotItem* )
|
|
|
|
#endif
|