Implements the Renderer2D interface on top of the Cairo 2D Graphics Library. More...

#include <CairoRenderer2D.hpp>

Inheritance diagram for CDPL::Vis::CairoRenderer2D:

Public Member Functions
	CairoRenderer2D (const CairoPointer< cairo_t > &cairo_ctxt)
	Constructs a renderer object that operates on the Cairo cdrawing ontext specified by cairo_ctxt. More...

	~CairoRenderer2D ()
	Destructor. More...

void	saveState ()
	Pushes the current pen, brush, font, transformation and clip path onto an internal state stack. More...

void	restoreState ()
	Pops the topmost stack entry and restores the renderer to the saved state. More...

void	setTransform (const Math::Matrix3D &xform)
	Replaces the current transformation matrix by xform. More...

void	transform (const Math::Matrix3D &xform)
	Right-multiplies the current transformation matrix by xform. More...

void	setPen (const Pen &pen)
	Sets the pen used for drawing outlines and lines. More...

void	setBrush (const Brush &brush)
	Sets the brush used for filling shapes. More...

void	setFont (const Font &font)
	Sets the font used for rendering text. More...

void	drawRectangle (double x1, double y1, double x2, double y2)
	Draws an axis-aligned rectangle from (x1, y1) to (x2, y2). More...

void	drawPolygon (const Math::Vector2DArray &points)
	Draws the (filled) polygon defined by the vertex sequence points. More...

void	drawLine (double x1, double y1, double x2, double y2)
	Draws a single line segment from (x1, y1) to (x2, y2). More...

void	drawPolyline (const Math::Vector2DArray &points)
	Draws the open polyline defined by the vertex sequence points. More...

void	drawLineSegments (const Math::Vector2DArray &points)
	Draws the disjoint line segments defined by consecutive vertex pairs in points. More...

void	drawPoint (double x, double y)
	Draws a single point at (x, y). More...

void	drawText (double x, double y, const std::string &txt)
	Draws the text txt with its baseline starting at (x, y). More...

void	drawEllipse (double x, double y, double width, double height)
	Draws an axis-aligned ellipse centered at (x, y) with the given width and height. More...

void	drawPath (const Path2D &path)
	Draws (strokes and fills) the 2D path path. More...

void	setClipPath (const Path2D &path)
	Sets the renderer's active clipping region to path. More...

void	clearClipPath ()
	Disables any currently active clipping region. More...

Public Member Functions inherited from CDPL::Vis::Renderer2D
virtual	~Renderer2D ()
	Virtual destructor. More...

Detailed Description

Implements the Renderer2D interface on top of the Cairo 2D Graphics Library.

For more information about the Cairo 2D Graphics Library see [CAIRO].

Constructor & Destructor Documentation

◆ CairoRenderer2D()

CDPL::Vis::CairoRenderer2D::CairoRenderer2D ( const CairoPointer< cairo_t > & cairo_ctxt )

Constructs a renderer object that operates on the Cairo cdrawing ontext specified by cairo_ctxt.

Parameters

cairo_ctxt The Cairo drawing context.

Exceptions

Base::NullPointerException if cairo_ctxt is null.

◆ ~CairoRenderer2D()

CDPL::Vis::CairoRenderer2D::~CairoRenderer2D ( )

Destructor.

Member Function Documentation

◆ saveState()

void CDPL::Vis::CairoRenderer2D::saveState ( )

virtual

Pushes the current pen, brush, font, transformation and clip path onto an internal state stack.

Implements CDPL::Vis::Renderer2D.

◆ restoreState()

void CDPL::Vis::CairoRenderer2D::restoreState ( )

virtual

Pops the topmost stack entry and restores the renderer to the saved state.

Implements CDPL::Vis::Renderer2D.

◆ setTransform()

void CDPL::Vis::CairoRenderer2D::setTransform ( const Math::Matrix3D & xform )

virtual

Replaces the current transformation matrix by xform.

Parameters

xform The new transformation matrix.

Implements CDPL::Vis::Renderer2D.

◆ transform()

void CDPL::Vis::CairoRenderer2D::transform ( const Math::Matrix3D & xform )

virtual

Right-multiplies the current transformation matrix by xform.

Parameters

xform The transformation matrix to append.

Implements CDPL::Vis::Renderer2D.

◆ setPen()

void CDPL::Vis::CairoRenderer2D::setPen ( const Pen & pen )

virtual

Sets the pen used for drawing outlines and lines.

Parameters

pen	The new pen.

Implements CDPL::Vis::Renderer2D.

◆ setBrush()

void CDPL::Vis::CairoRenderer2D::setBrush ( const Brush & brush )

virtual

Sets the brush used for filling shapes.

Parameters

brush The new brush.

Implements CDPL::Vis::Renderer2D.

◆ setFont()

void CDPL::Vis::CairoRenderer2D::setFont ( const Font & font )

virtual

Sets the font used for rendering text.

Parameters

font	The new font.

Implements CDPL::Vis::Renderer2D.

◆ drawRectangle()

void CDPL::Vis::CairoRenderer2D::drawRectangle	(	double	x1,
		double	y1,
		double	x2,
		double	y2
	)

virtual

Draws an axis-aligned rectangle from (x1, y1) to (x2, y2).

Parameters

x1	The x-coordinate of the first corner.
y1	The y-coordinate of the first corner.
x2	The x-coordinate of the opposing corner.
y2	The y-coordinate of the opposing corner.

Implements CDPL::Vis::Renderer2D.

◆ drawPolygon()

void CDPL::Vis::CairoRenderer2D::drawPolygon ( const Math::Vector2DArray & points )

virtual

Draws the (filled) polygon defined by the vertex sequence points.

Parameters

points The polygon's vertex sequence.

Implements CDPL::Vis::Renderer2D.

◆ drawLine()

void CDPL::Vis::CairoRenderer2D::drawLine	(	double	x1,
		double	y1,
		double	x2,
		double	y2
	)

virtual

Draws a single line segment from (x1, y1) to (x2, y2).

Parameters

x1	The x-coordinate of the line's start point.
y1	The y-coordinate of the line's start point.
x2	The x-coordinate of the line's end point.
y2	The y-coordinate of the line's end point.

Implements CDPL::Vis::Renderer2D.

◆ drawPolyline()

void CDPL::Vis::CairoRenderer2D::drawPolyline ( const Math::Vector2DArray & points )

virtual

Draws the open polyline defined by the vertex sequence points.

Parameters

points The polyline's vertex sequence.

Implements CDPL::Vis::Renderer2D.

◆ drawLineSegments()

void CDPL::Vis::CairoRenderer2D::drawLineSegments ( const Math::Vector2DArray & points )

virtual

Draws the disjoint line segments defined by consecutive vertex pairs in points.

Parameters

points The vertex sequence (size must be even).

Implements CDPL::Vis::Renderer2D.

◆ drawPoint()

void CDPL::Vis::CairoRenderer2D::drawPoint	(	double	x,
		double	y
	)

virtual

Draws a single point at (x, y).

Parameters

x	The point's x-coordinate.
y	The point's y-coordinate.

Implements CDPL::Vis::Renderer2D.

◆ drawText()

void CDPL::Vis::CairoRenderer2D::drawText	(	double	x,
		double	y,
		const std::string &	txt
	)

virtual

Draws the text txt with its baseline starting at (x, y).

Parameters

x	The baseline x-coordinate.
y	The baseline y-coordinate.
txt	The text to draw.

Implements CDPL::Vis::Renderer2D.

◆ drawEllipse()

void CDPL::Vis::CairoRenderer2D::drawEllipse	(	double	x,
		double	y,
		double	width,
		double	height
	)

virtual

Draws an axis-aligned ellipse centered at (x, y) with the given width and height.

Parameters

x	The x-coordinate of the ellipse's center.
y	The y-coordinate of the ellipse's center.
width	The width of the ellipse.
height	The height of the ellipse.

Implements CDPL::Vis::Renderer2D.

◆ drawPath()

void CDPL::Vis::CairoRenderer2D::drawPath ( const Path2D & path )

virtual

Draws (strokes and fills) the 2D path path.

Parameters

path	The path to draw.

Implements CDPL::Vis::Renderer2D.

◆ setClipPath()

void CDPL::Vis::CairoRenderer2D::setClipPath ( const Path2D & path )

virtual

Sets the renderer's active clipping region to path.

Parameters

path	The path defining the new clipping region.

Implements CDPL::Vis::Renderer2D.

◆ clearClipPath()

void CDPL::Vis::CairoRenderer2D::clearClipPath ( )

virtual

Disables any currently active clipping region.

Implements CDPL::Vis::Renderer2D.

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

CairoRenderer2D.hpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ CairoRenderer2D()

◆ ~CairoRenderer2D()

Member Function Documentation

◆ saveState()

◆ restoreState()

◆ setTransform()

◆ transform()

◆ setPen()

◆ setBrush()

◆ setFont()

◆ drawRectangle()

◆ drawPolygon()

◆ drawLine()

◆ drawPolyline()

◆ drawLineSegments()

◆ drawPoint()

◆ drawText()

◆ drawEllipse()

◆ drawPath()

◆ setClipPath()

◆ clearClipPath()