QGIS API Documentation 4.1.0-Master (5bf3c20f3c9)
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
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"
39
40#include <QString>
41
42#include "moc_qgsprocessingguiregistry.cpp"
43
44using namespace Qt::StringLiterals;
45
47{
48 addAlgorithmConfigurationWidgetFactory( new QgsFilterAlgorithmConfigurationWidgetFactory() );
49 addAlgorithmConfigurationWidgetFactory( new QgsConditionalBranchAlgorithmConfigurationWidgetFactory() );
50
51 addParameterWidgetFactory( new QgsProcessingAlignRasterLayersWidgetWrapper() );
52 addParameterWidgetFactory( new QgsProcessingBooleanWidgetWrapper() );
53 addParameterWidgetFactory( new QgsProcessingCrsWidgetWrapper() );
54 addParameterWidgetFactory( new QgsProcessingStringWidgetWrapper() );
55 addParameterWidgetFactory( new QgsProcessingNumericWidgetWrapper() );
56 addParameterWidgetFactory( new QgsProcessingDistanceWidgetWrapper() );
57 addParameterWidgetFactory( new QgsProcessingAreaWidgetWrapper() );
58 addParameterWidgetFactory( new QgsProcessingVolumeWidgetWrapper() );
59 addParameterWidgetFactory( new QgsProcessingDurationWidgetWrapper() );
60 addParameterWidgetFactory( new QgsProcessingScaleWidgetWrapper() );
61 addParameterWidgetFactory( new QgsProcessingRangeWidgetWrapper() );
62 addParameterWidgetFactory( new QgsProcessingAuthConfigWidgetWrapper() );
63 addParameterWidgetFactory( new QgsProcessingMatrixWidgetWrapper() );
64 addParameterWidgetFactory( new QgsProcessingFileWidgetWrapper() );
65 addParameterWidgetFactory( new QgsProcessingExpressionWidgetWrapper() );
66 addParameterWidgetFactory( new QgsProcessingEnumWidgetWrapper() );
67 addParameterWidgetFactory( new QgsProcessingLayoutWidgetWrapper() );
68 addParameterWidgetFactory( new QgsProcessingLayoutItemWidgetWrapper() );
69 addParameterWidgetFactory( new QgsProcessingPointWidgetWrapper() );
70 addParameterWidgetFactory( new QgsProcessingGeometryWidgetWrapper() );
71 addParameterWidgetFactory( new QgsProcessingColorWidgetWrapper() );
72 addParameterWidgetFactory( new QgsProcessingCoordinateOperationWidgetWrapper() );
73 addParameterWidgetFactory( new QgsProcessingFieldWidgetWrapper() );
74 addParameterWidgetFactory( new QgsProcessingMapThemeWidgetWrapper() );
75 addParameterWidgetFactory( new QgsProcessingDateTimeWidgetWrapper() );
76 addParameterWidgetFactory( new QgsProcessingProviderConnectionWidgetWrapper() );
77 addParameterWidgetFactory( new QgsProcessingDatabaseSchemaWidgetWrapper() );
78 addParameterWidgetFactory( new QgsProcessingDatabaseTableWidgetWrapper() );
79 addParameterWidgetFactory( new QgsProcessingExtentWidgetWrapper() );
80 addParameterWidgetFactory( new QgsProcessingMapLayerWidgetWrapper() );
81 addParameterWidgetFactory( new QgsProcessingVectorLayerWidgetWrapper() );
82 addParameterWidgetFactory( new QgsProcessingFeatureSourceWidgetWrapper() );
83 addParameterWidgetFactory( new QgsProcessingRasterLayerWidgetWrapper() );
84 addParameterWidgetFactory( new QgsProcessingMeshLayerWidgetWrapper() );
85 addParameterWidgetFactory( new QgsProcessingBandWidgetWrapper() );
86 addParameterWidgetFactory( new QgsProcessingMultipleLayerWidgetWrapper() );
87 addParameterWidgetFactory( new QgsProcessingVectorTileWriterLayersWidgetWrapper() );
88 addParameterWidgetFactory( new QgsProcessingFeatureSinkWidgetWrapper() );
89 addParameterWidgetFactory( new QgsProcessingVectorDestinationWidgetWrapper() );
90 addParameterWidgetFactory( new QgsProcessingRasterDestinationWidgetWrapper() );
91 addParameterWidgetFactory( new QgsProcessingFileDestinationWidgetWrapper() );
92 addParameterWidgetFactory( new QgsProcessingFolderDestinationWidgetWrapper() );
93 addParameterWidgetFactory( new QgsProcessingFieldMapWidgetWrapper() );
94 addParameterWidgetFactory( new QgsProcessingAggregateWidgetWrapper() );
95 addParameterWidgetFactory( new QgsProcessingTinInputLayersWidgetWrapper() );
96 addParameterWidgetFactory( new QgsProcessingDxfLayersWidgetWrapper() );
97 addParameterWidgetFactory( new QgsProcessingMeshDatasetGroupsWidgetWrapper() );
98 addParameterWidgetFactory( new QgsProcessingMeshDatasetTimeWidgetWrapper() );
99 addParameterWidgetFactory( new QgsProcessingPointCloudLayerWidgetWrapper() );
100 addParameterWidgetFactory( new QgsProcessingAnnotationLayerWidgetWrapper() );
101 addParameterWidgetFactory( new QgsProcessingPointCloudDestinationWidgetWrapper() );
102 addParameterWidgetFactory( new QgsProcessingPointCloudAttributeWidgetWrapper() );
103 addParameterWidgetFactory( new QgsProcessingVectorTileDestinationWidgetWrapper() );
104 addParameterWidgetFactory( new QgsProcessingRasterOptionsWidgetWrapper() );
105
106
107 mModelConfigWidgetFactory = std::make_unique< QgsProcessingGuiInternalModelConfigWidgetFactory >();
108 registerModelConfigWidgetFactory( mModelConfigWidgetFactory.get() );
109}
110
112{
113 const QList<QgsProcessingAlgorithmConfigurationWidgetFactory *> factories = mAlgorithmConfigurationWidgetFactories;
114 for ( QgsProcessingAlgorithmConfigurationWidgetFactory *factory : factories )
116 const QMap<QString, QgsProcessingParameterWidgetFactoryInterface *> paramFactories = mParameterWidgetFactories;
117 for ( auto it = paramFactories.constBegin(); it != paramFactories.constEnd(); ++it )
118 removeParameterWidgetFactory( it.value() );
119
120 unregisterModelConfigWidgetFactory( mModelConfigWidgetFactory.get() );
121 mModelConfigWidgetFactory.reset();
122}
123
125{
126 mAlgorithmConfigurationWidgetFactories.append( factory );
127}
128
130{
131 mAlgorithmConfigurationWidgetFactories.removeAll( factory );
132 delete factory;
133}
134
136{
137 for ( const auto *factory : mAlgorithmConfigurationWidgetFactories )
138 {
139 if ( factory->canCreateFor( algorithm ) )
140 {
141 std::unique_ptr<QgsProcessingAlgorithmConfigurationWidget> widget( factory->create( algorithm ) );
142 if ( widget )
143 widget->setAlgorithm( algorithm );
144 return widget.release();
145 }
146 }
147
148 return nullptr;
149}
150
152{
153 if ( !factory )
154 return false;
155
156 if ( mParameterWidgetFactories.contains( factory->parameterType() ) )
157 {
158 QgsLogger::warning( u"Duplicate parameter factory for %1 registered"_s.arg( factory->parameterType() ) );
159 return false;
160 }
161
162 mParameterWidgetFactories.insert( factory->parameterType(), factory );
163 return true;
164}
165
167{
168 if ( !factory )
169 return;
170
171 mParameterWidgetFactories.remove( factory->parameterType() );
172 delete factory;
173}
174
176{
177 mModelConfigWidgetFactories << factory;
178}
179
181{
182 mModelConfigWidgetFactories.removeAll( factory );
183}
184
186{
187 if ( !parameter )
188 return nullptr;
189
190 const QVariantMap metadata = parameter->metadata();
191 const QString widgetType = metadata.value( u"widget_wrapper"_s ).toMap().value( u"widget_type"_s ).toString();
192 const QString parameterType = !widgetType.isEmpty() ? widgetType : parameter->type();
193 if ( !mParameterWidgetFactories.contains( parameterType ) )
194 return nullptr;
195
196 if ( QgsProcessingParameterWidgetFactoryInterface *factory = mParameterWidgetFactories.value( parameterType ) )
197 {
198 return factory->createWidgetWrapper( parameter, type );
199 }
200 return nullptr;
201}
202
204 QgsProcessingModelAlgorithm *model, const QString &childId, const QgsProcessingParameterDefinition *parameter, QgsProcessingContext &context
205)
206{
207 if ( !parameter )
208 return nullptr;
209
210 const QString parameterType = parameter->type();
211 auto it = mParameterWidgetFactories.constFind( parameterType );
212 if ( it == mParameterWidgetFactories.constEnd() )
213 return nullptr;
214
215 return it.value()->createModelerWidgetWrapper( model, childId, parameter, context );
216}
217
219 const QString &type, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext, const QgsProcessingParameterDefinition *definition, const QgsProcessingAlgorithm *algorithm
220)
221{
222 auto it = mParameterWidgetFactories.constFind( type );
223 if ( it == mParameterWidgetFactories.constEnd() )
224 return nullptr;
225
226 return it.value()->createParameterDefinitionWidget( context, widgetContext, definition, algorithm );
227}
228
230 QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext
231) const
232{
233 for ( auto it = mModelConfigWidgetFactories.constBegin(); it != mModelConfigWidgetFactories.constEnd(); ++it )
234 {
235 // factory may have been deleted without deregistering, don't crash!
236 if ( !it->data() )
237 continue;
238
239 if ( it->data()->supportsComponent( component ) )
240 {
241 if ( QgsProcessingModelConfigWidget *widget = it->data()->createWidget( component, context, widgetContext ) )
242 return widget;
243 }
244 }
245 return nullptr;
246}
247
249bool QgsProcessingGuiInternalModelConfigWidgetFactory::supportsComponent( QgsProcessingModelComponent *component ) const
250{
251 if ( dynamic_cast< QgsProcessingModelGroupBox * >( component ) )
252 return true;
253
254 return false;
255}
256
257QgsProcessingModelConfigWidget *QgsProcessingGuiInternalModelConfigWidgetFactory::createWidget(
258 QgsProcessingModelComponent *component, QgsProcessingContext &context, const QgsProcessingParameterWidgetContext &widgetContext
259) const
260{
261 ( void ) context;
262
263 if ( QgsProcessingModelGroupBox *groupBox = dynamic_cast< QgsProcessingModelGroupBox * >( component ) )
264 {
265 QgsModelDesignerDialog *dialog = widgetContext.modelDesignerDialog();
266 const QString boxUuid = groupBox->uuid();
267
268 auto widget = new QgsModelGroupBoxDefinitionPanelWidget( *groupBox );
269 connect( widget, &QgsModelGroupBoxDefinitionPanelWidget::widgetChanged, this, [dialog, boxUuid, widget] {
270 QgsModelGraphicsScene *modelScene = dialog->modelScene();
271 QgsModelGroupBoxGraphicItem *graphicItem = dynamic_cast< QgsModelGroupBoxGraphicItem * >( modelScene->groupBoxItem( boxUuid ) );
272 if ( !graphicItem )
273 return; // should not happen
274
275 graphicItem->applyEdit( widget->groupBox() );
276 } );
277
278 return widget;
279 }
280
281 return nullptr;
282}
ProcessingMode
Types of modes which Processing widgets can be created for.
Definition qgis.h:3786
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