#include <MapPainterCairo.h>

Inheritance diagram for osmscout::MapPainterCairo:

Classes
struct	CairoNativeGlyph

struct	CairoNativeLabel

Public Types
using	CairoFont = cairo_scaled_font_t *

using	CairoGlyph = Glyph< CairoNativeGlyph >

using	CairoLabel = Label< CairoNativeGlyph, CairoNativeLabel >

using	CairoLabelInstance = LabelInstance< CairoNativeGlyph, CairoNativeLabel >

using	CairoLabelLayouter = LabelLayouter< CairoNativeGlyph, CairoNativeLabel, MapPainterCairo >

Public Types inherited from osmscout::MapPainter
using	WayPathDataIt = std::list< WayPathData >::iterator

Public Member Functions
bool	DrawMap (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data, cairo_t *draw, RenderSteps startStep=RenderSteps::FirstStep, RenderSteps endStep=RenderSteps::LastStep)

	MapPainterCairo ()

	~MapPainterCairo () override

Public Member Functions inherited from osmscout::MapPainter
bool	Draw (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data)

bool	Draw (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data, RenderSteps startStep, RenderSteps endStep)

	MapPainter ()

virtual	~MapPainter ()

Public Attributes
friend	CairoLabelLayouter

Protected Member Functions
void	BeforeDrawingCallback (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data) override

void	DrawArea (const Projection &projection, const MapParameter &parameter, const AreaData &area) override
	Draw the given area using the given FillStyle for the area outline.

void	DrawContourSymbol (const Projection &projection, const MapParameter &parameter, const Symbol &symbol, const ContourSymbolData &data) override
	Draw the given Symbol on top of the contour of the given path.

void	DrawGlyphs (const Projection &projection, const MapParameter &parameter, const osmscout::PathTextStyleRef &style, const std::vector< CairoGlyph > &glyphs)

void	DrawGround (const Projection &projection, const MapParameter &parameter, const FillStyle &style) override
	(Optionally) fills the area with the given default color for ground.

void	DrawIcon (const IconStyle *style, const Vertex2D &centerPos, double width, double height) override
	Draw the Icon as defined by the IconStyle at the given pixel coordinate (icon center).

void	DrawLabel (const Projection &projection, const MapParameter &parameter, const ScreenVectorRectangle &labelRectangle, const LabelData &label, const CairoNativeLabel &layout)

void	DrawLabels (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data) override

void	DrawPath (const Projection &projection, const MapParameter &parameter, const Color &color, double width, const std::vector< double > &dash, LineStyle::CapStyle startCap, LineStyle::CapStyle endCap, const CoordBufferRange &coordRange) override
	Draw simple line with the given style,the given color, the given width and the given untransformed nodes.

void	DrawSymbol (const Projection &projection, const MapParameter &parameter, const Symbol &symbol, const Vertex2D &screenPos, double scaleFactor) override
	Draw the Symbol as defined by the SymbolStyle at the given pixel coordinate (symbol center).

double	GetFontHeight (const Projection &projection, const MapParameter &parameter, double fontSize) override
	Returns the height of the font.

osmscout::ScreenVectorRectangle	GlyphBoundingBox (const CairoNativeGlyph &glyph) const

bool	HasIcon (const StyleConfig &styleConfig, const Projection &projection, const MapParameter &parameter, IconStyle &style) override
	Return true, if the icon in the IconStyle is available and can be drawn.

bool	HasPattern (const MapParameter &parameter, const FillStyle &style)

std::shared_ptr< CairoLabel >	Layout (const Projection &projection, const MapParameter &parameter, const std::string &text, double fontSize, double objectWidth, bool enableWrapping=false, bool contourLabel=false)

void	RegisterContourLabel (const Projection &projection, const MapParameter &parameter, const ObjectFileRef &ref, const PathLabelData &label, const LabelPath &labelPath) override
	Register contour label.

void	RegisterRegularLabel (const Projection &projection, const MapParameter &parameter, const ObjectFileRef &ref, const std::vector< LabelData > &labels, const Vertex2D &position, double objectWidth) override
	Register regular label with given text at the given pixel coordinate in a style defined by the given LabelStyle.

void	StyleSheetChanged (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data) override
	Low level drawing routines that have to be implemented by the concrete drawing engine.

Protected Member Functions inherited from osmscout::MapPainter
virtual void	AfterDrawingCallback (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data)

virtual void	AfterPreprocessingCallback (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data)

virtual void	DrawContourLines (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data)

virtual void	DrawContourLines (size_t dbIndex, const Projection &projection, const MapParameter &parameter, const MapData &data)

virtual void	DrawHillShading (const Projection &projection, const MapParameter &parameter, const std::vector< MapData > &data)

virtual void	DrawHillShading (const StyleConfigRef &styleConfig, const Projection &projection, const MapParameter &parameter, const MapData &data)

virtual void	DrawWay (const Projection &projection, const MapParameter &parameter, const WayData &data)

const std::list< AreaData > &	GetAreaData () const

double	GetProjectedWidth (const Projection &projection, double minPixel, double width) const

double	GetProjectedWidth (const Projection &projection, double width) const

virtual double	GetProposedLabelWidth (const MapParameter &parameter, double averageCharWidth, double objectWidth, size_t stringLength)
	Compute suggested label width for given parameters.

const std::list< WayData > &	GetWayData () const

bool	IsVisibleArea (const Projection &projection, const GeoBox &boundingBox, double pixelOffset) const
	Useful global helper functions.

bool	IsVisibleWay (const Projection &projection, const GeoBox &boundingBox, double pixelOffset) const

std::vector< OffsetRel >	ParseLaneTurns (const LanesFeatureValue &feature) const

Additional Inherited Members
Protected Attributes inherited from osmscout::MapPainter
FillStyle	areaMarkStyle
	Marker fill style for internal debugging.

FeatureValueBuffer	coastlineSegmentAttributes

double	contourLabelOffset
	Same value as in MapParameter but converted to pixel.

double	contourLabelSpace
	Same value as in MapParameter but converted to pixel.

CoordBuffer	coordBuffer
	Coordinate buffer.

std::vector< DatabaseCacheEntry >	databaseCache
	Cache of database specific data for rendering, such as attribute readers and style config reference.

TextStyleRef	debugLabel

std::vector< double >	emptyDash
	Presets, precalculations and similar.

FillStyleRef	landFill
	Fallback styles in case they are missing for the style sheet.

FillStyleRef	seaFill

double	shieldGridSizeHoriz
	Width of a cell for shield label placement.

double	shieldGridSizeVert
	Height of a cell for shield label placement.

TransBuffer	transBuffer
	Internal coordinate transformation data structures.

std::vector< double >	tunnelDash
	Dash array for drawing tunnel border.

Member Typedef Documentation

◆ CairoFont

using osmscout::MapPainterCairo::CairoFont = cairo_scaled_font_t*

◆ CairoGlyph

using osmscout::MapPainterCairo::CairoGlyph = Glyph<CairoNativeGlyph>

◆ CairoLabel

using osmscout::MapPainterCairo::CairoLabel = Label<CairoNativeGlyph, CairoNativeLabel>

◆ CairoLabelInstance

using osmscout::MapPainterCairo::CairoLabelInstance = LabelInstance<CairoNativeGlyph, CairoNativeLabel>

◆ CairoLabelLayouter

using osmscout::MapPainterCairo::CairoLabelLayouter = LabelLayouter<CairoNativeGlyph, CairoNativeLabel, MapPainterCairo>

Constructor & Destructor Documentation

◆ MapPainterCairo()

osmscout::MapPainterCairo::MapPainterCairo ( )

◆ ~MapPainterCairo()

osmscout::MapPainterCairo::~MapPainterCairo ( )

override

Member Function Documentation

◆ BeforeDrawingCallback()

void osmscout::MapPainterCairo::BeforeDrawingCallback	(	const Projection &	projection,
		const MapParameter &	parameter,
		const std::vector< MapData > &	data
	)

overrideprotectedvirtual

Reimplemented from osmscout::MapPainter.

References osmscout::Projection::ConvertWidthToPixel(), osmscout::MapParameter::GetLabelLayouterOverlap(), osmscout::ScreenVectorRectangle::height, osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::SetLayoutOverlap(), osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::SetViewport(), osmscout::ScreenVectorRectangle::width, osmscout::ScreenVectorRectangle::x, and osmscout::ScreenVectorRectangle::y.

◆ DrawArea()

void osmscout::MapPainterCairo::DrawArea	(	const Projection &	projection,
		const MapParameter &	parameter,
		const AreaData &	area
	)

overrideprotectedvirtual

Draw the given area using the given FillStyle for the area outline.

Implements osmscout::MapPainter.

References osmscout::MapPainter::AreaData::borderStyle, osmscout::MapPainter::AreaData::clippings, osmscout::MapPainter::AreaData::coordRange, osmscout::MapPainter::AreaData::fillStyle, osmscout::CoordBufferRange::Get(), osmscout::CoordBufferRange::GetEnd(), osmscout::CoordBufferRange::GetFirst(), osmscout::CoordBufferRange::GetStart(), osmscout::Vertex2D::GetX(), and osmscout::Vertex2D::GetY().

◆ DrawContourSymbol()

void osmscout::MapPainterCairo::DrawContourSymbol	(	const Projection &	projection,
		const MapParameter &	parameter,
		const Symbol &	symbol,
		const ContourSymbolData &	data
	)

overrideprotectedvirtual

Draw the given Symbol on top of the contour of the given path.

Implements osmscout::MapPainter.

References osmscout::MapPainter::ContourSymbolData::coordRange, osmscout::CoordBufferRange::Get(), osmscout::Symbol::GetBoundingBox(), osmscout::CoordBufferRange::GetEnd(), osmscout::CoordBufferRange::GetFirst(), osmscout::ScreenBox::GetHeight(), osmscout::CoordBufferRange::GetLength(), osmscout::CoordBufferRange::GetStart(), osmscout::ScreenBox::GetWidth(), osmscout::Vertex2D::GetX(), osmscout::Vertex2D::GetY(), osmscout::MapPathOnPath(), osmscout::SymbolRenderer::Render(), osmscout::MapPainter::ContourSymbolData::symbolOffset, osmscout::MapPainter::ContourSymbolData::symbolScale, and osmscout::MapPainter::ContourSymbolData::symbolSpace.

◆ DrawGlyphs()

void osmscout::MapPainterCairo::DrawGlyphs	(	const Projection &	projection,
		const MapParameter &	parameter,
		const osmscout::PathTextStyleRef &	style,
		const std::vector< CairoGlyph > &	glyphs
	)

protected

◆ DrawGround()

void osmscout::MapPainterCairo::DrawGround	(	const Projection &	projection,
		const MapParameter &	parameter,
		const FillStyle &	style
	)

overrideprotectedvirtual

(Optionally) fills the area with the given default color for ground.

In 2D backends this just fills the given area, 3D backends might draw a sphere or an infinite plane.

Implements osmscout::MapPainter.

References osmscout::Color::GetB(), osmscout::FillStyle::GetFillColor(), osmscout::Color::GetG(), osmscout::Projection::GetHeight(), osmscout::Color::GetR(), and osmscout::Projection::GetWidth().

◆ DrawIcon()

void osmscout::MapPainterCairo::DrawIcon	(	const IconStyle *	style,
		const Vertex2D &	centerPos,
		double	width,
		double	height
	)

overrideprotectedvirtual

Draw the Icon as defined by the IconStyle at the given pixel coordinate (icon center).

Implements osmscout::MapPainter.

References osmscout::IconStyle::GetIconId(), osmscout::Vertex2D::GetX(), and osmscout::Vertex2D::GetY().

◆ DrawLabel()

void osmscout::MapPainterCairo::DrawLabel	(	const Projection &	projection,
		const MapParameter &	parameter,
		const ScreenVectorRectangle &	labelRectangle,
		const LabelData &	label,
		const CairoNativeLabel &	layout
	)

protected

References osmscout::LabelData::alpha, osmscout::MapPainterCairo::CairoNativeLabel::fontExtents, osmscout::ScreenVectorRectangle::height, osmscout::TextStyle::normal, osmscout::LabelData::style, osmscout::LabelData::text, osmscout::ScreenVectorRectangle::width, osmscout::ScreenVectorRectangle::x, and osmscout::ScreenVectorRectangle::y.

◆ DrawLabels()

void osmscout::MapPainterCairo::DrawLabels	(	const Projection &	projection,
		const MapParameter &	parameter,
		const std::vector< MapData > &	data
	)

overrideprotectedvirtual

Implements osmscout::MapPainter.

References osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::DrawLabels(), osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::Layout(), and osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::Reset().

◆ DrawMap()

bool osmscout::MapPainterCairo::DrawMap	(	const Projection &	projection,
		const MapParameter &	parameter,
		const std::vector< MapData > &	data,
		cairo_t *	draw,
		RenderSteps	startStep = `RenderSteps::FirstStep`,
		RenderSteps	endStep = `RenderSteps::LastStep`
	)

References osmscout::MapPainter::Draw(), osmscout::Projection::GetDPI(), and osmscout::MapParameter::GetLineMinWidthPixel().

◆ DrawPath()

void osmscout::MapPainterCairo::DrawPath	(	const Projection &	projection,
		const MapParameter &	parameter,
		const Color &	color,
		double	width,
		const std::vector< double > &	dash,
		LineStyle::CapStyle	startCap,
		LineStyle::CapStyle	endCap,
		const CoordBufferRange &	coordRange
	)

overrideprotectedvirtual

Draw simple line with the given style,the given color, the given width and the given untransformed nodes.

Implements osmscout::MapPainter.

References osmscout::LineStyle::capButt, osmscout::LineStyle::capRound, osmscout::LineStyle::capSquare, osmscout::CoordBufferRange::Get(), osmscout::CoordBufferRange::GetEnd(), osmscout::CoordBufferRange::GetFirst(), osmscout::CoordBufferRange::GetLast(), osmscout::CoordBufferRange::GetStart(), osmscout::Vertex2D::GetX(), and osmscout::Vertex2D::GetY().

◆ DrawSymbol()

void osmscout::MapPainterCairo::DrawSymbol	(	const Projection &	projection,
		const MapParameter &	parameter,
		const Symbol &	symbol,
		const Vertex2D &	screenPos,
		double	scaleFactor
	)

overrideprotectedvirtual

Draw the Symbol as defined by the SymbolStyle at the given pixel coordinate (symbol center).

Implements osmscout::MapPainter.

References osmscout::SymbolRenderer::Render().

◆ GetFontHeight()

double osmscout::MapPainterCairo::GetFontHeight	(	const Projection &	projection,
		const MapParameter &	parameter,
		double	fontSize
	)

overrideprotectedvirtual

Returns the height of the font.

Implements osmscout::MapPainter.

◆ GlyphBoundingBox()

ScreenVectorRectangle osmscout::MapPainterCairo::GlyphBoundingBox ( const CairoNativeGlyph & glyph ) const

protected

References osmscout::MapPainterCairo::CairoNativeGlyph::height, and osmscout::MapPainterCairo::CairoNativeGlyph::width.

◆ HasIcon()

bool osmscout::MapPainterCairo::HasIcon	(	const StyleConfig &	styleConfig,
		const Projection &	projection,
		const MapParameter &	parameter,
		IconStyle &	style
	)

overrideprotectedvirtual

Return true, if the icon in the IconStyle is available and can be drawn.

If this method returns false, possibly a fallback (using a Symbol) will be chosen.

Icon style dimensions and iconId may be setup for later usage.

Implements osmscout::MapPainter.

References osmscout::Projection::ConvertWidthToPixel(), osmscout::Log::Debug(), osmscout::Log::Error(), osmscout::IconStyle::GetIconId(), osmscout::MapParameter::GetIconMode(), osmscout::IconStyle::GetIconName(), osmscout::MapParameter::GetIconPaths(), osmscout::MapParameter::GetIconPixelSize(), osmscout::MapParameter::GetIconSize(), osmscout::IconStyle::GetWidth(), osmscout::LoadPNG(), osmscout::log, osmscout::MapParameter::OriginalPixmap, osmscout::MapParameter::Scalable, osmscout::MapParameter::ScaledPixmap, osmscout::IconStyle::SetHeight(), osmscout::IconStyle::SetIconId(), and osmscout::IconStyle::SetWidth().

◆ HasPattern()

bool osmscout::MapPainterCairo::HasPattern	(	const MapParameter &	parameter,
		const FillStyle &	style
	)

protected

References osmscout::Log::Debug(), osmscout::Log::Error(), osmscout::FillStyle::GetPatternId(), osmscout::FillStyle::GetPatternName(), osmscout::MapParameter::GetPatternPaths(), osmscout::FillStyle::HasPattern(), osmscout::LoadPNG(), osmscout::log, and osmscout::FillStyle::SetPatternId().

◆ Layout()

std::shared_ptr< MapPainterCairo::CairoLabel > osmscout::MapPainterCairo::Layout	(	const Projection &	projection,
		const MapParameter &	parameter,
		const std::string &	text,
		double	fontSize,
		double	objectWidth,
		bool	enableWrapping = `false`,
		bool	contourLabel = `false`
	)

protected

References osmscout::UTF8StringToWString().

◆ RegisterContourLabel()

void osmscout::MapPainterCairo::RegisterContourLabel	(	const Projection &	projection,
		const MapParameter &	parameter,
		const ObjectFileRef &	ref,
		const PathLabelData &	label,
		const LabelPath &	labelPath
	)

overrideprotectedvirtual

Register contour label.

Implements osmscout::MapPainter.

References osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::RegisterContourLabel().

◆ RegisterRegularLabel()

void osmscout::MapPainterCairo::RegisterRegularLabel	(	const Projection &	projection,
		const MapParameter &	parameter,
		const ObjectFileRef &	ref,
		const std::vector< LabelData > &	labels,
		const Vertex2D &	position,
		double	objectWidth
	)

overrideprotectedvirtual

Register regular label with given text at the given pixel coordinate in a style defined by the given LabelStyle.

Implements osmscout::MapPainter.

References osmscout::LabelLayouter< NativeGlyph, NativeLabel, TextLayouter >::RegisterLabel().

◆ StyleSheetChanged()

void osmscout::MapPainterCairo::StyleSheetChanged	(	const Projection &	projection,
		const MapParameter &	parameter,
		const std::vector< MapData > &	data
	)

overrideprotectedvirtual

Low level drawing routines that have to be implemented by the concrete drawing engine.

Some optional callbacks between individual processing steps. Stylesheet at least of one of the databases has changed, so the renderer can clear caches and similar.

Reimplemented from osmscout::MapPainter.

Member Data Documentation

◆ CairoLabelLayouter

friend osmscout::MapPainterCairo::CairoLabelLayouter

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

Classes

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Additional Inherited Members

Member Typedef Documentation

◆ CairoFont

◆ CairoGlyph

◆ CairoLabel

◆ CairoLabelInstance

◆ CairoLabelLayouter

Constructor & Destructor Documentation

◆ MapPainterCairo()

◆ ~MapPainterCairo()

Member Function Documentation

◆ BeforeDrawingCallback()

◆ DrawArea()

◆ DrawContourSymbol()

◆ DrawGlyphs()

◆ DrawGround()

◆ DrawIcon()

◆ DrawLabel()

◆ DrawLabels()

◆ DrawMap()

◆ DrawPath()

◆ DrawSymbol()

◆ GetFontHeight()

◆ GlyphBoundingBox()

◆ HasIcon()

◆ HasPattern()

◆ Layout()

◆ RegisterContourLabel()

◆ RegisterRegularLabel()

◆ StyleSheetChanged()

Member Data Documentation

◆ CairoLabelLayouter