Array item class. More...

#include <arrayitem.h>

Inheritance diagram for ArrayItem:

Public Types
enum	DecimalCharacter { Point, Comma, Settings }
	Decimal character. More...

enum	{ Type = UserType + Array }
	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
	ArrayItem ()
	Constructor. More...

	ArrayItem (unsigned color, int colX=0, int colY=0, int colErr=0, bool errorBars=false, Symbol symbol=OpenCircle, DecimalCharacter decimalChar=Point, const KUrl &url=KUrl(), double fx=1, double fy=1, QGraphicsItem *parent=0, int n=0, int rowStart=0, FillStyle fillStyle=NoBrush, double xOffset=0, double yOffset=0, bool visible=true, bool internal=false, double relSize=1)
	Constructor. More...

	ArrayItem (const ArrayItem &a)
	Copy constructor. More...

	ArrayItem (const KConfigGroup plo, const KUrl &urlPlo, unsigned color=0, int colX=0, int colY=0, int colErr=0, bool errorBars=false, Symbol symbol=OpenCircle, QGraphicsItem parent=0)
	Constructor. More...

virtual	~ArrayItem ()
	Destructor. More...

void	adjustCols (int colX, int colY, int colErr)
	Sets and limits the column indices. More...

void	adjustCols ()
	Limits the column indices. More...

virtual QRectF	boundingRect () const
	Calculates bounding rectangle. More...

int	colErr () const
	Returns y error column index. More...

int	colX () const
	Returns x column index. More...

int	colY () const
	Returns y column index. More...

int	count () const
	Returns number of data points to be plotted. More...

double **	data () const
	Returns pointer to internal array. More...

DecimalCharacter	decimalCharacter () const
	Returns decimal symbol of floating point numbers. More...

bool	errorBars () const
	Returns true for plotting error bars. More...

void	exponent (int &expX, int &expY, double &fx, double &fy) const
	Calculates normalization factors. More...

bool	internal () const
	Returns true for internal stored array data. More...

void	limits (double &xMin, double &xMax, double &yMin, double &yMax) const
	Calculates minimum and maximum values. More...

int	numCols () const
	Returns number of columns. More...

int	numRows () const
	Returns number of rows. More...

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

virtual int	readFile ()
	Reads double values from the URL. More...

int	readFile (QString *text)
	Reads double values from a string. More...

int	rowStart () const
	Returns start row index. More...

void	setColErr (int colErr)
	Sets error column index. More...

void	setColX (int colX)
	Sets x column index. More...

void	setColY (int colY)
	Sets y column index. More...

void	setCount (int n)
	Sets number of data points. More...

void	setDashOffset ()
	Sets offset for dashed lines. More...

void	setData (double **data)
	Sets array pointer. More...

void	setDecimalCharacter (DecimalCharacter decimalChar)
	Sets decimal character. More...

void	setErrorBars (bool errorBars)
	Sets error bars plotting. More...

void	setInternal (bool internal)
	Sets storage mode. More...

void	setNumCols (int nCols)
	Sets number of columns. More...

void	setNumRows (int nRows)
	Sets number of rows. More...

void	setRange (int rowStart, int n)
	Sets and limits the start row index and the number of points to be plotted. More...

void	setRowStart (int rowStart)
	Sets start row index. More...

void	setUrl (const KUrl &url)
	Sets URL. More...

virtual QPainterPath	shape () const
	Returns the shape of the plot item. More...

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

const KUrl &	url () const
	Returns URL of data file. More...

void	writePlo (KConfigGroup *plo, const KUrl &urlPlo, bool absolute) const
	Writes into plot file. More...

Public Member Functions inherited from ScaledItem
	ScaledItem ()
	Constructor. More...

	ScaledItem (const ScaledItem &a)
	Copy constructor. More...

	ScaledItem (const KConfigGroup plo, Symbol symbol, unsigned color, QGraphicsItem parent)
	Constructor. More...

	ScaledItem (FillStyle fillStyle, Symbol symbol, unsigned color, double fx, double fy, double xOffset, double yOffset, double relSize, QGraphicsItem *parent)
	Constructor. More...

virtual	~ScaledItem ()
	Destructor. More...

unsigned	color () const
	Returns color. More...

FillStyle	fillStyle () const
	Returns fill style. More...

bool	isNormalized (double fx, double fy) const
	Checks if both normalization factors are equal to given values. More...

void	normalize (double fx, double fy)
	Sets normalization factors. More...

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

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

QPixmap	pixmap () const
	Returns decoration pixmap for item list. More...

void	readPlo (const KConfigGroup *plo, Symbol symbol, unsigned color)
	Initializes corresponding to plot file. More...

void	setColor (unsigned color)
	Sets color. More...

void	setFillStyle (FillStyle style)
	Sets fill style. More...

void	setNormX (double fx)
	Sets normalization factor for x values. More...

void	setNormY (double fy)
	Sets normalization factor for y values. More...

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

void	setSize ()
	Sets size according to transformation matrix. More...

void	setSymbol (Symbol symbol)
	Sets symbol type. More...

void	setXOffset (double xOffset)
	Sets offset for x values. More...

void	setYOffset (double yOffset)
	Sets offset for y values. More...

Symbol	symbol () const
	Returns symbol type. More...

void	update ()
	Applies changes and forces redrawing. More...

void	updateGeometry ()
	Updates geometry. More...

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

double	xOffset () const
	Returns offset for x values. More...

double	yOffset () const
	Returns offset for y values. More...

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

	KplItem (const KplItem &a)
	Copy constructor. More...

	KplItem (const KConfigGroup *plo)
	Constructor. More...

virtual	~KplItem ()
	Destructor. More...

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

double	relSize () const
	Returns relative size of item. More...

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

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

Public Member Functions inherited from QGraphicsItem
	QGraphicsItem (QGraphicsItem *parent)

QGraphicsScene *	scene () const

QGraphicsItem *	parentItem () const

QGraphicsItem *	topLevelItem () const

QGraphicsObject *	parentObject () const

QGraphicsWidget *	parentWidget () const

QGraphicsWidget *	topLevelWidget () const

QGraphicsWidget *	window () const

QGraphicsItem *	panel () const

void	setParentItem (QGraphicsItem *newParent)

QList< QGraphicsItem * >	children () const

QList< QGraphicsItem * >	childItems () const

bool	isWidget () const

bool	isWindow () const

bool	isPanel () const

QGraphicsObject *	toGraphicsObject ()

const QGraphicsObject *	toGraphicsObject () const

QGraphicsItemGroup *	group () const

void	setGroup (QGraphicsItemGroup *group)

GraphicsItemFlags	flags () const

void	setFlag (GraphicsItemFlag flag, bool enabled)

void	setFlags (QFlags< QGraphicsItem::GraphicsItemFlag > flags)

CacheMode	cacheMode () const

void	setCacheMode (CacheMode mode, const QSize &logicalCacheSize)

PanelModality	panelModality () const

void	setPanelModality (PanelModality panelModality)

bool	isBlockedByModalPanel (QGraphicsItem **blockingPanel) const

QString	toolTip () const

void	setToolTip (const QString &toolTip)

QCursor	cursor () const

void	setCursor (const QCursor &cursor)

bool	hasCursor () const

void	unsetCursor ()

bool	isVisible () const

bool	isVisibleTo (const QGraphicsItem *parent) const

void	setVisible (bool visible)

void	hide ()

void	show ()

bool	isEnabled () const

void	setEnabled (bool enabled)

bool	isSelected () const

void	setSelected (bool selected)

bool	acceptDrops () const

void	setAcceptDrops (bool on)

qreal	opacity () const

qreal	effectiveOpacity () const

void	setOpacity (qreal opacity)

QGraphicsEffect *	graphicsEffect () const

void	setGraphicsEffect (QGraphicsEffect *effect)

Qt::MouseButtons	acceptedMouseButtons () const

void	setAcceptedMouseButtons (QFlags< Qt::MouseButton > buttons)

bool	acceptsHoverEvents () const

void	setAcceptsHoverEvents (bool enabled)

bool	acceptHoverEvents () const

void	setAcceptHoverEvents (bool enabled)

bool	acceptTouchEvents () const

void	setAcceptTouchEvents (bool enabled)

bool	filtersChildEvents () const

void	setFiltersChildEvents (bool enabled)

bool	handlesChildEvents () const

void	setHandlesChildEvents (bool enabled)

bool	isActive () const

void	setActive (bool active)

bool	hasFocus () const

void	setFocus (Qt::FocusReason focusReason)

void	clearFocus ()

QGraphicsItem *	focusProxy () const

void	setFocusProxy (QGraphicsItem *item)

QGraphicsItem *	focusItem () const

void	grabMouse ()

void	ungrabMouse ()

void	grabKeyboard ()

void	ungrabKeyboard ()

QPointF	pos () const

qreal	x () const

void	setX (qreal x)

qreal	y () const

void	setY (qreal y)

QPointF	scenePos () const

void	setPos (const QPointF &pos)

void	setPos (qreal x, qreal y)

void	moveBy (qreal dx, qreal dy)

void	ensureVisible (const QRectF &rect, int xmargin, int ymargin)

void	ensureVisible (qreal x, qreal y, qreal w, qreal h, int xmargin, int ymargin)

QMatrix	matrix () const

QMatrix	sceneMatrix () const

void	setMatrix (const QMatrix &matrix, bool combine)

void	resetMatrix ()

QTransform	transform () const

QTransform	sceneTransform () const

QTransform	deviceTransform (const QTransform &viewportTransform) const

QTransform	itemTransform (const QGraphicsItem other, bool ok) const

void	setTransform (const QTransform &matrix, bool combine)

void	resetTransform ()

void	rotate (qreal angle)

void	scale (qreal sx, qreal sy)

void	shear (qreal sh, qreal sv)

void	translate (qreal dx, qreal dy)

void	setRotation (qreal angle)

qreal	rotation () const

void	setScale (qreal factor)

qreal	scale () const

QList< QGraphicsTransform * >	transformations () const

void	setTransformations (const QList< QGraphicsTransform * > &transformations)

QPointF	transformOriginPoint () const

void	setTransformOriginPoint (const QPointF &origin)

void	setTransformOriginPoint (qreal x, qreal y)

virtual void	advance (int phase)

qreal	zValue () const

void	setZValue (qreal z)

void	stackBefore (const QGraphicsItem *sibling)

virtual QRectF	boundingRect () const =0

QRectF	childrenBoundingRect () const

QRectF	sceneBoundingRect () const

bool	isClipped () const

QPainterPath	clipPath () const

virtual bool	contains (const QPointF &point) const

virtual bool	collidesWithItem (const QGraphicsItem *other, Qt::ItemSelectionMode mode) const

virtual bool	collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode) const

QList< QGraphicsItem * >	collidingItems (Qt::ItemSelectionMode mode) const

bool	isObscured () const

bool	isObscured (const QRectF &rect) const

bool	isObscured (qreal x, qreal y, qreal w, qreal h) const

virtual bool	isObscuredBy (const QGraphicsItem *item) const

virtual QPainterPath	opaqueArea () const

QRegion	boundingRegion (const QTransform &itemToDeviceTransform) const

qreal	boundingRegionGranularity () const

void	setBoundingRegionGranularity (qreal granularity)

virtual void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget)=0

void	update (const QRectF &rect)

void	update (qreal x, qreal y, qreal width, qreal height)

void	scroll (qreal dx, qreal dy, const QRectF &rect)

QPointF	mapToItem (const QGraphicsItem *item, const QPointF &point) const

QPointF	mapToParent (const QPointF &point) const

QPointF	mapToScene (const QPointF &point) const

QPolygonF	mapToItem (const QGraphicsItem *item, const QRectF &rect) const

QPolygonF	mapToParent (const QRectF &rect) const

QPolygonF	mapToScene (const QRectF &rect) const

QRectF	mapRectToItem (const QGraphicsItem *item, const QRectF &rect) const

QRectF	mapRectToParent (const QRectF &rect) const

QRectF	mapRectToScene (const QRectF &rect) const

QPolygonF	mapToItem (const QGraphicsItem *item, const QPolygonF &polygon) const

QPolygonF	mapToParent (const QPolygonF &polygon) const

QPolygonF	mapToScene (const QPolygonF &polygon) const

QPainterPath	mapToItem (const QGraphicsItem *item, const QPainterPath &path) const

QPainterPath	mapToParent (const QPainterPath &path) const

QPainterPath	mapToScene (const QPainterPath &path) const

QPointF	mapFromItem (const QGraphicsItem *item, const QPointF &point) const

QPointF	mapFromParent (const QPointF &point) const

QPointF	mapFromScene (const QPointF &point) const

QPolygonF	mapFromItem (const QGraphicsItem *item, const QRectF &rect) const

QPolygonF	mapFromParent (const QRectF &rect) const

QPolygonF	mapFromScene (const QRectF &rect) const

QRectF	mapRectFromItem (const QGraphicsItem *item, const QRectF &rect) const

QRectF	mapRectFromParent (const QRectF &rect) const

QRectF	mapRectFromScene (const QRectF &rect) const

QPolygonF	mapFromItem (const QGraphicsItem *item, const QPolygonF &polygon) const

QPolygonF	mapFromParent (const QPolygonF &polygon) const

QPolygonF	mapFromScene (const QPolygonF &polygon) const

QPainterPath	mapFromItem (const QGraphicsItem *item, const QPainterPath &path) const

QPainterPath	mapFromParent (const QPainterPath &path) const

QPainterPath	mapFromScene (const QPainterPath &path) const

QPointF	mapToItem (const QGraphicsItem *item, qreal x, qreal y) const

QPointF	mapToParent (qreal x, qreal y) const

QPointF	mapToScene (qreal x, qreal y) const

QPolygonF	mapToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapToParent (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapToScene (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToParent (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectToScene (qreal x, qreal y, qreal w, qreal h) const

QPointF	mapFromItem (const QGraphicsItem *item, qreal x, qreal y) const

QPointF	mapFromParent (qreal x, qreal y) const

QPointF	mapFromScene (qreal x, qreal y) const

QPolygonF	mapFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapFromParent (qreal x, qreal y, qreal w, qreal h) const

QPolygonF	mapFromScene (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromParent (qreal x, qreal y, qreal w, qreal h) const

QRectF	mapRectFromScene (qreal x, qreal y, qreal w, qreal h) const

bool	isAncestorOf (const QGraphicsItem *child) const

QGraphicsItem *	commonAncestorItem (const QGraphicsItem *other) const

bool	isUnderMouse () const

QVariant	data (int key) const

void	setData (int key, const QVariant &value)

Qt::InputMethodHints	inputMethodHints () const

void	setInputMethodHints (QFlags< Qt::InputMethodHint > hints)

void	installSceneEventFilter (QGraphicsItem *filterItem)

void	removeSceneEventFilter (QGraphicsItem *filterItem)

Static Public Member Functions
static double **	copyArray (double **data, int nCols, int nRows)
	Copies array storage. More...

static void	freeArray (double ***data)
	Deallocates array storage. More...

static int	readFile (const KUrl &url, int &nCols, double ***data, DecimalCharacter decimalChar=Point)
	Reads double values from a file into an array. More...

static int	readFile (QIODevice device, int &nCols, double **data, DecimalCharacter decimalChar=Point)
	Reads double values from an I/O device into an array. More...

static int	readFile (QString text, int &nCols, double **data, DecimalCharacter decimalChar=Point)
	Reads double values from a string into an array. More...

static int	readLines (QTextStream &t, int nCols, double ***data, DecimalCharacter decimalChar=Point)
	Reads double values from a text stream into an array. More...

static void	translate (QString &line, DecimalCharacter decimalChar)
	Translates exponent and decimal symbols. More...

Static Public Member Functions inherited from ScaledItem
static void	exponent (double a, int &iExp, double &f)
	Calculates normalization factor. More...

static bool	limits (double &xMin, double &xMax, const double *values, int n)
	Calculates minimum and maximum values of an array. More...

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

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

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

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

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

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

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

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

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

static QString	tempFileName (const QString &suffix=".tmp")
	Generates unique temporary file name. More...

Protected Member Functions
void	paintCond (QPainter *painter) const
	Paints or calculates bounding area. More...

Protected Member Functions inherited from ScaledItem
double	length (const double x, const double y, int n) const
	Calculates line length. More...

void	plotArray (QPainter painter, const double x, const double *y, int n) const
	Plots array. More...

void	setProperties ()
	Sets properties according to transformation matrix. More...

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

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

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

Protected Member Functions inherited from QGraphicsItem
void	updateMicroFocus ()

virtual bool	sceneEventFilter (QGraphicsItem watched, QEvent event)

virtual bool	sceneEvent (QEvent *event)

virtual void	contextMenuEvent (QGraphicsSceneContextMenuEvent *event)

virtual void	dragEnterEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dragLeaveEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dragMoveEvent (QGraphicsSceneDragDropEvent *event)

virtual void	dropEvent (QGraphicsSceneDragDropEvent *event)

virtual void	focusInEvent (QFocusEvent *event)

virtual void	focusOutEvent (QFocusEvent *event)

virtual void	hoverEnterEvent (QGraphicsSceneHoverEvent *event)

virtual void	hoverMoveEvent (QGraphicsSceneHoverEvent *event)

virtual void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event)

virtual void	keyPressEvent (QKeyEvent *event)

virtual void	keyReleaseEvent (QKeyEvent *event)

virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)

virtual void	mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event)

virtual void	wheelEvent (QGraphicsSceneWheelEvent *event)

virtual void	inputMethodEvent (QInputMethodEvent *event)

virtual QVariant	inputMethodQuery (Qt::InputMethodQuery query) const

virtual QVariant	itemChange (GraphicsItemChange change, const QVariant &value)

void	prepareGeometryChange ()

Protected Attributes
bool	m_internal

bool	m_errorBars

int	m_colX

int	m_colY

int	m_colErr

int	m_rowStart

int	m_count

int	m_numRows

int	m_numCols

DecimalCharacter	m_decimalCharacter

double **	m_data

KUrl	m_url

Protected Attributes inherited from ScaledItem
FillStyle	m_fillStyle

Symbol	m_symbol

unsigned	m_color

double	m_normX

double	m_normY

double	m_xOffset

double	m_yOffset

double	dydx

QPen	m_pen

QPainterPath	bPath

QRectF	bRect

QRectF	symbRect

QTransform	m_matrix

Protected Attributes inherited from KplItem
double	m_relSize

Additional Inherited Members
Public Attributes inherited from QGraphicsItem
typedef	GraphicsItemFlags

Static Public Attributes inherited from KplItem
static const double	Deg2rad
	Factor for converting from degrees to radians. More...

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. More...

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

Static Protected Attributes inherited from KplItem
static double	m_dashOffset

Detailed Description

Array item class.

Class for array items showing data arrays by lines or markers.

Author: Werner Stille

Member Enumeration Documentation

anonymous enum

Specific QGraphicsItem type number for function type()

Enumerator
Type	Specific QGraphicsItem type number of ArrayItem for function type().

enum ArrayItem::DecimalCharacter

Decimal character.

Determines decimal character for reading of floating point numbers.

Enumerator
Point	Decimal point.
Comma	Decimal comma.
Settings	Use Kpl Settings (only for internal use in Kpl application).

Constructor & Destructor Documentation

ArrayItem::ArrayItem ( )

Constructor.

ArrayItem::ArrayItem	(	unsigned	color,
		int	colX = `0`,
		int	colY = `0`,
		int	colErr = `0`,
		bool	errorBars = `false`,
		Symbol	symbol = `OpenCircle`,
		DecimalCharacter	decimalChar = `Point`,
		const KUrl &	url = `KUrl()`,
		double	fx = `1`,
		double	fy = `1`,
		QGraphicsItem *	parent = `0`,
		int	n = `0`,
		int	rowStart = `0`,
		FillStyle	fillStyle = `NoBrush`,
		double	xOffset = `0`,
		double	yOffset = `0`,
		bool	visible = `true`,
		bool	internal = `false`,
		double	relSize = `1`
	)

Constructor.

Initializes corresponding to arguments.

Parameters

color	color for data plot.
colX	x column index.
colY	y column index.
colErr	y error column index.
errorBars	true to plot error bars.
symbol	symbol type.
decimalChar	decimal symbol of floating point numbers used in file.
url	URL of data file.
fx	normalization factor for x values.
fy	normalization factor for y values.
parent	pointer to parent item.
n	number of data points to be plotted.
rowStart	start row index.
fillStyle	fill style.
xOffset	offset for x values.
yOffset	offset for x values.
visible	true for visible item.
internal	true for internal stored array data.
relSize	relative size of lines or symbols.

ArrayItem::ArrayItem ( const ArrayItem & a )

Copy constructor.

Parameters

a	source item.

ArrayItem::ArrayItem	(	const KConfigGroup *	plo,
		const KUrl &	urlPlo,
		unsigned	color = `0`,
		int	colX = `0`,
		int	colY = `0`,
		int	colErr = `0`,
		bool	errorBars = `false`,
		Symbol	symbol = `OpenCircle`,
		QGraphicsItem *	parent = `0`
	)

Constructor.

Initializes corresponding to plot file.

Parameters

plo	pointer to KSimpleConfig object containing item data.
urlPlo	URL of plot file.
color	default color for data plot.
colX	default x column index.
colY	default y column index.
colErr	default y error column index.
errorBars	default, true to plot error bars.
symbol	default symbol type.
parent	pointer to parent item.

virtual ArrayItem::~ArrayItem ( )

virtual

Destructor.

Member Function Documentation

void ArrayItem::adjustCols	(	int	colX,
		int	colY,
		int	colErr
	)

Sets and limits the column indices.

Parameters

colX	x column.
colY	y column.
colErr	error column.

void ArrayItem::adjustCols ( )

inline

Limits the column indices.

virtual QRectF ArrayItem::boundingRect ( ) const

virtual

Calculates bounding rectangle.

int ArrayItem::colErr ( ) const

inline

Returns y error column index.

int ArrayItem::colX ( ) const

inline

Returns x column index.

int ArrayItem::colY ( ) const

inline

Returns y column index.

static double** ArrayItem::copyArray	(	double **	data,
		int	nCols,
		int	nRows
	)

static

Copies array storage.

Parameters

data	two-dimensional source array.
nCols	number of columns.
nRows	number of rows.

Returns: pointer to copy of array.

int ArrayItem::count ( ) const

inline

Returns number of data points to be plotted.

double** ArrayItem::data ( ) const

inline

Returns pointer to internal array.

Returns: pointer to two-dimensional array.

DecimalCharacter ArrayItem::decimalCharacter ( ) const

inline

Returns decimal symbol of floating point numbers.

bool ArrayItem::errorBars ( ) const

inline

Returns true for plotting error bars.

void ArrayItem::exponent	(	int &	expX,
		int &	expY,
		double &	fx,
		double &	fy
	)		const

Calculates normalization factors.

Parameters

expX	reference to logarithm of x normalization factor.
expY	reference to logarithm of x normalization factor.
fx	reference to x normalization factor.
fy	reference to y normalization factor.

static void ArrayItem::freeArray ( double *** data )

static

Deallocates array storage.

Parameters

data	pointer to two-dimensional array.

bool ArrayItem::internal ( ) const

inline

Returns true for internal stored array data.

void ArrayItem::limits	(	double &	xMin,
		double &	xMax,
		double &	yMin,
		double &	yMax
	)		const

Calculates minimum and maximum values.

Parameters

xMin	reference to minimum of x values.
xMax	reference to maximum of x values.
yMin	reference to minimum of y values.
yMax	reference to maximum of y values.

int ArrayItem::numCols ( ) const

inline

Returns number of columns.

int ArrayItem::numRows ( ) const

inline

Returns number of rows.

virtual void ArrayItem::paint	(	QPainter *	painter,
		const QStyleOptionGraphicsItem *	option,
		QWidget *	widget = `0`
	)

virtual

Paints item.

void ArrayItem::paintCond ( QPainter * painter ) const

protected

Paints or calculates bounding area.

Parameters

painter Pointer to QPainter object, 0 for calculating bounding area.

virtual int ArrayItem::readFile ( )

virtual

Reads double values from the URL.

Returns: number of rows, 0 for error.

static int ArrayItem::readFile	(	const KUrl &	url,
		int &	nCols,
		double ***	data,
		DecimalCharacter	decimalChar = `Point`
	)

static

Reads double values from a file into an array.

Parameters

url	URL of data file.
nCols	reference to number of columns.
data	pointer to two-dimensional array.
decimalChar	decimal symbol of floating point numbers used in file.

Returns: number of rows, 0 for error.

static int ArrayItem::readFile	(	QIODevice *	device,
		int &	nCols,
		double ***	data,
		DecimalCharacter	decimalChar = `Point`
	)

static

Reads double values from an I/O device into an array.

Parameters

device	I/O device to read from.
nCols	reference to number of columns.
data	pointer to two-dimensional array.
decimalChar	decimal character: Point or Comma.

Returns: number of rows, 0 for error.

static int ArrayItem::readFile	(	QString *	text,
		int &	nCols,
		double ***	data,
		DecimalCharacter	decimalChar = `Point`
	)

static

Reads double values from a string into an array.

Parameters

text	string to read from.
nCols	reference to number of columns.
data	pointer to two-dimensional array.
decimalChar	decimal character: Point or Comma.

Returns: number of rows, 0 for error.

int ArrayItem::readFile ( QString * text )

Reads double values from a string.

Returns: number of rows, 0 for error.

static int ArrayItem::readLines	(	QTextStream &	t,
		int	nCols,
		double ***	data,
		DecimalCharacter	decimalChar = `Point`
	)

static

Reads double values from a text stream into an array.

Parameters

t	text stream to read from.
nCols	number of columns.
data	pointer to array.
decimalChar	decimal character: Point or Comma.

Returns: number of lines, 0 for error.

int ArrayItem::rowStart ( ) const

inline

Returns start row index.

void ArrayItem::setColErr ( int colErr )

inline

Sets error column index.

Parameters

colErr y error column index.

void ArrayItem::setColX ( int colX )

inline

Sets x column index.

Parameters

colX	y error column index.

void ArrayItem::setColY ( int colY )

inline

Sets y column index.

Parameters

colY	y column index.

void ArrayItem::setCount ( int n )

inline

Sets number of data points.

Parameters

n	number of data points.

void ArrayItem::setDashOffset ( )

Sets offset for dashed lines.

void ArrayItem::setData ( double ** data )

Sets array pointer.

Parameters

data	two-dimensional array.

void ArrayItem::setDecimalCharacter ( DecimalCharacter decimalChar )

inline

Sets decimal character.

Parameters

decimalChar decimal symbol of floating point numbers used in file.

void ArrayItem::setErrorBars ( bool errorBars )

inline

Sets error bars plotting.

Parameters

errorBars true to plot error bars.

void ArrayItem::setInternal ( bool internal )

inline

Sets storage mode.

Parameters

internal true for internal stored array data.

void ArrayItem::setNumCols ( int nCols )

inline

Sets number of columns.

Parameters

nCols number of columns.

void ArrayItem::setNumRows ( int nRows )

inline

Sets number of rows.

Parameters

nRows number of Rows.

void ArrayItem::setRange	(	int	rowStart,
		int	n
	)

Sets and limits the start row index and the number of points to be plotted.

Parameters

rowStart	start row index.
n	number of data points.

void ArrayItem::setRowStart ( int rowStart )

inline

Sets start row index.

Parameters

rowStart start row index.

void ArrayItem::setUrl ( const KUrl & url )

inline

Sets URL.

Parameters

url	URL of data file.

virtual QPainterPath ArrayItem::shape ( ) const

virtual

Returns the shape of the plot item.

Reimplemented from QGraphicsItem.

static void ArrayItem::translate	(	QString &	line,
		DecimalCharacter	decimalChar
	)

static

Translates exponent and decimal symbols.

Parameters

line	line from data or parameter file.
decimalChar	decimal symbol of floating point numbers used in file.

virtual int ArrayItem::type ( ) const

inlinevirtual

Returns specific QGraphicsItem type number.

Reimplemented from QGraphicsItem.

const KUrl& ArrayItem::url ( ) const

inline

Returns URL of data file.

void ArrayItem::writePlo	(	KConfigGroup *	plo,
		const KUrl &	urlPlo,
		bool	absolute
	)		const

Writes into plot file.

Parameters

plo	KConfigGroup object.
urlPlo	URL of plot file.
absolute	true to save absolute paths.

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

arrayitem.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation