ImageItem Class Reference

Image item class. More...

#include <imageitem.h>

Inheritance diagram for ImageItem:

Public Types
enum	{ Type = UserType + Image }
	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
	ImageItem (double x0=1, double y0=1, QGraphicsItem *parent=nullptr, const QUrl &url=QUrl(), bool visible=true, double scaleX=1, double scaleY=1, double dir=0)
	Constructor.
	ImageItem (const ImageItem &a)
	Copy constructor.
	ImageItem (const KConfigGroup *plo, const QUrl &urlPlo, QGraphicsItem *parent=nullptr)
	Constructor.
virtual	~ImageItem ()
	Destructor.
double	dir () const
	Returns rotation angle in deg.
virtual void	paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
	Paints item.
void	renderPS (QPixmap *pixmap, int dpiX, int dpiY)
	Renders PostScript code to pixmap by use of ghostscript.
double	scaleX () const
	Returns horizontal scaling factor.
double	scaleY () const
	Returns vertical scaling factor.
void	setDir (double dir)
	Sets rotation angle.
void	setProperties (const QTransform &m)
	Sets properties according to transformation matrix.
void	setScaleX (double f)
	Sets horizontal scaling factor.
void	setScaleY (double f)
	Sets vertical scaling factor.
void	setUrl (const QUrl &url)
	Sets URL.
virtual int	type () const override
	Returns specific QGraphicsItem type number.
const QUrl &	url () const
	Returns URL of PostScript file.
void	update ()
	Applies changes and forces redrawing.
void	writePlo (KConfigGroup *plo, const QUrl &urlPlo, bool absolute) const
	Writes into plot file.
Public Member Functions inherited from DecoItem
	DecoItem (unsigned color=0, double x0=0, double y0=0, double relSize=1)
	Constructor.
	DecoItem (const KConfigGroup *plo, unsigned color=0)
	Constructor.
virtual	~DecoItem ()
	Destructor.
unsigned	color () const
	Returns color.
void	setColor (unsigned color)
	Sets color.
void	setX0 (double x0)
	Sets x position.
void	setY0 (double y0)
	Sets y position.
void	updatePos (const QPointF &p, bool absolute=true)
	Updates position.
void	writePlo (KConfigGroup *plo, bool visible) const
	Writes into plot file.
double	x0 () const
	Returns x position in cm.
double	y0 () const
	Returns y position in cm.
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.

Static Public Member Functions
static bool	boundingBox (const QUrl &url, QString &filename, double *x1, double *y1, double *x2, double *y2)
	Reads bounding box coordinates from an EPS file.
static bool	checkBoundingBox (const QUrl &url)
	Reads bounding box coordinates from an EPS file.
static void	renderPS (const QString &psFile, const QString &imageFile, int width, int height, double x0=0, double y0=0, double scaleX=1, double scaleY=1, const char format[]="pbmraw")
	Renders PostScript code to image file by use of ghostscript.
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.

Protected Member Functions
virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event) override
	Updates position.
void	setProperties ()
	Sets properties according to transformation matrix.
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
double	m_scaleX
double	m_scaleY
double	m_dir
QUrl	m_url
Protected Attributes inherited from DecoItem
unsigned	m_color
double	m_x0
double	m_y0
QTransform	m_matrix
Protected Attributes inherited from KplItem
double	m_relSize

Additional Inherited Members
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

Image item class.

Class for EPS image items.

Author

Werner Stille

Member Enumeration Documentation

anonymous enum

anonymous enum

Specific QGraphicsItem type number for function type()

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

Constructor & Destructor Documentation

ImageItem() [1/3]

ImageItem::ImageItem	(	double	x0 = 1,
		double	y0 = 1,
		QGraphicsItem *	parent = nullptr,
		const QUrl &	url = QUrl(),
		bool	visible = true,
		double	scaleX = 1,
		double	scaleY = 1,
		double	dir = 0 )

Constructor.

Initializes corresponding to arguments.

Parameters

x0	x position in cm.
y0	y position in cm.
parent	pointer to parent item.
url	URL of EPS file.
visible	true for visible item.
scaleX	x scaling factor.
scaleY	y scaling factor.
dir	rotation angle in degree.

ImageItem() [2/3]

ImageItem::ImageItem

(

const ImageItem &

a

)

Copy constructor.

Parameters

a	source item.

ImageItem() [3/3]

ImageItem::ImageItem	(	const KConfigGroup *	plo,
		const QUrl &	urlPlo,
		QGraphicsItem *	parent = nullptr )

Constructor.

Initializes corresponding to plot file.

Parameters

plo	pointer to KSimpleConfig object containing item data.
urlPlo	URL of plot file.
parent	pointer to parent item.

Member Function Documentation

boundingBox()

static bool ImageItem::boundingBox ( const QUrl & url, QString & filename, double * x1, double * y1, double * x2, double * y2 )

static

Reads bounding box coordinates from an EPS file.

Parameters

url	URL of EPS file.
filename	path (returned).
x1	left x value.
y1	bottom y value.
x2	right x value.
y2	top y value.

Returns

true for success.

checkBoundingBox()

static bool ImageItem::checkBoundingBox ( const QUrl & url )

static

Reads bounding box coordinates from an EPS file.

Parameters

url	URL of EPS file.

Returns

true for success.

renderPS() [1/2]

static void ImageItem::renderPS ( const QString & psFile, const QString & imageFile, int width, int height, double x0 = 0, double y0 = 0, double scaleX = 1, double scaleY = 1, const char format[] = "pbmraw" )

static

Renders PostScript code to image file by use of ghostscript.

Parameters

psFile	path to PostScript file.
imageFile	path to image file.
width	image width in dots.
height	image height in dots.
x0	left margin of bounding box in points.
y0	lower margin of bounding box in points.
scaleX	horizontal scaling factor.
scaleY	vertical scaling factor.
format	image file format.

renderPS() [2/2]

void ImageItem::renderPS	(	QPixmap *	pixmap,
		int	dpiX,
		int	dpiY )

Renders PostScript code to pixmap by use of ghostscript.

Parameters

pixmap	pointer to destination pixmap.
dpiX	horizontal resolution of the paint device in dots per inch.
dpiY	vertical resolution of the paint device in dots per inch.

setDir()

void ImageItem::setDir ( double dir )

inline

Sets rotation angle.

Parameters

dir	rotation angle in deg.

setProperties()

void ImageItem::setProperties

(

const QTransform &

m

)

Sets properties according to transformation matrix.

Parameters

m	transformation matrix.

setScaleX()

void ImageItem::setScaleX ( double f )

inline

Sets horizontal scaling factor.

Parameters

f	scaling factor.

setScaleY()

void ImageItem::setScaleY ( double f )

inline

Sets vertical scaling factor.

Parameters

f	scaling factor.

setUrl()

void ImageItem::setUrl ( const QUrl & url )

inline

Sets URL.

Parameters

url	URL of PostScript file.

writePlo()

void ImageItem::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:

• imageitem.h