The QgsMapSettings class contains configuration for rendering of the map. More...

#include <qgsmapsettings.h>

Public Types
enum	Flag { Antialiasing = 0x01, DrawEditingInfo = 0x02, ForceVectorOutput = 0x04, UseAdvancedEffects = 0x08, DrawLabeling = 0x10, UseRenderingOptimization = 0x20, DrawSelection = 0x40, DrawSymbolBounds = 0x80, RenderMapTile = 0x100, RenderPartialOutput = 0x200, RenderPreviewJob = 0x400 }
	Enumeration of flags that adjust the way the map is rendered. More...

Public Member Functions
	QgsMapSettings ()

QColor	backgroundColor () const
	Get the background color of the map. More...

QString	customRenderFlags () const
	Get custom rendering flags. More...

QgsCoordinateReferenceSystem	destinationCrs () const
	returns CRS of destination coordinate reference system More...

QString	ellipsoid () const
	Returns ellipsoid's acronym. More...

const QgsExpressionContext &	expressionContext () const
	Gets the expression context. More...

QgsRectangle	extent () const
	Return geographical coordinates of the rectangle that should be rendered. More...

Flags	flags () const
	Return combination of flags used for rendering. More...

QgsRectangle	fullExtent () const
	returns current extent of layer set More...

bool	hasValidSettings () const
	Check whether the map settings are valid and can be used for rendering. More...

const QgsLabelingEngineSettings &	labelingEngineSettings () const
	Returns global configuration of the labeling engine. More...

QgsRectangle	layerExtentToOutputExtent (const QgsMapLayer *layer, QgsRectangle extent) const
	transform bounding box from layer's CRS to output CRS More...

QStringList	layerIds () const
	Get list of layer IDs for map rendering The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top) More...

QList< QgsMapLayer * >	layers () const
	Get list of layers for map rendering The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top) More...

QMap< QString, QString >	layerStyleOverrides () const
	Get map of map layer style overrides (key: layer ID, value: style name) where a different style should be used instead of the current one. More...

QgsPointXY	layerToMapCoordinates (const QgsMapLayer *layer, QgsPointXY point) const
	transform point coordinates from layer's CRS to output CRS More...

QgsRectangle	layerToMapCoordinates (const QgsMapLayer *layer, QgsRectangle rect) const
	transform rectangle from layer's CRS to output CRS More...

double	layerToMapUnits (const QgsMapLayer *layer, const QgsRectangle &referenceExtent=QgsRectangle()) const
	Computes an estimated conversion factor between layer and map units: layerUnits * layerToMapUnits = mapUnits. More...

QgsCoordinateTransform	layerTransform (const QgsMapLayer *layer) const
	Return coordinate transform from layer's CRS to destination CRS. More...

double	magnificationFactor () const
	Return the magnification factor. More...

QgsPointXY	mapToLayerCoordinates (const QgsMapLayer *layer, QgsPointXY point) const
	transform point coordinates from output CRS to layer's CRS More...

QgsRectangle	mapToLayerCoordinates (const QgsMapLayer *layer, QgsRectangle rect) const
	transform rectangle from output CRS to layer's CRS More...

const QgsMapToPixel &	mapToPixel () const

QgsUnitTypes::DistanceUnit	mapUnits () const
	Get units of map's geographical coordinates - used for scale calculation. More...

double	mapUnitsPerPixel () const
	Return the distance in geographical coordinates that equals to one pixel in the map. More...

double	outputDpi () const
	Return DPI used for conversion between real world units (e.g. More...

QgsRectangle	outputExtentToLayerExtent (const QgsMapLayer *layer, QgsRectangle extent) const
	transform bounding box from output CRS to layer's CRS More...

QImage::Format	outputImageFormat () const
	format of internal QImage, default QImage::Format_ARGB32_Premultiplied More...

QSize	outputSize () const
	Return the size of the resulting map image. More...

const QgsPathResolver &	pathResolver () const
	Returns the path resolver for conversion between relative and absolute paths during rendering operations, e.g. More...

void	readXml (QDomNode &node)

double	rotation () const
	Returns the rotation of the resulting map image, in degrees clockwise. More...

double	scale () const
	Returns the calculated map scale. More...

double	segmentationTolerance () const
	Gets the segmentation tolerance applied when rendering curved geometries. More...

QgsAbstractGeometry::SegmentationToleranceType	segmentationToleranceType () const
	Gets segmentation tolerance type (maximum angle or maximum difference between curve and approximation) More...

QColor	selectionColor () const
	Get color that is used for drawing of selected vector features. More...

void	setBackgroundColor (const QColor &color)
	Set the background color of the map. More...

void	setCustomRenderFlags (const QString &customRenderFlags)
	Sets the custom rendering flags. More...

void	setDestinationCrs (const QgsCoordinateReferenceSystem &crs)
	sets destination coordinate reference system More...

bool	setEllipsoid (const QString &ellipsoid)
	Sets the ellipsoid by its acronym. More...

void	setExpressionContext (const QgsExpressionContext &context)
	Sets the expression context. More...

void	setExtent (const QgsRectangle &rect, bool magnified=true)
	Set coordinates of the rectangle which should be rendered. More...

void	setFlag (Flag flag, bool on=true)
	Enable or disable a particular flag (other flags are not affected) More...

void	setFlags (QgsMapSettings::Flags flags)
	Set combination of flags that will be used for rendering. More...

void	setLabelingEngineSettings (const QgsLabelingEngineSettings &settings)
	Sets global configuration of the labeling engine. More...

void	setLayers (const QList< QgsMapLayer *> &layers)
	Set list of layers for map rendering. More...

void	setLayerStyleOverrides (const QMap< QString, QString > &overrides)
	Set map of map layer style overrides (key: layer ID, value: style name) where a different style should be used instead of the current one. More...

void	setMagnificationFactor (double factor)
	Set the magnification factor. More...

void	setOutputDpi (double dpi)
	Set DPI used for conversion between real world units (e.g. mm) and pixels. More...

void	setOutputImageFormat (QImage::Format format)
	sets format of internal QImage More...

void	setOutputSize (QSize size)
	Set the size of the resulting map image. More...

void	setPathResolver (const QgsPathResolver &resolver)
	Sets the path resolver for conversion between relative and absolute paths during rendering operations, e.g. More...

void	setRotation (double rotation)
	Sets the rotation of the resulting map image, in degrees clockwise. More...

void	setSegmentationTolerance (double tolerance)
	Sets the segmentation tolerance applied when rendering curved geometries. More...

void	setSegmentationToleranceType (QgsAbstractGeometry::SegmentationToleranceType type)
	Sets segmentation tolerance type (maximum angle or maximum difference between curve and approximation) More...

void	setSelectionColor (const QColor &color)
	Set color that is used for drawing of selected vector features. More...

void	setTransformContext (const QgsCoordinateTransformContext &context)
	Sets the coordinate transform context, which stores various information regarding which datum transforms should be used when transforming points from a source to destination coordinate reference system. More...

bool	testFlag (Flag flag) const
	Check whether a particular flag is enabled. More...

QgsCoordinateTransformContext	transformContext () const
	Returns the coordinate transform context, which stores various information regarding which datum transforms should be used when transforming points from a source to destination coordinate reference system. More...

QgsRectangle	visibleExtent () const
	Return the actual extent derived from requested extent that takes takes output image size into account. More...

QPolygonF	visiblePolygon () const
	Return the visible area as a polygon (may be rotated) More...

void	writeXml (QDomNode &node, QDomDocument &doc)

Protected Member Functions
void	updateDerived ()

Protected Attributes
QColor	mBackgroundColor

QString	mCustomRenderFlags

QgsCoordinateReferenceSystem	mDestCRS

double	mDpi

QString	mEllipsoid
	ellipsoid acronym (from table tbl_ellipsoids) More...

QgsExpressionContext	mExpressionContext

QgsRectangle	mExtent

Flags	mFlags

QImage::Format	mImageFormat = QImage::Format_ARGB32_Premultiplied

QgsLabelingEngineSettings	mLabelingEngineSettings

QgsWeakMapLayerPointerList	mLayers
	list of layers to be rendered (stored as weak pointers) More...

QMap< QString, QString >	mLayerStyleOverrides

double	mMagnificationFactor = 1.0

QgsMapToPixel	mMapToPixel

double	mMapUnitsPerPixel = 1

QgsPathResolver	mPathResolver

double	mRotation = 0.0

double	mScale = 1

QgsScaleCalculator	mScaleCalculator

double	mSegmentationTolerance

QgsAbstractGeometry::SegmentationToleranceType	mSegmentationToleranceType = QgsAbstractGeometry::MaximumAngle

QColor	mSelectionColor

QSize	mSize

QgsCoordinateTransformContext	mTransformContext

bool	mValid = false
	Whether the actual settings are valid (set in updateDerived()) More...

QgsRectangle	mVisibleExtent
	Extent with some additional white space that matches the output aspect ratio. More...

Detailed Description

The QgsMapSettings class contains configuration for rendering of the map.

The rendering itself is done by QgsMapRendererJob subclasses.

In order to set up QgsMapSettings instance, it is necessary to set at least few members: extent, output size and layers.

QgsMapSettings and QgsMapRendererJob (+subclasses) are intended to replace QgsMapRenderer class that existed before QGIS 2.4. The advantage of the new classes is that they separate the settings from the rendering and provide asynchronous API for map rendering.

Since: QGIS 2.4

Definition at line 58 of file qgsmapsettings.h.

Member Enumeration Documentation

◆ Flag

enum QgsMapSettings::Flag

Enumeration of flags that adjust the way the map is rendered.

Enumerator
Antialiasing	Enable anti-aliasing for map rendering.
DrawEditingInfo	Enable drawing of vertex markers for layers in editing mode.
ForceVectorOutput	Vector graphics should not be cached and drawn as raster images.
UseAdvancedEffects	Enable layer opacity and blending effects.
DrawLabeling	Enable drawing of labels on top of the map.
UseRenderingOptimization	Enable vector simplification and other rendering optimizations.
DrawSelection	Whether vector selections should be shown in the rendered map.
DrawSymbolBounds	Draw bounds of symbols (for debugging/testing)
RenderMapTile	Draw map such that there are no problems between adjacent tiles.
RenderPartialOutput	Whether to make extra effort to update map image with partially rendered layers (better for interactive map canvas). Added in QGIS 3.0.
RenderPreviewJob	Render is a 'canvas preview' render, and shortcuts should be taken to ensure fast rendering.

Definition at line 206 of file qgsmapsettings.h.

Constructor & Destructor Documentation

◆ QgsMapSettings()

QgsMapSettings::QgsMapSettings ( )

Definition at line 34 of file qgsmapsettings.cpp.

Member Function Documentation

◆ backgroundColor()

QColor QgsMapSettings::backgroundColor ( ) const

inline

Get the background color of the map.

Definition at line 198 of file qgsmapsettings.h.

◆ customRenderFlags()

QString QgsMapSettings::customRenderFlags ( ) const

inline

Get custom rendering flags.

Layers might honour these to alter their rendering.

Returns: custom flags strings, separated by ';'

Since: QGIS 2.16

See also: setCustomRenderFlags()

Definition at line 159 of file qgsmapsettings.h.

◆ destinationCrs()

QgsCoordinateReferenceSystem QgsMapSettings::destinationCrs ( ) const

returns CRS of destination coordinate reference system

Definition at line 288 of file qgsmapsettings.cpp.

◆ ellipsoid()

QString QgsMapSettings::ellipsoid ( ) const

inline

Returns ellipsoid's acronym.

Calculations will only use the ellipsoid if a valid ellipsoid has been set.

Since: QGIS 3.0

See also: setEllipsoid()

Definition at line 193 of file qgsmapsettings.h.

◆ expressionContext()

const QgsExpressionContext& QgsMapSettings::expressionContext ( ) const

inline

Gets the expression context.

This context should be used for all expression evaluation associated with this map settings.

See also: setExpressionContext()

Since: QGIS 2.12

Definition at line 270 of file qgsmapsettings.h.

◆ extent()

QgsRectangle QgsMapSettings::extent ( ) const

Return geographical coordinates of the rectangle that should be rendered.

The actual visible extent used for rendering could be slightly different since the given extent may be expanded in order to fit the aspect ratio of output size. Use visibleExtent() to get the resulting extent.

Definition at line 73 of file qgsmapsettings.cpp.

◆ flags()

QgsMapSettings::Flags QgsMapSettings::flags ( ) const

Return combination of flags used for rendering.

Definition at line 320 of file qgsmapsettings.cpp.

◆ fullExtent()

QgsRectangle QgsMapSettings::fullExtent ( ) const

returns current extent of layer set

Definition at line 527 of file qgsmapsettings.cpp.

◆ hasValidSettings()

bool QgsMapSettings::hasValidSettings ( ) const

Check whether the map settings are valid and can be used for rendering.

Definition at line 336 of file qgsmapsettings.cpp.

◆ labelingEngineSettings()

const QgsLabelingEngineSettings& QgsMapSettings::labelingEngineSettings ( ) const

inline

Returns global configuration of the labeling engine.

Since: QGIS 3.0

Definition at line 400 of file qgsmapsettings.h.

◆ layerExtentToOutputExtent()

QgsRectangle QgsMapSettings::layerExtentToOutputExtent	(	const QgsMapLayer *	layer,
		QgsRectangle	extent
	)		const

transform bounding box from layer's CRS to output CRS

See also: layerToMapCoordinates( QgsMapLayer* layer, QgsRectangle rect ) if you want to transform a rectangle

Returns: a bounding box (aligned rectangle) containing the transformed extent

Definition at line 410 of file qgsmapsettings.cpp.

◆ layerIds()

QStringList QgsMapSettings::layerIds ( ) const

Get list of layer IDs for map rendering The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top)

Definition at line 246 of file qgsmapsettings.cpp.

◆ layers()

QList< QgsMapLayer * > QgsMapSettings::layers ( ) const

Get list of layers for map rendering The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top)

Definition at line 252 of file qgsmapsettings.cpp.

◆ layerStyleOverrides()

QMap< QString, QString > QgsMapSettings::layerStyleOverrides ( ) const

Get map of map layer style overrides (key: layer ID, value: style name) where a different style should be used instead of the current one.

Since: QGIS 2.8

Definition at line 270 of file qgsmapsettings.cpp.

◆ layerToMapCoordinates() [1/2]

QgsPointXY QgsMapSettings::layerToMapCoordinates	(	const QgsMapLayer *	layer,
		QgsPointXY	point
	)		const

transform point coordinates from layer's CRS to output CRS

Returns: the transformed point

Definition at line 458 of file qgsmapsettings.cpp.

◆ layerToMapCoordinates() [2/2]

QgsRectangle QgsMapSettings::layerToMapCoordinates	(	const QgsMapLayer *	layer,
		QgsRectangle	rect
	)		const

transform rectangle from layer's CRS to output CRS

See also: layerExtentToOutputExtent() if you want to transform a bounding box

Returns: the transformed rectangle

Definition at line 475 of file qgsmapsettings.cpp.

◆ layerToMapUnits()

double QgsMapSettings::layerToMapUnits	(	const QgsMapLayer *	layer,
		const QgsRectangle &	referenceExtent = `QgsRectangle()`
	)		const

Computes an estimated conversion factor between layer and map units: layerUnits * layerToMapUnits = mapUnits.

Parameters

layer	The layer
referenceExtent	A reference extent based on which to perform the computation. If not specified, the layer extent is used

Since: QGIS 2.12

Definition at line 397 of file qgsmapsettings.cpp.

◆ layerTransform()

QgsCoordinateTransform QgsMapSettings::layerTransform ( const QgsMapLayer * layer ) const

Return coordinate transform from layer's CRS to destination CRS.

Parameters

layer

Returns: transform - may be invalid if the transform is not needed

Definition at line 389 of file qgsmapsettings.cpp.

◆ magnificationFactor()

double QgsMapSettings::magnificationFactor ( ) const

Return the magnification factor.

Since: QGIS 2.16

See also: setMagnificationFactor()

Definition at line 68 of file qgsmapsettings.cpp.

◆ mapToLayerCoordinates() [1/2]

QgsPointXY QgsMapSettings::mapToLayerCoordinates	(	const QgsMapLayer *	layer,
		QgsPointXY	point
	)		const

transform point coordinates from output CRS to layer's CRS

Returns: the transformed point

Definition at line 492 of file qgsmapsettings.cpp.

◆ mapToLayerCoordinates() [2/2]

QgsRectangle QgsMapSettings::mapToLayerCoordinates	(	const QgsMapLayer *	layer,
		QgsRectangle	rect
	)		const

transform rectangle from output CRS to layer's CRS

See also: outputExtentToLayerExtent() if you want to transform a bounding box

Returns: the transformed rectangle

Definition at line 509 of file qgsmapsettings.cpp.

◆ mapToPixel()

const QgsMapToPixel& QgsMapSettings::mapToPixel ( ) const

inline

Definition at line 310 of file qgsmapsettings.h.

◆ mapUnits()

QgsUnitTypes::DistanceUnit QgsMapSettings::mapUnits ( ) const

Get units of map's geographical coordinates - used for scale calculation.

Definition at line 330 of file qgsmapsettings.cpp.

◆ mapUnitsPerPixel()

double QgsMapSettings::mapUnitsPerPixel ( ) const

Return the distance in geographical coordinates that equals to one pixel in the map.

Definition at line 361 of file qgsmapsettings.cpp.

◆ outputDpi()

double QgsMapSettings::outputDpi ( ) const

Return DPI used for conversion between real world units (e.g.

mm) and pixels Default value is 96

Definition at line 233 of file qgsmapsettings.cpp.

◆ outputExtentToLayerExtent()

QgsRectangle QgsMapSettings::outputExtentToLayerExtent	(	const QgsMapLayer *	layer,
		QgsRectangle	extent
	)		const

transform bounding box from output CRS to layer's CRS

See also: mapToLayerCoordinates( QgsMapLayer* layer,QgsRectangle rect ) if you want to transform a rectangle

Returns: a bounding box (aligned rectangle) containing the transformed extent

Definition at line 434 of file qgsmapsettings.cpp.

◆ outputImageFormat()

QImage::Format QgsMapSettings::outputImageFormat ( ) const

inline

format of internal QImage, default QImage::Format_ARGB32_Premultiplied

Definition at line 235 of file qgsmapsettings.h.

◆ outputSize()

QSize QgsMapSettings::outputSize ( ) const

Return the size of the resulting map image.

Definition at line 221 of file qgsmapsettings.cpp.

◆ pathResolver()

const QgsPathResolver& QgsMapSettings::pathResolver ( ) const

inline

Returns the path resolver for conversion between relative and absolute paths during rendering operations, e.g.

for resolving relative symbol paths.

Since: QGIS 3.0

See also: setPathResolver()

Definition at line 299 of file qgsmapsettings.h.

◆ readXml()

void QgsMapSettings::readXml ( QDomNode & node )

Definition at line 585 of file qgsmapsettings.cpp.

◆ rotation()

double QgsMapSettings::rotation ( ) const

Returns the rotation of the resulting map image, in degrees clockwise.

Since: QGIS 2.8

See also: setRotation()

Definition at line 90 of file qgsmapsettings.cpp.

◆ scale()

double QgsMapSettings::scale ( ) const

Returns the calculated map scale.

The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

Definition at line 366 of file qgsmapsettings.cpp.

◆ segmentationTolerance()

double QgsMapSettings::segmentationTolerance ( ) const

inline

Gets the segmentation tolerance applied when rendering curved geometries.

Definition at line 381 of file qgsmapsettings.h.

◆ segmentationToleranceType()

QgsAbstractGeometry::SegmentationToleranceType QgsMapSettings::segmentationToleranceType ( ) const

inline

Gets segmentation tolerance type (maximum angle or maximum difference between curve and approximation)

Definition at line 388 of file qgsmapsettings.h.

◆ selectionColor()

QColor QgsMapSettings::selectionColor ( ) const

inline

Get color that is used for drawing of selected vector features.

Definition at line 203 of file qgsmapsettings.h.

◆ setBackgroundColor()

void QgsMapSettings::setBackgroundColor ( const QColor & color )

inline

Set the background color of the map.

Definition at line 196 of file qgsmapsettings.h.

◆ setCustomRenderFlags()

void QgsMapSettings::setCustomRenderFlags ( const QString & customRenderFlags )

inline

Sets the custom rendering flags.

Layers might honour these to alter their rendering.

Parameters

customRenderFlags custom flags strings, separated by ';'

Since: QGIS 2.16

See also: customRenderFlags()

Definition at line 167 of file qgsmapsettings.h.

◆ setDestinationCrs()

void QgsMapSettings::setDestinationCrs ( const QgsCoordinateReferenceSystem & crs )

sets destination coordinate reference system

Definition at line 280 of file qgsmapsettings.cpp.

◆ setEllipsoid()

bool QgsMapSettings::setEllipsoid ( const QString & ellipsoid )

Sets the ellipsoid by its acronym.

Known ellipsoid acronyms can be retrieved using QgsEllipsoidUtils::acronyms(). Calculations will only use the ellipsoid if a valid ellipsoid has been set.

Returns: true if ellipsoid was successfully set

Since: QGIS 3.0

See also: ellipsoid()

Definition at line 293 of file qgsmapsettings.cpp.

◆ setExpressionContext()

void QgsMapSettings::setExpressionContext ( const QgsExpressionContext & context )

inline

Sets the expression context.

This context is used for all expression evaluation associated with this map settings.

See also: expressionContext()

Since: QGIS 2.12

Definition at line 262 of file qgsmapsettings.h.

◆ setExtent()

void QgsMapSettings::setExtent	(	const QgsRectangle &	rect,
		bool	magnified = `true`
	)

Set coordinates of the rectangle which should be rendered.

The actual visible extent used for rendering could be slightly different since the given extent may be expanded in order to fit the aspect ratio of output size. Use visibleExtent() to get the resulting extent.

Definition at line 78 of file qgsmapsettings.cpp.

◆ setFlag()

void QgsMapSettings::setFlag	(	QgsMapSettings::Flag	flag,
		bool	on = `true`
	)

Enable or disable a particular flag (other flags are not affected)

Definition at line 312 of file qgsmapsettings.cpp.

◆ setFlags()

void QgsMapSettings::setFlags ( QgsMapSettings::Flags flags )

Set combination of flags that will be used for rendering.

Definition at line 307 of file qgsmapsettings.cpp.

◆ setLabelingEngineSettings()

void QgsMapSettings::setLabelingEngineSettings ( const QgsLabelingEngineSettings & settings )

inline

Sets global configuration of the labeling engine.

Since: QGIS 3.0

Definition at line 394 of file qgsmapsettings.h.

◆ setLayers()

void QgsMapSettings::setLayers ( const QList< QgsMapLayer *> & layers )

Set list of layers for map rendering.

The layers must be registered in QgsProject. The layers are stored in the reverse order of how they are rendered (layer with index 0 will be on top)

Note: Any non-spatial layers will be automatically stripped from the list (since they cannot be rendered!).

Definition at line 257 of file qgsmapsettings.cpp.

◆ setLayerStyleOverrides()

void QgsMapSettings::setLayerStyleOverrides ( const QMap< QString, QString > & overrides )

Set map of map layer style overrides (key: layer ID, value: style name) where a different style should be used instead of the current one.

Since: QGIS 2.8

Definition at line 275 of file qgsmapsettings.cpp.

◆ setMagnificationFactor()

void QgsMapSettings::setMagnificationFactor ( double factor )

Set the magnification factor.

Parameters

factor the factor of magnification

Since: QGIS 2.16

See also: magnificationFactor()

Definition at line 47 of file qgsmapsettings.cpp.

◆ setOutputDpi()

void QgsMapSettings::setOutputDpi ( double dpi )

Set DPI used for conversion between real world units (e.g. mm) and pixels.

Definition at line 238 of file qgsmapsettings.cpp.

◆ setOutputImageFormat()

void QgsMapSettings::setOutputImageFormat ( QImage::Format format )

inline

sets format of internal QImage

Definition at line 233 of file qgsmapsettings.h.

◆ setOutputSize()

void QgsMapSettings::setOutputSize ( QSize size )

Set the size of the resulting map image.

Definition at line 226 of file qgsmapsettings.cpp.

◆ setPathResolver()

void QgsMapSettings::setPathResolver ( const QgsPathResolver & resolver )

inline

Sets the path resolver for conversion between relative and absolute paths during rendering operations, e.g.

for resolving relative symbol paths.

Since: QGIS 3.0

See also: pathResolver()

Definition at line 308 of file qgsmapsettings.h.

◆ setRotation()

void QgsMapSettings::setRotation ( double rotation )

Sets the rotation of the resulting map image, in degrees clockwise.

Since: QGIS 2.8

See also: rotation()

Definition at line 95 of file qgsmapsettings.cpp.

◆ setSegmentationTolerance()

void QgsMapSettings::setSegmentationTolerance ( double tolerance )

inline

Sets the segmentation tolerance applied when rendering curved geometries.

Parameters

tolerance the segmentation tolerance

Definition at line 379 of file qgsmapsettings.h.

◆ setSegmentationToleranceType()

void QgsMapSettings::setSegmentationToleranceType ( QgsAbstractGeometry::SegmentationToleranceType type )

inline

Sets segmentation tolerance type (maximum angle or maximum difference between curve and approximation)

Parameters

type	the segmentation tolerance typename

Definition at line 386 of file qgsmapsettings.h.

◆ setSelectionColor()

void QgsMapSettings::setSelectionColor ( const QColor & color )

inline

Set color that is used for drawing of selected vector features.

Definition at line 201 of file qgsmapsettings.h.

◆ setTransformContext()

void QgsMapSettings::setTransformContext ( const QgsCoordinateTransformContext & context )

Sets the coordinate transform context, which stores various information regarding which datum transforms should be used when transforming points from a source to destination coordinate reference system.

Since: QGIS 3.0

See also: transformContext()

Definition at line 381 of file qgsmapsettings.cpp.

◆ testFlag()

bool QgsMapSettings::testFlag ( QgsMapSettings::Flag flag ) const

Check whether a particular flag is enabled.

Definition at line 325 of file qgsmapsettings.cpp.

◆ transformContext()

QgsCoordinateTransformContext QgsMapSettings::transformContext ( ) const

Returns the coordinate transform context, which stores various information regarding which datum transforms should be used when transforming points from a source to destination coordinate reference system.

Since: QGIS 3.0

See also: setTransformContext()

Definition at line 371 of file qgsmapsettings.cpp.

◆ updateDerived()

void QgsMapSettings::updateDerived ( )

protected

Definition at line 107 of file qgsmapsettings.cpp.

◆ visibleExtent()

QgsRectangle QgsMapSettings::visibleExtent ( ) const

Return the actual extent derived from requested extent that takes takes output image size into account.

Definition at line 341 of file qgsmapsettings.cpp.

◆ visiblePolygon()

QPolygonF QgsMapSettings::visiblePolygon ( ) const

Return the visible area as a polygon (may be rotated)

Since: QGIS 2.8

Definition at line 346 of file qgsmapsettings.cpp.

◆ writeXml()

void QgsMapSettings::writeXml	(	QDomNode &	node,
		QDomDocument &	doc
	)

Definition at line 620 of file qgsmapsettings.cpp.

Member Data Documentation

◆ mBackgroundColor

QColor QgsMapSettings::mBackgroundColor

protected

Definition at line 423 of file qgsmapsettings.h.

◆ mCustomRenderFlags

QString QgsMapSettings::mCustomRenderFlags

protected

Definition at line 416 of file qgsmapsettings.h.

◆ mDestCRS

QgsCoordinateReferenceSystem QgsMapSettings::mDestCRS

protected

Definition at line 419 of file qgsmapsettings.h.

◆ mDpi

double QgsMapSettings::mDpi

protected

Definition at line 404 of file qgsmapsettings.h.

◆ mEllipsoid

QString QgsMapSettings::mEllipsoid

protected

ellipsoid acronym (from table tbl_ellipsoids)

Definition at line 421 of file qgsmapsettings.h.

◆ mExpressionContext

QgsExpressionContext QgsMapSettings::mExpressionContext

protected

Definition at line 417 of file qgsmapsettings.h.

◆ mExtent

QgsRectangle QgsMapSettings::mExtent

protected

Definition at line 408 of file qgsmapsettings.h.

◆ mFlags

Flags QgsMapSettings::mFlags

protected

Definition at line 426 of file qgsmapsettings.h.

◆ mImageFormat

QImage::Format QgsMapSettings::mImageFormat = QImage::Format_ARGB32_Premultiplied

protected

Definition at line 428 of file qgsmapsettings.h.

◆ mLabelingEngineSettings

QgsLabelingEngineSettings QgsMapSettings::mLabelingEngineSettings

protected

Definition at line 433 of file qgsmapsettings.h.

◆ mLayers

QgsWeakMapLayerPointerList QgsMapSettings::mLayers

protected

list of layers to be rendered (stored as weak pointers)

Definition at line 414 of file qgsmapsettings.h.

◆ mLayerStyleOverrides

QMap<QString, QString> QgsMapSettings::mLayerStyleOverrides

protected

Definition at line 415 of file qgsmapsettings.h.

◆ mMagnificationFactor

double QgsMapSettings::mMagnificationFactor = 1.0

protected

Definition at line 411 of file qgsmapsettings.h.

◆ mMapToPixel

QgsMapToPixel QgsMapSettings::mMapToPixel

protected

Definition at line 443 of file qgsmapsettings.h.

◆ mMapUnitsPerPixel

double QgsMapSettings::mMapUnitsPerPixel = 1

protected

Definition at line 438 of file qgsmapsettings.h.

◆ mPathResolver

QgsPathResolver QgsMapSettings::mPathResolver

protected

Definition at line 447 of file qgsmapsettings.h.

◆ mRotation

double QgsMapSettings::mRotation = 0.0

protected

Definition at line 410 of file qgsmapsettings.h.

◆ mScale

double QgsMapSettings::mScale = 1

protected

Definition at line 439 of file qgsmapsettings.h.

◆ mScaleCalculator

QgsScaleCalculator QgsMapSettings::mScaleCalculator

protected

Definition at line 442 of file qgsmapsettings.h.

◆ mSegmentationTolerance

double QgsMapSettings::mSegmentationTolerance

protected

Definition at line 430 of file qgsmapsettings.h.

◆ mSegmentationToleranceType

QgsAbstractGeometry::SegmentationToleranceType QgsMapSettings::mSegmentationToleranceType = QgsAbstractGeometry::MaximumAngle

protected

Definition at line 431 of file qgsmapsettings.h.

◆ mSelectionColor

QColor QgsMapSettings::mSelectionColor

protected

Definition at line 424 of file qgsmapsettings.h.

◆ mSize

QSize QgsMapSettings::mSize

protected

Definition at line 406 of file qgsmapsettings.h.

◆ mTransformContext

QgsCoordinateTransformContext QgsMapSettings::mTransformContext

protected

Definition at line 445 of file qgsmapsettings.h.

◆ mValid

bool QgsMapSettings::mValid = false

protected

Whether the actual settings are valid (set in updateDerived())

Definition at line 436 of file qgsmapsettings.h.

◆ mVisibleExtent

QgsRectangle QgsMapSettings::mVisibleExtent

protected

Extent with some additional white space that matches the output aspect ratio.

Definition at line 437 of file qgsmapsettings.h.

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

/tmp/buildd/qgis-3.0.2+14stretch/src/core/qgsmapsettings.h
/tmp/buildd/qgis-3.0.2+14stretch/src/core/qgsmapsettings.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ Flag

Constructor & Destructor Documentation

◆ QgsMapSettings()

Member Function Documentation

◆ backgroundColor()

◆ customRenderFlags()

◆ destinationCrs()

◆ ellipsoid()

◆ expressionContext()

◆ extent()

◆ flags()

◆ fullExtent()

◆ hasValidSettings()

◆ labelingEngineSettings()

◆ layerExtentToOutputExtent()

◆ layerIds()

◆ layers()

◆ layerStyleOverrides()

◆ layerToMapCoordinates() [1/2]

◆ layerToMapCoordinates() [2/2]

◆ layerToMapUnits()

◆ layerTransform()

◆ magnificationFactor()

◆ mapToLayerCoordinates() [1/2]

◆ mapToLayerCoordinates() [2/2]

◆ mapToPixel()

◆ mapUnits()

◆ mapUnitsPerPixel()

◆ outputDpi()

◆ outputExtentToLayerExtent()

◆ outputImageFormat()

◆ outputSize()

◆ pathResolver()

◆ readXml()

◆ rotation()

◆ scale()

◆ segmentationTolerance()

◆ segmentationToleranceType()

◆ selectionColor()

◆ setBackgroundColor()

◆ setCustomRenderFlags()

◆ setDestinationCrs()

◆ setEllipsoid()

◆ setExpressionContext()

◆ setExtent()

◆ setFlag()

◆ setFlags()

◆ setLabelingEngineSettings()

◆ setLayers()

◆ setLayerStyleOverrides()

◆ setMagnificationFactor()

◆ setOutputDpi()

◆ setOutputImageFormat()

◆ setOutputSize()

◆ setPathResolver()

◆ setRotation()

◆ setSegmentationTolerance()

◆ setSegmentationToleranceType()

◆ setSelectionColor()

◆ setTransformContext()

◆ testFlag()

◆ transformContext()

◆ updateDerived()

◆ visibleExtent()

◆ visiblePolygon()

◆ writeXml()

Member Data Documentation

◆ mBackgroundColor

◆ mCustomRenderFlags

◆ mDestCRS

◆ mDpi

◆ mEllipsoid

◆ mExpressionContext

◆ mExtent