QGIS/python/core/processing/qgsprocessingparameters.sip
Matthias Kuhn a9d7630a69 Rename QgsPointV2 to QgsPoint and QgsPoint to QgsPointXY
Because 3D coordinates should be the default.

References https://github.com/qgis/qgis3.0_api/issues/36
2017-06-02 19:53:37 +02:00

954 lines
27 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/core/processing/qgsprocessingparameters.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/
class QgsProcessingParameterDefinition
{
%Docstring
Base class for the definition of processing parameters.
Parameter definitions encapsulate properties regarding the behavior of parameters,
their acceptable ranges, defaults, etc.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
enum Flag
{
FlagAdvanced,
FlagHidden,
FlagOptional,
};
typedef QFlags<QgsProcessingParameterDefinition::Flag> Flags;
enum LayerType
{
TypeAny
TypeVectorAny
TypeVectorPoint,
TypeVectorLine,
TypeVectorPolygon,
TypeRaster,
TypeFile,
TypeTable,
};
QgsProcessingParameterDefinition( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterDefinition.
%End
virtual ~QgsProcessingParameterDefinition();
virtual QString type() const = 0;
%Docstring
Unique parameter type name.
:rtype: str
%End
QString name() const;
%Docstring
Returns the name of the parameter. This is the internal identifier by which
algorithms access this parameter.
@see setName()
:rtype: str
%End
void setName( const QString &name );
%Docstring
Sets the ``name`` of the parameter. This is the internal identifier by which
algorithms access this parameter.
@see name()
%End
QString description() const;
%Docstring
Returns the description for the parameter. This is the user-visible string
used to identify this parameter.
@see setDescription()
:rtype: str
%End
void setDescription( const QString &description );
%Docstring
Sets the ``description`` for the parameter. This is the user-visible string
used to identify this parameter.
@see description()
%End
QVariant defaultValue() const;
%Docstring
Returns the default value for the parameter.
@see setDefaultValue()
:rtype: QVariant
%End
void setDefaultValue( const QVariant &value );
%Docstring
Sets the default ``value`` for the parameter. Caller takes responsibility
to ensure that ``value`` is a valid input for the parameter subclass.
@see defaultValue()
%End
Flags flags() const;
%Docstring
Returns any flags associated with the parameter.
@see setFlags()
:rtype: Flags
%End
void setFlags( const Flags &flags );
%Docstring
Sets the ``flags`` associated with the parameter.
@see flags()
%End
protected:
};
QFlags<QgsProcessingParameterDefinition::Flag> operator|(QgsProcessingParameterDefinition::Flag f1, QFlags<QgsProcessingParameterDefinition::Flag> f2);
typedef QList< const QgsProcessingParameterDefinition * > QgsProcessingParameterDefinitions;
class QgsProcessingParameters
{
%Docstring
A collection of utilities for working with parameters when running a processing algorithm.
Parameters are stored in a QVariantMap and referenced by a unique string key.
The QVariants in parameters are not usually accessed
directly, and instead the high level API provided through QgsProcessingParameters
parameterAsString(), parameterAsDouble() are used instead.
Parameters are evaluated using a provided QgsProcessingContext, allowing
the evaluation to understand available map layers and expression contexts
(for expression based parameters).
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
static bool isDynamic( const QVariantMap &parameters, const QString &name );
%Docstring
Returns true if the parameter with matching ``name`` is a dynamic parameter, and must
be evaluated once for every input feature processed.
:rtype: bool
%End
static QString parameterAsString( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a static string value.
:rtype: str
%End
static QString parameterAsExpression( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to an expression.
:rtype: str
%End
static double parameterAsDouble( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a static double value.
:rtype: float
%End
static int parameterAsInt( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a static integer value.
:rtype: int
%End
static int parameterAsEnum( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a enum value.
:rtype: int
%End
static QList<int> parameterAsEnums( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to list of enum values.
:rtype: list of int
%End
static bool parameterAsBool( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, const QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a static boolean value.
:rtype: bool
%End
static QgsMapLayer *parameterAsLayer( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a map layer.
Layers will either be taken from ``context``'s active project, or loaded from external
sources and stored temporarily in the ``context``. In either case, callers do not
need to handle deletion of the returned layer.
:rtype: QgsMapLayer
%End
static QgsRasterLayer *parameterAsRasterLayer( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a raster layer.
Layers will either be taken from ``context``'s active project, or loaded from external
sources and stored temporarily in the ``context``. In either case, callers do not
need to handle deletion of the returned layer.
:rtype: QgsRasterLayer
%End
static QgsVectorLayer *parameterAsVectorLayer( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a vector layer.
Layers will either be taken from ``context``'s active project, or loaded from external
sources and stored temporarily in the ``context``. In either case, callers do not
need to handle deletion of the returned layer.
:rtype: QgsVectorLayer
%End
static QgsCoordinateReferenceSystem parameterAsCrs( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a coordinate reference system.
:rtype: QgsCoordinateReferenceSystem
%End
static QgsRectangle parameterAsExtent( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a rectangular extent.
:rtype: QgsRectangle
%End
static QgsPointXY parameterAsPoint( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a point.
:rtype: QgsPointXY
%End
static QString parameterAsFile( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a file/folder name.
:rtype: str
%End
static QVariantList parameterAsMatrix( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a matrix/table of values.
Tables are collapsed to a 1 dimensional list.
:rtype: QVariantList
%End
static QList< QgsMapLayer *> parameterAsLayerList( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a list of map layers.
:rtype: list of QgsMapLayer
%End
static QList<double> parameterAsRange( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a range of values.
:rtype: list of float
%End
static QStringList parameterAsFields( const QgsProcessingParameterDefinition *definition, const QVariantMap &parameters, const QString &name, QgsProcessingContext &context );
%Docstring
Evaluates the parameter with matching ``name`` to a list of fields.
:rtype: list of str
%End
};
class QgsProcessingParameterBoolean : QgsProcessingParameterDefinition
{
%Docstring
A boolean parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterBoolean( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterBoolean.
%End
virtual QString type() const;
};
class QgsProcessingParameterCrs : QgsProcessingParameterDefinition
{
%Docstring
A coordinate reference system parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterCrs( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterCrs.
%End
virtual QString type() const;
};
class QgsProcessingParameterMapLayer : QgsProcessingParameterDefinition
{
%Docstring
A map layer parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterMapLayer( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterMapLayer.
%End
virtual QString type() const;
};
class QgsProcessingParameterExtent : QgsProcessingParameterDefinition
{
%Docstring
A rectangular map extent parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterExtent( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterExtent.
%End
virtual QString type() const;
};
class QgsProcessingParameterPoint : QgsProcessingParameterDefinition
{
%Docstring
A point parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterPoint( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterPoint.
%End
virtual QString type() const;
};
class QgsProcessingParameterFile : QgsProcessingParameterDefinition
{
%Docstring
An input file or folder parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
enum Behavior
{
File,
Folder,
};
QgsProcessingParameterFile( const QString &name, const QString &description = QString(), Behavior behavior = File, const QString &extension = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterFile.
%End
virtual QString type() const;
Behavior behavior() const;
%Docstring
Returns the parameter behavior (e.g. File or Folder).
.. seealso:: setBehavior()
:rtype: Behavior
%End
void setBehavior( Behavior behavior );
%Docstring
Sets the parameter ``behavior`` (e.g. File or Folder).
.. seealso:: behavior()
%End
QString extension() const;
%Docstring
Returns any specified file extension for the parameter.
.. seealso:: setExtension()
:rtype: str
%End
void setExtension( const QString &extension );
%Docstring
Sets a file ``extension`` for the parameter.
.. seealso:: extension()
%End
};
class QgsProcessingParameterMatrix : QgsProcessingParameterDefinition
{
%Docstring
An table (matrix) parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterMatrix( const QString &name, const QString &description = QString(), int numberRows = 3,
bool hasFixedNumberRows = false, const QStringList &headers = QStringList(),
const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterMatrix.
%End
virtual QString type() const;
QStringList headers() const;
%Docstring
Returns a list of column headers (if set).
.. seealso:: setHeaders()
:rtype: list of str
%End
void setHeaders( const QStringList &headers );
%Docstring
Sets the list of column ``headers``.
.. seealso:: headers()
%End
int numberRows() const;
%Docstring
Returns the fixed number of rows in the table. This parameter only has an
effect if hasFixedNumberRows() is true.
.. seealso:: setNumberRows()
.. seealso:: setFixedNumberRows()
:rtype: int
%End
void setNumberRows( int rows );
%Docstring
Sets the fixed number of ``rows`` in the table. This parameter only has an
effect if hasFixedNumberRows() is true.
.. seealso:: numberRows()
.. seealso:: setFixedNumberRows()
%End
bool hasFixedNumberRows() const;
%Docstring
Returns whether the table has a fixed number of rows.
.. seealso:: numberRows()
.. seealso:: setHasFixedNumberRows()
:rtype: bool
%End
void setHasFixedNumberRows( bool hasFixedNumberRows );
%Docstring
Sets whether the table has a fixed number of rows.
.. seealso:: setNumberRows()
.. seealso:: hasFixedNumberRows()
%End
};
class QgsProcessingParameterMultipleLayers : QgsProcessingParameterDefinition
{
%Docstring
A parameter for processing algorithms which accepts multiple map layers.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterMultipleLayers( const QString &name, const QString &description = QString(), QgsProcessingParameterDefinition::LayerType layerType = QgsProcessingParameterDefinition::TypeVectorAny,
const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterMultipleLayers.
%End
virtual QString type() const;
QgsProcessingParameterDefinition::LayerType layerType() const;
%Docstring
Returns the layer type for layers acceptable by the parameter.
.. seealso:: setLayerType()
:rtype: QgsProcessingParameterDefinition.LayerType
%End
void setLayerType( QgsProcessingParameterDefinition::LayerType type );
%Docstring
Sets the layer ``type`` for layers acceptable by the parameter.
.. seealso:: layerType()
%End
};
class QgsProcessingParameterNumber : QgsProcessingParameterDefinition
{
%Docstring
A numeric parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
enum Type
{
Integer,
Double,
};
explicit QgsProcessingParameterNumber( const QString &name, const QString &description = QString(),
Type type = Integer,
const QVariant &defaultValue = QVariant(),
bool optional = false,
double minValue = -DBL_MAX,
double maxValue = DBL_MAX
);
%Docstring
Constructor for QgsProcessingParameterNumber.
%End
virtual QString type() const;
double minimum() const;
%Docstring
Returns the minimum value acceptable by the parameter.
.. seealso:: setMinimum()
:rtype: float
%End
void setMinimum( double minimum );
%Docstring
Sets the ``minimum`` value acceptable by the parameter.
.. seealso:: minimum()
%End
double maximum() const;
%Docstring
Returns the maximum value acceptable by the parameter.
.. seealso:: setMaximum()
:rtype: float
%End
void setMaximum( double maximum );
%Docstring
Sets the ``maximum`` value acceptable by the parameter.
.. seealso:: maximum()
%End
Type dataType() const;
%Docstring
Returns the acceptable data type for the parameter.
.. seealso:: setDataType()
:rtype: Type
%End
void setDataType( const Type &type );
%Docstring
Sets the acceptable data ``type`` for the parameter.
.. seealso:: dataType()
%End
};
class QgsProcessingParameterRange : QgsProcessingParameterDefinition
{
%Docstring
A numeric range parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterRange( const QString &name, const QString &description = QString(),
QgsProcessingParameterNumber::Type type = QgsProcessingParameterNumber::Integer,
const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterRange.
%End
virtual QString type() const;
QgsProcessingParameterNumber::Type dataType() const;
%Docstring
Returns the acceptable data type for the range.
.. seealso:: setDataType()
:rtype: QgsProcessingParameterNumber.Type
%End
void setDataType( const QgsProcessingParameterNumber::Type &dataType );
%Docstring
Sets the acceptable data ``type`` for the range.
.. seealso:: dataType()
%End
};
class QgsProcessingParameterRasterLayer : QgsProcessingParameterDefinition
{
%Docstring
A raster layer parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterRasterLayer( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterRasterLayer.
%End
virtual QString type() const;
};
class QgsProcessingParameterEnum : QgsProcessingParameterDefinition
{
%Docstring
An enum based parameter for processing algorithms, allowing for selection from predefined values.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterEnum( const QString &name, const QString &description = QString(), const QStringList &options = QStringList(),
bool allowMultiple = false,
const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterEnum.
%End
virtual QString type() const;
QStringList options() const;
%Docstring
Returns the list of acceptable options for the parameter.
.. seealso:: setOptions()
:rtype: list of str
%End
void setOptions( const QStringList &options );
%Docstring
Sets the list of acceptable ``options`` for the parameter.
.. seealso:: options()
%End
bool allowMultiple() const;
%Docstring
Returns true if the parameter allows multiple selected values.
.. seealso:: setAllowMultiple()
:rtype: bool
%End
void setAllowMultiple( bool allowMultiple );
%Docstring
Sets whether the parameter allows multiple selected values.
.. seealso:: allowMultiple()
%End
};
class QgsProcessingParameterString : QgsProcessingParameterDefinition
{
%Docstring
A string parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterString( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool multiLine = false,
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterString.
%End
virtual QString type() const;
bool multiLine() const;
%Docstring
Returns true if the parameter allows multiline strings.
.. seealso:: setMultiLine()
:rtype: bool
%End
void setMultiLine( bool multiLine );
%Docstring
Sets whether the parameter allows multiline strings.
.. seealso:: multiLine()
%End
};
class QgsProcessingParameterExpression : QgsProcessingParameterDefinition
{
%Docstring
An expression parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterExpression( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
const QString &parentLayerParameterName = QString(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterExpression.
%End
virtual QString type() const;
QString parentLayerParameter() const;
%Docstring
Returns the name of the parent layer parameter, or an empty string if this is not set.
.. seealso:: setParentLayerParameter()
:rtype: str
%End
void setParentLayerParameter( const QString &parentLayerParameter );
%Docstring
Sets the name of the parent layer parameter. Use an empty string if this is not required.
.. seealso:: parentLayerParameter()
%End
};
class QgsProcessingParameterTable : QgsProcessingParameterDefinition
{
%Docstring
A table (i.e. vector layers with or without geometry) parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterTable( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterTable.
%End
virtual QString type() const;
};
class QgsProcessingParameterTableField : QgsProcessingParameterDefinition
{
%Docstring
A table field parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
enum DataType
{
Any
Numeric,
String,
DateTime
};
QgsProcessingParameterTableField( const QString &name, const QString &description = QString(), const QVariant &defaultValue = QVariant(),
const QString &parentLayerParameterName = QString(),
DataType type = Any,
bool allowMultiple = false,
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterTableField.
%End
virtual QString type() const;
QString parentLayerParameter() const;
%Docstring
Returns the name of the parent layer parameter, or an empty string if this is not set.
.. seealso:: setParentLayerParameter()
:rtype: str
%End
void setParentLayerParameter( const QString &parentLayerParameter );
%Docstring
Sets the name of the parent layer parameter. Use an empty string if this is not required.
.. seealso:: parentLayerParameter()
%End
DataType dataType() const;
%Docstring
Returns the acceptable data type for the field.
.. seealso:: setDataType()
:rtype: DataType
%End
void setDataType( const DataType &type );
%Docstring
Sets the acceptable data ``type`` for the field.
.. seealso:: dataType()
%End
bool allowMultiple() const;
%Docstring
Returns whether multiple field selections are permitted.
.. seealso:: setAllowMultiple()
:rtype: bool
%End
void setAllowMultiple( bool allowMultiple );
%Docstring
Sets whether multiple field selections are permitted.
.. seealso:: allowMultiple()
%End
};
class QgsProcessingParameterVector : QgsProcessingParameterDefinition
{
%Docstring
A vector layer parameter for processing algorithms.
.. versionadded:: 3.0
%End
%TypeHeaderCode
#include "qgsprocessingparameters.h"
%End
public:
QgsProcessingParameterVector( const QString &name, const QString &description = QString(), QgsProcessingParameterDefinition::LayerType type = QgsProcessingParameterDefinition::TypeVectorAny, const QVariant &defaultValue = QVariant(),
bool optional = false );
%Docstring
Constructor for QgsProcessingParameterVector.
%End
virtual QString type() const;
QgsProcessingParameterDefinition::LayerType dataType() const;
%Docstring
Returns the layer type for layers acceptable by the parameter.
.. seealso:: setDataType()
:rtype: QgsProcessingParameterDefinition.LayerType
%End
void setDataType( QgsProcessingParameterDefinition::LayerType type );
%Docstring
Sets the layer ``type`` for layers acceptable by the parameter.
.. seealso:: dataType()
%End
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/core/processing/qgsprocessingparameters.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/