3D item class. More...

#include <threeditem.h>

Inheritance diagram for ThreeDItem:

[legend]

Public Types
enum	Mode3D { AlongX , AlongZ , Grid }
	3D mode. More...

Public Types inherited from FrameItem
enum	GridMode { FrameOnly , Axes , AxesWithLabels , Grid , GridWithLabels }
	Grid mode. More...

enum	{ Type = UserType + Frame }
	Specific QGraphicsItem type number for function type() More...

Public Types inherited from KplItem
enum	FillStyle { NoBrush , SolidPattern , HorPattern , VerPattern , CrossPattern , BDiagPattern , FDiagPattern , DiagCrossPattern }
	Fill styles. More...

enum	ItemType { Frame = 1 , Array , Function , ParFunction , Spline , Array3D , Function3D , Legend , Text , Line , Arrow , Arc , Rectangle , Ellipse , Image , ScaleBar }
	Item types. More...

enum	PenType { FramePen , GridPen , DataPen }
	Pen types. More...

enum	Symbol { Invisible = -17 , FilledOctagon , FilledHourglass , FilledTriangle , FilledSquare , FilledDiamond , FilledCircle , Umbrella , Ypsilon , Plus , Cross , OpenOctagon , OpenHourglass , OpenTriangle , OpenSquare , OpenDiamond , Dot , OpenCircle , SolidLine , DashLine1 , DashLine2 , DotLine1 , DashLine3 , DashDotLine , DashLine4 , DashLine5 , DotLine2 }
	Symbol types. More...

Public Member Functions
	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=QString(), const QString &textY=QString(), const QString &textZ=QString(), const QString &header=QString(), 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.

	ThreeDItem (const ThreeDItem &a)
	Copy constructor.

	ThreeDItem (const KConfigGroup *plo, double x0, double y0, double width, double height, unsigned colorFrame, unsigned colorGrid, unsigned colorData, GridMode gridMode)
	Constructor.

	~ThreeDItem ()
	Destructor.

virtual QRectF	boundingRect () const override
	Calculates bounding rectangle.

double	boxX () const
	Returns x box width in cm.

double	boxY () const
	Returns y box width in cm.

double	boxZ () const
	Returns z box width in cm.

unsigned	colorData () const
	Returns color for data.

double	deltaX () const
	Returns x step size of grid.

double	deltaZ () const
	Returns z step size of grid.

void	exportTable (QTextStream &stream, char separator, char format, int precision) const
	Exports value table to file.

int	expZ () const
	Returns logarithm of normalization factor for z axis.

double	fX () const
	Returns normalization factor for x values.

double	fY () const
	Returns normalization factor for y values.

double	fZ () const
	Returns normalization factor for z values.

bool	logZ () const
	Returns true for logarithmic z axis.

int	minTicZ () const
	Returns number of intervals between major tics of z axis.

Mode3D	mode3D () const
	Returns 0 for lines parallel to x, 1 for lines parallel to z, 2 for x,z grid.

int	numDigZ () const
	Returns number of digits for z axis.

virtual void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget=nullptr) override
	Paints item.

void	paintCond (QPainter painter, PSGraph ps=nullptr) const
	Paints or calculates bounding area.

double	phi () const
	Returns angle of rotation about y axis in deg.

void	setBoxX (double width)
	Sets x box width in cm.

void	setBoxY (double width)
	Sets y box width in cm.

void	setBoxZ (double width)
	Sets z box width in cm.

void	setColorData (unsigned color)
	Sets color for data.

void	setDeltaX (double dx)
	Sets x step size of grid.

void	setDeltaZ (double dz)
	Sets z step size of grid.

void	setExpZ (int e)
	Sets exponent of z normalization factor.

void	setFX (double fx)
	Sets x normalization factor.

void	setFY (double fy)
	Sets y normalization factor.

void	setFZ (double fz)
	Sets z normalization factor.

void	setLogZ (bool logZ)
	Sets logarithmic mode of z axis.

void	setMinTicZ (int minTicZ)
	Sets number of intervals between major tics of z axis.

void	setMode3D (Mode3D mode3D)
	Sets 3D mode.

void	setNumDigZ (int numDigZ)
	Sets number of digits for z axis.

void	setPhi (double phi)
	Sets angle of rotation about y axis.

void	setProperties (const QTransform &m)
	Sets properties according to transformation matrix.

void	setShowFrame (bool showFrame)
	Sets frame mode.

void	setTextZ (const QString &text)
	Sets z axis text.

void	setTheta (double theta)
	Sets angle of rotation about y axis.

void	setXRef (double xRef)
	Sets x position of center of box bottom plane.

void	setYRef (double yRef)
	Sets y position of center of box bottom plane.

void	setZMax (double zMax)
	Sets upper z data limit.

void	setZMin (double zMin)
	Sets lower z data limit.

void	setZTic (double zTic)
	Sets z tic distance.

bool	showFrame () const
	Returns true for shown frame.

QString	textZ () const
	Returns z axis text.

double	theta () const
	Returns angle of rotation about y axis in deg.

void	update ()
	Applies changes and forces redrawing.

void	writePlo (KConfigGroup *plo) const
	Writes into plot file.

double	xRef () const
	Returns x position of center of box bottom plane.

double	yRef () const
	Returns y position of center of box bottom plane.

double **	yValues () const
	Returns pointer to y value array.

double	zMax () const
	Returns upper z data limit user units.

double	zMin () const
	Returns lower z data limit user units.

double	zTic () const
	Returns distance between major tics of z axis.

Public Member Functions inherited from FrameItem
	FrameItem (double x0=4, double y0=3, double width=15, double height=10, unsigned colorFrame=0, unsigned colorGrid=0, bool logX=false, bool logY=false, GridMode gridMode=AxesWithLabels, double xMax=15, double yMax=10, const QString &textX=QString(), const QString &textY=QString(), const QString &header=QString(), double relSize=1, int numDigX=-1, int numDigY=-1, int minTicX=5, int minTicY=2, int expX=0, int expY=0, double xMin=0, double yMin=0, double xTic=5, double yTic=2, bool collapsed=false, bool visible=true, double xOffset=0, double yOffset=0, bool xBottom=true, bool xTop=false, bool yLeft=true, bool yRight=false)
	Constructor.

	FrameItem (const FrameItem &a)
	Copy constructor.

	FrameItem (const KConfigGroup *plo, double x0=4, double y0=3, double width=15, double height=10, unsigned colorFrame=0, unsigned colorGrid=0, GridMode gridMode=AxesWithLabels)
	Constructor.

virtual	~FrameItem ()
	Destructor.

void	autoScale (double xmi, double xma, double fx, double ymi, double yma, double fy)
	Calculates and sets the scaling parameters.

void	autoScale (bool autoNorm=true)
	Calculates and sets the scaling parameters.

bool	calcAutoScale (bool autoNorm, const QList< QGraphicsItem * > &items, double &fx, double &fy)
	Calculates scaling parameters for a frame item and all its child items.

QRectF	clipRect () const
	Returns clipping rectangle.

unsigned	colorFrame () const
	Returns color for frame and labels.

unsigned	colorGrid () const
	Returns color for grids and tics.

int	expX () const
	Returns logarithm of normalization factor for x axis.

int	expY () const
	Returns logarithm of normalization factor for y axis.

GridMode	gridMode () const
	Returns grid mode.

QString	header () const
	Returns heading text.

double	height () const
	Returns height in cm.

bool	collapsed () const
	Returns collapse state for list view.

bool	logX () const
	Returns true for logarithmic x axis.

bool	logY () const
	Returns true for logarithmic y axis.

QPointF	mapFromUser (const QPointF &p) const
	Maps from user to pixel coordinates.

QPointF	mapToUser (const QPointF &p) const
	Maps from pixel to user coordinates.

QRectF	mapToUser (const QRectF &rect) const
	Maps from pixel to user coordinates.

int	minTicX () const
	Returns number of intervals between major tics of x axis.

int	minTicY () const
	Returns number of intervals between major tics of y axis.

double	normX () const
	Returns normalization factor for x values.

double	normY () const
	Returns normalization factor for y values.

int	numDigX () const
	Returns number of digits for x axis.

int	numDigY () const
	Returns number of digits for y axis.

QPointF	rectPos () const
	Returns position in cm units.

void	setColorFrame (unsigned color)
	Sets color for frame and labels.

void	setColorGrid (unsigned color)
	Sets color for grids and tics.

void	setExpX (int expX)
	Sets exponent of x normalization factor.

void	setExpY (int expY)
	Sets exponent of y normalization factor.

void	setGridMode (GridMode gridMode)
	Sets grid mode.

void	setHeight (double height)
	Sets height.

void	setLogX (bool logX)
	Sets logarithmic mode of x axis.

void	setLogY (bool logY)
	Sets logarithmic mode of y axis.

void	setMinTicX (int minTicX)
	Sets number of intervals between major tics of x axis.

void	setMinTicY (int minTicY)
	Sets number of intervals between major tics of y axis.

void	setNumDigX (int numDigX)
	Sets number of digits for x axis.

void	setNumDigY (int numDigY)
	Sets number of digits for y axis.

void	setProperties (const QTransform &m)
	Sets properties according to transformation matrix.

void	setHeader (const QString &text)
	Sets heading text.

void	setTextX (const QString &text)
	Sets x axis text.

void	setTextY (const QString &text)
	Sets y axis text.

void	setWidth (double width)
	Sets width.

void	setX0 (double x0)
	Sets left page margin.

void	setXBottom (bool xBottom)
	Sets bottom side label mode.

void	setXMax (double xMax)
	Sets upper x data limit.

void	setXMin (double xMin)
	Sets lower x data limit.

void	setXOffset (double xOffset)
	Sets x offset.

void	setXTic (double xTic)
	Sets x tick distance.

void	setXTop (bool xTop)
	Sets top side label mode.

void	setY0 (double y0)
	Sets bottom page margin.

void	setYLeft (bool yLeft)
	Sets left side label mode.

void	setYMax (double yMax)
	Sets upper y data limit.

void	setYMin (double yMin)
	Sets lower y data limit.

void	setYOffset (double yOffset)
	Sets y offset.

void	setYRight (bool yRight)
	Sets right side label mode.

void	setYTic (double yTic)
	Sets y tick distance.

QPointF	steps () const
	Returns user units steps for one pixel steps.

QString	textX () const
	Returns x axis text.

QString	textY () const
	Returns y axis text.

virtual int	type () const override
	Returns specific QGraphicsItem type number.

void	toggleCollapsed ()
	Toggles collapse state.

void	update ()
	Applies changes and forces redrawing.

void	updatePos (QPointF p)
	Sets position.

bool	valid (double x, double y) const
	Checks coordinates for validity.

double	width () const
	Returns width in cm.

void	writePlo (KConfigGroup *plo) const
	Writes into plot file.

double	x0 () const
	Returns left page margin in cm.

bool	xBottom () const
	Returns true for x axis labels on bottom side.

double	xMax () const
	Returns x value of right data window margin in user units.

double	xMin () const
	Returns x value of left data window margin in user units.

double	xOffset () const
	Returns offset for first major x tick.

double	xTic () const
	Returns distance between major tics of x axis.

bool	xTop () const
	Returns true for x axis labels on top side.

double	y0 () const

bool	yLeft () const
	Returns true for y axis labels on left side.

bool	yRight () const
	Returns true for y axis labels on right side.

double	yMax () const
	Returns y value of upper data window margin in user units.

double	yMin () const
	Returns y value of lower data window margin in user units.

double	yOffset () const
	Returns offset for first major y tick.

double	yTic () const
	Returns distance between major tics of y axis.

Public Member Functions inherited from KplItem
	KplItem (double relSize=1)
	Constructor.

	KplItem (const KplItem &a)
	Copy constructor.

	KplItem (const KConfigGroup *plo)
	Constructor.

virtual	~KplItem ()
	Destructor.

void	readPlo (const KConfigGroup *plo)
	Initializes corresponding to plot file.

double	relSize () const
	Returns relative size of item.

void	setRelSize (double relSize)
	Sets relative size of item.

void	writePlo (KConfigGroup *plo, bool visible=true) const
	Writes into plot file.

Protected Types
enum	Axis { X , Y , Z }
	3D mode. More...

Protected Member Functions
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=nullptr) const
	Plots 3D axis.

void	drawText (QPainter painter, const QString &text, double x, double y, TextItem::Alignment alignment, PSGraph ps, double dir=0) const
	Plots text.

void	frame3D (QPainter painter, int iBack, PSGraph ps=nullptr) const
	Plots 3D frame.

void	line3D (QPainter painter, double x1, double y1, double z1, double x2, double y2, double z2, PSGraph ps=nullptr) const
	Draws line in 3D space.

void	plotArray3D (QPainter painter, PSGraph ps=nullptr) const
	Plots 3D data.

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=nullptr) const
	Plots curve in 3D space.

void	plotArray (QPainter painter, const double x, const double y, int n, PSGraph ps=nullptr) const
	Plots array.

void	raster3d (QPainter painter, PSGraph ps=nullptr) const
	Draws frame and axes of 3D plot.

void	setProperties ()
	Sets properties according to transformation matrix.

double	xFrom3d (double x, double z) const
	Calculates 2D x value.

double	yFrom3d (double x, double y, double z) const
	Calculates 2D y value.

Protected Member Functions inherited from FrameItem
void	drawText (QPainter *painter, const QString &text, double x, double y, TextItem::Alignment alignment, double dir=0) const
	Plots text.

double	incLog (double &x, double f) const
	Increment logarithm for next major axis tick.

virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event) override
	Updates position.

int	number (double v, int numDig, QString &label) const
	Prepares number label.

void	paintCond (QPainter *painter) const
	Paints or calculates bounding area.

void	setProperties ()
	Sets properties according to transformation matrix.

double	tick (double tic, bool log) const
	Calculates actual distance between major tics.

Protected Member Functions inherited from KplItem
QPen &	changePenWidth (QPen &pen, double width) const
	Changes pen width.

QPen	createPen (QGraphicsItem *item, unsigned color=0, PenType penType=DataPen, Symbol symbol=SolidLine) const
	Creates pen for plot item.

double	penWidth (const QGraphicsItem *item, PenType penType=DataPen) const
	Calculates pen width for plot item.

Protected Attributes
bool	m_showFrame

bool	m_logZ

bool	logXo

bool	logZo

int	m_numDigZ

int	m_minTicZ

int	m_expZ

Mode3D	m_mode3D

int	nx

int	nz

unsigned	m_colorData

double	m_zMin

double	m_zMax

double	m_deltaX

double	m_deltaZ

double	m_zTic

double	m_phi

double	m_theta

double	m_boxX

double	m_boxY

double	m_boxZ

double	m_xRef

double	m_yRef

double	m_fX

double	m_fY

double	m_fZ

double	zminl

double	xStep

double	zStep

double	xMino

double	xMaxo

double	deltaXo

double	zMino

double	zMaxo

double	deltaZo

double	scalx

double	scaly

double	scalz

double	scal3D

double	phio

double	thetao

double	xOff3D

double	yOff3D

double **	m_yValues

double	vertex [16]

QTransform	m3D

QVector< double >	yMin3D

QVector< double >	yMax3D

QString	m_textZ

Protected Attributes inherited from FrameItem
bool	m_logX

bool	m_logY

bool	m_xBottom

bool	m_xTop

bool	m_yLeft

bool	m_yRight

bool	m_collapsed

int	m_numDigX

int	m_numDigY

int	m_minTicX

int	m_minTicY

int	m_expX

int	m_expY

GridMode	m_gridMode

unsigned	m_colorFrame

unsigned	m_colorGrid

double	m_x0

double	m_y0

double	m_width

double	m_height

double	m_xMin

double	m_xMax

double	m_yMin

double	m_yMax

double	m_xTic

double	m_yTic

double	m_xOffset

double	m_yOffset

double	m_normX

double	m_normY

double	xminl

double	xmaxl

double	yminl

double	ymaxl

QString	m_textX

QString	m_textY

QString	m_header

QRectF	bRect

QRectF	cRect

QTransform	md

QTransform	m_inv

QTransform	m_matrix

Protected Attributes inherited from KplItem
double	m_relSize

Additional Inherited Members
Static Public Member Functions inherited from FrameItem
static void	autoScale (double &xMin, double &xMax, double &tick, int &minTic, int &numDig, double xmi, double xma, double f, double c, bool log)
	Calculates scaling parameters.

static bool	valid (double v, bool log=false)
	Checks a double value for validity.

Static Public Member Functions inherited from KplItem
static QUrl	absoluteUrl (const QString &path, const QUrl &urlPlo)
	Constructs absolute file URL.

static QBrush	createBrush (unsigned color, FillStyle fillStyle=NoBrush)
	Creates brush.

static QPen	createPen (double width, unsigned color, PenType penType, Symbol symbol)
	Creates pen.

static void	paintSymbol (QPainter *painter, const QRectF &rect, Symbol symbol=OpenCircle)
	Paints symbol.

static QPixmap	pixmap (Symbol symbol)
	Returns black decoration pixmap of plot symbol for use in dialog GUI.

static QPixmap	pixmap (QPen pen, Symbol symbol=SolidLine)
	Returns decoration pixmap of plot symbol for use in item lists.

static QString	path (const QUrl &urlPlo, const QUrl &url, bool absolute=false)
	Constructs absolute or (if possible) relative file path.

static void	resetDashOffset ()
	Resets offset for dashed lines.

static unsigned	rgb (const QString &color)
	Converts rgb string to QRgb.

static unsigned	rgbQt1 (unsigned rgb)
	Converts QRgb to Qt1 QRgb.

Static Protected Member Functions inherited from KplItem
static double	parentWidth (const QGraphicsItem *item)
	Returns width of item's parent frame or width of scene if the item has no parent item.

static double	penWidthFactor (PenType penType)
	Returns factor to calculate pen width from frame width.

Static Protected Attributes inherited from KplItem
static double	m_dashOffset

Detailed Description

3D item class.

Base class for 3D array items and 3d function items.

Author: Werner Stille

Member Enumeration Documentation

◆ Axis

enum ThreeDItem::Axis

protected

3D mode.

Determines how the surface y = f(x, z) should be plotted.

Enumerator
X	x axis.
Y	y axis.
Z	z axis.

◆ Mode3D

enum ThreeDItem::Mode3D

3D mode.

Determines how the surface y = f(x, z) should be plotted.

Enumerator
AlongX	Lines along x direction.
AlongZ	Lines along z direction.
Grid	x, z grid.

Constructor & Destructor Documentation

◆ ThreeDItem() [1/3]

ThreeDItem::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 = QString(),
		const QString &	textY = QString(),
		const QString &	textZ = QString(),
		const QString &	header = QString(),
		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.

Initializes corresponding to arguments.

Parameters

x0	left page margin in centimeters.
y0	bottom page margin in centimeters.
width	width in centimeters.
height	height in centimeters.
colFrame	color for frame and labels.
colGrid	color for grids and tics.
colData	color for data plot.
logX	true for logarithmic x axis.
logY	true for logarithmic y axis.
logZ	true for logarithmic y axis.
gridMode	grid mode.
mode3D	3D mode.
xMax	maximum x value.
yMax	maximum y value.
zMax	maximum z value.
textX	x axis text.
textY	y axis text.
textZ	z axis text.
header	heading text.
relSize	relative size of text, markers and lines.
numDigX	number of digits for x axis.
numDigY	number of digits for y axis.
numDigZ	number of digits for z axis.
minTicX	number of intervals between major tics of x axis.
minTicY	number of intervals between major tics of y axis.
minTicZ	number of intervals between major tics of z axis.
expX	logarithm of normalization factor for x axis.
expY	logarithm of normalization factor for y axis.
expZ	logarithm of normalization factor for z axis.
xMin	minimum x value.
yMin	minimum y value.
zMin	minimum z value.
xTic	distance between major tics of x axis.
yTic	distance between major tics of y axis.
zTic	distance between major tics of z axis.
deltaX	x step size of grid.
deltaZ	z step size of grid.
phi	angle of rotation about y axis in deg.
theta	tilt angle of y axis in deg.
boxX	x box width in cm.
boxY	y box width in cm.
boxZ	z box width in cm.
xRef	x position of center of box bottom plane.
yRef	y position of center of box bottom plane.
fx	normalization factor for x values.
fy	normalization factor for y values.
fz	normalization factor for z values.
showFrame	true to show frame.
collapsed	true for collapsed in list view.
visible	true for visible item.

◆ ThreeDItem() [2/3]

ThreeDItem::ThreeDItem ( const ThreeDItem & a )

Copy constructor.

Parameters

a	source item.

◆ ThreeDItem() [3/3]

ThreeDItem::ThreeDItem	(	const KConfigGroup *	plo,
		double	x0,
		double	y0,
		double	width,
		double	height,
		unsigned	colorFrame,
		unsigned	colorGrid,
		unsigned	colorData,
		GridMode	gridMode )

Constructor.

Initializes corresponding to plot file.

Parameters

plo	pointer to KConfigGroup object containing item data.
x0	default value for left page margin in centimeters.
y0	default value for bottom page margin in centimeters.
width	default value for width in centimeters.
height	default value for height in centimeters.
colorFrame	default value for color for frame and labels.
colorGrid	default value for color for grids and tics.
colorData	color for data plot.
gridMode	grid mode.

Member Function Documentation

◆ axis3D()

void ThreeDItem::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 = nullptr ) const

protected

Plots 3D axis.

Parameters

painter	pointer to QPainter object.
vMin	minimum axis value.
vMax	maximum axis value.
tic	distance between major tics.
minTic	number of intervals between major tics.
f	normalization factor.
scale	scaling factor.
xAxis	3D x position of axis start point.
zAxis	3D z position of axis start point.
ticLen	tic length.
numDig	number of digits.
axis	axis.
log	true for logarithmic axis.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ boundingRect()

virtual QRectF ThreeDItem::boundingRect ( ) const

overridevirtual

Calculates bounding rectangle.

Reimplemented from FrameItem.

◆ drawText()

void ThreeDItem::drawText	(	QPainter *	painter,
		const QString &	text,
		double	x,
		double	y,
		TextItem::Alignment	alignment,
		PSGraph *	ps,
		double	dir = 0 ) const

protected

Plots text.

Parameters

painter	pointer to QPainter object.
text	text.
x	x position in pixel units.
y	y position in pixel units.
alignment	horizontal alignment.
ps	pointer to PSGraph object, != 0 for PostScript output.
dir	text direction in degree.

◆ exportTable()

void ThreeDItem::exportTable	(	QTextStream &	stream,
		char	separator,
		char	format,
		int	precision ) const

Exports value table to file.

Parameters

stream	stream for output file.
separator	column separator character.
format	C format character.
precision	precision.

◆ frame3D()

void ThreeDItem::frame3D	(	QPainter *	painter,
		int	iBack,
		PSGraph *	ps = nullptr ) const

protected

Plots 3D frame.

Parameters

painter	pointer to QPainter object.
iBack	index of vertex furthest in the background.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ line3D()

void ThreeDItem::line3D	(	QPainter *	painter,
		double	x1,
		double	y1,
		double	z1,
		double	x2,
		double	y2,
		double	z2,
		PSGraph *	ps = nullptr ) const

protected

Draws line in 3D space.

Parameters

painter	pointer to QPainter object.
x1	3D x value of point 1.
y1	3D y value of point 1.
z1	3D z value of point 1.
x2	3D x value of point 2.
y2	3D y value of point 2.
z2	3D z value of point 2.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ paint()

virtual void ThreeDItem::paint	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		QWidget *	widget = nullptr )

overridevirtual

Paints item.

Reimplemented from FrameItem.

Reimplemented in Array3DItem, and Fun3DItem.

◆ paintCond()

void ThreeDItem::paintCond	(	QPainter *	painter,
		PSGraph *	ps = nullptr ) const

Paints or calculates bounding area.

Parameters

painter	QPainter object, 0 for calculating bounding area.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ plot3D()

void ThreeDItem::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 = nullptr ) const

protected

Plots curve in 3D space.

Parameters

painter	pointer to QPainter object.
xArray	true for array in xData.
yArray	true for array in yData.
zArray	true for array in zData.
xData	array or start value of x data.
yData	array or start value of y data.
zData	array or start value of z data.
xScale	factor for x array step width x data.
yScale	factor for y array step width y data.
zScale	factor for z array step width z data.
firstLine	true for first line of 3D surface.
n	number of points of the curve.
xOffset	2D x offset for 3D y axis mimimum.
yOffset	2D y offset for 3D y axis mimimum.
vertex	array to store vertices.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ plotArray()

void ThreeDItem::plotArray	(	QPainter *	painter,
		const double *	x,
		const double *	y,
		int	n,
		PSGraph *	ps = nullptr ) const

protected

Plots array.

Parameters

painter	pointer to QPainter object, 0 for calculating bounding box.
x	array with x values.
y	array with y values.
n	number of values.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ plotArray3D()

void ThreeDItem::plotArray3D	(	QPainter *	painter,
		PSGraph *	ps = nullptr ) const

protected

Plots 3D data.

Parameters

painter	pointer to QPainter object.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ raster3d()

void ThreeDItem::raster3d	(	QPainter *	painter,
		PSGraph *	ps = nullptr ) const

protected

Draws frame and axes of 3D plot.

Parameters

painter	pointer to QPainter object.
ps	pointer to PSGraph object, != 0 for PostScript output.

◆ setBoxX()

void ThreeDItem::setBoxX ( double width )

inline

Sets x box width in cm.

Parameters

width width.

◆ setBoxY()

void ThreeDItem::setBoxY ( double width )

inline

Sets y box width in cm.

Parameters

width width.

◆ setBoxZ()

void ThreeDItem::setBoxZ ( double width )

inline

Sets z box width in cm.

Parameters

width width.

◆ setColorData()

void ThreeDItem::setColorData ( unsigned color )

inline

Sets color for data.

Parameters

color color.

◆ setDeltaX()

void ThreeDItem::setDeltaX ( double dx )

inline

Sets x step size of grid.

Parameters

dx	step size.

◆ setDeltaZ()

void ThreeDItem::setDeltaZ ( double dz )

inline

Sets z step size of grid.

Parameters

dz	step size.

◆ setExpZ()

void ThreeDItem::setExpZ ( int e )

inline

Sets exponent of z normalization factor.

Parameters

e exponent.

◆ setFX()

void ThreeDItem::setFX ( double fx )

inline

Sets x normalization factor.

Parameters

fx factor.

◆ setFY()

void ThreeDItem::setFY ( double fy )

inline

Sets y normalization factor.

Parameters

fy factor.

◆ setFZ()

void ThreeDItem::setFZ ( double fz )

inline

Sets z normalization factor.

Parameters

fz factor.

◆ setLogZ()

void ThreeDItem::setLogZ ( bool logZ )

inline

Sets logarithmic mode of z axis.

Parameters

logZ	true for logarithmic z axis.

◆ setMinTicZ()

void ThreeDItem::setMinTicZ ( int minTicZ )

inline

Sets number of intervals between major tics of z axis.

Parameters

minTicZ number of intervals.

◆ setMode3D()

void ThreeDItem::setMode3D ( Mode3D mode3D )

inline

Sets 3D mode.

Parameters

mode3D 3D mode.

◆ setNumDigZ()

void ThreeDItem::setNumDigZ ( int numDigZ )

inline

Sets number of digits for z axis.

Parameters

numDigZ number of digits.

◆ setPhi()

void ThreeDItem::setPhi ( double phi )

inline

Sets angle of rotation about y axis.

Parameters

phi	angle in deg.

◆ setProperties()

void ThreeDItem::setProperties ( const QTransform & m )

Sets properties according to transformation matrix.

Parameters

m	transformation matrix.

◆ setShowFrame()

void ThreeDItem::setShowFrame ( bool showFrame )

inline

Sets frame mode.

Parameters

showFrame true to show frame.

◆ setTextZ()

void ThreeDItem::setTextZ ( const QString & text )

inline

Sets z axis text.

Parameters

text	axis text.

◆ setTheta()

void ThreeDItem::setTheta ( double theta )

inline

Sets angle of rotation about y axis.

Parameters

theta angle in deg.

◆ setXRef()

void ThreeDItem::setXRef ( double xRef )

inline

Sets x position of center of box bottom plane.

Parameters

xRef	x position in cm.

◆ setYRef()

void ThreeDItem::setYRef ( double yRef )

inline

Sets y position of center of box bottom plane.

Parameters

yRef	y position in cm.

◆ setZMax()

void ThreeDItem::setZMax ( double zMax )

inline

Sets upper z data limit.

Parameters

zMax	upper limit in user units.

◆ setZMin()

void ThreeDItem::setZMin ( double zMin )

inline

Sets lower z data limit.

Parameters

zMin	lower limit in user units.

◆ setZTic()

void ThreeDItem::setZTic ( double zTic )

inline

Sets z tic distance.

Parameters

zTic	distance between major tics of z axis.

◆ writePlo()

void ThreeDItem::writePlo ( KConfigGroup * plo ) const

Writes into plot file.

Parameters

plo	KConfigGroup object.

◆ xFrom3d()

double ThreeDItem::xFrom3d	(	double	x,
		double	z ) const

protected

Calculates 2D x value.

Parameters

x	3D x value.
z	3D z value.

◆ yFrom3d()

double ThreeDItem::yFrom3d	(	double	x,
		double	y,
		double	z ) const

protected

Calculates 2D y value.

Parameters

x	3D x value.
y	3D y value.
z	3D z value.

The documentation for this class was generated from the following file:

threeditem.h

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ Axis

◆ Mode3D

Constructor & Destructor Documentation

◆ ThreeDItem() [1/3]

◆ ThreeDItem() [2/3]

◆ ThreeDItem() [3/3]

Member Function Documentation

◆ axis3D()

◆ boundingRect()

◆ drawText()

◆ exportTable()

◆ frame3D()

◆ line3D()

◆ paint()

◆ paintCond()

◆ plot3D()

◆ plotArray()

◆ plotArray3D()

◆ raster3d()

◆ setBoxX()

◆ setBoxY()

◆ setBoxZ()

◆ setColorData()

◆ setDeltaX()

◆ setDeltaZ()

◆ setExpZ()

◆ setFX()

◆ setFY()

◆ setFZ()

◆ setLogZ()

◆ setMinTicZ()

◆ setMode3D()

◆ setNumDigZ()

◆ setPhi()

◆ setProperties()

◆ setShowFrame()

◆ setTextZ()

◆ setTheta()

◆ setXRef()

◆ setYRef()

◆ setZMax()

◆ setZMin()

◆ setZTic()

◆ writePlo()

◆ xFrom3d()

◆ yFrom3d()