QGIS API Documentation 4.3.0-Master (026d9cd75d1)
Loading...
Searching...
No Matches
qgsprocessingguiregistry.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsprocessingguiregistry.cpp
3 ---------------------
4 begin : April 2018
5 copyright : (C) 2018 by Matthias Kuhn
6 email : matthias@opengis.ch
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
19
20#include "qgis.h"
21#include "qgslogger.h"
40
41#include <QString>
42
43#include "moc_qgsprocessingguiregistry.cpp"
44
45using namespace Qt::StringLiterals;
46
48{
49 addAlgorithmConfigurationWidgetFactory( new QgsFilterAlgorithmConfigurationWidgetFactory() );
50 addAlgorithmConfigurationWidgetFactory( new QgsConditionalBranchAlgorithmConfigurationWidgetFactory() );
51
52 addParameterWidgetFactory( new QgsProcessingAlignRasterLayersWidgetWrapper() );
53 addParameterWidgetFactory( new QgsProcessingBooleanWidgetWrapper() );
54 addParameterWidgetFactory( new QgsProcessingCrsWidgetWrapper() );
55 addParameterWidgetFactory( new QgsProcessingStringWidgetWrapper() );
56 addParameterWidgetFactory( new QgsProcessingNumericWidgetWrapper() );
57 addParameterWidgetFactory( new QgsProcessingDistanceWidgetWrapper() );
58 addParameterWidgetFactory( new QgsProcessingAreaWidgetWrapper() );
59 addParameterWidgetFactory( new QgsProcessingVolumeWidgetWrapper() );
60 addParameterWidgetFactory( new QgsProcessingDurationWidgetWrapper() );
61 addParameterWidgetFactory( new QgsProcessingScaleWidgetWrapper() );
62 addParameterWidgetFactory( new QgsProcessingRangeWidgetWrapper() );
63 addParameterWidgetFactory( new QgsProcessingAuthConfigWidgetWrapper() );
64 addParameterWidgetFactory( new QgsProcessingMatrixWidgetWrapper() );
65 addParameterWidgetFactory( new QgsProcessingFileWidgetWrapper() );
66 addParameterWidgetFactory( new QgsProcessingExpressionWidgetWrapper() );
67 addParameterWidgetFactory( new QgsProcessingEnumWidgetWrapper() );
68 addParameterWidgetFactory( new QgsProcessingLayoutWidgetWrapper() );
69 addParameterWidgetFactory( new QgsProcessingLayoutItemWidgetWrapper() );
70 addParameterWidgetFactory( new QgsProcessingPointWidgetWrapper() );
71 addParameterWidgetFactory( new QgsProcessingGeometryWidgetWrapper() );
72 addParameterWidgetFactory( new QgsProcessingColorWidgetWrapper() );
73 addParameterWidgetFactory( new QgsProcessingCoordinateOperationWidgetWrapper() );
74 addParameterWidgetFactory( new QgsProcessingFieldWidgetWrapper() );
75 addParameterWidgetFactory( new QgsProcessingMapThemeWidgetWrapper() );
76 addParameterWidgetFactory( new QgsProcessingDateTimeWidgetWrapper() );
77 addParameterWidgetFactory( new QgsProcessingProviderConnectionWidgetWrapper() );
78 addParameterWidgetFactory( new QgsProcessingDatabaseSchemaWidgetWrapper() );
79 addParameterWidgetFactory( new QgsProcessingDatabaseTableWidgetWrapper() );
80 addParameterWidgetFactory( new QgsProcessingExtentWidgetWrapper() );
81 addParameterWidgetFactory( new QgsProcessingMapLayerWidgetWrapper() );
82 addParameterWidgetFactory( new QgsProcessingVectorLayerWidgetWrapper() );
83 addParameterWidgetFactory( new QgsProcessingFeatureSourceWidgetWrapper() );
84 addParameterWidgetFactory( new QgsProcessingRasterLayerWidgetWrapper() );
85 addParameterWidgetFactory( new QgsProcessingMeshLayerWidgetWrapper() );
86 addParameterWidgetFactory( new QgsProcessingBandWidgetWrapper() );
87 addParameterWidgetFactory( new QgsProcessingMultipleLayerWidgetWrapper() );
88 addParameterWidgetFactory( new QgsProcessingVectorTileWriterLayersWidgetWrapper() );
89 addParameterWidgetFactory( new QgsProcessingFeatureSinkWidgetWrapper() );
90 addParameterWidgetFactory( new QgsProcessingVectorDestinationWidgetWrapper() );
91 addParameterWidgetFactory( new QgsProcessingRasterDestinationWidgetWrapper() );
92 addParameterWidgetFactory( new QgsProcessingFileDestinationWidgetWrapper() );
93 addParameterWidgetFactory( new QgsProcessingFolderDestinationWidgetWrapper() );
94 addParameterWidgetFactory( new QgsProcessingFieldMapWidgetWrapper() );
95 addParameterWidgetFactory( new QgsProcessingAggregateWidgetWrapper() );
96 addParameterWidgetFactory( new QgsProcessingTinInputLayersWidgetWrapper() );
97 addParameterWidgetFactory( new QgsProcessingDxfLayersWidgetWrapper() );
98 addParameterWidgetFactory( new QgsProcessingMeshDatasetGroupsWidgetWrapper() );
99 addParameterWidgetFactory( new QgsProcessingMeshDatasetTimeWidgetWrapper() );
100 addParameterWidgetFactory( new QgsProcessingPointCloudLayerWidgetWrapper() );
101 addParameterWidgetFactory( new QgsProcessingAnnotationLayerWidgetWrapper() );
102 addParameterWidgetFactory( new QgsProcessingPointCloudDestinationWidgetWrapper() );
103 addParameterWidgetFactory( new QgsProcessingPointCloudAttributeWidgetWrapper() );
104 addParameterWidgetFactory( new QgsProcessingVectorTileDestinationWidgetWrapper() );
105 addParameterWidgetFactory( new QgsProcessingRasterOptionsWidgetWrapper() );
106 addParameterWidgetFactory( new QgsProcessingHeatmapPixelSizeWidgetWrapper() );
107 addParameterWidgetFactory( new QgsProcessingReliefColorsWidgetWrapper() );
108 addParameterWidgetFactory( new QgsProcessingExecuteSqlWidgetWrapper() );
109
110 mModelConfigWidgetFactory = std::make_unique< QgsProcessingGuiInternalModelConfigWidgetFactory >();
111 registerModelConfigWidgetFactory( mModelConfigWidgetFactory.get() );
112}
113
115{
116 const QList<QgsProcessingAlgorithmConfigurationWidgetFactory *> factories = mAlgorithmConfigurationWidgetFactories;
117 for ( QgsProcessingAlgorithmConfigurationWidgetFactory *factory : factories )
119 const QMap<QString, QgsProcessingParameterWidgetFactoryInterface *> paramFactories = mParameterWidgetFactories;
120 for ( auto it = paramFactories.constBegin(); it != paramFactories.constEnd(); ++it )
121 removeParameterWidgetFactory( it.value() );
122
123 unregisterModelConfigWidgetFactory( mModelConfigWidgetFactory.get() );
124 mModelConfigWidgetFactory.reset();
125}
126
128{
129 mAlgorithmConfigurationWidgetFactories.append( factory );
130}
131
133{
134 mAlgorithmConfigurationWidgetFactories.removeAll( factory );
135 delete factory;
136}
137
139{
140 for ( const auto *factory : mAlgorithmConfigurationWidgetFactories )
141 {
142 if ( factory->canCreateFor( algorithm ) )
143 {
144 std::unique_ptr<QgsProcessingAlgorithmConfigurationWidget> widget( factory->create( algorithm ) );
145 if ( widget )
146 widget->setAlgorithm( algorithm );
147 return widget.release();
148 }
149 }
150
151 return nullptr;
152}
153
155{
156 if ( !factory )
157 return false;
158
159 if ( mParameterWidgetFactories.contains( factory->parameterType() ) )
160 {
161 QgsLogger::warning( u"Duplicate parameter factory for %1 registered"_s.arg( factory->parameterType() ) );
162 return false;
163 }
164
165 mParameterWidgetFactories.insert( factory->parameterType(), factory );
166 return true;
167}
168
170{
171 if ( !factory )
172 return;
173
174 mParameterWidgetFactories.remove( factory->parameterType() );
175 delete factory;
176}
177
179{
180 mModelConfigWidgetFactories << factory;
181}
182
184{
185 mModelConfigWidgetFactories.removeAll( factory );
186}
187
189{
190 if ( !parameter )
191 return nullptr;
192
193 const QVariantMap metadata = parameter->metadata();
194 const QString widgetType = metadata.value( u"widget_wrapper"_s ).toMap().value( u"widget_type"_s ).toString();
195 const QString parameterType = !widgetType.isEmpty() ? widgetType : parameter->type();
196 if ( !mParameterWidgetFactories.contains( parameterType ) )
197 return nullptr;
198
199 if ( QgsProcessingParameterWidgetFactoryInterface *factory = mParameterWidgetFactories.value( parameterType ) )
200 {
201 return factory->createWidgetWrapper( parameter, type );
202 }
203 return nullptr;
204}
205
207 QgsProcessingModelAlgorithm *model, const QString &childId, const QgsProcessingParameterDefinition *parameter, QgsProcessingContext &context
208)
209{
210 if ( !parameter )
211 return nullptr;
212
213 const QString parameterType = parameter->type();
214 auto it = mParameterWidgetFactories.constFind( parameterType );
215 if ( it == mParameterWidgetFactories.constEnd() )
216 return nullptr;
217
218 return it.value()->createModelerWidgetWrapper( model, childId, parameter, context );
219}
220
222 const QString &type, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext, const QgsProcessingParameterDefinition *definition, const QgsProcessingAlgorithm *algorithm
223)
224{
225 auto it = mParameterWidgetFactories.constFind( type );
226 if ( it == mParameterWidgetFactories.constEnd() )
227 return nullptr;
228
229 return it.value()->createParameterDefinitionWidget( context, widgetContext, definition, algorithm );
230}
231
233 QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext
234) const
235{
236 for ( auto it = mModelConfigWidgetFactories.constBegin(); it != mModelConfigWidgetFactories.constEnd(); ++it )
237 {
238 // factory may have been deleted without deregistering, don't crash!
239 if ( !it->data() )
240 continue;
241
242 if ( it->data()->supportsComponent( component ) )
243 {
244 if ( QgsProcessingModelConfigWidget *widget = it->data()->createWidget( component, context, widgetContext ) )
245 return widget;
246 }
247 }
248 return nullptr;
249}
250
252bool QgsProcessingGuiInternalModelConfigWidgetFactory::supportsComponent( QgsProcessingModelComponent *component ) const
253{
254 if ( dynamic_cast< QgsProcessingModelGroupBox * >( component ) )
255 return true;
256
257 return false;
258}
259
260QgsProcessingModelConfigWidget *QgsProcessingGuiInternalModelConfigWidgetFactory::createWidget(
261 QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext
262) const
263{
264 ( void ) context;
265
266 if ( QgsProcessingModelGroupBox *groupBox = dynamic_cast< QgsProcessingModelGroupBox * >( component ) )
267 {
268 QgsModelDesignerDialog *dialog = widgetContext.modelDesignerDialog();
269 const QString boxUuid = groupBox->uuid();
270
271 auto widget = new QgsModelGroupBoxDefinitionPanelWidget( *groupBox );
272 connect( widget, &QgsModelGroupBoxDefinitionPanelWidget::widgetChanged, this, [dialog, boxUuid, widget] {
273 QgsModelGraphicsScene *modelScene = dialog->modelScene();
274 QgsModelGroupBoxGraphicItem *graphicItem = dynamic_cast< QgsModelGroupBoxGraphicItem * >( modelScene->groupBoxItem( boxUuid ) );
275 if ( !graphicItem )
276 return; // should not happen
277
278 graphicItem->applyEdit( widget->groupBox() );
279 } );
280
281 return widget;
282 }
283
284 return nullptr;
285}
ProcessingMode
Types of modes which Processing widgets can be created for.
Definition qgis.h:3883
A widget wrapper for Processing parameter value widgets.
static void warning(const QString &msg)
Goes to qWarning.
A widget which allows users to specify the properties of a model group box.
void widgetChanged()
Emitted when the widget state changes.
Abstract base class for widgets which allow users to specify the properties of a Processing parameter...
Interface base class for factories for algorithm configuration widgets.
A configuration widget for processing algorithms allows providing additional configuration options di...
Abstract base class for processing algorithms.
Contains information about the context in which a processing algorithm is executed.
void addAlgorithmConfigurationWidgetFactory(QgsProcessingAlgorithmConfigurationWidgetFactory *factory)
Add a new configuration widget factory for customized algorithm configuration widgets.
bool addParameterWidgetFactory(QgsProcessingParameterWidgetFactoryInterface *factory)
Adds a parameter widget factory to the registry, allowing widget creation for parameters of the match...
void removeAlgorithmConfigurationWidgetFactory(QgsProcessingAlgorithmConfigurationWidgetFactory *factory)
Remove a configuration widget factory for customized algorithm configuration widgets.
void registerModelConfigWidgetFactory(QgsProcessingModelConfigWidgetFactory *factory)
Register a new factory class for creating panel widgets that can be shown in the Processing model des...
void unregisterModelConfigWidgetFactory(QgsProcessingModelConfigWidgetFactory *factory)
Unregister a previously registered factory for creating panel widgets that can be shown in the Proces...
QgsProcessingAlgorithmConfigurationWidget * algorithmConfigurationWidget(const QgsProcessingAlgorithm *algorithm) const
Gets the configuration widget for an algorithm.
QgsAbstractProcessingParameterWidgetWrapper * createParameterWidgetWrapper(const QgsProcessingParameterDefinition *parameter, Qgis::ProcessingMode type)
Creates a new parameter widget wrapper for the given parameter.
QgsProcessingAbstractParameterDefinitionWidget * createParameterDefinitionWidget(const QString &type, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext, const QgsProcessingParameterDefinition *definition=nullptr, const QgsProcessingAlgorithm *algorithm=nullptr)
Creates a new parameter definition widget allowing for configuration of an instance of a specific par...
QgsProcessingModelerParameterWidget * createModelerParameterWidget(QgsProcessingModelAlgorithm *model, const QString &childId, const QgsProcessingParameterDefinition *parameter, QgsProcessingContext &context)
Creates a new modeler parameter widget for the given parameter.
void removeParameterWidgetFactory(QgsProcessingParameterWidgetFactoryInterface *factory)
Removes a parameter widget factory from the registry.
QgsProcessingModelConfigWidget * createModelConfigWidgetForComponent(QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext) const
Creates a new widget for configuring a Processing model component.
Factory class for creating panel widgets that can be shown in the Processing model designer dialog.
A panel widget that can be shown in the Processing model designer dialog for configuring part of the ...
A widget for customising the value of Processing algorithm parameters inside a Processing model.
Base class for the definition of processing parameters.
QVariantMap metadata() const
Returns the parameter's freeform metadata.
virtual QString type() const =0
Unique parameter type name.
Contains settings which reflect the context in which a Processing parameter widget is shown.
QgsModelDesignerDialog * modelDesignerDialog() const
Returns the associated model designer dialog, if applicable.
An interface for Processing widget wrapper factories.
virtual QString parameterType() const =0
Returns the type string for the parameter type the factory is associated with.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into allowing algorithms to be written in pure substantial changes are required in order to port existing x Processing algorithms for QGIS x The most significant changes are outlined not GeoAlgorithm For algorithms which operate on features one by consider subclassing the QgsProcessingFeatureBasedAlgorithm class This class allows much of the boilerplate code for looping over features from a vector layer to be bypassed and instead requires implementation of a processFeature method Ensure that your algorithm(or algorithm 's parent class) implements the new pure virtual createInstance(self) call