QGIS/python/core/auto_generated/qgsprovidermetadata.sip.in
Peter Petrik b93dfdd0b3
[feature] Support datasets with data defined on faces in mesh calculator (#33248)
* [feature] support datasets with data defined on faces in mesh calculator, fix #30219, fix #30170

added "driver" and "group name" to the calculator interface.
MDAL now supports 3 drivers for storing results, so user must be able to choose appropriate driver and dataset group name (some drivers store multiple groups to 1 file)
2019-12-06 18:27:28 +01:00

384 lines
11 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/core/qgsprovidermetadata.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/
class QgsMeshDriverMetadata
{
%Docstring
Holds metadata about mesh driver
.. versionadded:: 3.12
%End
%TypeHeaderCode
#include "qgsprovidermetadata.h"
%End
public:
static const QMetaObject staticMetaObject;
public:
enum MeshDriverCapability
{
CanWriteFaceDatasets,
CanWriteVertexDatasets,
};
typedef QFlags<QgsMeshDriverMetadata::MeshDriverCapability> MeshDriverCapabilities;
QgsMeshDriverMetadata();
%Docstring
Constructs default metadata without any capabilities
%End
QgsMeshDriverMetadata( const QString &name,
const QString &description,
const MeshDriverCapabilities &capabilities );
%Docstring
Constructs driver metadata with selected capabilities
:param name: name/key of the driver
:param description: short description of the driver
:param capabilities: driver's capabilities
%End
MeshDriverCapabilities capabilities() const;
%Docstring
Returns the capabilities for this driver.
%End
QString name() const;
%Docstring
Returns the name (key) for this driver.
%End
QString description() const;
%Docstring
Returns the description for this driver.
%End
};
QFlags<QgsMeshDriverMetadata::MeshDriverCapability> operator|(QgsMeshDriverMetadata::MeshDriverCapability f1, QFlags<QgsMeshDriverMetadata::MeshDriverCapability> f2);
class QgsProviderMetadata
{
%Docstring
Holds data provider key, description, and associated shared library file or function pointer information.
Provider metadata refers either to providers which are loaded via libraries or
which are native providers that are included in the core QGIS installation
and accessed through function pointers.
For library based providers, the metadata class is used in a lazy load
implementation in :py:class:`QgsProviderRegistry`. To save memory, data providers
are only actually loaded via QLibrary calls if they're to be used. (Though they're all
iteratively loaded once to get their metadata information, and then
unloaded when the QgsProviderRegistry is created.) :py:class:`QgsProviderMetadata`
supplies enough information to be able to later load the associated shared
library object.
%End
%TypeHeaderCode
#include "qgsprovidermetadata.h"
%End
public:
QgsProviderMetadata( const QString &key, const QString &description, const QString &library = QString() );
%Docstring
Constructor for provider metadata
:param key: provider key
:param description: provider description
:param library: plugin library file name (empty if the provider is not loaded from a library)
%End
virtual ~QgsProviderMetadata();
QString key() const;
%Docstring
This returns the unique key associated with the provider
This key string is used for the associative container in :py:class:`QgsProviderRegistry`
%End
QString description() const;
%Docstring
This returns descriptive text for the provider
This is used to provide a descriptive list of available data providers.
%End
QString library() const /Deprecated/;
%Docstring
This returns the library file name
This is used to QLibrary calls to load the data provider (only for dynamically loaded libraries)
.. deprecated::
QGIS 3.10 - providers may not need to be loaded from a library (empty string returned)
%End
virtual void initProvider();
%Docstring
Initialize the provider
.. versionadded:: 3.10
%End
virtual void cleanupProvider();
%Docstring
Cleanup the provider
.. versionadded:: 3.10
%End
enum class FilterType
{
FilterVector,
FilterRaster,
FilterMesh,
FilterMeshDataset
};
virtual QString filters( FilterType type );
%Docstring
Builds the list of file filter strings (supported formats)
Suitable for use in a QFileDialog.getOpenFileNames() call.
.. versionadded:: 3.10
%End
virtual QList<QgsMeshDriverMetadata> meshDriversMetadata();
%Docstring
Builds the list of available mesh drivers metadata
.. versionadded:: 3.12
%End
virtual QgsDataProvider *createProvider( const QString &uri, const QgsDataProvider::ProviderOptions &options ) /Factory/;
%Docstring
Class factory to return a pointer to a newly created QgsDataProvider object
.. versionadded:: 3.10
%End
virtual QgsRasterDataProvider *createRasterDataProvider(
const QString &uri,
const QString &format,
int nBands,
Qgis::DataType type,
int width,
int height,
double *geoTransform,
const QgsCoordinateReferenceSystem &crs,
const QStringList &createOptions = QStringList() ) /Factory/;
%Docstring
Creates a new instance of the raster data provider.
.. versionadded:: 3.10
%End
virtual QList<QPair<QString, QString> > pyramidResamplingMethods();
%Docstring
Returns pyramid resampling methods available for provider
.. versionadded:: 3.10
%End
virtual QVariantMap decodeUri( const QString &uri );
%Docstring
Breaks a provider data source URI into its component paths (e.g. file path, layer name).
:param uri: uri string
:return: map containing components. Standard components include "path", "layerName", "url".
.. note::
this function may not be supported by all providers, an empty map will be returned in such case
.. versionadded:: 3.10
%End
virtual QList< QgsDataItemProvider * > dataItemProviders() const /Factory/;
%Docstring
Returns data item providers. Caller is responsible for ownership of the item providers
.. seealso:: :py:func:`QgsProviderGuiMetadata.dataItemGuiProviders`
.. note::
Ownership of created data item providers is passed to the caller.
.. versionadded:: 3.10
%End
virtual int listStyles( const QString &uri, QStringList &ids, QStringList &names,
QStringList &descriptions, QString &errCause );
%Docstring
Lists stored layer styles in the provider defined by ``uri``
:return: -1 if not implemented by provider, otherwise number of styles stored
.. versionadded:: 3.10
%End
virtual QString getStyleById( const QString &uri, QString styleId, QString &errCause );
%Docstring
Gets a layer style defined by ``uri``
.. versionadded:: 3.10
%End
virtual bool deleteStyleById( const QString &uri, QString styleId, QString &errCause );
%Docstring
Deletes a layer style defined by ``styleId``
.. versionadded:: 3.10
%End
virtual bool saveStyle( const QString &uri, const QString &qmlStyle, const QString &sldStyle,
const QString &styleName, const QString &styleDescription,
const QString &uiFileContent, bool useAsDefault, QString &errCause );
%Docstring
Saves a layer style to provider
.. versionadded:: 3.10
%End
virtual QString loadStyle( const QString &uri, QString &errCause );
%Docstring
Loads a layer style defined by ``uri``
.. versionadded:: 3.10
%End
virtual bool createDb( const QString &dbPath, QString &errCause );
%Docstring
Creates database by the provider on the path
.. versionadded:: 3.10
%End
virtual QgsTransaction *createTransaction( const QString &connString ) /Factory/;
%Docstring
Returns new instance of transaction. Ownership is transferred to the caller
.. versionadded:: 3.10
%End
virtual QMap<QString, QgsAbstractProviderConnection *> connections( bool cached = true ) throw( QgsProviderConnectionException );
%Docstring
Returns a dictionary of stored provider connections,
the dictionary key is the connection identifier.
Ownership is not transferred.
Raises a QgsProviderConnectionException if any errors are encountered.
:param cached: if ``False`` connections will be re-read from the settings
:raises :: py:class:`QgsProviderConnectionException`
.. versionadded:: 3.10
%End
QMap<QString, QgsAbstractDatabaseProviderConnection *> dbConnections( bool cached = true ) throw( QgsProviderConnectionException );
%Docstring
Returns a dictionary of database provider connections,
the dictionary key is the connection identifier.
Ownership is not transferred.
Raises a QgsProviderConnectionException if any errors are encountered.
:param cached: if ``False`` connections will be re-read from the settings
:raises :: py:class:`QgsProviderConnectionException`
.. versionadded:: 3.10
%End
QgsAbstractProviderConnection *findConnection( const QString &name, bool cached = true ) throw( QgsProviderConnectionException );
%Docstring
Searches and returns a (possibly NULL) connection from the stored provider connections.
Ownership is not transferred.
Raises a QgsProviderConnectionException if any errors are encountered.
:param name: the connection name
:param cached: if ``False`` connections will be re-read from the settings
:raises :: py:class:`QgsProviderConnectionException`
.. versionadded:: 3.10
%End
virtual QgsAbstractProviderConnection *createConnection( const QString &uri, const QVariantMap &configuration ) /Factory/;
%Docstring
Creates a new connection from ``uri`` and ``configuration``,
the newly created connection is not automatically stored in the settings, call
saveConnection() to save it.
Ownership is transferred to the caller.
.. seealso:: :py:func:`saveConnection`
.. versionadded:: 3.10
%End
virtual QgsAbstractProviderConnection *createConnection( const QString &name );
%Docstring
Creates a new connection by loading the connection with the given ``name`` from the settings.
Ownership is transferred to the caller.
.. seealso:: :py:func:`findConnection`
%End
virtual void deleteConnection( const QString &name ) throw( QgsProviderConnectionException );
%Docstring
Removes the connection with the given ``name`` from the settings.
Raises a QgsProviderConnectionException if any errors are encountered.
:raises :: py:class:`QgsProviderConnectionException`
.. versionadded:: 3.10
%End
virtual void saveConnection( const QgsAbstractProviderConnection *connection, const QString &name );
%Docstring
Stores the connection in the settings
:param connection: the connection to be stored in the settings
:param name: the name under which the connection will be stored
.. versionadded:: 3.10
%End
protected:
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/core/qgsprovidermetadata.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/