LibBoard::ShapeList Struct Reference

A group of shapes. More...

#include <ShapeList.h>

Inheritance diagram for LibBoard::ShapeList:

Public Types
enum	Direction { Top, Right, Bottom, Left }
enum	Alignment {   AlignTop, AlignBottom, AlignCenter, AlignLeft,   AlignRight }
Public Types inherited from LibBoard::Shape
enum	LineCap { ButtCap = 0, RoundCap, SquareCap }
enum	LineJoin { MiterJoin = 0, RoundJoin, BevelJoin }
enum	LineStyle {   SolidStyle = 0, DashStyle, DotStyle, DashDotStyle,   DashDotDotStyle, DashDotDotDotStyle }

Public Member Functions
	ShapeList (int depth=-1)
	ShapeList (const ShapeList &other)
ShapeList &	operator= (const ShapeList &other)
	ShapeList (const Shape &shape, unsigned int times, double dx, double dy, double scale)
	ShapeList (const Shape &shape, unsigned int times, double dx, double dy, double scaleX, double scaleY, double angle)
const std::string &	name () const
ShapeList &	clear ()
ShapeList &	rotate (double angle, const Point &center)
ShapeList	rotated (double angle, const Point &center)
ShapeList &	rotate (double angle)
ShapeList	rotated (double angle)
ShapeList &	translate (double dx, double dy)
ShapeList	translated (double dx, double dy)
ShapeList &	scale (double sx, double sy)
ShapeList &	scale (double s)
ShapeList	scaled (double sx, double sy)
ShapeList	scaled (double s)
void	scaleAll (double s)
void	flushPostscript (std::ostream &stream, const TransformEPS &transform) const
void	flushFIG (std::ostream &stream, const TransformFIG &transform, std::map< Color, int > &colormap) const
void	flushSVG (std::ostream &stream, const TransformSVG &transform) const
void	flushTikZ (std::ostream &stream, const TransformTikZ &transform) const
Rect	boundingBox () const
virtual int	minDepth () const
virtual int	maxDepth () const
void	shiftDepth (int shift)
ShapeList *	clone () const
ShapeList &	operator<< (const Shape &shape)
ShapeList &	operator+= (const Shape &shape)
ShapeList &	append (const Shape &shape, Direction direction, Alignment alignment)
Group &	addTiling (const Shape &shape, Point topLeftCorner, std::size_t columns, std::size_t rows, double spacing=0.0)
ShapeList &	insert (const Shape &shape, int depth)
ShapeList &	dup (std::size_t copies=1)
template<typename T >
T &	last (const std::size_t position=0)
Shape &	last (const std::size_t position=0)
Shape &	top ()
Public Member Functions inherited from LibBoard::Shape
	Shape (Color penColor, Color fillColor, double lineWidth, LineStyle style, const LineCap cap, const LineJoin join, int depth)
virtual	~Shape ()
bool	filled () const
virtual Point	center () const
Shape &	rotateDeg (double angle, const Point &center)
Shape &	rotateDeg (double angle)
Shape &	moveCenter (double x, double y)
Shape &	moveCenter (Point p)
Rect	bbox () const
Shape &	operator-- ()
Shape &	operator++ ()
int	depth () const
virtual void	depth (int)
const Color &	penColor () const
const Color &	fillColor () const

Protected Member Functions
void	addShape (const Shape &shape, double scaleFactor)
void	free ()
Protected Member Functions inherited from LibBoard::Shape
std::string	svgProperties (const TransformSVG &transform) const
std::string	postscriptProperties () const
std::string	tikzProperties (const TransformTikZ &transform) const

Protected Attributes
std::vector< Shape * >	_shapes
int	_nextDepth
Protected Attributes inherited from LibBoard::Shape
int	_depth
Color	_penColor
Color	_fillColor
double	_lineWidth
LineStyle	_lineStyle
LineCap	_lineCap
LineJoin	_lineJoin

Detailed Description

A group of shapes.

The ShapeList structure.

Examples:

examples/example4.cpp, and examples/koch.cpp.

Constructor & Destructor Documentation

LibBoard::ShapeList::ShapeList	(	const Shape &	shape,
		unsigned int	times,
		double	dx,
		double	dy,
		double	scale
	)

Create a ShapeList by repeating a shape (translation & scaling)

Parameters

shape	The shape to be repeated.
times	The number of repetitions.
dx	The x shift between two repetitions.
dy	The y shift between two repetitions.
scale	The scaling factor between two repetitions.

References LibBoard::Shape::clone(), LibBoard::Shape::scale(), and LibBoard::Shape::translate().

LibBoard::ShapeList::ShapeList	(	const Shape &	shape,
		unsigned int	times,
		double	dx,
		double	dy,
		double	scaleX,
		double	scaleY,
		double	angle
	)

Create a ShapeList by repeating a shape (translation, scaling & rotation)

Parameters

shape	The shape to be repeated.
times	The number of repetitions.
dx	The x shift between two repetitions.
dy	The y shift between two repetitions.
scaleX	The x scaling factor between two repetitions.
scaleY	The y scaling factor between two repetitions.
angle	The rotation angle between two repetitions.

References LibBoard::Shape::clone(), LibBoard::Shape::rotate(), LibBoard::Shape::scale(), and LibBoard::Shape::translate().

Member Function Documentation

Group & LibBoard::ShapeList::addTiling	(	const Shape &	shape,
		Point	topLeftCorner,
		std::size_t	columns,
		std::size_t	rows,
		double	spacing = 0.0
	)

Insert a tiling based on a shape by repeating this shape along its bounding box.

Parameters

shape	A shape to be repeated.
topLeftCorner	Position of the top left corner of the tiling.
columns	Number of columns of the tiling.
rows	Number of rows of the tiling.
spacing	Spacing between rows and columns.

Returns

A reference to the tiling that has been added, as a Group.

References LibBoard::Shape::boundingBox(), LibBoard::Shape::clone(), LibBoard::Rect::height, last(), LibBoard::Rect::left, LibBoard::Rect::top, LibBoard::Shape::translate(), LibBoard::Rect::width, LibBoard::Point::x, and LibBoard::Point::y.

ShapeList & LibBoard::ShapeList::append	(	const Shape &	shape,
		ShapeList::Direction	direction,
		ShapeList::Alignment	alignment
	)

Append a shape beside the shapelist.

Parameters

shape	A shape.
direction	The direction where the shape should be appended.
alignment	The alignement with the current shapelist.

Returns

The shapelist itself, after the shape has been appended.

References boundingBox(), LibBoard::Shape::boundingBox(), LibBoard::Shape::clone(), LibBoard::Rect::height, LibBoard::Rect::left, LibBoard::Shape::moveCenter(), LibBoard::Rect::top, LibBoard::Rect::width, LibBoard::Point::x, and LibBoard::Point::y.

Rect LibBoard::ShapeList::boundingBox ( ) const

virtual

Compute the bounding box of the figure.

Returns

The rectangle of the bounding box.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

Examples:

examples/ellipse.cpp.

References _shapes.

Referenced by append(), LibBoard::Group::boundingBox(), LibBoard::Board::drawBoundingBox(), LibBoard::Board::saveEPS(), LibBoard::Board::saveFIG(), LibBoard::Board::saveSVG(), and LibBoard::Board::saveTikZ().

ShapeList * LibBoard::ShapeList::clone ( ) const

virtual

Return a copy of the shape.

Returns

A copy of the shape.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

ShapeList & LibBoard::ShapeList::dup

(

std::size_t

copies = 1

)

Duplicates the last inserted shape.

Parameters

copies

The number of copies.

Examples:

examples/koch.cpp.

References _shapes.

void LibBoard::ShapeList::flushFIG ( std::ostream &  stream, const TransformFIG &  transform, std::map< Color, int > &  colormap  ) const

virtual

Write the FIG code of the shape in a stream according to a transform.

Parameters

stream	The output stream.
transform	A 2D transform to be applied.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References _shapes.

Referenced by LibBoard::Group::flushFIG().

void LibBoard::ShapeList::flushPostscript ( std::ostream &  stream, const TransformEPS &  transform  ) const

virtual

Write the EPS code of the shape in a stream according to a transform.

Parameters

stream	The output stream.
transform	A 2D transform to be applied.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References _shapes.

Referenced by LibBoard::Group::flushPostscript().

void LibBoard::ShapeList::flushSVG ( std::ostream &  stream, const TransformSVG &  transform  ) const

virtual

Write the SVG code of the shape in a stream according to a transform.

Parameters

stream	The output stream.
transform	A 2D transform to be applied.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References _shapes.

Referenced by LibBoard::Group::flushSVG().

void LibBoard::ShapeList::flushTikZ ( std::ostream &  stream, const TransformTikZ &  transform  ) const

virtual

Write the TikZ code of the shape in a stream according to a transform.

Parameters

stream	The output stream.
transform	A 2D transform to be applied.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References _shapes.

Referenced by LibBoard::Group::flushTikZ().

void LibBoard::ShapeList::free ( )

protected

Free the memory used by the shapes in the shape vector.

References _shapes.

Referenced by LibBoard::Board::operator=().

ShapeList & LibBoard::ShapeList::insert	(	const Shape &	shape,
		int	depth
	)

Insert the shape at a given depth. If the shape is ShapeList or a Board, then all shapes above it will be shifted.

Parameters

shape
depth

Returns

template<typename T >

T & LibBoard::ShapeList::last

(

const std::size_t

position = 0

)

Return the last inserted shape with its actual type, if specified (otherwise, a Shape &).

Parameters

position

The position. 0 is the last inserted shape, 1 is the one before, etc.

Returns

A reference to the addressed shape.

Examples:

examples/example2.cpp, examples/koch.cpp, examples/logo.cpp, and examples/ruler.cpp.

Referenced by addTiling().

const std::string & LibBoard::ShapeList::name ( ) const

virtual

Returns the generic name of the shape (e.g., Circle, Rectangle, etc.)

Returns

Reimplemented from LibBoard::Shape.

Reimplemented in LibBoard::Group.

ShapeList & LibBoard::ShapeList::operator+=

(

const Shape &

shape

)

Adds a shape to the list of shape, always preserving the shape's depth.

Parameters

shape

Returns

References _shapes, and LibBoard::Shape::clone().

ShapeList & LibBoard::ShapeList::operator<<

(

const Shape &

shape

)

Adds a shape to the shape list. If the shape has no given depth or is a compound shape (ShapeList) then it is placed on top of the shapes stack. Otherwise, the shape depth is left unchanged.

Parameters

shape

Returns

References _nextDepth, _shapes, and LibBoard::Shape::clone().

ShapeList & LibBoard::ShapeList::rotate ( double  angle, const Point &  center  )

virtual

Rotate the shape around a given center of rotation.

Parameters

angle	The rotation angle in radian.
center	The center of rotation.

Returns

A reference to the shape itself.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References _shapes.

Referenced by rotate(), LibBoard::Board::rotate(), and LibBoard::Group::rotate().

ShapeList & LibBoard::ShapeList::rotate ( double  angle )

virtual

Rotate the shape around its center.

Parameters

angle

The rotation angle in radian.

Returns

A reference to the shape itself.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References LibBoard::Shape::center(), and rotate().

ShapeList & LibBoard::ShapeList::scale ( double  sx, double  sy  )

virtual

Scale the shape along the x an y axis.

Parameters

sx	The scaling factor along the x axis.
sy	The scaling factor along the y axis.

Returns

The shape itself.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References _shapes, LibBoard::Shape::center(), translate(), LibBoard::Point::x, and LibBoard::Point::y.

Referenced by scale(), LibBoard::Board::scale(), and LibBoard::Group::scale().

ShapeList & LibBoard::ShapeList::scale ( double  s )

virtual

Scale the shape along both axis.

Parameters

s	The scaling factor along both axis.

Returns

The shape itself.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

References scale().

void LibBoard::ShapeList::scaleAll ( double  s )

virtual

Scales all the values (positions, dimensions, etc.) associated with the shape.

Parameters

s	The scaling factor.

Implements LibBoard::Shape.

References _shapes.

Shape & LibBoard::ShapeList::top

(

)

Convenience function that simply calls last(0).

Parameters

position

Returns

ShapeList & LibBoard::ShapeList::translate ( double  dx, double  dy  )

virtual

Translate the shape by a given offset.

Parameters

dx	The x offset.
dy	The y offset.

Returns

A reference to the shape itself.

Implements LibBoard::Shape.

Reimplemented in LibBoard::Group.

Examples:

examples/example4.cpp.

References _shapes.

Referenced by scale(), LibBoard::Board::translate(), and LibBoard::Group::translate().

Member Data Documentation

int LibBoard::ShapeList::_nextDepth

protected

The depth of the next figure to be added.

Referenced by LibBoard::Board::drawArrow(), LibBoard::Board::drawBoundingBox(), LibBoard::Board::drawCircle(), LibBoard::Board::drawClosedPolyline(), LibBoard::Board::drawDot(), LibBoard::Board::drawEllipse(), LibBoard::Board::drawLine(), LibBoard::Board::drawPolyline(), LibBoard::Board::drawRectangle(), LibBoard::Board::drawText(), LibBoard::Board::drawTriangle(), LibBoard::Board::fillCircle(), LibBoard::Board::fillEllipse(), LibBoard::Board::fillGouraudTriangle(), LibBoard::Board::fillPolyline(), LibBoard::Board::fillRectangle(), LibBoard::Board::fillTriangle(), and operator<<().

std::vector<Shape*> LibBoard::ShapeList::_shapes

protected

The vector of shapes.

Referenced by boundingBox(), LibBoard::Board::drawArrow(), LibBoard::Board::drawBoundingBox(), LibBoard::Board::drawCircle(), LibBoard::Board::drawClosedPolyline(), LibBoard::Board::drawDot(), LibBoard::Board::drawEllipse(), LibBoard::Board::drawLine(), LibBoard::Board::drawPolyline(), LibBoard::Board::drawRectangle(), LibBoard::Board::drawText(), LibBoard::Board::drawTriangle(), dup(), LibBoard::Board::fillCircle(), LibBoard::Board::fillEllipse(), LibBoard::Board::fillGouraudTriangle(), LibBoard::Board::fillPolyline(), LibBoard::Board::fillRectangle(), LibBoard::Board::fillTriangle(), flushFIG(), flushPostscript(), flushSVG(), flushTikZ(), free(), operator+=(), operator<<(), LibBoard::Board::operator=(), rotate(), LibBoard::Board::saveEPS(), LibBoard::Board::saveFIG(), LibBoard::Board::saveSVG(), LibBoard::Board::saveTikZ(), scale(), scaleAll(), and translate().

---

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

• include/board/ShapeList.h
• src/ShapeList.cpp