#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 MapData &data, cairo_t *draw, RenderSteps startStep=RenderSteps::FirstStep, RenderSteps endStep=RenderSteps::LastStep)

	MapPainterCairo (const StyleConfigRef &styleConfig)

	~MapPainterCairo () override

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

bool	Draw (const Projection &projection, const MapParameter &parameter, const MapData &data, RenderSteps startStep, RenderSteps endStep)

	MapPainter (const StyleConfigRef &styleConfig)

virtual	~MapPainter ()

Public Attributes
friend	CairoLabelLayouter

Protected Member Functions
void	BeforeDrawing (const StyleConfig &styleConfig, const Projection &projection, const MapParameter &parameter, const 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 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.

Protected Member Functions inherited from osmscout::MapPainter
virtual void	AfterDrawing (const StyleConfig &styleConfig, const Projection &projection, const MapParameter &parameter, const MapData &data)

virtual void	AfterPreprocessing (const StyleConfig &styleConfig, const Projection &projection, const MapParameter &parameter, const MapData &data)
	Low level drawing routines that have to be implemented by the concrete drawing engine.

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

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

virtual void	DrawWay (const StyleConfig &styleConfig, 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
AccessFeatureValueReader	accessReader
	Value reader for the 'lanes' feature.

AddressFeatureValueReader	addressReader
	Value reader for the 'address' feature.

FillStyle	areaMarkStyle
	Marker fill style for internal debugging.

FeatureValueBuffer	coastlineSegmentAttributes

ColorFeatureValueReader	colorReader
	Value reader for the 'color' feature.

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.

TextStyleRef	debugLabel

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

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

LanesFeatureValueReader	lanesReader
	Value reader for the 'lanes' feature.

LayerFeatureValueReader	layerReader
	Value reader for the 'layer' feature.

NameAltFeatureValueReader	nameAltReader
	Value reader for the 'alternative name' feature.

NameFeatureValueReader	nameReader
	Attribute readers.

RefFeatureValueReader	refReader
	Value reader for the 'ref' feature.

FillStyleRef	seaFill

double	shieldGridSizeHoriz
	Width of a cell for shield label placement.

double	shieldGridSizeVert
	Height of a cell for shield label placement.

StyleConfigRef	styleConfig
	Reference to the style configuration to be used.

TransBuffer	transBuffer
	Internal coordinate transformation data structures.

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

WidthFeatureValueReader	widthReader
	Value reader for the 'width' feature.

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 ( const StyleConfigRef & styleConfig )

explicit

◆ ~MapPainterCairo()

osmscout::MapPainterCairo::~MapPainterCairo ( )

override

Member Function Documentation

◆ BeforeDrawing()

void osmscout::MapPainterCairo::BeforeDrawing	(	const StyleConfig &	styleConfig,
		const Projection &	projection,
		const MapParameter &	parameter,
		const 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 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 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().

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

◆ BeforeDrawing()

◆ DrawArea()

◆ DrawContourSymbol()

◆ DrawGlyphs()

◆ DrawGround()

◆ DrawIcon()

◆ DrawLabel()

◆ DrawLabels()

◆ DrawMap()

◆ DrawPath()

◆ DrawSymbol()

◆ GetFontHeight()

◆ GlyphBoundingBox()

◆ HasIcon()

◆ HasPattern()

◆ Layout()

◆ RegisterContourLabel()

◆ RegisterRegularLabel()

Member Data Documentation

◆ CairoLabelLayouter