QGIS API Documentation 3.41.0-Master (45a0abf3bec)
Loading...
Searching...
No Matches
qgsmeshlayerlabeling.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsmeshlayerlabeling.h
3 ---------------------
4 begin : November 2023
5 copyright : (C) 2023 by Alexander Bruy
6 email : alexander dot bruy at gmail dot com
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17#ifndef QGSMESHLAYERLABELING_H
18#define QGSMESHLAYERLABELING_H
19
20#include <memory>
21
22#include <QString>
23#include <QStringList>
24#include <QDomNode>
25
26#include "qgis.h"
27
28class QDomDocument;
29class QDomElement;
30
33class QgsMeshLayer;
36
37
45{
46 public:
47
49 virtual ~QgsAbstractMeshLayerLabeling() = default;
50
52 virtual QString type() const = 0;
53
56
61 virtual QgsMeshLayerLabelProvider *provider( QgsMeshLayer *layer ) const SIP_SKIP { Q_UNUSED( layer ) return nullptr; }
62
64 virtual QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) const = 0;
65
67 virtual QStringList subProviders() const { return QStringList( QString() ); }
68
73 virtual QgsPalLayerSettings settings( const QString &providerId = QString() ) const = 0;
74
81 virtual void setSettings( QgsPalLayerSettings *settings SIP_TRANSFER, const QString &providerId = QString() ) = 0;
82
88 virtual bool requiresAdvancedEffects() const = 0;
89
96 virtual void multiplyOpacity( double opacityFactor ) { Q_UNUSED( opacityFactor ); };
97
98
99 // static stuff
100
102 static QgsAbstractMeshLayerLabeling *create( const QDomElement &element, const QgsReadWriteContext &context ) SIP_FACTORY;
103
107 virtual void toSld( QDomNode &parent, const QVariantMap &props ) const
108 {
109 Q_UNUSED( parent )
110 Q_UNUSED( props )
111 QDomDocument doc = parent.ownerDocument();
112 parent.appendChild( doc.createComment( QStringLiteral( "SE Export for %1 not implemented yet" ).arg( type() ) ) );
113 }
114
122 virtual bool accept( QgsStyleEntityVisitorInterface *visitor ) const;
123
127 static QgsPalLayerSettings defaultSettingsForLayer( const QgsMeshLayer *layer );
128
129 private:
130 Q_DISABLE_COPY( QgsAbstractMeshLayerLabeling )
131
132#ifdef SIP_RUN
134#endif
135
136};
137
145{
146 public:
147
152 explicit QgsMeshLayerSimpleLabeling( const QgsPalLayerSettings &settings, bool labelFaces = false );
153
154 QString type() const override;
155 QgsMeshLayerSimpleLabeling *clone() const override SIP_FACTORY;
157 QgsMeshLayerLabelProvider *provider( QgsMeshLayer *layer ) const override SIP_SKIP;
158 QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) const override;
159 QgsPalLayerSettings settings( const QString &providerId = QString() ) const override;
160 bool accept( QgsStyleEntityVisitorInterface *visitor ) const override;
161
168 void setSettings( QgsPalLayerSettings *settings SIP_TRANSFER, const QString &providerId = QString() ) override;
169
170 bool requiresAdvancedEffects() const override;
171 void multiplyOpacity( double opacityFactor ) override;
173 static QgsMeshLayerSimpleLabeling *create( const QDomElement &element, const QgsReadWriteContext &context ); // cppcheck-suppress duplInheritedMember
174
175 private:
176 std::unique_ptr<QgsPalLayerSettings> mSettings;
177 bool mLabelFaces = false;
178};
179
180#endif // QGSMESHLAYERLABELING_H
Abstract base class - its implementations define different approaches to the labeling of a mesh layer...
virtual QgsMeshLayerLabelProvider * provider(QgsMeshLayer *layer) const
Factory for label provider implementation.
virtual QStringList subProviders() const
Gets list of sub-providers within the layer's labeling.
virtual void toSld(QDomNode &parent, const QVariantMap &props) const
Writes the SE 1.1 TextSymbolizer element based on the current layer labeling settings.
virtual QDomElement save(QDomDocument &doc, const QgsReadWriteContext &context) const =0
Returns labeling configuration as XML element.
virtual void multiplyOpacity(double opacityFactor)
Multiply opacity by opacityFactor.
virtual QgsAbstractMeshLayerLabeling * clone() const =0
Returns a new copy of the object.
virtual QString type() const =0
Unique type string of the labeling configuration implementation.
virtual bool requiresAdvancedEffects() const =0
Returns true if drawing labels requires advanced effects like composition modes, which could prevent ...
virtual void setSettings(QgsPalLayerSettings *settings, const QString &providerId=QString())=0
Set pal settings for a specific provider (takes ownership).
virtual QgsPalLayerSettings settings(const QString &providerId=QString()) const =0
Gets associated label settings.
virtual ~QgsAbstractMeshLayerLabeling()=default
The QgsMeshLayerLabelProvider class implements a label provider for mesh layers.
Basic implementation of the labeling interface for mesh layer.
Represents a mesh layer supporting display of data on structured or unstructured meshes.
Contains settings for how a map layer will be labeled.
The class is used as a container of context for various read/write operations on other objects.
An interface for classes which can visit style entity (e.g.
#define SIP_SKIP
Definition qgis_sip.h:126
#define SIP_TRANSFER
Definition qgis_sip.h:36
#define SIP_FACTORY
Definition qgis_sip.h:76