QGIS API Documentation  3.20.0-Odense (decaadbb31)
qgspointclusterrendererwidget.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgspointclusterrendererwidget.cpp
3  ---------------------------------
4  begin : February 2016
5  copyright : (C) 2016 by Nyall Dawson
6  email : nyall dot dawson 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 
20 #include "qgsrendererregistry.h"
21 #include "qgsfield.h"
22 #include "qgsstyle.h"
24 #include "qgssymbollayerutils.h"
25 #include "qgsvectorlayer.h"
26 #include "qgsguiutils.h"
27 #include "qgsapplication.h"
28 #include "qgsmarkersymbol.h"
29 
31 {
32  return new QgsPointClusterRendererWidget( layer, style, renderer );
33 }
34 
36  : QgsRendererWidget( layer, style )
37 
38 {
39  if ( !layer )
40  {
41  return;
42  }
43 
44  //the renderer only applies to point vector layers
46  {
47  //setup blank dialog
48  mRenderer = nullptr;
49  setupBlankUi( layer->name() );
50  return;
51  }
52  setupUi( this );
53  connect( mRendererComboBox, static_cast<void ( QComboBox::* )( int )>( &QComboBox::currentIndexChanged ), this, &QgsPointClusterRendererWidget::mRendererComboBox_currentIndexChanged );
54  connect( mDistanceSpinBox, static_cast < void ( QDoubleSpinBox::* )( double ) > ( &QDoubleSpinBox::valueChanged ), this, &QgsPointClusterRendererWidget::mDistanceSpinBox_valueChanged );
55  connect( mDistanceUnitWidget, &QgsUnitSelectionWidget::changed, this, &QgsPointClusterRendererWidget::mDistanceUnitWidget_changed );
56  connect( mRendererSettingsButton, &QPushButton::clicked, this, &QgsPointClusterRendererWidget::mRendererSettingsButton_clicked );
57  this->layout()->setContentsMargins( 0, 0, 0, 0 );
58 
61 
62  mCenterSymbolToolButton->setSymbolType( Qgis::SymbolType::Marker );
63 
64  if ( renderer )
65  {
67  }
68  if ( !mRenderer )
69  {
70  mRenderer = std::make_unique< QgsPointClusterRenderer >();
71  }
72 
73  blockAllSignals( true );
74 
75  //insert possible renderer types
77  QStringList::const_iterator it = rendererList.constBegin();
78  for ( ; it != rendererList.constEnd(); ++it )
79  {
80  if ( *it != QLatin1String( "pointDisplacement" ) && *it != QLatin1String( "pointCluster" ) && *it != QLatin1String( "heatmapRenderer" ) )
81  {
83  mRendererComboBox->addItem( m->icon(), m->visibleName(), *it );
84  }
85  }
86 
87  mDistanceSpinBox->setValue( mRenderer->tolerance() );
88  mDistanceUnitWidget->setUnit( mRenderer->toleranceUnit() );
89  mDistanceUnitWidget->setMapUnitScale( mRenderer->toleranceMapUnitScale() );
90  mCenterSymbolToolButton->setSymbol( mRenderer->clusterSymbol()->clone() );
91 
92  blockAllSignals( false );
93 
94  //set the appropriate renderer dialog
95  if ( mRenderer->embeddedRenderer() )
96  {
97  QString rendererName = mRenderer->embeddedRenderer()->type();
98  int rendererIndex = mRendererComboBox->findData( rendererName );
99  if ( rendererIndex != -1 )
100  {
101  mRendererComboBox->setCurrentIndex( rendererIndex );
102  mRendererComboBox_currentIndexChanged( rendererIndex );
103  }
104  }
105 
106  connect( mCenterSymbolToolButton, &QgsSymbolButton::changed, this, &QgsPointClusterRendererWidget::centerSymbolChanged );
107  mCenterSymbolToolButton->setDialogTitle( tr( "Cluster symbol" ) );
108  mCenterSymbolToolButton->setLayer( mLayer );
109  mCenterSymbolToolButton->registerExpressionContextGenerator( this );
110 }
111 
113 
115 {
116  return mRenderer.get();
117 }
118 
120 {
122  if ( mDistanceUnitWidget )
123  mDistanceUnitWidget->setMapCanvas( context.mapCanvas() );
124  if ( mCenterSymbolToolButton )
125  {
126  mCenterSymbolToolButton->setMapCanvas( context.mapCanvas() );
127  mCenterSymbolToolButton->setMessageBar( context.messageBar() );
128  }
129 }
130 
131 void QgsPointClusterRendererWidget::mRendererComboBox_currentIndexChanged( int index )
132 {
133  QString rendererId = mRendererComboBox->itemData( index ).toString();
135  if ( m )
136  {
137  // unfortunately renderer conversion is only available through the creation of a widget...
138  std::unique_ptr< QgsFeatureRenderer > oldRenderer( mRenderer->embeddedRenderer()->clone() );
139  QgsRendererWidget *tempRenderWidget = m->createRendererWidget( mLayer, mStyle, oldRenderer.get() );
140  mRenderer->setEmbeddedRenderer( tempRenderWidget->renderer()->clone() );
141  delete tempRenderWidget;
142  }
143  emit widgetChanged();
144 }
145 
146 void QgsPointClusterRendererWidget::mRendererSettingsButton_clicked()
147 {
148  if ( !mRenderer )
149  return;
150 
151  QgsRendererAbstractMetadata *m = QgsApplication::rendererRegistry()->rendererMetadata( mRenderer->embeddedRenderer()->type() );
152  if ( m )
153  {
154  QgsRendererWidget *w = m->createRendererWidget( mLayer, mStyle, mRenderer->embeddedRenderer()->clone() );
155  w->setPanelTitle( tr( "Renderer Settings" ) );
156 
160  QList< QgsExpressionContextScope > scopes = mContext.additionalExpressionContextScopes();
161  scopes << scope;
164  w->setContext( context );
165  w->disableSymbolLevels();
166  connect( w, &QgsPanelWidget::widgetChanged, this, &QgsPointClusterRendererWidget::updateRendererFromWidget );
167  w->setDockMode( this->dockMode() );
168  openPanel( w );
169  }
170 }
171 
172 void QgsPointClusterRendererWidget::mDistanceSpinBox_valueChanged( double d )
173 {
174  if ( mRenderer )
175  {
176  mRenderer->setTolerance( d );
177  }
178  emit widgetChanged();
179 }
180 
181 void QgsPointClusterRendererWidget::mDistanceUnitWidget_changed()
182 {
183  if ( mRenderer )
184  {
185  mRenderer->setToleranceUnit( mDistanceUnitWidget->unit() );
186  mRenderer->setToleranceMapUnitScale( mDistanceUnitWidget->getMapUnitScale() );
187  }
188  emit widgetChanged();
189 }
190 
191 void QgsPointClusterRendererWidget::blockAllSignals( bool block )
192 {
193  mRendererComboBox->blockSignals( block );
194  mCenterSymbolToolButton->blockSignals( block );
195  mDistanceSpinBox->blockSignals( block );
196  mDistanceUnitWidget->blockSignals( block );
197 }
198 
200 {
202  if ( auto *lExpressionContext = mContext.expressionContext() )
203  context = *lExpressionContext;
204  else
209  QList< QgsExpressionContextScope > scopes = mContext.additionalExpressionContextScopes();
210  scopes << scope;
211  const auto constScopes = scopes;
212  for ( const QgsExpressionContextScope &s : constScopes )
213  {
215  }
216  return context;
217 }
218 
219 void QgsPointClusterRendererWidget::centerSymbolChanged()
220 {
221  mRenderer->setClusterSymbol( mCenterSymbolToolButton->clonedSymbol< QgsMarkerSymbol >() );
222  emit widgetChanged();
223 }
224 
225 void QgsPointClusterRendererWidget::updateRendererFromWidget()
226 {
227  QgsRendererWidget *w = qobject_cast<QgsRendererWidget *>( sender() );
228  if ( !w )
229  return;
230 
231  mRenderer->setEmbeddedRenderer( w->renderer()->clone() );
232  emit widgetChanged();
233 }
234 
235 void QgsPointClusterRendererWidget::setupBlankUi( const QString &layerName )
236 {
237  QGridLayout *layout = new QGridLayout( this );
238  QLabel *label = new QLabel( tr( "The point cluster renderer only applies to (single) point layers. \n'%1' is not a (single) point layer and cannot be displayed by the point cluster renderer." ).arg( layerName ), this );
239  layout->addWidget( label );
240 }
@ Marker
Marker symbol.
static QgsRendererRegistry * rendererRegistry()
Returns the application's renderer registry, used for managing vector layer renderers.
Single scope for storing variables and functions for use within a QgsExpressionContext.
void addVariable(const QgsExpressionContextScope::StaticVariable &variable)
Adds a variable into the context scope.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
static const QString EXPR_CLUSTER_SIZE
Inbuilt variable name for cluster size variable.
static const QString EXPR_CLUSTER_COLOR
Inbuilt variable name for cluster color variable.
virtual QgsFeatureRenderer * clone() const =0
Create a deep copy of this renderer.
QString name
Definition: qgsmaplayer.h:73
A marker symbol type, for rendering Point and MultiPoint geometries.
void openPanel(QgsPanelWidget *panel)
Open a panel or dialog depending on dock mode setting If dock mode is true this method will emit the ...
void widgetChanged()
Emitted when the widget state changes.
void setPanelTitle(const QString &panelTitle)
Set the title of the panel when shown in the interface.
bool dockMode()
Returns the dock mode state.
QgsPointClusterRendererWidget(QgsVectorLayer *layer, QgsStyle *style, QgsFeatureRenderer *renderer)
Constructor for QgsPointClusterRendererWidget.
~QgsPointClusterRendererWidget() override
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
void setContext(const QgsSymbolWidgetContext &context) override
Sets the context in which the renderer widget is shown, e.g., the associated map canvas and expressio...
QgsFeatureRenderer * renderer() override
Returns pointer to the renderer (no transfer of ownership)
static QgsRendererWidget * create(QgsVectorLayer *layer, QgsStyle *style, QgsFeatureRenderer *renderer)
Returns a new QgsPointClusterRendererWidget.
static QgsPointClusterRenderer * convertFromRenderer(const QgsFeatureRenderer *renderer)
Creates a QgsPointClusterRenderer from an existing renderer.
Stores metadata about one renderer class.
@ PointLayer
Compatible with point layers.
QIcon icon() const
Returns an icon representing the renderer.
virtual QgsRendererWidget * createRendererWidget(QgsVectorLayer *layer, QgsStyle *style, QgsFeatureRenderer *oldRenderer)
Returns new instance of settings widget for the renderer.
QString visibleName() const
Returns a friendly display name of the renderer.
QStringList renderersList(QgsRendererAbstractMetadata::LayerTypes layerTypes=QgsRendererAbstractMetadata::All) const
Returns a list of available renderers.
QgsRendererAbstractMetadata * rendererMetadata(const QString &rendererName)
Returns the metadata for a specified renderer.
Base class for renderer settings widgets.
virtual QgsFeatureRenderer * renderer()=0
Returns pointer to the renderer (no transfer of ownership)
void setDockMode(bool dockMode) override
Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs.
QgsSymbolWidgetContext mContext
Context in which widget is shown.
virtual void setContext(const QgsSymbolWidgetContext &context)
Sets the context in which the renderer widget is shown, e.g., the associated map canvas and expressio...
virtual void disableSymbolLevels()
Disables symbol level modification on the widget.
QgsSymbolWidgetContext context() const
Returns the context in which the renderer widget is shown, e.g., the associated map canvas and expres...
QgsVectorLayer * mLayer
void changed()
Emitted when the symbol's settings are changed.
Contains settings which reflect the context in which a symbol (or renderer) widget is shown,...
QList< QgsExpressionContextScope > additionalExpressionContextScopes() const
Returns the list of additional expression context scopes to show as available within the layer.
QList< QgsExpressionContextScope * > globalProjectAtlasMapLayerScopes(const QgsMapLayer *layer) const
Returns list of scopes: global, project, atlas, map, layer.
void setAdditionalExpressionContextScopes(const QList< QgsExpressionContextScope > &scopes)
Sets a list of additional expression context scopes to show as available within the layer.
QgsExpressionContext * expressionContext() const
Returns the expression context used for the widget, if set.
QgsMapCanvas * mapCanvas() const
Returns the map canvas associated with the widget.
QgsMessageBar * messageBar() const
Returns the message bar associated with the widget.
QList< QgsUnitTypes::RenderUnit > RenderUnitList
List of render units.
Definition: qgsunittypes.h:240
@ RenderPoints
Points (e.g., for font sizes)
Definition: qgsunittypes.h:173
@ RenderPixels
Pixels.
Definition: qgsunittypes.h:171
@ RenderInches
Inches.
Definition: qgsunittypes.h:174
@ RenderMillimeters
Millimeters.
Definition: qgsunittypes.h:169
@ RenderMapUnits
Map units.
Definition: qgsunittypes.h:170
Represents a vector layer which manages a vector based data sets.
Q_INVOKABLE QgsWkbTypes::Type wkbType() const FINAL
Returns the WKBType or WKBUnknown in case of error.
static Type flatType(Type type) SIP_HOLDGIL
Returns the flat type for a WKB type.
Definition: qgswkbtypes.h:702
Single variable definition for use within a QgsExpressionContextScope.