PS graphics class. More...

#include <psgraph.h>

Public Member Functions
	PSGraph (QTextStream stream, const QList< QGraphicsItem > &list, const QSizeF &size, bool landscape=false, bool eps=true)
	Constructor. More...

	PSGraph (QTextStream *stream, const QSizeF &size, const QPointF &topRight=QPointF(), const QPointF &bottomLeft=QPointF(), bool landscape=false, bool eps=true)
	Constructor. More...

	~PSGraph ()
	Destructor. More...

void	drawArray (const double x, const double y, double fx, double fy, int n, KplItem::FillStyle fillStyle=KplItem::NoBrush, double xOff=0, double yOff=0, bool clip=true)
	Plots array item. More...

void	drawItems (const QList< QGraphicsItem * > &list)
	Plots items. More...

void	drawText (const QString &text, double x, double y, TextItem::Alignment alignment=TextItem::AlignLeft)
	Plots text. More...

void	finish ()
	Finishes plot. More...

void	setColorData (unsigned color)
	Sets color for data plotting. More...

void	setDir (double dir)
	Sets rotation angle. More...

double	setRelSize (double m_relSize)
	Sets relative size of item. More...

Static Public Attributes
static const double	pts
	Points per cm. More...

Protected Member Functions
void	cm2r (double xcm, double ycm, double fx, double fy, double xu, double yu) const
	Converts from centimeters to user units. More...

void	draw3D (ThreeDItem *item)
	Plots 3D item. More...

void	drawArc (ArcItem *item)
	Plots arc item. More...

void	drawArray (ArrayItem *item)
	Plots array item. More...

void	drawArray3D (Array3DItem *item)
	Plots 3D array item. More...

void	drawArrow (ArrowItem *item)
	Plots arrow item. More...

void	drawEllipse (EllipseItem *item)
	Plots ellipse item. More...

void	drawErrorBars (const double x, const double y, const double *errors, double fx, double fy, int n, double xOff=0, double yOff=0, bool clip=true)
	Plots error bars for array item. More...

void	drawFrame (FrameItem *item)
	Plots frame item. More...

void	drawFunc (FunItem *item)
	Plots function item. More...

void	drawFunc3D (Fun3DItem *item)
	Plots 3D function item. More...

void	drawImage (ImageItem *item)
	Plots image item. More...

void	drawLegend (LegendItem *item)
	Plots legend item. More...

void	drawLine (LineItem *item)
	Plots line item. More...

void	drawParFunc (ParFunItem *item)
	Plots parametric function item. More...

void	drawRect (RectItem *item)
	Plots rectangle item. More...

void	drawScaleBar (ScaleBarItem *item)
	Plots scale bar item. More...

void	drawSpline (SplineItem *item)
	Plots spline item. More...

void	drawText (TextItem *item)
	Plots text item. More...

void	labelX (const QString &text, int exp, bool xTop)
	Plots x axis label. More...

void	labelY (const QString &text, int exp, bool yRight)
	Plots y axis label. More...

void	prolog (bool landscape, bool eps, const QPointF &topRight=QPointF(), const QPointF &bottomLeft=QPointF())
	Writes PostScript prolog. More...

void	psStr (const QString &text)
	Converts to PostScript string. More...

void	resetDashOffset ()
	Resets offset for dashed lines. More...

void	scale (double xMin, double xMax, double yMin, double yMax, bool logX=false, bool logY=false)
	Scales data window to user units. More...

void	setColorFrame (unsigned color)
	Sets color for frame. More...

void	setColorGrid (unsigned color)
	Sets color for grid and tics. More...

void	setProperties (ScaledItem *item)
	Sets color and symbol type for array and function items. More...

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

void	window (double x0, double width, double y0, double height)
	Sets position and size of the data window. More...

Protected Attributes
bool	m_logX

bool	m_logY

KplItem::Symbol	m_symbol

double	m_x0

double	m_y0

double	m_width

double	m_height

double	m_xMin

double	m_yMin

double	m_xMax

double	m_yMax

double	m_relSize

QTextStream *	ts

QSizeF	m_size

Detailed Description

PS graphics class.

Provides methods to generate PS and EPS output.

Author: Werner Stille

Constructor & Destructor Documentation

PSGraph::PSGraph	(	QTextStream *	stream,
		const QList< QGraphicsItem * > &	list,
		const QSizeF &	size,
		bool	landscape = `false`,
		bool	eps = `true`
	)

Constructor.

Creates PS or EPS output of plot items.

Parameters

stream	pointer to output stream.
list	list of plot items.
size	media size in cm.
landscape	true for landscape orientation.
eps	true for EPS, false for PS output.

PSGraph::PSGraph	(	QTextStream *	stream,
		const QSizeF &	size,
		const QPointF &	topRight = `QPointF()`,
		const QPointF &	bottomLeft = `QPointF()`,
		bool	landscape = `false`,
		bool	eps = `true`
	)

Constructor.

Writes PS prolog.

Parameters

stream	pointer to output stream.
size	media size in cm.
topRight	top-right coordinates of graphics rectangle in cm.
bottomLeft	bottom-left coordinates of graphics rectangle in cm.
landscape	true for landscape orientation.
eps	true for EPS, false for PS output.

PSGraph::~PSGraph ( )

Destructor.

Member Function Documentation

void PSGraph::cm2r	(	double	xcm,
		double	ycm,
		double	fx,
		double	fy,
		double *	xu,
		double *	yu
	)		const

protected

Converts from centimeters to user units.

Parameters

xcm	x value in centimeters.
ycm	y value in centimeters.
fx	normalization factor for x values.
fy	normalization factor for y values.
xu	pointer to x value in user units (output).
yu	pointer to y value in user units (output).

void PSGraph::draw3D ( ThreeDItem * item )

protected

Plots 3D item.

Parameters

item	pointer to item.

void PSGraph::drawArc ( ArcItem * item )

protected

Plots arc item.

Parameters

item	pointer to item.

void PSGraph::drawArray	(	const double *	x,
		const double *	y,
		double	fx,
		double	fy,
		int	n,
		KplItem::FillStyle	fillStyle = `KplItem::NoBrush`,
		double	xOff = `0`,
		double	yOff = `0`,
		bool	clip = `true`
	)

Plots array item.

Parameters

x	array with x values.
y	array with y values.
fx	normalization factor for x values.
fy	normalization factor for y values.
n	number of data points.
fillStyle	fill style.
xOff	offset for x values.
yOff	offset for x values.
clip	true for clipping.

void PSGraph::drawArray ( ArrayItem * item )

protected

Plots array item.

Parameters

item	pointer to item.

void PSGraph::drawArray3D ( Array3DItem * item )

protected

Plots 3D array item.

Parameters

item	pointer to item.

void PSGraph::drawArrow ( ArrowItem * item )

protected

Plots arrow item.

Parameters

item	pointer to item.

void PSGraph::drawEllipse ( EllipseItem * item )

protected

Plots ellipse item.

Parameters

item	pointer to item.

void PSGraph::drawErrorBars	(	const double *	x,
		const double *	y,
		const double *	errors,
		double	fx,
		double	fy,
		int	n,
		double	xOff = `0`,
		double	yOff = `0`,
		bool	clip = `true`
	)

protected

Plots error bars for array item.

Parameters

x	array with x values.
y	array with y values.
errors	array with y error values.
fx	normalization factor for x values.
fy	normalization factor for y values.
n	number of data points.
xOff	offset for x values.
yOff	offset for x values.
clip	true for clipping.

void PSGraph::drawFrame ( FrameItem * item )

protected

Plots frame item.

Parameters

item	pointer to item.

void PSGraph::drawFunc ( FunItem * item )

protected

Plots function item.

Parameters

item	pointer to item.

void PSGraph::drawFunc3D ( Fun3DItem * item )

protected

Plots 3D function item.

Parameters

item	pointer to item.

void PSGraph::drawImage ( ImageItem * item )

protected

Plots image item.

Parameters

item	pointer to item.

void PSGraph::drawItems ( const QList< QGraphicsItem * > & list )

Plots items.

Parameters

list	list of items.

void PSGraph::drawLegend ( LegendItem * item )

protected

Plots legend item.

Parameters

item	pointer to item.

void PSGraph::drawLine ( LineItem * item )

protected

Plots line item.

Parameters

item	pointer to item.

void PSGraph::drawParFunc ( ParFunItem * item )

protected

Plots parametric function item.

Parameters

item	pointer to item.

void PSGraph::drawRect ( RectItem * item )

protected

Plots rectangle item.

Parameters

item	pointer to item.

void PSGraph::drawScaleBar ( ScaleBarItem * item )

protected

Plots scale bar item.

Parameters

item	pointer to item.

void PSGraph::drawSpline ( SplineItem * item )

protected

Plots spline item.

Parameters

item	pointer to item.

void PSGraph::drawText	(	const QString &	text,
		double	x,
		double	y,
		TextItem::Alignment	alignment = `TextItem::AlignLeft`
	)

Plots text.

Parameters

text	text.
x	x value in points.
y	y value in points.
alignment	horizontal alignment.

void PSGraph::drawText ( TextItem * item )

protected

Plots text item.

Parameters

item	pointer to item.

void PSGraph::finish ( )

Finishes plot.

void PSGraph::labelX	(	const QString &	text,
		int	exp,
		bool	xTop
	)

protected

Plots x axis label.

Parameters

text	label text.
exp	logarithm of normalization factor for x axis.
xTop	true for top side, false for bottom side label.

void PSGraph::labelY	(	const QString &	text,
		int	exp,
		bool	yRight
	)

protected

Plots y axis label.

Parameters

text	label text.
exp	logarithm of normalization factor for y axis.
yRight	true for right side, false for left side label.

void PSGraph::prolog	(	bool	landscape,
		bool	eps,
		const QPointF &	topRight = `QPointF()`,
		const QPointF &	bottomLeft = `QPointF()`
	)

protected

Writes PostScript prolog.

Parameters

landscape	true for landscape orientation.
eps	true for EPS, false for PS output.
topRight	coordinates of top-right corner in cm.
bottomLeft	coordinates of bottom-left corner in cm.

void PSGraph::psStr ( const QString & text )

protected

Converts to PostScript string.

Parameters

text text.

void PSGraph::resetDashOffset ( )

protected

Resets offset for dashed lines.

void PSGraph::scale	(	double	xMin,
		double	xMax,
		double	yMin,
		double	yMax,
		bool	logX = `false`,
		bool	logY = `false`
	)

protected

Scales data window to user units.

Parameters

xMin	x value of left data window margin in user units.
xMax	x value of right data window margin in user units.
yMin	y value of bottom data window margin in user units.
yMax	y value of top window data margin in user units.
logX	true for logarithmic x scale.
logY	true for logarithmic y scale.

void PSGraph::setColorData ( unsigned color )

Sets color for data plotting.

Parameters

color color.

void PSGraph::setColorFrame ( unsigned color )

protected

Sets color for frame.

Parameters

color color.

void PSGraph::setColorGrid ( unsigned color )

protected

Sets color for grid and tics.

Parameters

color color.

void PSGraph::setDir ( double dir )

Sets rotation angle.

Parameters

dir	rotation angle in deg.

void PSGraph::setProperties ( ScaledItem * item )

protected

Sets color and symbol type for array and function items.

Parameters

item	pointer to item.

double PSGraph::setRelSize ( double m_relSize )

Sets relative size of item.

Parameters

m_relSize relative size.

Returns: old relative size.

void PSGraph::setSymbol ( KplItem::Symbol symbol )

protected

Sets symbol type.

Parameters

symbol symbol type.

void PSGraph::window	(	double	x0,
		double	width,
		double	y0,
		double	height
	)

protected

Sets position and size of the data window.

Parameters

x0	left page margin in centimeters.
width	width in centimeters.
y0	bottom page margin in centimeters.
height	height in centimeters.

Member Data Documentation

const double PSGraph::pts

static

Points per cm.

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

psgraph.h

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation