mirror of
https://github.com/jkriege2/JKQtPlotter.git
synced 2024-12-25 01:51:49 +08:00
0e2237e92f
- fixed JKQTPColumnMathImage with modifiers - improved documentation - make use of link_prl/create_prl in QMake projects (see http://doc.qt.io/qt-5/qmake-advanced-usage.html)
465 lines
20 KiB
C++
465 lines
20 KiB
C++
/*
|
|
Copyright (c) 2008-2019 Jan W. Krieger (<jan@jkrieger.de>)
|
|
|
|
|
|
|
|
This software is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License (LGPL) as published by
|
|
the Free Software Foundation, either version 2 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License (LGPL) for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License (LGPL)
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
|
|
/** \file jkqtpelementsoverlay.h
|
|
* \ingroup jkqtplotter_overlays
|
|
*/
|
|
|
|
#include <QObject>
|
|
#include <QString>
|
|
#include <QPainter>
|
|
#include <QPair>
|
|
#include "jkqtplottertools/jkqtptools.h"
|
|
#include "jkqtplottertools/jkqtp_imexport.h"
|
|
|
|
#ifndef jkqtpelementsoverlay_H
|
|
#define jkqtpelementsoverlay_H
|
|
|
|
// forward declarations
|
|
class JKQTBasePlotter;
|
|
|
|
/*! \brief this virtual base class describes an interface for graph overlay elements, which are simple geometric
|
|
forms drawn ONTO the graphe, so a redraw of the overlays does NOT require a redraw of the graph.
|
|
\ingroup jkqtplotter_overlays
|
|
|
|
These simple primitive elements can be used to e.g. display fast changing indicators on the graph ...
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayElement : public QObject {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayElement(JKQTBasePlotter *parent = 0);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter)=0;
|
|
|
|
/** \brief returns the parent painter class */
|
|
inline JKQTBasePlotter* getParent() { return parent; }
|
|
|
|
/** \brief sets the parent painter class */
|
|
virtual void setParent(JKQTBasePlotter* parent);
|
|
|
|
/*! \brief sets the property color ( \copybrief color ) to the specified \a __value.
|
|
\details Description of the parameter color is: <BLOCKQUOTE>\copydoc color </BLOCKQUOTE>
|
|
\see color for more information */
|
|
inline virtual void setColor(const QColor & __value)
|
|
{
|
|
this->color = __value;
|
|
}
|
|
/*! \brief returns the property color ( \copybrief color ).
|
|
\details Description of the parameter color is: <BLOCKQUOTE>\copydoc color </BLOCKQUOTE>
|
|
\see color for more information */
|
|
inline virtual QColor getColor() const
|
|
{
|
|
return this->color;
|
|
}
|
|
/*! \brief sets the property fillColor ( \copybrief fillColor ) to the specified \a __value.
|
|
\details Description of the parameter fillColor is: <BLOCKQUOTE>\copydoc fillColor </BLOCKQUOTE>
|
|
\see fillColor for more information */
|
|
inline virtual void setFillColor(const QColor & __value)
|
|
{
|
|
this->fillColor = __value;
|
|
}
|
|
/*! \brief returns the property fillColor ( \copybrief fillColor ).
|
|
\details Description of the parameter fillColor is: <BLOCKQUOTE>\copydoc fillColor </BLOCKQUOTE>
|
|
\see fillColor for more information */
|
|
inline virtual QColor getFillColor() const
|
|
{
|
|
return this->fillColor;
|
|
}
|
|
/*! \brief sets the property lineStyle ( \copybrief lineStyle ) to the specified \a __value.
|
|
\details Description of the parameter lineStyle is: <BLOCKQUOTE>\copydoc lineStyle </BLOCKQUOTE>
|
|
\see lineStyle for more information */
|
|
inline virtual void setLineStyle(const Qt::PenStyle & __value)
|
|
{
|
|
this->lineStyle = __value;
|
|
}
|
|
/*! \brief returns the property lineStyle ( \copybrief lineStyle ).
|
|
\details Description of the parameter lineStyle is: <BLOCKQUOTE>\copydoc lineStyle </BLOCKQUOTE>
|
|
\see lineStyle for more information */
|
|
inline virtual Qt::PenStyle getLineStyle() const
|
|
{
|
|
return this->lineStyle;
|
|
}
|
|
/*! \brief sets the property fillStyle ( \copybrief fillStyle ) to the specified \a __value.
|
|
\details Description of the parameter fillStyle is: <BLOCKQUOTE>\copydoc fillStyle </BLOCKQUOTE>
|
|
\see fillStyle for more information */
|
|
inline virtual void setFillStyle(const Qt::BrushStyle & __value)
|
|
{
|
|
this->fillStyle = __value;
|
|
}
|
|
/*! \brief returns the property fillStyle ( \copybrief fillStyle ).
|
|
\details Description of the parameter fillStyle is: <BLOCKQUOTE>\copydoc fillStyle </BLOCKQUOTE>
|
|
\see fillStyle for more information */
|
|
inline virtual Qt::BrushStyle getFillStyle() const
|
|
{
|
|
return this->fillStyle;
|
|
}
|
|
/*! \brief sets the property lineWidth ( \copybrief lineWidth ) to the specified \a __value.
|
|
\details Description of the parameter lineWidth is: <BLOCKQUOTE>\copydoc lineWidth </BLOCKQUOTE>
|
|
\see lineWidth for more information */
|
|
inline virtual void setLineWidth(double __value)
|
|
{
|
|
this->lineWidth = __value;
|
|
}
|
|
/*! \brief returns the property lineWidth ( \copybrief lineWidth ).
|
|
\details Description of the parameter lineWidth is: <BLOCKQUOTE>\copydoc lineWidth </BLOCKQUOTE>
|
|
\see lineWidth for more information */
|
|
inline virtual double getLineWidth() const
|
|
{
|
|
return this->lineWidth;
|
|
}
|
|
/*! \brief sets the property text ( \copybrief text ) to the specified \a __value.
|
|
\details Description of the parameter text is: <BLOCKQUOTE>\copydoc text </BLOCKQUOTE>
|
|
\see text for more information */
|
|
inline virtual void setText(const QString & __value)
|
|
{
|
|
this->text = __value;
|
|
}
|
|
/*! \brief returns the property text ( \copybrief text ).
|
|
\details Description of the parameter text is: <BLOCKQUOTE>\copydoc text </BLOCKQUOTE>
|
|
\see text for more information */
|
|
inline virtual QString getText() const
|
|
{
|
|
return this->text;
|
|
}
|
|
/*! \brief sets the property fontName ( \copybrief fontName ) to the specified \a __value.
|
|
\details Description of the parameter fontName is: <BLOCKQUOTE>\copydoc fontName </BLOCKQUOTE>
|
|
\see fontName for more information */
|
|
inline virtual void setFontName(const QString & __value)
|
|
{
|
|
this->fontName = __value;
|
|
}
|
|
/*! \brief returns the property fontName ( \copybrief fontName ).
|
|
\details Description of the parameter fontName is: <BLOCKQUOTE>\copydoc fontName </BLOCKQUOTE>
|
|
\see fontName for more information */
|
|
inline virtual QString getFontName() const
|
|
{
|
|
return this->fontName;
|
|
}
|
|
/*! \brief sets the property fontSize ( \copybrief fontSize ) to the specified \a __value.
|
|
\details Description of the parameter fontSize is: <BLOCKQUOTE>\copydoc fontSize </BLOCKQUOTE>
|
|
\see fontSize for more information */
|
|
inline virtual void setFontSize(double __value)
|
|
{
|
|
this->fontSize = __value;
|
|
}
|
|
/*! \brief returns the property fontSize ( \copybrief fontSize ).
|
|
\details Description of the parameter fontSize is: <BLOCKQUOTE>\copydoc fontSize </BLOCKQUOTE>
|
|
\see fontSize for more information */
|
|
inline virtual double getFontSize() const
|
|
{
|
|
return this->fontSize;
|
|
}
|
|
/*! \brief sets the property visible ( \copybrief visible ) to the specified \a __value.
|
|
\details Description of the parameter visible is: <BLOCKQUOTE>\copydoc visible </BLOCKQUOTE>
|
|
\see visible for more information */
|
|
inline virtual void setVisible(bool __value)
|
|
{
|
|
this->visible = __value;
|
|
}
|
|
/*! \brief returns the property visible ( \copybrief visible ).
|
|
\details Description of the parameter visible is: <BLOCKQUOTE>\copydoc visible </BLOCKQUOTE>
|
|
\see visible for more information */
|
|
inline virtual bool getVisible() const
|
|
{
|
|
return this->visible;
|
|
}
|
|
|
|
protected:
|
|
/** \brief the plotter object this object belongs to */
|
|
JKQTBasePlotter* parent;
|
|
|
|
QColor color;
|
|
QColor fillColor;
|
|
Qt::PenStyle lineStyle;
|
|
Qt::BrushStyle fillStyle;
|
|
double lineWidth;
|
|
QString text;
|
|
QString fontName;
|
|
double fontSize;
|
|
bool visible;
|
|
QFont getFont() const;
|
|
|
|
|
|
/** \brief tool routine that transforms a QPointF according to the parent's transformation rules */
|
|
QPointF transform(const QPointF& x);
|
|
|
|
double transfromX(double x);
|
|
double transfromY(double y);
|
|
|
|
/** \brief tool routine that back-transforms a QPointF according to the parent's transformation rules */
|
|
QPointF backTransform(const QPointF& x);
|
|
|
|
/** \brief tool routine that transforms a QPointF according to the parent's transformation rules */
|
|
inline QPointF transform(double x, double y) {
|
|
return transform(QPointF(x,y));
|
|
};
|
|
/** \brief tool routine that back-transforms a QPointF according to the parent's transformation rules */
|
|
inline QPointF backTransform(double x, double y) {
|
|
return backTransform(QPointF(x,y));
|
|
};
|
|
/** \brief tool routine that transforms a QVector<QPointF> according to the parent's transformation rules */
|
|
QVector<QPointF> transform(const QVector<QPointF>& x);
|
|
|
|
/** \brief tool routine that transforms a QVector<QPointF> according to the parent's transformation rules
|
|
* and returns a (non-closed) path consisting of lines */
|
|
QPainterPath transformToLinePath(const QVector<QPointF>& x);
|
|
|
|
/** \brief tool routine that transforms a QVector<QPointF> according to the parent's transformation rules
|
|
* and returns a polygon */
|
|
inline QPolygonF transformToPolygon(const QVector<QPointF>& x) {
|
|
return QPolygonF(transform(x));
|
|
}
|
|
|
|
virtual QBrush getBrush(JKQTPEnhancedPainter &painter) const;
|
|
virtual QPen getPen(JKQTPEnhancedPainter& painter) const;
|
|
|
|
};
|
|
|
|
|
|
|
|
/*! \brief baseclass for a two-position overlay
|
|
\ingroup jkqtplotter_overlays
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayTwoPositionOverlay : public JKQTPOverlayElement {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayTwoPositionOverlay(double x1, double y1, double x2, double y2, JKQTBasePlotter *parent = 0);
|
|
|
|
/*! \brief sets the property x1 ( \copybrief x1 ) to the specified \a __value.
|
|
\details Description of the parameter x1 is: <BLOCKQUOTE>\copydoc x1 </BLOCKQUOTE>
|
|
\see x1 for more information */
|
|
inline virtual void setX1(double __value)
|
|
{
|
|
this->x1 = __value;
|
|
}
|
|
/*! \brief returns the property x1 ( \copybrief x1 ).
|
|
\details Description of the parameter x1 is: <BLOCKQUOTE>\copydoc x1 </BLOCKQUOTE>
|
|
\see x1 for more information */
|
|
inline virtual double getX1() const
|
|
{
|
|
return this->x1;
|
|
}
|
|
/*! \brief sets the property x2 ( \copybrief x2 ) to the specified \a __value.
|
|
\details Description of the parameter x2 is: <BLOCKQUOTE>\copydoc x2 </BLOCKQUOTE>
|
|
\see x2 for more information */
|
|
inline virtual void setX2(double __value)
|
|
{
|
|
this->x2 = __value;
|
|
}
|
|
/*! \brief returns the property x2 ( \copybrief x2 ).
|
|
\details Description of the parameter x2 is: <BLOCKQUOTE>\copydoc x2 </BLOCKQUOTE>
|
|
\see x2 for more information */
|
|
inline virtual double getX2() const
|
|
{
|
|
return this->x2;
|
|
}
|
|
/*! \brief sets the property y1 ( \copybrief y1 ) to the specified \a __value.
|
|
\details Description of the parameter y1 is: <BLOCKQUOTE>\copydoc y1 </BLOCKQUOTE>
|
|
\see y1 for more information */
|
|
inline virtual void setY1(double __value)
|
|
{
|
|
this->y1 = __value;
|
|
}
|
|
/*! \brief returns the property y1 ( \copybrief y1 ).
|
|
\details Description of the parameter y1 is: <BLOCKQUOTE>\copydoc y1 </BLOCKQUOTE>
|
|
\see y1 for more information */
|
|
inline virtual double getY1() const
|
|
{
|
|
return this->y1;
|
|
}
|
|
/*! \brief sets the property y2 ( \copybrief y2 ) to the specified \a __value.
|
|
\details Description of the parameter y2 is: <BLOCKQUOTE>\copydoc y2 </BLOCKQUOTE>
|
|
\see y2 for more information */
|
|
inline virtual void setY2(double __value)
|
|
{
|
|
this->y2 = __value;
|
|
}
|
|
/*! \brief returns the property y2 ( \copybrief y2 ).
|
|
\details Description of the parameter y2 is: <BLOCKQUOTE>\copydoc y2 </BLOCKQUOTE>
|
|
\see y2 for more information */
|
|
inline virtual double getY2() const
|
|
{
|
|
return this->y2;
|
|
}
|
|
protected:
|
|
double x1;
|
|
double y1;
|
|
double x2;
|
|
double y2;
|
|
};
|
|
|
|
|
|
|
|
/*! \brief baseclass for one-coordinate indicator overlays (horizontal/vertical lines
|
|
\ingroup jkqtplotter_overlays
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayOneCoordOverlay : public JKQTPOverlayElement {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayOneCoordOverlay(double pos, JKQTBasePlotter *parent = 0);
|
|
|
|
/*! \brief sets the property position ( \copybrief position ) to the specified \a __value.
|
|
\details Description of the parameter position is: <BLOCKQUOTE>\copydoc position </BLOCKQUOTE>
|
|
\see position for more information */
|
|
inline virtual void setPosition(double __value)
|
|
{
|
|
this->position = __value;
|
|
}
|
|
/*! \brief returns the property position ( \copybrief position ).
|
|
\details Description of the parameter position is: <BLOCKQUOTE>\copydoc position </BLOCKQUOTE>
|
|
\see position for more information */
|
|
inline virtual double getPosition() const
|
|
{
|
|
return this->position;
|
|
}
|
|
protected:
|
|
double position;
|
|
};
|
|
|
|
|
|
|
|
/*! \brief baseclass for two-coordinate indicator overlays (horizontal/vertical lines
|
|
\ingroup jkqtplotter_overlays
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayTwoCoordOverlay : public JKQTPOverlayOneCoordOverlay {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayTwoCoordOverlay(double pos, double pos2, JKQTBasePlotter *parent = 0);
|
|
|
|
/*! \brief sets the property position2 ( \copybrief position2 ) to the specified \a __value.
|
|
\details Description of the parameter position2 is: <BLOCKQUOTE>\copydoc position2 </BLOCKQUOTE>
|
|
\see position2 for more information */
|
|
inline virtual void setPosition2(double __value)
|
|
{
|
|
this->position2 = __value;
|
|
}
|
|
/*! \brief returns the property position2 ( \copybrief position2 ).
|
|
\details Description of the parameter position2 is: <BLOCKQUOTE>\copydoc position2 </BLOCKQUOTE>
|
|
\see position2 for more information */
|
|
inline virtual double getPosition2() const
|
|
{
|
|
return this->position2;
|
|
}
|
|
protected:
|
|
double position2;
|
|
};
|
|
|
|
|
|
|
|
|
|
/*! \brief draws a vertical line as an overlay
|
|
\ingroup jkqtplotter_overlays
|
|
|
|
These simple primitive elements can be used to e.g. display fast changing indicators on the graph ...
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayVerticalLine : public JKQTPOverlayOneCoordOverlay {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayVerticalLine(double pos, JKQTBasePlotter *parent = 0);
|
|
explicit JKQTPOverlayVerticalLine(double pos, const QString& text, JKQTBasePlotter *parent = 0);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter);
|
|
};
|
|
|
|
|
|
|
|
/*! \brief draws a vertical range as an overlay
|
|
\ingroup jkqtplotter_overlays
|
|
|
|
These simple primitive elements can be used to e.g. display fast changing indicators on the graph ...
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayVerticalRange : public JKQTPOverlayTwoCoordOverlay {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayVerticalRange(double pos, double pos2, JKQTBasePlotter *parent = 0);
|
|
explicit JKQTPOverlayVerticalRange(double pos, double pos2, const QString& text, JKQTBasePlotter *parent = 0);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter);
|
|
|
|
/*! \brief sets the property inverted ( \copybrief inverted ) to the specified \a __value.
|
|
\details Description of the parameter inverted is: <BLOCKQUOTE>\copydoc inverted </BLOCKQUOTE>
|
|
\see inverted for more information */
|
|
inline virtual void setInverted(bool __value)
|
|
{
|
|
this->inverted = __value;
|
|
}
|
|
/*! \brief returns the property inverted ( \copybrief inverted ).
|
|
\details Description of the parameter inverted is: <BLOCKQUOTE>\copydoc inverted </BLOCKQUOTE>
|
|
\see inverted for more information */
|
|
inline virtual bool getInverted() const
|
|
{
|
|
return this->inverted;
|
|
}
|
|
protected:
|
|
/** \brief if set \c false, the range is filled, otherwise everything outside the range is filled */
|
|
bool inverted;
|
|
};
|
|
|
|
/*! \brief draws a line throught two points
|
|
\ingroup jkqtplotter_overlays
|
|
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayLine : public JKQTPOverlayTwoPositionOverlay {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayLine(double x1, double y1, double x2, double y2, JKQTBasePlotter *parent = 0);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter);
|
|
|
|
/*! \brief sets the property infinite ( \copybrief infinite ) to the specified \a __value.
|
|
\details Description of the parameter infinite is: <BLOCKQUOTE>\copydoc infinite </BLOCKQUOTE>
|
|
\see infinite for more information */
|
|
inline virtual void setInfinite(bool __value)
|
|
{
|
|
this->infinite = __value;
|
|
}
|
|
/*! \brief returns the property infinite ( \copybrief infinite ).
|
|
\details Description of the parameter infinite is: <BLOCKQUOTE>\copydoc infinite </BLOCKQUOTE>
|
|
\see infinite for more information */
|
|
inline virtual bool getInfinite() const
|
|
{
|
|
return this->infinite;
|
|
}
|
|
protected:
|
|
/** \brief the line goes on infinitely */
|
|
bool infinite;
|
|
};
|
|
|
|
/*! \brief draws a rectangle, spanned by two points
|
|
\ingroup jkqtplotter_overlays
|
|
|
|
*/
|
|
class LIB_EXPORT JKQTPOverlayRectangle : public JKQTPOverlayTwoPositionOverlay {
|
|
Q_OBJECT
|
|
public:
|
|
explicit JKQTPOverlayRectangle(double x1, double y1, double x2, double y2, JKQTBasePlotter *parent = 0);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter);
|
|
|
|
protected:
|
|
};
|
|
|
|
#endif // jkqtpelementsoverlay_H
|