Median cut implementation. More...

Classes
class	QgsBadRequestException
	Exception thrown in case of malformed request. More...

class	QgsMapRendererJobProxy
	Proxy for sequential or parallel map render job. More...

class	QgsRenderer
	Map renderer for WMS requests. More...

class	QgsSecurityException
	Exception thrown when data access violates access controls. More...

class	QgsServiceException
	Exception class for WMS service exceptions. More...

class	QgsWmsParameter
	WMS parameter received from the client. More...

class	QgsWmsParameters
	Provides an interface to retrieve and manipulate WMS parameters received from the client. More...

struct	QgsWmsParametersComposerMap

struct	QgsWmsParametersExternalLayer

struct	QgsWmsParametersFilter

struct	QgsWmsParametersHighlightLayer

struct	QgsWmsParametersLayer

class	QgsWmsRenderContext
	Rendering context for the WMS renderer. More...

class	QgsWmsRequest
	Class defining request interface passed to WMS service. More...

class	QgsWmsRestorer
	RAII class to restore the rendering context configuration on destruction. More...

class	Service
	OGC web service specialized for WMS. More...

Typedefs
typedef QList< QPair< QRgb, int > >	QgsColorBox

typedef QMultiMap< int, QgsColorBox >	QgsColorBoxMap

Enumerations
enum class	ImageOutputFormat { Unknown , PNG , PNG8 , PNG16 , PNG1 , JPEG , WEBP }
	Supported image output format. More...

Functions
void	checkParameters (QgsWmsParameters &parameters)
	checkParameters checks request parameters and sets SRCHEIGHT and SRCWIDTH to default values in case BBOX is specified for contextual legend and (SRC)HEIGHT or (SRC)WIDTH are not.

QMap< QString, QgsRectangle >	combineCrsExtents (const QStringList &layerIds, const QMap< QString, QgsWmsLayerInfos > &wmsLayerInfos)
	Returns the combinations of the extent CRSes of the layers from the list of layers ids.

QgsRectangle	combineWgs84BoundingRect (const QStringList &layerIds, const QMap< QString, QgsWmsLayerInfos > &wmsLayerInfos)
	Returns the combination of the WGS84 bounding rectangle of the layers from the list of layers ids.

QDomDocument	describeLayer (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request)
	DescribeLayer is defined for WMS1.1.1/SLD1.0 and in WMS 1.3.0 SLD Extension.

QDomDocument	getCapabilities (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, bool projectSettings)
	Creates the WMS GetCapabilities XML document.

QDomElement	getCapabilityElement (QDomDocument &doc, const QgsProject project, const QgsWmsRequest &request, bool projectSettings, QgsServerInterface serverIface)
	Create Capability element for get capabilities document.

QDomElement	getComposerTemplatesElement (QDomDocument &doc, const QgsProject *project)
	Create ComposerTemplates element for get capabilities document.

QDomDocument	getContext (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request)
	Returns XML document for the 'GetContext' request.

QDomElement	getInspireCapabilitiesElement (QDomDocument &doc, const QgsProject *project)
	Create InspireCapabilities element for get capabilities document.

QDomElement	getLayersAndStylesCapabilitiesElement (QDomDocument &doc, QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, bool projectSettings)
	Create element for get capabilities document.

QDomElement	getServiceElement (QDomDocument &doc, const QgsProject project, const QgsWmsRequest &request, const QgsServerSettings serverSettings)
	Create Service element for get capabilities document.

QDomDocument	getStyles (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request)
	Returns an SLD file with the styles of the requested layers.

QDomElement	getWFSLayersElement (QDomDocument &doc, const QgsProject *project)
	Create WFSLayers element for get capabilities document.

void	handleLayersFromTreeGroup (QDomDocument &doc, QDomElement &parentLayer, QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, const QgsLayerTreeGroup *layerTreeGroup, const QMap< QString, QgsWmsLayerInfos > &wmsLayerInfos, bool projectSettings)

bool	hasQueryableLayers (const QStringList &layerIds, const QMap< QString, QgsWmsLayerInfos > &wmsLayerInfos)
	Returns true if at least one layer from the layers ids is queryable.

QString	implementationVersion ()
	Returns the highest version supported by this implementation.

QgsLayerTree *	layerTree (const QgsWmsRenderContext &context)

QgsLayerTree *	layerTreeWithGroups (const QgsWmsRenderContext &context, QgsLayerTree *projectRoot)

QgsLayerTreeModel *	legendModel (const QgsWmsRenderContext &context, QgsLayerTree &tree)

QgsLayerTreeModelLegendNode *	legendNode (const QString &rule, QgsLayerTreeModel &model)

void	medianCut (QVector< QRgb > &colorTable, int nColors, const QImage &inputImage)
	Median cut implementation used when reducing RGB colors to palletized colors.

ImageOutputFormat	parseImageFormat (const QString &format)
	Parse image format parameter.

QUrl	serviceUrl (const QgsServerRequest &request, const QgsProject *project, const QgsServerSettings &settings)
	Returns WMS service URL.

void	writeAsDxf (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetMap response in DXF format.

void	writeAsPdf (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetMap response in PDF format.

void	writeDescribeLayer (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetMap response in DXF format.

void	writeGetCapabilities (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response, bool projectSettings=false)
	Output GetCapabilities response.

void	writeGetContext (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetContext response.

void	writeGetFeatureInfo (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetFeatureInfo response.

void	writeGetLegendGraphics (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetLegendGRaphics response.

void	writeGetMap (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetMap response in DXF format.

void	writeGetPrint (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetPrint response.

void	writeGetSchemaExtension (QgsServerResponse &response)
	Output GetSchemaExtension response.

void	writeGetStyles (QgsServerInterface serverIface, const QgsProject project, const QgsWmsRequest &request, QgsServerResponse &response)
	Output GetStyles response.

void	writeImage (QgsServerResponse &response, QImage &img, const QString &formatStr, int imageQuality=-1)
	Write image response.

Detailed Description

Median cut implementation.

WMS implementation.

WMS implementation

Typedef Documentation

◆ QgsColorBox

typedef QList<QPair<QRgb, int> > QgsWms::QgsColorBox

Definition at line 31 of file qgsmediancut.cpp.

◆ QgsColorBoxMap

typedef QMultiMap<int, QgsColorBox> QgsWms::QgsColorBoxMap

Definition at line 32 of file qgsmediancut.cpp.

Enumeration Type Documentation

◆ ImageOutputFormat

enum class QgsWms::ImageOutputFormat

strong

Supported image output format.

Enumerator
Unknown	Unknown/invalid format.
PNG	PNG format.
PNG8	PNG8 format.
PNG16	PNG16 format.
PNG1	PNG1 format.
JPEG	JPEG format.
WEBP	WEBP format.

Definition at line 40 of file qgswmsutils.h.

Function Documentation

◆ checkParameters()

void QgsWms::checkParameters ( QgsWmsParameters & parameters )

checkParameters checks request parameters and sets SRCHEIGHT and SRCWIDTH to default values in case BBOX is specified for contextual legend and (SRC)HEIGHT or (SRC)WIDTH are not.

Definition at line 192 of file qgswmsgetlegendgraphics.cpp.

◆ combineCrsExtents()

QMap< QString, QgsRectangle > QgsWms::combineCrsExtents	(	const QStringList &	layerIds,
		const QMap< QString, QgsWmsLayerInfos > &	wmsLayerInfos
	)

Returns the combinations of the extent CRSes of the layers from the list of layers ids.

Parameters

layerIds	list of layer ids
wmsLayerInfos	WMS layers definition to build WMS capabilities

Returns: the extent combination of the WGS84 bounding rectangle of the layers from the list of layers ids

Since: QGIS 3.28.0

Definition at line 1845 of file qgswmsgetcapabilities.cpp.

◆ combineWgs84BoundingRect()

QgsRectangle QgsWms::combineWgs84BoundingRect	(	const QStringList &	layerIds,
		const QMap< QString, QgsWmsLayerInfos > &	wmsLayerInfos
	)

Returns the combination of the WGS84 bounding rectangle of the layers from the list of layers ids.

Parameters

layerIds	list of layer ids
wmsLayerInfos	WMS layers definition to build WMS capabilities

Returns: the extent combination of the WGS84 bounding rectangle of the layers from the list of layers ids

Since: QGIS 3.28.0

Definition at line 1808 of file qgswmsgetcapabilities.cpp.

◆ describeLayer()

QDomDocument QgsWms::describeLayer	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request
	)

DescribeLayer is defined for WMS1.1.1/SLD1.0 and in WMS 1.3.0 SLD Extension.

Definition at line 40 of file qgswmsdescribelayer.cpp.

◆ getCapabilities()

QDomDocument QgsWms::getCapabilities	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		bool	projectSettings
	)

Creates the WMS GetCapabilities XML document.

Parameters

serverIface	Interface for plugins
project	Project
request	WMS request
projectSettings	If `true`, adds extended project information (does not validate against WMS schema)

Returns: GetCapabilities XML document

Definition at line 138 of file qgswmsgetcapabilities.cpp.

◆ getCapabilityElement()

QDomElement QgsWms::getCapabilityElement	(	QDomDocument &	doc,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		bool	projectSettings,
		QgsServerInterface *	serverIface
	)

Create Capability element for get capabilities document.

Definition at line 377 of file qgswmsgetcapabilities.cpp.

◆ getComposerTemplatesElement()

QDomElement QgsWms::getComposerTemplatesElement	(	QDomDocument &	doc,
		const QgsProject *	project
	)

Create ComposerTemplates element for get capabilities document.

Definition at line 609 of file qgswmsgetcapabilities.cpp.

◆ getContext()

QDomDocument QgsWms::getContext	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request
	)

Returns XML document for the 'GetContext' request.

Definition at line 82 of file qgswmsgetcontext.cpp.

◆ getInspireCapabilitiesElement()

QDomElement QgsWms::getInspireCapabilitiesElement	(	QDomDocument &	doc,
		const QgsProject *	project
	)

Create InspireCapabilities element for get capabilities document.

Definition at line 503 of file qgswmsgetcapabilities.cpp.

◆ getLayersAndStylesCapabilitiesElement()

QDomElement QgsWms::getLayersAndStylesCapabilitiesElement	(	QDomDocument &	doc,
		QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		bool	projectSettings
	)

Create element for get capabilities document.

Definition at line 774 of file qgswmsgetcapabilities.cpp.

◆ getServiceElement()

QDomElement QgsWms::getServiceElement	(	QDomDocument &	doc,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		const QgsServerSettings *	serverSettings
	)

Create Service element for get capabilities document.

Definition at line 223 of file qgswmsgetcapabilities.cpp.

◆ getStyles()

QDomDocument QgsWms::getStyles	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request
	)

Returns an SLD file with the styles of the requested layers.

Exception is raised in case of troubles :-)

Definition at line 49 of file qgswmsgetstyles.cpp.

◆ getWFSLayersElement()

QDomElement QgsWms::getWFSLayersElement	(	QDomDocument &	doc,
		const QgsProject *	project
	)

Create WFSLayers element for get capabilities document.

Definition at line 725 of file qgswmsgetcapabilities.cpp.

◆ handleLayersFromTreeGroup()

void QgsWms::handleLayersFromTreeGroup	(	QDomDocument &	doc,
		QDomElement &	parentLayer,
		QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		const QgsLayerTreeGroup *	layerTreeGroup,
		const QMap< QString, QgsWmsLayerInfos > &	wmsLayerInfos,
		bool	projectSettings
	)

Definition at line 755 of file qgswmsgetcapabilities.cpp.

◆ hasQueryableLayers()

bool QgsWms::hasQueryableLayers	(	const QStringList &	layerIds,
		const QMap< QString, QgsWmsLayerInfos > &	wmsLayerInfos
	)

Returns true if at least one layer from the layers ids is queryable.

Parameters

layerIds	list of layer ids
wmsLayerInfos	WMS layers definition to build WMS capabilities

Returns: True if at least one layer form the layers ids is queryable

Since: QGIS 3.28.0

Definition at line 1792 of file qgswmsgetcapabilities.cpp.

◆ implementationVersion()

QString QgsWms::implementationVersion ( )

Returns the highest version supported by this implementation.

Since: QGIS 3.22.12

Definition at line 33 of file qgswmsutils.cpp.

◆ layerTree()

QgsLayerTree * QgsWms::layerTree ( const QgsWmsRenderContext & context )

Definition at line 321 of file qgswmsgetlegendgraphics.cpp.

◆ layerTreeWithGroups()

QgsLayerTree * QgsWms::layerTreeWithGroups	(	const QgsWmsRenderContext &	context,
		QgsLayerTree *	projectRoot
	)

Definition at line 359 of file qgswmsgetlegendgraphics.cpp.

◆ legendModel()

QgsLayerTreeModel * QgsWms::legendModel	(	const QgsWmsRenderContext &	context,
		QgsLayerTree &	tree
	)

Definition at line 243 of file qgswmsgetlegendgraphics.cpp.

◆ legendNode()

QgsLayerTreeModelLegendNode * QgsWms::legendNode	(	const QString &	rule,
		QgsLayerTreeModel &	model
	)

Definition at line 393 of file qgswmsgetlegendgraphics.cpp.

◆ medianCut()

void QgsWms::medianCut	(	QVector< QRgb > &	colorTable,
		int	nColors,
		const QImage &	inputImage
	)

Median cut implementation used when reducing RGB colors to palletized colors.

Definition at line 254 of file qgsmediancut.cpp.

◆ parseImageFormat()

ImageOutputFormat QgsWms::parseImageFormat ( const QString & format )

Parse image format parameter.

Returns: OutputFormat

Definition at line 73 of file qgswmsutils.cpp.

◆ serviceUrl()

QUrl QgsWms::serviceUrl	(	const QgsServerRequest &	request,
		const QgsProject *	project,
		const QgsServerSettings &	settings
	)

Returns WMS service URL.

Definition at line 38 of file qgswmsutils.cpp.

◆ writeAsDxf()

void QgsWms::writeAsDxf	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetMap response in DXF format.

Definition at line 25 of file qgsdxfwriter.cpp.

◆ writeAsPdf()

void QgsWms::writeAsPdf	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetMap response in PDF format.

Since: QGIS 3.36

Definition at line 27 of file qgspdfwriter.cpp.

◆ writeDescribeLayer()

void QgsWms::writeDescribeLayer	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetMap response in DXF format.

Definition at line 32 of file qgswmsdescribelayer.cpp.

◆ writeGetCapabilities()

void QgsWms::writeGetCapabilities	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response,
		bool	projectSettings
	)

Output GetCapabilities response.

Definition at line 66 of file qgswmsgetcapabilities.cpp.

◆ writeGetContext()

void QgsWms::writeGetContext	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetContext response.

Definition at line 48 of file qgswmsgetcontext.cpp.

◆ writeGetFeatureInfo()

void QgsWms::writeGetFeatureInfo	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetFeatureInfo response.

Definition at line 27 of file qgswmsgetfeatureinfo.cpp.

◆ writeGetLegendGraphics()

void QgsWms::writeGetLegendGraphics	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetLegendGRaphics response.

Definition at line 41 of file qgswmsgetlegendgraphics.cpp.

◆ writeGetMap()

void QgsWms::writeGetMap	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetMap response in DXF format.

Definition at line 31 of file qgswmsgetmap.cpp.

◆ writeGetPrint()

void QgsWms::writeGetPrint	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetPrint response.

Definition at line 29 of file qgswmsgetprint.cpp.

◆ writeGetSchemaExtension()

void QgsWms::writeGetSchemaExtension ( QgsServerResponse & response )

Output GetSchemaExtension response.

Definition at line 32 of file qgswmsgetschemaextension.cpp.

◆ writeGetStyles()

void QgsWms::writeGetStyles	(	QgsServerInterface *	serverIface,
		const QgsProject *	project,
		const QgsWmsRequest &	request,
		QgsServerResponse &	response
	)

Output GetStyles response.

Definition at line 42 of file qgswmsgetstyles.cpp.

◆ writeImage()

void QgsWms::writeImage	(	QgsServerResponse &	response,
		QImage &	img,
		const QString &	formatStr,
		int	imageQuality
	)

Write image response.

Definition at line 106 of file qgswmsutils.cpp.

Classes

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ QgsColorBox

◆ QgsColorBoxMap

Enumeration Type Documentation

◆ ImageOutputFormat

Function Documentation

◆ checkParameters()

◆ combineCrsExtents()

◆ combineWgs84BoundingRect()

◆ describeLayer()

◆ getCapabilities()

◆ getCapabilityElement()

◆ getComposerTemplatesElement()

◆ getContext()

◆ getInspireCapabilitiesElement()

◆ getLayersAndStylesCapabilitiesElement()

◆ getServiceElement()

◆ getStyles()

◆ getWFSLayersElement()

◆ handleLayersFromTreeGroup()

◆ hasQueryableLayers()

◆ implementationVersion()

◆ layerTree()

◆ layerTreeWithGroups()

◆ legendModel()

◆ legendNode()

◆ medianCut()

◆ parseImageFormat()

◆ serviceUrl()

◆ writeAsDxf()

◆ writeAsPdf()

◆ writeDescribeLayer()

◆ writeGetCapabilities()

◆ writeGetContext()

◆ writeGetFeatureInfo()

◆ writeGetLegendGraphics()

◆ writeGetMap()

◆ writeGetPrint()

◆ writeGetSchemaExtension()

◆ writeGetStyles()

◆ writeImage()