A canvas built on top of Qt. More...

#include <Canvas.h>

Inheritance diagram for te::qt::widgets::Canvas:

Public Member Functions
Initializer Methods
Methods related to instantiation and destruction.
	Canvas (int w, int h, int devType=QInternal::Pixmap)
	It initializes a new Canvas and associates a pixmap as the default device. More...

	Canvas (QPaintDevice *device)
	It initializes a new Canvas associated with the given paint device. More...

	~Canvas ()
	Destructor. More...

Methods Inherited From Abstract Canvas
These methods are re-implementations from abstract canvas.
void	setWindow (const double &llx, const double &lly, const double &urx, const double &ury)
	It sets the world (or window) coordinates area (supposing a cartesian reference system). More...

void	calcAspectRatio (double &llx, double &lly, double &urx, double &ury, const te::map::AlignType hAlign=te::map::Center, const te::map::AlignType vAlign=te::map::Center)
	It calculates the best aspect ratio for world (or window) coordinates area (supposing a cartesian reference system). More...

void	calcAspectRatio (te::gm::Envelope *envelope, const te::map::AlignType hAlign=te::map::Center, const te::map::AlignType vAlign=te::map::Center)
	It calculates the best aspect ratio for world (or window) coordinates area (supposing a cartesian reference system). More...

void	setBackgroundColor (const te::color::RGBAColor &color)
	It sets the canvas background color. More...

te::color::RGBAColor	getBackgroundColor () const
	It returns the canvas background color. More...

void	clear ()
	It clears the canvas content and fills with the background color. More...

void	resize (int w, int h)
	It adjusts the canvas size (width and height). More...

int	getWidth () const
	It returns the canvas width. More...

int	getHeight () const
	It returns the canvas height. More...

void	draw (const te::gm::Geometry *geom)
	It draws the geometry on canvas. More...

void	draw (const te::gm::Point *point)
	It draws the point on canvas. More...

void	draw (const te::gm::MultiPoint *mpoint)
	It draws the MultiPoint on canvas. More...

void	draw (const te::gm::LineString *line)
	It draws the LineString on canvas. More...

void	draw (const te::gm::MultiLineString *mline)
	It draws the MultiLineString on canvas. More...

void	draw (const te::gm::Polygon *poly)
	It draws the polygon on canvas. More...

void	draw (const te::gm::MultiPolygon *mpoly)
	It draws the MultiPolygon on canvas. More...

void	draw (const te::gm::GeometryCollection *g)
	It draws the GeometryCollection on canvas. More...

void	save (const char *fileName, te::map::ImageType t, int quality=75, int fg=0) const
	It saves the canvas content to a file image in the specified format type. More...

char *	getImage (te::map::ImageType t, std::size_t &size, int quality=75, int fg=0) const
	It returns the internal content as an image in a specific format (PNG, JPEG, ...). More...

te::color::RGBAColor **	getImage (const int x=0, const int y=0, const int w=0, const int h=0) const
	It gets a RGBA color array from internal canvas buffer. More...

void	freeImage (char *img) const
	This is the method that you should use to release an image generated by the canvas. More...

void	drawImage (char *src, std::size_t size, te::map::ImageType t)
	It draws the src image over the canvas. More...

void	drawImage (te::color::RGBAColor **src, int w, int h)
	It draws the src image over the canvas. More...

void	drawImage (int x, int y, char *src, std::size_t size, te::map::ImageType t)
	It draws the src image over the canvas at the specified position (x, y). More...

void	drawImage (int x, int y, te::color::RGBAColor **src, int w, int h)
	It draws the src image over the canvas at the specified position (x, y). More...

void	drawImage (int x, int y, int w, int h, char *src, std::size_t size, te::map::ImageType t)
	It draws the source image into the rectangle at position (x, y) with the given width and height. More...

void	drawImage (int x, int y, int w, int h, te::color::RGBAColor **src, int srcw, int srch)
	It draws the source image into the rectangle at position (x, y) with the given width and height. More...

void	drawImage (int x, int y, int w, int h, char *src, std::size_t size, te::map::ImageType t, int sx, int sy, int sw, int sh)
	It draws the rectangular portion with the origin (sx, sy), width sw and height sh, of the source image, at the point (x, y), with a width of w and a height of h. If sw or sh are equal to zero the width/height of the pixmap is used and adjusted by the offset sx/sy. More...

void	drawImage (int x, int y, int w, int h, te::color::RGBAColor **src, int sx, int sy, int sw, int sh)
	It draws the rectangular portion with the origin (sx, sy), width sw and height sh, of the source image, at the point (x, y), with a width of w and a height of h. If sw or sh are equal to zero the width/height of the pixmap is used and adjusted by the offset sx/sy. More...

void	drawImage (int x, int y, te::rst::Raster *src, int opacity=TE_OPAQUE)
	It draws a raster over the canvas at the specified position (x, y). The raster must be with three 8-bit bands (1R, 2G, 3B),. More...

void	drawImage (int x, int y, int w, int h, te::rst::Raster *src, int sx, int sy, int sw, int sh, int opacity=TE_OPAQUE)
	It draws the rectangular portion with the origin (sx, sy), width sw and height sh, of the source raster, starting at the point (x, y), with a width of w and a height of h. If sw or sh are equal to zero the width/height of the pixmap is used and adjusted by the offset sx/sy. More...

void	drawPixel (int x, int y)
	It sets a pixel using the point pen. More...

void	drawPixel (int x, int y, const te::color::RGBAColor &color)
	It sets a pixel to a particular color. More...

void	drawText (int x, int y, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It draws a text. More...

void	drawText (const te::gm::Point *p, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It draws a text. More...

void	drawText (const double &x, const double &y, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It draws a text. More...

void	draw (const te::at::Text *tx)
	It draws an annotaion text. More...

te::gm::Polygon *	getTextBoundary (int x, int y, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It returns the text boundary (its enclose rectangle). More...

te::gm::Polygon *	getTextBoundary (const te::gm::Point *p, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It returns the text boundary (its enclose rectangle). More...

te::gm::Polygon *	getTextBoundary (const double &x, const double &y, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It returns the text boundary (its enclose rectangle). More...

void	setTextColor (const te::color::RGBAColor &color)
	It sets the text drawing color. More...

void	setTextOpacity (int opacity)
	It sets the text opacity. More...

void	setFontFamily (const std::string &family)
	It sets the text font family. More...

void	setTextPointSize (double psize)
	It sets the text point Size. More...

void	setTextStyle (te::at::FontStyle style)
	It sets the text style. More...

void	setTextWeight (te::at::FontWeight weight)
	It sets the text weight. More...

void	setTextStretch (std::size_t stretch)
	It sets the text stretch. More...

void	setTextUnderline (bool b)
	It sets the text underline flag. More...

void	setTextOverline (bool b)
	It sets the text overline flag. More...

void	setTextStrikeOut (bool b)
	It sets the text strike out flag. More...

void	setTextDecorationColor (const te::color::RGBAColor &color)
	It sets the text color for drawing text decoration. More...

void	setTextDecorationWidth (int width)
	It sets the width for drawing text decoration. More...

void	setTextContourColor (const te::color::RGBAColor &color)
	It sets the text contour (outline) drawing color. More...

void	setTextContourEnabled (bool b)
	It controls the display of the text outline. More...

void	setTextContourOpacity (int opacity)
	It sets the text contour opacity. More...

void	setTextContourWidth (int width)
	It sets the text contour width. More...

void	setTextJustification (te::at::LineJustification just)
	It sets the text justification for multi line text. More...

void	setTextMultiLineSpacing (int spacing)
	It sets the multi line text spacing. More...

void	setPointColor (const te::color::RGBAColor &color)
	It sets the point drawing color. More...

void	setPointWidth (int w)
	It sets the point width. If point has a patterns, this pattern is scaled to width. More...

void	setPointPattern (te::color::RGBAColor **pattern, int ncols, int nrows)
	It sets the point pattern. More...

void	setPointPattern (char *pattern, std::size_t size, te::map::ImageType t)
	It sets the point pattern using a buffered image. More...

void	setPointPatternRotation (const double &angle)
	It sets the point pattern rotation. Rotation is made from the center of the pattern. More...

void	setPointPatternOpacity (int opacity)
	It sets the point pattern opacity. More...

void	setLineColor (const te::color::RGBAColor &color)
	It sets the pen color used to draw line geometries. More...

void	setLinePattern (te::color::RGBAColor **pattern, int ncols, int nrows)
	It sets the line pattern. More...

void	setLinePattern (char *pattern, std::size_t size, te::map::ImageType t)
	It sets the line pattern using a buffered image. More...

void	setLinePatternRotation (const double &angle)
	It sets the line pattern rotation. Rotation is made from the center of the pattern. More...

void	setLinePatternOpacity (int opacity)
	It sets the line pattern opacity. More...

void	setLineDashStyle (te::map::LineDashStyle style)
	It sets the line dash style. More...

void	setLineDashStyle (const std::vector< double > &style)
	It sets the line dash style to the given pattern. More...

void	setLineCapStyle (te::map::LineCapStyle style)
	It sets the line cap style. More...

void	setLineJoinStyle (te::map::LineJoinStyle style)
	It sets the line join style. More...

void	setLineWidth (int w)
	It sets the line width. More...

void	setPolygonFillColor (const te::color::RGBAColor &color)
	It sets the color used to fill the draw of polygon geometries. More...

void	setPolygonContourColor (const te::color::RGBAColor &color)
	It sets the pen color used to draw the boundary of polygon geometries. More...

void	setPolygonFillPattern (te::color::RGBAColor **pattern, int ncols, int nrows)
	It sets the polygon fill pattern. More...

void	setPolygonFillPattern (char *pattern, std::size_t size, te::map::ImageType t)
	It sets the polygon fill pattern using a buffered image. More...

void	setPolygonPatternWidth (int w)
	It sets the polygon pattern width. More...

void	setPolygonPatternRotation (const double &angle)
	It sets the polygon pattern rotation. More...

void	setPolygonPatternOpacity (int opacity)
	It sets the polygon pattern opacity. More...

void	setPolygonContourPattern (te::color::RGBAColor **pattern, int ncols, int nrows)
	It sets the pen pattern used to draw the boundary of polygon geometries. More...

void	setPolygonContourPattern (char *pattern, std::size_t size, te::map::ImageType t)
	It sets the pen pattern used to draw the boundary of polygon geometries using a buffered image. More...

void	setPolygonContourWidth (int w)
	It sets the polygon contour width. More...

void	setPolygonContourPatternRotation (const double &angle)
	It sets the polygon contour pattern rotation. More...

void	setPolygonContourPatternOpacity (int opacity)
	It sets the polygon contour pattern opacity. More...

void	setPolygonContourDashStyle (te::map::LineDashStyle style)
	It sets the polygon contour dash style. More...

void	setPolygonContourDashStyle (const std::vector< double > &style)
	It sets the polygon contour dash style to the given pattern. More...

void	setPolygonContourCapStyle (te::map::LineCapStyle style)
	It sets the polygon contour cap style. More...

void	setPolygonContourJoinStyle (te::map::LineJoinStyle style)
	It sets the polygon contour join style. More...

void	setEraseMode ()
	It sets the painter to erase mode. More...

void	setNormalMode ()
	It sets the painter to normal copy source to destination mode. More...

Qt Canvas Specific Methos
Methods that belongs only to Qt Canvas.
void	drawText (const QPoint &p, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It draws a text. More...

te::gm::Polygon *	getTextBoundary (const QPoint &p, const std::string &txt, float angle=0.0, te::at::HorizontalAlignment hAlign=te::at::Start, te::at::VerticalAlignment vAlign=te::at::Baseline)
	It returns text boundary. Color and font family should be defined in advance. More...

QPixmap *	getPixmap () const
	It returns the internal pixmap used to draw geographical objects. More...

QImage *	getImage () const
	It returns the internal image used to draw geographical objects. More...

QPaintDevice *	getDevice () const
	It returns the internal device used to draw geographical objects. More...

void	setDevice (QPaintDevice *device, bool takeOwnerShip)
	It sets new device as QPrinter. More...

int	getResolution ()
	It returns the device resolution. More...

QMatrix	getMatrix ()
	It returns the matrix. More...

void	setRenderHint (QPainter::RenderHint hint, bool on=true)
	Sets the given render hint on the canvas painter if on is true; otherwise clears the render hint. More...

Private Member Functions
Copy Constructor and Assignment Operator
Copy constructor and assignment operator not allowed.
	Canvas (const Canvas &rhs)
	Copy constructor not allowed. More...

Canvas &	operator= (const Canvas &rhs)
	Assignment operator not allowed. More...

Auxiliary Methods
Auxiliary methods.
void	setLineDashStyle (QPen &pen, const std::vector< double > &style)
	It adjusts the given pen to use the given pattern. More...

void	updateAlpha (QImage &img, const int &opacity)
	It updates the alpha channel of the given image using the given opacity value. More...

void	createPointPatterns ()
	It creates two patterns. A pattern used to draw selected objects and the other used to erase this pattern. More...

void	drawContour (const te::gm::LineString *line)
	It draw the polygon contour. More...

Private Attributes
QColor	m_bgColor
	Canvas background color. Defaults: white fully transparent. More...

bool	m_erase
	used for erase operation. More...

QFont	m_font
	The text font. More...

bool	m_isDeviceOwner
	Tells if canvas is the owner of the paint device. More...

QColor	m_lnColor
	The color used to draw lines. More...

QPen	m_lnPen
	The pen used to draw lines. More...

QMatrix	m_matrix
	Matrix that transforms the world coordinate to device coordinate. More...

QPainter	m_painter
	The painter used to draw geometric objects. More...

std::map< std::string, QPixmap * >	m_patterns
	The pixmap styles used to draw patterns. More...

QBrush	m_polyBrush
	The brush used to fill polygon. More...

QColor	m_polyColor
	The color used to fill polygon (solid, marker or pattern). More...

QColor	m_polyContourColor
	The color used to draw polygon contour. More...

QPen	m_polyContourPen
	The pen used to draw contour polygon. More...

QImage *	m_polyImage
	The pattern image used to fill polygon. More...

int	m_polyPatternWidth
	The width used to draw marker or pattern. More...

QImage *	m_polyRotatedImage
	The pattern rotated image used to fill polygon. More...

QPointF	m_pt
	Point buffer to avoid creating another point instance. More...

QImage *	m_ptClearPatternImg
	The marker or pattern used to clear (erase point). More...

QColor	m_ptColor
	The color used to draw point (pixel) or marker. More...

QColor	m_ptColorFrom
	Indicates the color that originated the pattern that shows the status of selection. Used for optmization. More...

int	m_ptHOffset
	Horizontal offset in pixels (in device coordinate) applied to point pattern or marker. More...

QImage *	m_ptImg
	The marker or pattern used to point. More...

QImage *	m_ptImgRotated
	The marker or pattern already with rotation used to draw points. More...

QPen	m_ptPen
	The pen used to draw points. More...

double	m_ptRotation
	The point pattern rotation. More...

QImage *	m_ptSelectionPatternImg
	The marker or pattern used to show selection status. The color is mixed with point pattern. More...

int	m_ptVOffset
	Vertical offset in pixels (in device coordinate) applied to point pattern or marker. More...

int	m_ptWidth
	The width for point markers and point pattern. More...

QBrush	m_txtBrush
	The brush used to draw texts. More...

bool	m_txtContourEnabled
	The flag indicates whether the outline of the text should be drawn. More...

QPen	m_txtContourPen
	The pen used to draw the text contour. More...

int	m_txtLetterSpacing
	Text letter spacing. More...

int	m_txtLineSpacing
	Text multi line spacing. More...

int	m_txtWordSpacing
	Text word spacing. More...

Detailed Description

A canvas built on top of Qt.

See Also: te::map::Canvas

Definition at line 54 of file Canvas.h.

Constructor & Destructor Documentation

te::qt::widgets::Canvas::Canvas	(	int	w,
		int	h,
		int	devType = `QInternal::Pixmap`
	)

It initializes a new Canvas and associates a pixmap as the default device.

Parameters

w	The internal pixmap width in pixels.
h	The internal pixmap height in pixels.
devType	The internal device. It can be Pixmap or Image.

Definition at line 51 of file Canvas.cpp.

References m_bgColor, m_painter, m_ptColor, and m_ptPen.

te::qt::widgets::Canvas::Canvas ( QPaintDevice * device )

It initializes a new Canvas associated with the given paint device.

Parameters

device The paint device that will be associated to this canvas.

Note: The canvas will NOT take the ownership of the given device.

Definition at line 98 of file Canvas.cpp.

References m_painter.

te::qt::widgets::Canvas::~Canvas ( )

virtual

Destructor.

Reimplemented from te::map::Canvas.

Definition at line 131 of file Canvas.cpp.

te::qt::widgets::Canvas::Canvas ( const Canvas & rhs )

private

Copy constructor not allowed.

Parameters

rhs	The right-hand-side copy that would be used to copy from.

Member Function Documentation

void te::qt::widgets::Canvas::calcAspectRatio	(	double &	llx,
		double &	lly,
		double &	urx,
		double &	ury,
		const te::map::AlignType	hAlign = `te::map::Center`,
		const te::map::AlignType	vAlign = `te::map::Center`
	)

virtual

It calculates the best aspect ratio for world (or window) coordinates area (supposing a cartesian reference system).

Parameters

llx	Lower left x-coordinate of the World.
lly	Lower left y-coordinate of the World.
urx	Upper right x-coordinate of the World.
ury	Upper right y-coordinate of the World.
hAlign	Horizontal Alignment. It can be left, center or right.
vAlign	Vertical Alignment. It can be top, center or bottom.

Note: The input coordinates will be adjusted according to the alignment parameters provided.

Implements te::map::Canvas.

Definition at line 160 of file Canvas.cpp.

References te::map::Bottom, te::map::Left, te::map::Right, and te::map::Top.

Referenced by te::qt::widgets::MapDisplay::getCanvas(), te::qt::widgets::DrawLayerThread::run(), and te::qt::widgets::MapDisplay::setExtent().

void te::qt::widgets::Canvas::calcAspectRatio	(	te::gm::Envelope *	envelope,
		const te::map::AlignType	hAlign = `te::map::Center`,
		const te::map::AlignType	vAlign = `te::map::Center`
	)

virtual

It calculates the best aspect ratio for world (or window) coordinates area (supposing a cartesian reference system).

Parameters

envelope	A rectangle with world coordinates that will be adjusted.
hAlign	Horizontal Alignment. It can be left, center or right.
vAlign	Vertical Alignment. It can be top, center or bottom.

Note: The input coordinates will be adjusted according to the alignment parameters provided.

Implements te::map::Canvas.

Definition at line 202 of file Canvas.cpp.

References te::gm::Envelope::m_llx, te::gm::Envelope::m_lly, te::gm::Envelope::m_urx, and te::gm::Envelope::m_ury.

void te::qt::widgets::Canvas::clear ( )

virtual

It clears the canvas content and fills with the background color.

Implements te::map::Canvas.

Definition at line 222 of file Canvas.cpp.

Referenced by te::qt::widgets::DrawLayerThread::run(), and te::qt::widgets::MapDisplay::setExtent().

void te::qt::widgets::Canvas::createPointPatterns ( )

private

It creates two patterns. A pattern used to draw selected objects and the other used to erase this pattern.

Definition at line 2159 of file Canvas.cpp.

void te::qt::widgets::Canvas::draw ( const te::gm::Geometry * geom )

virtual

It draws the geometry on canvas.

Parameters

geom	Any geometry (point, line, polygon, ...).

Implements te::map::Canvas.

Definition at line 296 of file Canvas.cpp.

References te::gm::GeometryCollectionMType, te::gm::GeometryCollectionType, te::gm::GeometryCollectionZMType, te::gm::GeometryCollectionZType, te::gm::Geometry::getGeomTypeId(), te::gm::LineStringMType, te::gm::LineStringType, te::gm::LineStringZMType, te::gm::LineStringZType, te::gm::MultiLineStringMType, te::gm::MultiLineStringType, te::gm::MultiLineStringZMType, te::gm::MultiLineStringZType, te::gm::MultiPointMType, te::gm::MultiPointType, te::gm::MultiPointZMType, te::gm::MultiPointZType, te::gm::MultiPolygonMType, te::gm::MultiPolygonType, te::gm::MultiPolygonZMType, te::gm::MultiPolygonZType, te::gm::PointMType, te::gm::PointType, te::gm::PointZMType, te::gm::PointZType, te::gm::PolygonMType, te::gm::PolygonType, te::gm::PolygonZMType, and te::gm::PolygonZType.

Referenced by te::qt::af::MapDisplay::drawDataSet(), te::qt::widgets::Info::drawGeometry(), te::qt::widgets::DataFrame::drawLayerSelection(), te::qt::widgets::PolygonAcquire::drawLine(), te::qt::widgets::Measure::drawLine(), te::qt::widgets::PolygonAcquire::drawPolygon(), and te::qt::widgets::Measure::drawPolygon().

void te::qt::widgets::Canvas::draw ( const te::gm::Point * point )

virtual

It draws the point on canvas.

Parameters

point The point.

Implements te::map::Canvas.

Definition at line 353 of file Canvas.cpp.

References te::gm::Point::getX(), and te::gm::Point::getY().

void te::qt::widgets::Canvas::draw ( const te::gm::MultiPoint * mpoint )

virtual

It draws the MultiPoint on canvas.

Parameters

mpoint The MultiPoint.

Implements te::map::Canvas.

Definition at line 387 of file Canvas.cpp.

References te::gm::GeometryCollection::getGeometryN(), and te::gm::GeometryCollection::getNumGeometries().

void te::qt::widgets::Canvas::draw ( const te::gm::LineString * line )

virtual

It draws the LineString on canvas.

Parameters

line	The LineString.

Implements te::map::Canvas.

Definition at line 395 of file Canvas.cpp.

References te::gm::LineString::getCoordinates(), and te::gm::LineString::getNPoints().

void te::qt::widgets::Canvas::draw ( const te::gm::MultiLineString * mline )

virtual

It draws the MultiLineString on canvas.

Parameters

mline The MultiLineString.

Implements te::map::Canvas.

Definition at line 579 of file Canvas.cpp.

References te::gm::GeometryCollection::getGeometryN(), and te::gm::GeometryCollection::getNumGeometries().

void te::qt::widgets::Canvas::draw ( const te::gm::Polygon * poly )

virtual

It draws the polygon on canvas.

Parameters

poly	The polygon.

Implements te::map::Canvas.

Definition at line 587 of file Canvas.cpp.

References te::gm::LineString::getCoordinates(), te::gm::Envelope::getHeight(), te::gm::Geometry::getMBR(), te::gm::LineString::getNPoints(), te::gm::CurvePolygon::getNumRings(), te::gm::CurvePolygon::getRingN(), te::gm::Envelope::getWidth(), te::gm::Envelope::m_llx, and te::gm::Envelope::m_lly.

void te::qt::widgets::Canvas::draw ( const te::gm::MultiPolygon * mpoly )

virtual

It draws the MultiPolygon on canvas.

Parameters

mpoly The MultiPolygon.

Implements te::map::Canvas.

Definition at line 922 of file Canvas.cpp.

References te::gm::GeometryCollection::getGeometryN(), and te::gm::GeometryCollection::getNumGeometries().

void te::qt::widgets::Canvas::draw ( const te::gm::GeometryCollection * g )

virtual

It draws the GeometryCollection on canvas.

Parameters

g	The GeometryCollection.

Implements te::map::Canvas.

Definition at line 929 of file Canvas.cpp.

References te::gm::GeometryCollection::getGeometryN(), and te::gm::GeometryCollection::getNumGeometries().

void te::qt::widgets::Canvas::draw ( const te::at::Text * txt )

virtual

It draws an annotaion text.

Parameters

txt	The annotation text to be drawn.

Implements te::map::Canvas.

Definition at line 1255 of file Canvas.cpp.

void te::qt::widgets::Canvas::drawContour ( const te::gm::LineString * line )

private

It draw the polygon contour.

Definition at line 727 of file Canvas.cpp.

References te::gm::LineString::getCoordinates(), and te::gm::LineString::getNPoints().

void te::qt::widgets::Canvas::drawImage	(	char *	src,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It draws the src image over the canvas.

Parameters

src	A source image of any type (PNG, JPEG, GIF, ...).
size	The image size in bytes.
t	The image format type (see ImageType enum).

Implements te::map::Canvas.

Definition at line 1062 of file Canvas.cpp.

void te::qt::widgets::Canvas::drawImage	(	te::color::RGBAColor **	src,
		int	w,
		int	h
	)

virtual

It draws the src image over the canvas.

Parameters

src	The source image.
w	The image width (number of columns).
h	The image height (number of rows).

Implements te::map::Canvas.

Definition at line 1067 of file Canvas.cpp.

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		char *	src,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It draws the src image over the canvas at the specified position (x, y).

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
src	A source image of any type (PNG, JPEG, GIF, ...).
size	The image size in bytes.
t	The image format type (see ImageType enum).

Implements te::map::Canvas.

Definition at line 1072 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		te::color::RGBAColor **	src,
		int	w,
		int	h
	)

virtual

It draws the src image over the canvas at the specified position (x, y).

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
src	The source image.
w	The image width (number of columns).
h	The image height (number of rows).

Implements te::map::Canvas.

Definition at line 1084 of file Canvas.cpp.

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		int	w,
		int	h,
		char *	src,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It draws the source image into the rectangle at position (x, y) with the given width and height.

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
w	The rectangle width.
h	The rectangle height.
src	A source image of any type (PNG, JPEG, GIF, ...).
size	The image size in bytes.
t	The image format type (see ImageType enum).

Implements te::map::Canvas.

Definition at line 1103 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		int	w,
		int	h,
		te::color::RGBAColor **	src,
		int	srcw,
		int	srch
	)

virtual

It draws the source image into the rectangle at position (x, y) with the given width and height.

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
w	The rectangle width.
h	The rectangle height.
src	The source image.
srcw	The source image width (number of columns).
srch	The source image height (number of rows).

Implements te::map::Canvas.

Definition at line 1115 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		int	w,
		int	h,
		char *	src,
		std::size_t	size,
		te::map::ImageType	t,
		int	sx,
		int	sy,
		int	sw,
		int	sh
	)

virtual

It draws the rectangular portion with the origin (sx, sy), width sw and height sh, of the source image, at the point (x, y), with a width of w and a height of h. If sw or sh are equal to zero the width/height of the pixmap is used and adjusted by the offset sx/sy.

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
w	The rectangle width.
h	The rectangle height.
src	A source image of any type (PNG, JPEG, GIF, ...).
size	The image size in bytes.
t	The image format type (see ImageType enum).
sx	The source image position.
sy	The source image position.
sw	The source image rectangle width.
sh	The source image rectangle height.

Implements te::map::Canvas.

Definition at line 1128 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		int	w,
		int	h,
		te::color::RGBAColor **	src,
		int	sx,
		int	sy,
		int	sw,
		int	sh
	)

virtual

It draws the rectangular portion with the origin (sx, sy), width sw and height sh, of the source image, at the point (x, y), with a width of w and a height of h. If sw or sh are equal to zero the width/height of the pixmap is used and adjusted by the offset sx/sy.

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
w	The rectangle width.
h	The rectangle height.
src	The source image.
sx	The source image start position.
sy	The source image start position.
sw	The source image rectangle width.
sh	The source image rectangle height.

Implements te::map::Canvas.

Definition at line 1140 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		te::rst::Raster *	src,
		int	opacity = `TE_OPAQUE`
	)

virtual

It draws a raster over the canvas at the specified position (x, y). The raster must be with three 8-bit bands (1R, 2G, 3B),.

Parameters

x	The canvas start position in x where the raster image will be drawn.
y	The canvas start position in y where the raster image will be drawn.
src	The source raster.
opacity	The opacity value used to draw the image

Implements te::map::Canvas.

Definition at line 1156 of file Canvas.cpp.

References te::rst::Raster::getNumberOfColumns(), and te::rst::Raster::getNumberOfRows().

void te::qt::widgets::Canvas::drawImage	(	int	x,
		int	y,
		int	w,
		int	h,
		te::rst::Raster *	src,
		int	sx,
		int	sy,
		int	sw,
		int	sh,
		int	opacity = `TE_OPAQUE`
	)

virtual

It draws the rectangular portion with the origin (sx, sy), width sw and height sh, of the source raster, starting at the point (x, y), with a width of w and a height of h. If sw or sh are equal to zero the width/height of the pixmap is used and adjusted by the offset sx/sy.

Parameters

x	The canvas start position where the src image will be drawn.
y	The canvas start position where the src image will be drawn.
w	The rectangle width.
h	The rectangle height.
src	The source raster.
sx	The source image start position.
sy	The source image start position.
sw	The source image rectangle width.
sh	The source image rectangle height.
opacity	The opacity value used to draw the image

Implements te::map::Canvas.

Definition at line 1164 of file Canvas.cpp.

References te::color::RGBAColor::getAlpha(), te::color::RGBAColor::getBlue(), te::color::RGBAColor::getGreen(), te::color::RGBAColor::getRed(), and te::rst::Raster::getValue().

void te::qt::widgets::Canvas::drawPixel	(	int	x,
		int	y
	)

virtual

It sets a pixel using the point pen.

Parameters

x	Column.
y	Row.

Implements te::map::Canvas.

Definition at line 1205 of file Canvas.cpp.

void te::qt::widgets::Canvas::drawPixel	(	int	x,
		int	y,
		const te::color::RGBAColor &	color
	)

virtual

It sets a pixel to a particular color.

The color must be an RGBA value. With the following range:

R: 0-255;
G: 0-255;
B: 0-255;
A: 0-255.

Parameters

x Column.

y Row.

color Pixel color.

Implements te::map::Canvas.

Definition at line 1212 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

void te::qt::widgets::Canvas::drawText	(	int	x,
		int	y,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

virtual

It draws a text.

Color and font family should be defined in advance.

Parameters

x	The text entry point x in device coordinate.
y	The text entry point y in device coordinate.
txt	The text to be drawn.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Implements te::map::Canvas.

Definition at line 1224 of file Canvas.cpp.

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::drawText	(	const te::gm::Point *	p,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

virtual

It draws a text.

Color and font family should be defined in advance.

Parameters

p	The text entry point in world coordinate.
txt	The text to be drawn.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Implements te::map::Canvas.

Definition at line 1234 of file Canvas.cpp.

References te::gm::Point::getX(), and te::gm::Point::getY().

void te::qt::widgets::Canvas::drawText	(	const double &	x,
		const double &	y,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

virtual

It draws a text.

Color and font family should be defined in advance.

Parameters

x	The text entry point x in world coordinate.
y	The text entry point y in world coordinate.
txt	The text to be drawn.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Implements te::map::Canvas.

Definition at line 1243 of file Canvas.cpp.

void te::qt::widgets::Canvas::drawText	(	const QPoint &	p,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

It draws a text.

Color and font family should be defined in advance.

Parameters

p	The text entry point i device coordinate.
txt	The text to be drawed.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Note: Qt Canvas extended method.

Definition at line 1976 of file Canvas.cpp.

References te::at::Bottom, te::at::CenterH, te::at::CenterV, te::at::Start, and te::at::Top.

void te::qt::widgets::Canvas::freeImage ( char * img ) const

virtual

This is the method that you should use to release an image generated by the canvas.

Parameters

img	A pointer to an image previously created by the canvas.

Implements te::map::Canvas.

Definition at line 1057 of file Canvas.cpp.

te::color::RGBAColor te::qt::widgets::Canvas::getBackgroundColor ( ) const

virtual

It returns the canvas background color.

Returns: The canvas background color.

Implements te::map::Canvas.

Definition at line 217 of file Canvas.cpp.

QPaintDevice * te::qt::widgets::Canvas::getDevice ( ) const

It returns the internal device used to draw geographical objects.

Returns: The internal device used to draw geographical objects. Don't delete it!

Warning: Qt Canvas extended method.

Note: You can not delete this pointer.

Definition at line 2099 of file Canvas.cpp.

Referenced by te::qt::widgets::MapDisplay::draw().

int te::qt::widgets::Canvas::getHeight ( ) const

virtual

It returns the canvas height.

Returns: The canvas height.

Implements te::map::Canvas.

Definition at line 291 of file Canvas.cpp.

char * te::qt::widgets::Canvas::getImage	(	te::map::ImageType	t,
		std::size_t &	size,
		int	quality = `75`,
		int	fg = `0`
	)		const

virtual

It returns the internal content as an image in a specific format (PNG, JPEG, ...).

Parameters

t	The image format type (see ImageType enum).
size	The image size in bytes.
quality	JPEG quality, generally a value between 0 and 95.
fg	Foreground color for WBMP images.

Returns: The internal content as an image. The caller will take the ownership of the returned pointer.

Note: Use canvas freeImage in order to release the returned image resources.

Implements te::map::Canvas.

Definition at line 946 of file Canvas.cpp.

References te::map::BMP, te::map::GIF, te::map::JPEG, te::map::PNG, te::qt::widgets::Globals::sm_bmpFmt, te::qt::widgets::Globals::sm_gifFmt, te::qt::widgets::Globals::sm_jpegFmt, te::qt::widgets::Globals::sm_pngFmt, te::qt::widgets::Globals::sm_xbmFmt, te::qt::widgets::Globals::sm_xpmFmt, te::map::XBM, and te::map::XPM.

te::color::RGBAColor ** te::qt::widgets::Canvas::getImage	(	const int	x = `0`,
		const int	y = `0`,
		const int	w = `0`,
		const int	h = `0`
	)		const

virtual

It gets a RGBA color array from internal canvas buffer.

Returns: The Pointer RGBA colors.

Note: The caller of this method will take the ownership of the returned array.

Implements te::map::Canvas.

Definition at line 998 of file Canvas.cpp.

QImage * te::qt::widgets::Canvas::getImage ( ) const

It returns the internal image used to draw geographical objects.

Returns: The internal image used to draw geographical objects. Don't delete it! Null is returned if device is not a image.

Warning: Qt Canvas extended method.

Note: You can not delete this pointer.

Definition at line 2091 of file Canvas.cpp.

QMatrix te::qt::widgets::Canvas::getMatrix ( )

It returns the matrix.

Returns: The marix.

Definition at line 2123 of file Canvas.cpp.

Referenced by te::qt::widgets::MapDisplay::transform().

QPixmap * te::qt::widgets::Canvas::getPixmap ( ) const

It returns the internal pixmap used to draw geographical objects.

Returns: The internal pixmap used to draw geographical objects. Don't delete it! Null is returned if device is not a pixmap.

Warning: Qt Canvas extended method.

Note: You can not delete this pointer.

Definition at line 2083 of file Canvas.cpp.

int te::qt::widgets::Canvas::getResolution ( )

It returns the device resolution.

Returns: The device resolution.

Definition at line 2115 of file Canvas.cpp.

te::gm::Polygon * te::qt::widgets::Canvas::getTextBoundary	(	int	x,
		int	y,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

virtual

It returns the text boundary (its enclose rectangle).

Color and font family should be defined in advance.

Parameters

x	The text entry point x in device coordinate.
y	The text entry point y in device coordinate.
txt	The text to be drawn.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Returns: The text boundary in world coordinate.

Note: The caller of this method will take the ownership of the returned Polygon.

Implements te::map::Canvas.

Definition at line 1404 of file Canvas.cpp.

te::gm::Polygon * te::qt::widgets::Canvas::getTextBoundary	(	const te::gm::Point *	p,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

virtual

It returns the text boundary (its enclose rectangle).

Color and font family should be defined in advance.

Parameters

p	The text entry point in world coordinate.
txt	The text to be drawn.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Returns: The text boundary in world coordinate.

Note: The caller of this method will take the ownership of the returned Polygon.

Implements te::map::Canvas.

Definition at line 1410 of file Canvas.cpp.

References te::gm::Point::getX(), and te::gm::Point::getY().

te::gm::Polygon * te::qt::widgets::Canvas::getTextBoundary	(	const double &	x,
		const double &	y,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

virtual

It returns the text boundary (its enclose rectangle).

Color and font family should be defined in advance.

Parameters

x	The text entry point x in world coordinate.
y	The text entry point y in world coordinate.
txt	The text to be drawn.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Returns: The text boundary in world coordinates.

Note: The caller of this method will take the ownership of the returned Polygon.

Implements te::map::Canvas.

Definition at line 1415 of file Canvas.cpp.

te::gm::Polygon * te::qt::widgets::Canvas::getTextBoundary	(	const QPoint &	p,
		const std::string &	txt,
		float	angle = `0.0`,
		te::at::HorizontalAlignment	hAlign = `te::at::Start`,
		te::at::VerticalAlignment	vAlign = `te::at::Baseline`
	)

It returns text boundary. Color and font family should be defined in advance.

Parameters

p	The text entry point in device coordinate.
tx	The text to be drawed.
angle	The text rotation.
hAlign	The horizontal text alignment.
vAlign	The vertical text alignment.

Returns: The text boundary in world coordinate.

Note: The caller of this method will take the ownership of the returned Polygon.

Warning: Qt Canvas extended method.

Definition at line 2029 of file Canvas.cpp.

References te::at::Bottom, te::at::CenterH, te::at::CenterV, te::gm::LineStringType, te::gm::PolygonType, te::gm::LineString::setPoint(), te::gm::CurvePolygon::setRingN(), te::at::Start, and te::at::Top.

int te::qt::widgets::Canvas::getWidth ( ) const

virtual

It returns the canvas width.

Returns: The canvas width.

Implements te::map::Canvas.

Definition at line 286 of file Canvas.cpp.

Canvas& te::qt::widgets::Canvas::operator= ( const Canvas & rhs )

private

Assignment operator not allowed.

Parameters

rhs	The right-hand-side copy that would be used to copy from.

Returns: A reference to this object.

void te::qt::widgets::Canvas::resize	(	int	w,
		int	h
	)

virtual

It adjusts the canvas size (width and height).

Parameters

w	The new canvas width.
h	The new canvas height.

Implements te::map::Canvas.

Definition at line 255 of file Canvas.cpp.

void te::qt::widgets::Canvas::save	(	const char *	fileName,
		te::map::ImageType	t,
		int	quality = `75`,
		int	fg = `0`
	)		const

virtual

It saves the canvas content to a file image in the specified format type.

Parameters

fileName	The file name and path where the image will be saved.
t	The image format type (see ImageType enum).
quality	JPEG quality, generally a value between 0 and 95.
fg	Foreground color for WBMP images.

Implements te::map::Canvas.

Definition at line 936 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::setBackgroundColor ( const te::color::RGBAColor & color )

virtual

It sets the canvas background color.

The default is totally transparent (255, 255, 255, 0).

Parameters

color The background color.

Note: When this method is called, all the canvas content is dropped out.

Implements te::map::Canvas.

Definition at line 207 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

void te::qt::widgets::Canvas::setDevice	(	QPaintDevice *	device,
		bool	takeOwnerShip
	)

It sets new device as QPrinter.

Parameters

device	The new paint device.
takeOwnerShip	If true the canvas will take the ownership of the given device otherwise it is the caller responsability to release the device.

Definition at line 2104 of file Canvas.cpp.

Referenced by te::qt::widgets::PolygonAcquire::drawGeometry(), te::qt::widgets::Measure::drawGeometry(), te::qt::widgets::RasterNavigatorWidget::drawRaster(), te::qt::widgets::OverlayWidget::onApplyToolButtonClicked(), and te::qt::widgets::OverlayWidget::onMapDisplayExtentChanged().

void te::qt::widgets::Canvas::setEraseMode ( )

virtual

It sets the painter to erase mode.

Implements te::map::Canvas.

Definition at line 2210 of file Canvas.cpp.

void te::qt::widgets::Canvas::setFontFamily ( const std::string & family )

virtual

It sets the text font family.

Parameters

family The new font family for drawing a text.

Implements te::map::Canvas.

Definition at line 1436 of file Canvas.cpp.

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setLineCapStyle ( te::map::LineCapStyle style )

virtual

It sets the line cap style.

Parameters

style The line cap style.

Implements te::map::Canvas.

Definition at line 1715 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLineColor ( const te::color::RGBAColor & color )

virtual

It sets the pen color used to draw line geometries.

This method will drop any pattern or line style previously set.

Parameters

color The color to be used by the pen.

Implements te::map::Canvas.

Definition at line 1620 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

Referenced by te::qt::widgets::Info::drawGeometry(), te::qt::widgets::PolygonAcquire::drawLine(), and te::qt::widgets::Measure::drawLine().

void te::qt::widgets::Canvas::setLineDashStyle ( te::map::LineDashStyle style )

virtual

It sets the line dash style.

Parameters

style The line dash style.

Implements te::map::Canvas.

Definition at line 1705 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLineDashStyle ( const std::vector< double > & style )

virtual

It sets the line dash style to the given pattern.

Parameters

style The line custom dash style.

Note: The style should be specified as an even number of positive double where the entries 0, 2, 4, ... are dashes and 1, 3, 5, ... are spaces.

Implements te::map::Canvas.

Definition at line 1710 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLineDashStyle	(	QPen &	pen,
		const std::vector< double > &	style
	)

private

It adjusts the given pen to use the given pattern.

Parameters

pen	The pen that will be adjusted.
style	The line custom dash style.

Definition at line 2133 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLineJoinStyle ( te::map::LineJoinStyle style )

virtual

It sets the line join style.

Parameters

style The line join style.

Implements te::map::Canvas.

Definition at line 1720 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLinePattern	(	te::color::RGBAColor **	pattern,
		int	ncols,
		int	nrows
	)

virtual

It sets the line pattern.

The pattern is a matrix of int's, and each position corresponds to a RGBA color.

Parameters

pattern	The pattern matrix: a square matrix of int's where each position corresponds to a RGBA color.
ncols	Number of columns in the matrix.
nrows	Number of rows in the matrix.

Implements te::map::Canvas.

Definition at line 1634 of file Canvas.cpp.

References te::qt::widgets::GetImage().

void te::qt::widgets::Canvas::setLinePattern	(	char *	pattern,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It sets the line pattern using a buffered image.

Parameters

pattern	The buffered image.
size	The buffer image size.
t	The image type used by the style.

Implements te::map::Canvas.

Definition at line 1653 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::setLinePatternOpacity ( int opacity )

virtual

It sets the line pattern opacity.

Parameters

opacity The pattern opacity.

Implements te::map::Canvas.

Definition at line 1691 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLinePatternRotation ( const double & angle )

virtual

It sets the line pattern rotation. Rotation is made from the center of the pattern.

Parameters

angle The rotation angle in degress.

Implements te::map::Canvas.

Definition at line 1675 of file Canvas.cpp.

void te::qt::widgets::Canvas::setLineWidth ( int w )

virtual

It sets the line width.

Parameters

w	The line width.

Implements te::map::Canvas.

Definition at line 1725 of file Canvas.cpp.

Referenced by te::qt::widgets::Info::drawGeometry(), te::qt::widgets::PolygonAcquire::drawLine(), and te::qt::widgets::Measure::drawLine().

void te::qt::widgets::Canvas::setNormalMode ( )

virtual

It sets the painter to normal copy source to destination mode.

Implements te::map::Canvas.

Definition at line 2216 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPointColor ( const te::color::RGBAColor & color )

virtual

It sets the point drawing color.

This method will instruct the canvas to draw points like pixels. Any pattern previously set will be released.

Parameters

color The new color for drawing a point.

Implements te::map::Canvas.

Definition at line 1530 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

Referenced by te::qt::widgets::Info::drawGeometry().

void te::qt::widgets::Canvas::setPointPattern	(	te::color::RGBAColor **	pattern,
		int	ncols,
		int	nrows
	)

virtual

It sets the point pattern.

The pattern is a matrix of int's, and each position corresponds to a RGBA color.

Parameters

pattern	The pattern matrix: a square matrix of int's where each position corresponds to a RGBA color.
ncols	Number of columns in the matrix.
nrows	Number of rows in the matrix.

Implements te::map::Canvas.

Definition at line 1565 of file Canvas.cpp.

References te::qt::widgets::GetImage().

Referenced by te::qt::widgets::Info::drawGeometry().

void te::qt::widgets::Canvas::setPointPattern	(	char *	pattern,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It sets the point pattern using a buffered image.

Parameters

pattern	The buffered image.
size	The buffer image size.
t	The image type used by the style.

Implements te::map::Canvas.

Definition at line 1580 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::setPointPatternOpacity ( int opacity )

virtual

It sets the point pattern opacity.

Parameters

opacity The pattern opacity.

Implements te::map::Canvas.

Definition at line 1611 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPointPatternRotation ( const double & angle )

virtual

It sets the point pattern rotation. Rotation is made from the center of the pattern.

Parameters

angle The rotation angle in degress.

Implements te::map::Canvas.

Definition at line 1605 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPointWidth ( int w )

virtual

It sets the point width. If point has a patterns, this pattern is scaled to width.

Parameters

w	The width used to draw point.

Implements te::map::Canvas.

Definition at line 1544 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourCapStyle ( te::map::LineCapStyle style )

virtual

It sets the polygon contour cap style.

Parameters

style The polygon contour cap style.

Implements te::map::Canvas.

Definition at line 1966 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourColor ( const te::color::RGBAColor & color )

virtual

It sets the pen color used to draw the boundary of polygon geometries.

Parameters

color The color to be used to outline a polygon.

Implements te::map::Canvas.

Definition at line 1862 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

Referenced by te::qt::widgets::Info::drawGeometry(), te::qt::widgets::PolygonAcquire::drawPolygon(), and te::qt::widgets::Measure::drawPolygon().

void te::qt::widgets::Canvas::setPolygonContourDashStyle ( te::map::LineDashStyle style )

virtual

It sets the polygon contour dash style.

Parameters

style The polygon contour dash style.

Implements te::map::Canvas.

Definition at line 1956 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourDashStyle ( const std::vector< double > & style )

virtual

It sets the polygon contour dash style to the given pattern.

Parameters

style The polygon contour custom dash style.

Note: The style should be specified as an even number of positive double where the entries 0, 2, 4, ... are dashes and 1, 3, 5, ... are spaces.

Implements te::map::Canvas.

Definition at line 1961 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourJoinStyle ( te::map::LineJoinStyle style )

virtual

It sets the polygon contour join style.

Parameters

style The polygon contour join style.

Implements te::map::Canvas.

Definition at line 1971 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourPattern	(	te::color::RGBAColor **	pattern,
		int	ncols,
		int	nrows
	)

virtual

It sets the pen pattern used to draw the boundary of polygon geometries.

The pattern is a matrix of int's, and each position corresponds to a RGBA color.

Parameters

pattern	The pattern matrix: a square matrix of int's where each position corresponds to a RGBA color.
ncols	Number of columns in the matrix.
nrows	Number of rows in the matrix.

Implements te::map::Canvas.

Definition at line 1878 of file Canvas.cpp.

References te::qt::widgets::GetImage().

void te::qt::widgets::Canvas::setPolygonContourPattern	(	char *	pattern,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It sets the pen pattern used to draw the boundary of polygon geometries using a buffered image.

Parameters

pattern	The buffered image.
size	The buffer image size.
t	The image type used by the style.

Implements te::map::Canvas.

Definition at line 1897 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::setPolygonContourPatternOpacity ( int opacity )

virtual

It sets the polygon contour pattern opacity.

Parameters

opacity The pattern opacity.

Implements te::map::Canvas.

Definition at line 1942 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourPatternRotation ( const double & angle )

virtual

It sets the polygon contour pattern rotation.

Parameters

angle The rotation angle in degress.

Implements te::map::Canvas.

Definition at line 1926 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonContourWidth ( int w )

virtual

It sets the polygon contour width.

Parameters

w	The contour width.

Implements te::map::Canvas.

Definition at line 1919 of file Canvas.cpp.

Referenced by te::qt::widgets::Info::drawGeometry(), te::qt::widgets::PolygonAcquire::drawPolygon(), and te::qt::widgets::Measure::drawPolygon().

void te::qt::widgets::Canvas::setPolygonFillColor ( const te::color::RGBAColor & color )

virtual

It sets the color used to fill the draw of polygon geometries.

Parameters

color The color to be used when filling a polygon.

Implements te::map::Canvas.

Definition at line 1732 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

Referenced by te::qt::widgets::Info::drawGeometry(), te::qt::widgets::PolygonAcquire::drawPolygon(), and te::qt::widgets::Measure::drawPolygon().

void te::qt::widgets::Canvas::setPolygonFillPattern	(	te::color::RGBAColor **	pattern,
		int	ncols,
		int	nrows
	)

virtual

It sets the polygon fill pattern.

The pattern is a matrix of int's, and each position corresponds to a RGBA color.

Parameters

pattern	The style matrix: a square matrix of int's where each position corresponds to a RGBA color.
ncols	Number of columns in the matrix.
nrows	Number of rows in the matrix.

Implements te::map::Canvas.

Definition at line 1739 of file Canvas.cpp.

References te::qt::widgets::GetImage().

void te::qt::widgets::Canvas::setPolygonFillPattern	(	char *	pattern,
		std::size_t	size,
		te::map::ImageType	t
	)

virtual

It sets the polygon fill pattern using a buffered image.

Parameters

pattern	The buffered image.
size	The buffer image size.
t	The image type used by the style.

Implements te::map::Canvas.

Definition at line 1776 of file Canvas.cpp.

References te::qt::widgets::GetFormat().

void te::qt::widgets::Canvas::setPolygonPatternOpacity ( int opacity )

virtual

It sets the polygon pattern opacity.

Parameters

opacity The pattern opacity.

Implements te::map::Canvas.

Definition at line 1847 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonPatternRotation ( const double & angle )

virtual

It sets the polygon pattern rotation.

Parameters

angle The rotation angle in degress.

Implements te::map::Canvas.

Definition at line 1833 of file Canvas.cpp.

void te::qt::widgets::Canvas::setPolygonPatternWidth ( int w )

virtual

It sets the polygon pattern width.

Parameters

w	The pattern width.

Implements te::map::Canvas.

Definition at line 1815 of file Canvas.cpp.

void te::qt::widgets::Canvas::setRenderHint	(	QPainter::RenderHint	hint,
		bool	on = `true`
	)

Sets the given render hint on the canvas painter if on is true; otherwise clears the render hint.

Definition at line 2128 of file Canvas.cpp.

Referenced by te::qt::widgets::Info::drawGeometry().

void te::qt::widgets::Canvas::setTextColor ( const te::color::RGBAColor & color )

virtual

It sets the text drawing color.

Parameters

color The new color for drawing a text.

Implements te::map::Canvas.

Definition at line 1423 of file Canvas.cpp.

References te::color::RGBAColor::getAlpha(), te::color::RGBAColor::getBlue(), te::color::RGBAColor::getGreen(), and te::color::RGBAColor::getRed().

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setTextContourColor ( const te::color::RGBAColor & color )

virtual

It sets the text contour (outline) drawing color.

Parameters

color The new color for drawing the contour of texts.

Implements te::map::Canvas.

Definition at line 1498 of file Canvas.cpp.

References te::color::RGBAColor::getRgba().

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setTextContourEnabled ( bool b )

virtual

It controls the display of the text outline.

Parameters

b	True to display and false to not display.

Implements te::map::Canvas.

Definition at line 1505 of file Canvas.cpp.

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setTextContourOpacity ( int opacity )

virtual

It sets the text contour opacity.

Parameters

opacity The new opacity for drawing the text contour.

Implements te::map::Canvas.

Definition at line 1510 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextContourWidth ( int width )

virtual

It sets the text contour width.

Parameters

width The new width for drawing the text contour.

Implements te::map::Canvas.

Definition at line 1516 of file Canvas.cpp.

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setTextDecorationColor ( const te::color::RGBAColor & color )

virtual

It sets the text color for drawing text decoration.

Parameters

color The new color for drawing text decoration.

Implements te::map::Canvas.

Definition at line 1490 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextDecorationWidth ( int width )

virtual

It sets the width for drawing text decoration.

Parameters

width The new width for drawing text decoration.

Implements te::map::Canvas.

Definition at line 1494 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextJustification ( te::at::LineJustification just )

virtual

It sets the text justification for multi line text.

Parameters

just	The new justification for drawing a multi line text.

Implements te::map::Canvas.

Definition at line 1521 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextMultiLineSpacing ( int spacing )

virtual

It sets the multi line text spacing.

Parameters

spacing The new spacing for drawing a multi line text.

Implements te::map::Canvas.

Definition at line 1525 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextOpacity ( int opacity )

virtual

It sets the text opacity.

Parameters

opacity The new opacity for drawing a text.

Implements te::map::Canvas.

Definition at line 1430 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextOverline ( bool b )

virtual

It sets the text overline flag.

Parameters

b	True: for overline. False otherwise.

Implements te::map::Canvas.

Definition at line 1480 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextPointSize ( double size )

virtual

It sets the text point Size.

Parameters

size	The new point size for drawing a text.

Implements te::map::Canvas.

Definition at line 1441 of file Canvas.cpp.

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setTextStretch ( std::size_t stretch )

virtual

It sets the text stretch.

Parameters

stretch The new stretch for drawing a text.

Implements te::map::Canvas.

Definition at line 1470 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextStrikeOut ( bool b )

virtual

It sets the text strike out flag.

Parameters

b	True: for strike out. False otherwise.

Implements te::map::Canvas.

Definition at line 1485 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextStyle ( te::at::FontStyle style )

virtual

It sets the text style.

Parameters

style The new style for drawing a text.

Implements te::map::Canvas.

Definition at line 1455 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextUnderline ( bool b )

virtual

It sets the text underline flag.

Parameters

b	True: for underline. False otherwise.

Implements te::map::Canvas.

Definition at line 1475 of file Canvas.cpp.

void te::qt::widgets::Canvas::setTextWeight ( te::at::FontWeight weight )

virtual

It sets the text weight.

Parameters

weight The new weight for drawing a text.

Implements te::map::Canvas.

Definition at line 1460 of file Canvas.cpp.

Referenced by te::qt::widgets::Measure::drawText().

void te::qt::widgets::Canvas::setWindow	(	const double &	llx,
		const double &	lly,
		const double &	urx,
		const double &	ury
	)

virtual

It sets the world (or window) coordinates area (supposing a cartesian reference system).

Parameters

llx	Lower left x-coordinate of the World.
lly	Lower left y-coordinate of the World.
urx	Upper right x-coordinate of the World.
ury	Upper right y-coordinate of the World.

Note: The coordinates must be in the Spatial Reference System of the features to be drawn in canvas.

Implements te::map::Canvas.

Definition at line 147 of file Canvas.cpp.

void te::qt::widgets::Canvas::updateAlpha	(	QImage &	img,
		const int &	opacity
	)

private

It updates the alpha channel of the given image using the given opacity value.

Parameters

img	The image that will be updated.
opacity	The opacity value that will be used.

Definition at line 2142 of file Canvas.cpp.

Member Data Documentation

QColor te::qt::widgets::Canvas::m_bgColor

private

Canvas background color. Defaults: white fully transparent.

Definition at line 476 of file Canvas.h.

Referenced by Canvas().

bool te::qt::widgets::Canvas::m_erase

private

used for erase operation.

Definition at line 478 of file Canvas.h.

QFont te::qt::widgets::Canvas::m_font

private

The text font.

Definition at line 507 of file Canvas.h.

bool te::qt::widgets::Canvas::m_isDeviceOwner

private

Tells if canvas is the owner of the paint device.

Definition at line 474 of file Canvas.h.

QColor te::qt::widgets::Canvas::m_lnColor

private

The color used to draw lines.

Definition at line 492 of file Canvas.h.

QPen te::qt::widgets::Canvas::m_lnPen

private

The pen used to draw lines.

Definition at line 493 of file Canvas.h.

QMatrix te::qt::widgets::Canvas::m_matrix

private

Matrix that transforms the world coordinate to device coordinate.

Definition at line 470 of file Canvas.h.

QPainter te::qt::widgets::Canvas::m_painter

private

The painter used to draw geometric objects.

Definition at line 472 of file Canvas.h.

Referenced by Canvas().

std::map<std::string, QPixmap*> te::qt::widgets::Canvas::m_patterns

private

The pixmap styles used to draw patterns.

Definition at line 513 of file Canvas.h.

QBrush te::qt::widgets::Canvas::m_polyBrush

private

The brush used to fill polygon.

Definition at line 499 of file Canvas.h.

QColor te::qt::widgets::Canvas::m_polyColor

private

The color used to fill polygon (solid, marker or pattern).

Definition at line 498 of file Canvas.h.

QColor te::qt::widgets::Canvas::m_polyContourColor

private

The color used to draw polygon contour.

Definition at line 495 of file Canvas.h.

QPen te::qt::widgets::Canvas::m_polyContourPen

private

The pen used to draw contour polygon.

Definition at line 496 of file Canvas.h.

QImage* te::qt::widgets::Canvas::m_polyImage

private

The pattern image used to fill polygon.

Definition at line 500 of file Canvas.h.

int te::qt::widgets::Canvas::m_polyPatternWidth

private

The width used to draw marker or pattern.

Definition at line 502 of file Canvas.h.

QImage* te::qt::widgets::Canvas::m_polyRotatedImage

private

The pattern rotated image used to fill polygon.

Definition at line 501 of file Canvas.h.

QPointF te::qt::widgets::Canvas::m_pt

private

Point buffer to avoid creating another point instance.

Definition at line 480 of file Canvas.h.

QImage* te::qt::widgets::Canvas::m_ptClearPatternImg

private

The marker or pattern used to clear (erase point).

Definition at line 487 of file Canvas.h.

QColor te::qt::widgets::Canvas::m_ptColor

private

The color used to draw point (pixel) or marker.

Definition at line 482 of file Canvas.h.

Referenced by Canvas().

QColor te::qt::widgets::Canvas::m_ptColorFrom

private

Indicates the color that originated the pattern that shows the status of selection. Used for optmization.

Definition at line 483 of file Canvas.h.

int te::qt::widgets::Canvas::m_ptHOffset

private

Horizontal offset in pixels (in device coordinate) applied to point pattern or marker.

Definition at line 490 of file Canvas.h.

QImage* te::qt::widgets::Canvas::m_ptImg

private

The marker or pattern used to point.

Definition at line 484 of file Canvas.h.

QImage* te::qt::widgets::Canvas::m_ptImgRotated

private

The marker or pattern already with rotation used to draw points.

Definition at line 485 of file Canvas.h.

QPen te::qt::widgets::Canvas::m_ptPen

private

The pen used to draw points.

Definition at line 479 of file Canvas.h.

Referenced by Canvas().

double te::qt::widgets::Canvas::m_ptRotation

private

The point pattern rotation.

Definition at line 488 of file Canvas.h.

QImage* te::qt::widgets::Canvas::m_ptSelectionPatternImg

private

The marker or pattern used to show selection status. The color is mixed with point pattern.

Definition at line 486 of file Canvas.h.

int te::qt::widgets::Canvas::m_ptVOffset

private

Vertical offset in pixels (in device coordinate) applied to point pattern or marker.

Definition at line 489 of file Canvas.h.

int te::qt::widgets::Canvas::m_ptWidth

private

The width for point markers and point pattern.

Definition at line 481 of file Canvas.h.

QBrush te::qt::widgets::Canvas::m_txtBrush

private

The brush used to draw texts.

Definition at line 506 of file Canvas.h.

bool te::qt::widgets::Canvas::m_txtContourEnabled

private

The flag indicates whether the outline of the text should be drawn.

Definition at line 505 of file Canvas.h.

QPen te::qt::widgets::Canvas::m_txtContourPen

private

The pen used to draw the text contour.

Definition at line 504 of file Canvas.h.

int te::qt::widgets::Canvas::m_txtLetterSpacing

private

Text letter spacing.

Definition at line 508 of file Canvas.h.

int te::qt::widgets::Canvas::m_txtLineSpacing

private

Text multi line spacing.

Definition at line 511 of file Canvas.h.

int te::qt::widgets::Canvas::m_txtWordSpacing

private

Text word spacing.

Definition at line 509 of file Canvas.h.

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

/home/castejon/castejon_files/develop/terralib5/git/src/terralib/qt/widgets/canvas/Canvas.h
/home/castejon/castejon_files/develop/terralib5/git/src/terralib/qt/widgets/canvas/Canvas.cpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation