QGIS API Documentation 3.43.0-Master (a93bf8b6462)
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
101 virtual bool hasNonDefaultCompositionMode() const = 0;
102
109 virtual void multiplyOpacity( double opacityFactor ) { Q_UNUSED( opacityFactor ); };
110
111
112 // static stuff
113
115 static QgsAbstractMeshLayerLabeling *create( const QDomElement &element, const QgsReadWriteContext &context ) SIP_FACTORY;
116
120 virtual void toSld( QDomNode &parent, const QVariantMap &props ) const
121 {
122 Q_UNUSED( parent )
123 Q_UNUSED( props )
124 QDomDocument doc = parent.ownerDocument();
125 parent.appendChild( doc.createComment( QStringLiteral( "SE Export for %1 not implemented yet" ).arg( type() ) ) );
126 }
127
135 virtual bool accept( QgsStyleEntityVisitorInterface *visitor ) const;
136
140 static QgsPalLayerSettings defaultSettingsForLayer( const QgsMeshLayer *layer );
141
142 private:
143 Q_DISABLE_COPY( QgsAbstractMeshLayerLabeling )
144
145#ifdef SIP_RUN
147#endif
148
149};
150
158{
159 public:
160
165 explicit QgsMeshLayerSimpleLabeling( const QgsPalLayerSettings &settings, bool labelFaces = false );
166
167 QString type() const override;
168 QgsMeshLayerSimpleLabeling *clone() const override SIP_FACTORY;
170 QgsMeshLayerLabelProvider *provider( QgsMeshLayer *layer ) const override SIP_SKIP;
171 QDomElement save( QDomDocument &doc, const QgsReadWriteContext &context ) const override;
172 QgsPalLayerSettings settings( const QString &providerId = QString() ) const override;
173 bool accept( QgsStyleEntityVisitorInterface *visitor ) const override;
174
181 void setSettings( QgsPalLayerSettings *settings SIP_TRANSFER, const QString &providerId = QString() ) override;
182
183 bool requiresAdvancedEffects() const override;
184 bool hasNonDefaultCompositionMode() const override;
185 void multiplyOpacity( double opacityFactor ) override;
187 static QgsMeshLayerSimpleLabeling *create( const QDomElement &element, const QgsReadWriteContext &context ); // cppcheck-suppress duplInheritedMember
188
189 private:
190 std::unique_ptr<QgsPalLayerSettings> mSettings;
191 bool mLabelFaces = false;
192};
193
194#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 bool hasNonDefaultCompositionMode() const =0
Returns true the labeling requires a non-default composition mode.
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
Implements a label provider for mesh layers.
Basic implementation of the labeling interface for mesh layers.
Represents a mesh layer supporting display of data on structured or unstructured meshes.
Contains settings for how a map layer will be labeled.
A container for the context for various read/write operations on 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