QGIS API Documentation 3.32.0-Lima (311a8cb8a6)
qgsprocessingprovider.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsprocessingprovider.h
3 ------------------------
4 begin : December 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
18#ifndef QGSPROCESSINGPROVIDER_H
19#define QGSPROCESSINGPROVIDER_H
20
21#include "qgis_core.h"
22#include "qgis.h"
24#include <QIcon>
25
35class CORE_EXPORT QgsProcessingProvider : public QObject
36{
37 Q_OBJECT
38
39 public:
40
45 enum Flag
46 {
47 FlagDeemphasiseSearchResults = 1 << 1,
48 };
49 Q_DECLARE_FLAGS( Flags, Flag )
50
51
54 QgsProcessingProvider( QObject *parent SIP_TRANSFERTHIS = nullptr );
55
56 ~QgsProcessingProvider() override;
57
62
67 virtual QIcon icon() const;
68
73 virtual QString svgIconPath() const;
74
80 virtual Flags flags() const;
81
89 virtual QString id() const = 0;
90
97 virtual QString helpId() const;
98
105 virtual QString name() const = 0;
106
117 virtual QString longName() const;
118
127 virtual QString versionInfo() const;
128
134 virtual bool canBeActivated() const { return true; }
135
146 virtual QString warningMessage() const { return QString(); }
147
151 virtual bool isActive() const { return true; }
152
159 virtual QStringList supportedOutputRasterLayerExtensions() const;
160
170 virtual QStringList supportedOutputVectorLayerExtensions() const;
171
183 virtual QStringList supportedOutputPointCloudLayerExtensions() const;
184
198 virtual QStringList supportedOutputVectorTileLayerExtensions() const;
199
214 virtual QStringList supportedOutputTableExtensions() const;
215
223 virtual bool isSupportedOutputValue( const QVariant &outputValue, const QgsProcessingDestinationParameter *parameter, QgsProcessingContext &context, QString &error SIP_OUT ) const;
224
241 virtual QString defaultVectorFileExtension( bool hasGeometry = true ) const;
242
256 virtual QString defaultRasterFileExtension() const;
257
273 virtual QString defaultPointCloudFileExtension() const;
274
289 virtual QString defaultVectorTileFileExtension() const;
290
304 virtual bool supportsNonFileBasedOutput() const;
305
315 virtual bool load() { refreshAlgorithms(); return true; }
316
321 virtual void unload() {}
322
326 void refreshAlgorithms();
327
332 QList< const QgsProcessingAlgorithm * > algorithms() const;
333
339 const QgsProcessingAlgorithm *algorithm( const QString &name ) const;
340
341 signals:
342
349
350 protected:
351
356 virtual void loadAlgorithms() = 0;
357
361 bool addAlgorithm( QgsProcessingAlgorithm *algorithm SIP_TRANSFER );
362
363 private:
364
365 QMap< QString, const QgsProcessingAlgorithm * > mAlgorithms;
366
367#ifdef SIP_RUN
369#endif
370};
371
372Q_DECLARE_OPERATORS_FOR_FLAGS( QgsProcessingProvider::Flags )
373
374#endif // QGSPROCESSINGPROVIDER_H
375
376
Abstract base class for processing algorithms.
Contains information about the context in which a processing algorithm is executed.
Base class for all parameter definitions which represent file or layer destinations,...
Abstract base class for processing providers.
QgsProcessingProvider(const QgsProcessingProvider &other)=delete
Providers cannot be copied.
virtual QString name() const =0
Returns the provider name, which is used to describe the provider within the GUI.
Flag
Flags indicating how and when an provider operates and should be exposed to users.
virtual bool isActive() const
Returns true if the provider is active and able to run algorithms.
void algorithmsLoaded()
Emitted when the provider has loaded (or refreshed) its list of available algorithms.
virtual void unload()
Unloads the provider.
virtual QString id() const =0
Returns the unique provider id, used for identifying the provider.
virtual bool load()
Loads the provider.
virtual void loadAlgorithms()=0
Loads all algorithms belonging to this provider.
virtual bool canBeActivated() const
Returns true if the provider can be activated, or false if it cannot be activated (e....
virtual QString warningMessage() const
Returns an optional warning message to show users when running algorithms from this provider.
QgsProcessingProvider & operator=(const QgsProcessingProvider &other)=delete
Providers cannot be copied.
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
#define SIP_TRANSFERTHIS
Definition: qgis_sip.h:53
#define SIP_TRANSFER
Definition: qgis_sip.h:36
#define SIP_OUT
Definition: qgis_sip.h:58
Q_DECLARE_OPERATORS_FOR_FLAGS(QgsField::ConfigurationFlags) CORE_EXPORT QDataStream &operator<<(QDataStream &out
Writes the field to stream out. QGIS version compatibility is not guaranteed.