ArrayItem Class Reference

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 QUrl &url=QUrl(), 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 QUrl &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 QUrl &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 QUrl &	url () const
	Returns URL of data file. More...
void	writePlo (KConfigGroup *plo, const QUrl &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 (GraphicsItemFlags 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 (Qt::MouseButtons 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)
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 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)
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 (Qt::InputMethodHints 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 QUrl &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 QUrl	absoluteUrl (const QString &path, const QUrl &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 QUrl &urlPlo, const QUrl &url, bool absolute=false)
	Constructs absolute or (if possible) relative file path. More...
static void	resetDashOffset ()
	Resets offset for dashed lines. More...
static unsigned	rgb (const QString &color)
	Converts rgb string to QRgb. More...
static unsigned	rgbQt1 (unsigned rgb)
	Converts QRgb to Qt1 QRgb. 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
QUrl	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
double	myDashOffset
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 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 QUrl &	url = QUrl(),
		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 QUrl &	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.

Implements QGraphicsItem.

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.

Implements QGraphicsItem.

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 QUrl &  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 QUrl &  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 QUrl& ArrayItem::url ( ) const

inline

Returns URL of data file.

void ArrayItem::writePlo	(	KConfigGroup *	plo,
		const QUrl &	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