libkpl  5.0
A Library for Graphical Presentation of Data Sets and Functions
threeditem.h
1 /***************************************************************************
2  threeditem.h - description
3  -------------------
4  begin : Tue Dec 25 2001
5  copyright : (C) 2017 by Werner Stille
6  email : kpl@werner-stille.de
7  ***************************************************************************/
8 
9 /***************************************************************************
10  * *
11  * This program is free software; you can redistribute it and/or modify *
12  * it under the terms of the GNU General Public License as published by *
13  * the Free Software Foundation; either version 2 of the License, or *
14  * (at your option) any later version. *
15  * *
16  ***************************************************************************/
17 
18 #ifndef THREEDITEM_H
19 #define THREEDITEM_H
20 
21 #include <QTransform>
22 #include "frameitem.h"
23 
24 class PSGraph;
25 
30 class Q_DECL_EXPORT ThreeDItem : public FrameItem
31 {
32 public:
34  enum Mode3D {
37  Grid
38  };
92  ThreeDItem(double x0 = 4, double y0 = 3, double width = 15,
93  double height = 10, unsigned colFrame = 0, unsigned colGrid = 0,
94  unsigned colData = 0, bool logX = false, bool logY = false,
95  bool logZ = false, GridMode gridMode = AxesWithLabels,
96  Mode3D mode3D = Grid, double xMax = 15, double yMax = 10,
97  double zMax = 15, const QString& textX = "",
98  const QString& textY = "", const QString& textZ = "",
99  const QString& header = "", double relSize = 1, int numDigX = -1,
100  int numDigY = -1, int numDigZ = -1, int minTicX = 5,
101  int minTicY = 2, int minTicZ = 5, int expX = 0, int expY = 0,
102  int expZ = 0, double xMin = 0, double yMin = 0, double zMin = 0,
103  double xTic = 5, double yTic = 2, double zTic = 5,
104  double deltaX = 0, double deltaZ = 0, double phi = 20,
105  double theta = -20, double boxX = 7.5, double boxY = 7.5,
106  double boxZ = 7.5, double xRef = 7.5, double yRef = 4,
107  double fx = 1, double fy = 1, double fz = 1,
108  bool showFrame = true, bool collapsed = false,
109  bool visible = true);
127  ThreeDItem(const KConfigGroup* plo, double x0, double y0, double width,
128  double height, unsigned colorFrame, unsigned colorGrid,
129  unsigned colorData, GridMode gridMode);
133  virtual QRectF boundingRect() const;
135  inline double boxX() const { return m_boxX; };
137  inline double boxY() const { return m_boxY; };
139  inline double boxZ() const { return m_boxZ; };
141  inline unsigned colorData() const { return m_colorData; };
143  inline double deltaX() const { return m_deltaX; };
145  inline double deltaZ() const { return m_deltaZ; };
153  void exportTable(QTextStream& stream, char separator, char format,
154  int precision) const;
156  inline int expZ() const { return m_expZ; };
158  inline double fX() const { return m_fX; };
160  inline double fY() const { return m_fY; };
162  inline double fZ() const { return m_fZ; };
164  inline bool logZ() const { return m_logZ; };
166  inline int minTicZ() const { return m_minTicZ; };
171  inline Mode3D mode3D() const { return m_mode3D; };
173  inline int numDigZ() const { return m_numDigZ; };
175  virtual void paint(QPainter* painter, const QStyleOptionGraphicsItem* option,
176  QWidget* widget = 0);
182  void paintCond(QPainter* painter, PSGraph* ps = 0) const;
184  inline double phi() const { return m_phi; };
189  inline void setBoxX(double width) { m_boxX = width; };
194  inline void setBoxY(double width) { m_boxY = width; };
199  inline void setBoxZ(double width) { m_boxZ = width; };
204  inline void setColorData(unsigned color) { m_colorData = color; };
209  inline void setDeltaX(double dx) { m_deltaX = dx; };
214  inline void setDeltaZ(double dz) { m_deltaZ = dz; };
219  inline void setExpZ(int e) { m_expZ = e; };
224  inline void setFX(double fx) { m_fX = fx; };
229  inline void setFY(double fy) { m_fY = fy; };
234  inline void setFZ(double fz) { m_fZ = fz; };
239  inline void setLogZ(bool logZ) { m_logZ = logZ; };
244  inline void setMinTicZ(int minTicZ) { m_minTicZ = minTicZ; };
249  inline void setMode3D(Mode3D mode3D) { m_mode3D = mode3D; };
254  inline void setNumDigZ(int numDigZ) { m_numDigZ = numDigZ; };
259  inline void setPhi(double phi) { m_phi = phi; };
264  void setProperties(const QTransform& m);
269  inline void setShowFrame(bool showFrame) { m_showFrame = showFrame; };
274  inline void setTextZ(const QString& text) { m_textZ = text; };
279  inline void setTheta(double theta) { m_theta = theta; };
284  inline void setXRef(double xRef) { m_xRef = xRef; };
289  inline void setYRef(double yRef) { m_yRef = yRef; };
294  inline void setZMax(double zMax) { m_zMax = zMax; };
299  inline void setZMin(double zMin) { m_zMin = zMin; };
304  inline void setZTic(double zTic) { m_zTic = zTic; };
306  inline bool showFrame() const { return m_showFrame; };
308  inline QString textZ() const { return m_textZ; };
310  inline double theta() const { return m_theta; };
312  void update();
317  void writePlo(KConfigGroup* plo) const;
319  inline double xRef() const { return m_xRef; };
321  inline double yRef() const { return m_yRef; };
323  double** yValues() const { return m_yValues; };
325  inline double zMax() const { return m_zMax; };
327  inline double zMin() const { return m_zMin; };
329  inline double zTic() const { return m_zTic; };
330 
331 protected:
333  enum Axis {
334  X,
335  Y,
336  Z
337  };
355  void axis3D(QPainter* painter, double vMin, double vMax, double tic,
356  int minTic,
357  double f, double scale, double xAxis, double zAxis,
358  double ticLen, int numDig, Axis axis, bool log,
359  PSGraph* ps = 0) const;
370  void drawText(QPainter* painter, const QString& text, double x, double y,
371  TextItem::Alignment alignment, PSGraph* ps,
372  double dir = 0) const;
379  void frame3D(QPainter* painter, int iBack, PSGraph* ps = 0) const;
391  void line3D(QPainter* painter, double x1, double y1, double z1,
392  double x2, double y2, double z2, PSGraph* ps = 0) const;
398  void plotArray3D(QPainter* painter, PSGraph* ps = 0) const;
418  void plot3D(QPainter* painter, bool xArray, bool yArray, bool zArray,
419  const double* xData, const double* yData,
420  const double* zData, double xScale, double yScale,
421  double zScale, bool firstLine, int n, double xOffset,
422  double yOffset, double* vertex, PSGraph* ps = 0) const;
432  void plotArray(QPainter* painter, const double* x, const double* y, int n,
433  PSGraph* ps = 0) const;
439  void raster3d(QPainter* painter, PSGraph* ps = 0) const;
447  double xFrom3d(double x, double z) const;
454  double yFrom3d(double x, double y, double z) const;
455  bool m_showFrame, m_logZ;
456  mutable bool logXo, logZo;
457  int m_numDigZ, m_minTicZ, m_expZ;
458  Mode3D m_mode3D;
459  mutable int nx, nz;
460  unsigned m_colorData;
461  double m_zMin, m_zMax, m_deltaX, m_deltaZ, m_zTic, m_phi, m_theta, m_boxX,
462  m_boxY, m_boxZ, m_xRef, m_yRef, m_fX, m_fY, m_fZ, zminl;
463  mutable double xStep, zStep, xMino, xMaxo, deltaXo, zMino, zMaxo, deltaZo,
464  scalx, scaly, scalz, scal3D, phio, thetao, xOff3D, yOff3D;
465  mutable double** m_yValues;
466  mutable double vertex[16];
467  mutable QTransform m3D;
468  mutable QVector<double> yMin3D, yMax3D;
469  QString m_textZ;
470 };
471 
472 #endif
Frame item class.
Definition: frameitem.h:34
double width() const
Returns width in cm.
Definition: frameitem.h:408
GridMode
Grid mode.
Definition: frameitem.h:37
PS graphics class.
Definition: psgraph.h:46
Alignment
Text alignment.
Definition: textitem.h:33
3D item class.
Definition: threeditem.h:31
void setShowFrame(bool showFrame)
Sets frame mode.
Definition: threeditem.h:269
void plotArray(QPainter *painter, const double *x, const double *y, int n, PSGraph *ps=0) const
Plots array.
void setBoxY(double width)
Sets y box width in cm.
Definition: threeditem.h:194
void setYRef(double yRef)
Sets y position of center of box bottom plane.
Definition: threeditem.h:289
void setTextZ(const QString &text)
Sets z axis text.
Definition: threeditem.h:274
void frame3D(QPainter *painter, int iBack, PSGraph *ps=0) const
Plots 3D frame.
Mode3D mode3D() const
Returns 0 for lines parallel to x, 1 for lines parallel to z, 2 for x,z grid.
Definition: threeditem.h:171
~ThreeDItem()
Destructor.
void setZMax(double zMax)
Sets upper z data limit.
Definition: threeditem.h:294
void plotArray3D(QPainter *painter, PSGraph *ps=0) const
Plots 3D data.
virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget=0)
Paints item.
void writePlo(KConfigGroup *plo) const
Writes into plot file.
void exportTable(QTextStream &stream, char separator, char format, int precision) const
Exports value table to file.
void setExpZ(int e)
Sets exponent of z normalization factor.
Definition: threeditem.h:219
void setBoxZ(double width)
Sets z box width in cm.
Definition: threeditem.h:199
void setTheta(double theta)
Sets angle of rotation about y axis.
Definition: threeditem.h:279
double theta() const
Returns angle of rotation about y axis in deg.
Definition: threeditem.h:310
double xFrom3d(double x, double z) const
Calculates 2D x value.
ThreeDItem(const KConfigGroup *plo, double x0, double y0, double width, double height, unsigned colorFrame, unsigned colorGrid, unsigned colorData, GridMode gridMode)
Constructor.
void setLogZ(bool logZ)
Sets logarithmic mode of z axis.
Definition: threeditem.h:239
void paintCond(QPainter *painter, PSGraph *ps=0) const
Paints or calculates bounding area.
void plot3D(QPainter *painter, bool xArray, bool yArray, bool zArray, const double *xData, const double *yData, const double *zData, double xScale, double yScale, double zScale, bool firstLine, int n, double xOffset, double yOffset, double *vertex, PSGraph *ps=0) const
Plots curve in 3D space.
double boxZ() const
Returns z box width in cm.
Definition: threeditem.h:139
void setMinTicZ(int minTicZ)
Sets number of intervals between major tics of z axis.
Definition: threeditem.h:244
void setZTic(double zTic)
Sets z tic distance.
Definition: threeditem.h:304
void setNumDigZ(int numDigZ)
Sets number of digits for z axis.
Definition: threeditem.h:254
double yFrom3d(double x, double y, double z) const
Calculates 2D y value.
Axis
3D mode.
Definition: threeditem.h:333
@ Y
y axis.
Definition: threeditem.h:335
@ X
x axis.
Definition: threeditem.h:334
double fZ() const
Returns normalization factor for z values.
Definition: threeditem.h:162
void setMode3D(Mode3D mode3D)
Sets 3D mode.
Definition: threeditem.h:249
double zMin() const
Returns lower z data limit user units.
Definition: threeditem.h:327
unsigned colorData() const
Returns color for data.
Definition: threeditem.h:141
bool showFrame() const
Returns true for shown frame.
Definition: threeditem.h:306
double boxX() const
Returns x box width in cm.
Definition: threeditem.h:135
void setBoxX(double width)
Sets x box width in cm.
Definition: threeditem.h:189
double boxY() const
Returns y box width in cm.
Definition: threeditem.h:137
QString textZ() const
Returns z axis text.
Definition: threeditem.h:308
void update()
Applies changes and forces redrawing.
int minTicZ() const
Returns number of intervals between major tics of z axis.
Definition: threeditem.h:166
void setProperties()
Sets properties according to transformation matrix.
void setFX(double fx)
Sets x normalization factor.
Definition: threeditem.h:224
void line3D(QPainter *painter, double x1, double y1, double z1, double x2, double y2, double z2, PSGraph *ps=0) const
Draws line in 3D space.
double deltaX() const
Returns x step size of grid.
Definition: threeditem.h:143
void setProperties(const QTransform &m)
Sets properties according to transformation matrix.
ThreeDItem(double x0=4, double y0=3, double width=15, double height=10, unsigned colFrame=0, unsigned colGrid=0, unsigned colData=0, bool logX=false, bool logY=false, bool logZ=false, GridMode gridMode=AxesWithLabels, Mode3D mode3D=Grid, double xMax=15, double yMax=10, double zMax=15, const QString &textX="", const QString &textY="", const QString &textZ="", const QString &header="", double relSize=1, int numDigX=-1, int numDigY=-1, int numDigZ=-1, int minTicX=5, int minTicY=2, int minTicZ=5, int expX=0, int expY=0, int expZ=0, double xMin=0, double yMin=0, double zMin=0, double xTic=5, double yTic=2, double zTic=5, double deltaX=0, double deltaZ=0, double phi=20, double theta=-20, double boxX=7.5, double boxY=7.5, double boxZ=7.5, double xRef=7.5, double yRef=4, double fx=1, double fy=1, double fz=1, bool showFrame=true, bool collapsed=false, bool visible=true)
Constructor.
void setFZ(double fz)
Sets z normalization factor.
Definition: threeditem.h:234
void setDeltaZ(double dz)
Sets z step size of grid.
Definition: threeditem.h:214
bool logZ() const
Returns true for logarithmic z axis.
Definition: threeditem.h:164
void setZMin(double zMin)
Sets lower z data limit.
Definition: threeditem.h:299
double xRef() const
Returns x position of center of box bottom plane.
Definition: threeditem.h:319
int expZ() const
Returns logarithm of normalization factor for z axis.
Definition: threeditem.h:156
double zMax() const
Returns upper z data limit user units.
Definition: threeditem.h:325
double ** yValues() const
Returns pointer to y value array.
Definition: threeditem.h:323
double phi() const
Returns angle of rotation about y axis in deg.
Definition: threeditem.h:184
int numDigZ() const
Returns number of digits for z axis.
Definition: threeditem.h:173
double yRef() const
Returns y position of center of box bottom plane.
Definition: threeditem.h:321
void setXRef(double xRef)
Sets x position of center of box bottom plane.
Definition: threeditem.h:284
void axis3D(QPainter *painter, double vMin, double vMax, double tic, int minTic, double f, double scale, double xAxis, double zAxis, double ticLen, int numDig, Axis axis, bool log, PSGraph *ps=0) const
Plots 3D axis.
void raster3d(QPainter *painter, PSGraph *ps=0) const
Draws frame and axes of 3D plot.
void setPhi(double phi)
Sets angle of rotation about y axis.
Definition: threeditem.h:259
void setDeltaX(double dx)
Sets x step size of grid.
Definition: threeditem.h:209
double fX() const
Returns normalization factor for x values.
Definition: threeditem.h:158
void setColorData(unsigned color)
Sets color for data.
Definition: threeditem.h:204
double fY() const
Returns normalization factor for y values.
Definition: threeditem.h:160
ThreeDItem(const ThreeDItem &a)
Copy constructor.
double zTic() const
Returns distance between major tics of z axis.
Definition: threeditem.h:329
void setFY(double fy)
Sets y normalization factor.
Definition: threeditem.h:229
virtual QRectF boundingRect() const
Calculates bounding rectangle.
double deltaZ() const
Returns z step size of grid.
Definition: threeditem.h:145
void drawText(QPainter *painter, const QString &text, double x, double y, TextItem::Alignment alignment, PSGraph *ps, double dir=0) const
Plots text.
Mode3D
3D mode.
Definition: threeditem.h:34
@ AlongX
Lines along x direction.
Definition: threeditem.h:35
@ AlongZ
Lines along z direction.
Definition: threeditem.h:36