QGIS API Documentation 4.1.0-Master (5bf3c20f3c9)
Loading...
Searching...
No Matches
qgsalgorithmaffinetransform.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsalgorithmaffinetransform.cpp
3 ---------------------
4 begin : December 2019
5 copyright : (C) 2019 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
19
20#include "qgsvectorlayer.h"
21
22#include <QString>
23
24using namespace Qt::StringLiterals;
25
27
28QString QgsAffineTransformationAlgorithm::name() const
29{
30 return u"affinetransform"_s;
31}
32
33QString QgsAffineTransformationAlgorithm::displayName() const
34{
35 return QObject::tr( "Affine transform" );
36}
37
38QStringList QgsAffineTransformationAlgorithm::tags() const
39{
40 return QObject::tr( "move,shift,transform,affine,scale,rotate,resize,matrix" ).split( ',' );
41}
42
43QString QgsAffineTransformationAlgorithm::group() const
44{
45 return QObject::tr( "Vector geometry" );
46}
47
48QString QgsAffineTransformationAlgorithm::groupId() const
49{
50 return u"vectorgeometry"_s;
51}
52
53QString QgsAffineTransformationAlgorithm::outputName() const
54{
55 return QObject::tr( "Transformed" );
56}
57
58QString QgsAffineTransformationAlgorithm::shortHelpString() const
59{
60 return QObject::tr(
61 "This algorithm applies an affine transformation to the geometries from a layer. Affine transformations can include "
62 "translation, scaling and rotation. The operations are performed in a scale, rotation, translation order."
63 )
64 + u"\n\n"_s
65 + QObject::tr( "Z and M values present in the geometry can also be translated and scaled independently." );
66}
67
68QString QgsAffineTransformationAlgorithm::shortDescription() const
69{
70 return QObject::tr( "Applies an affine transformation to geometries." );
71}
72
73QgsAffineTransformationAlgorithm *QgsAffineTransformationAlgorithm::createInstance() const
74{
75 return new QgsAffineTransformationAlgorithm();
76}
77
78void QgsAffineTransformationAlgorithm::initParameters( const QVariantMap & )
79{
80 auto xOffset = std::make_unique<QgsProcessingParameterDistance>( u"DELTA_X"_s, QObject::tr( "Translation (x-axis)" ), 0.0, u"INPUT"_s );
81 xOffset->setIsDynamic( true );
82 xOffset->setDynamicPropertyDefinition( QgsPropertyDefinition( u"DELTA_X"_s, QObject::tr( "Offset distance (x-axis)" ), QgsPropertyDefinition::Double ) );
83 xOffset->setDynamicLayerParameterName( u"INPUT"_s );
84 addParameter( xOffset.release() );
85
86 auto yOffset = std::make_unique<QgsProcessingParameterDistance>( u"DELTA_Y"_s, QObject::tr( "Translation (y-axis)" ), 0.0, u"INPUT"_s );
87 yOffset->setIsDynamic( true );
88 yOffset->setDynamicPropertyDefinition( QgsPropertyDefinition( u"DELTA_Y"_s, QObject::tr( "Offset distance (y-axis)" ), QgsPropertyDefinition::Double ) );
89 yOffset->setDynamicLayerParameterName( u"INPUT"_s );
90 addParameter( yOffset.release() );
91
92 auto zOffset = std::make_unique<QgsProcessingParameterNumber>( u"DELTA_Z"_s, QObject::tr( "Translation (z-axis)" ), Qgis::ProcessingNumberParameterType::Double, 0.0 );
93 zOffset->setIsDynamic( true );
94 zOffset->setDynamicPropertyDefinition( QgsPropertyDefinition( u"DELTA_Z"_s, QObject::tr( "Offset distance (z-axis)" ), QgsPropertyDefinition::Double ) );
95 zOffset->setDynamicLayerParameterName( u"INPUT"_s );
96 addParameter( zOffset.release() );
97
98 auto mOffset = std::make_unique<QgsProcessingParameterNumber>( u"DELTA_M"_s, QObject::tr( "Translation (m values)" ), Qgis::ProcessingNumberParameterType::Double, 0.0 );
99 mOffset->setIsDynamic( true );
100 mOffset->setDynamicPropertyDefinition( QgsPropertyDefinition( u"DELTA_M"_s, QObject::tr( "Offset distance (m values)" ), QgsPropertyDefinition::Double ) );
101 mOffset->setDynamicLayerParameterName( u"INPUT"_s );
102 addParameter( mOffset.release() );
103
104 auto xScale = std::make_unique<QgsProcessingParameterNumber>( u"SCALE_X"_s, QObject::tr( "Scale factor (x-axis)" ), Qgis::ProcessingNumberParameterType::Double, 1.0 );
105 xScale->setIsDynamic( true );
106 xScale->setDynamicPropertyDefinition( QgsPropertyDefinition( u"SCALE_X"_s, QObject::tr( "Scale factor (x-axis)" ), QgsPropertyDefinition::Double ) );
107 xScale->setDynamicLayerParameterName( u"INPUT"_s );
108 addParameter( xScale.release() );
109
110 auto yScale = std::make_unique<QgsProcessingParameterNumber>( u"SCALE_Y"_s, QObject::tr( "Scale factor (y-axis)" ), Qgis::ProcessingNumberParameterType::Double, 1.0 );
111 yScale->setIsDynamic( true );
112 yScale->setDynamicPropertyDefinition( QgsPropertyDefinition( u"SCALE_Y"_s, QObject::tr( "Scale factor (y-axis)" ), QgsPropertyDefinition::Double ) );
113 yScale->setDynamicLayerParameterName( u"INPUT"_s );
114 addParameter( yScale.release() );
115
116 auto zScale = std::make_unique<QgsProcessingParameterNumber>( u"SCALE_Z"_s, QObject::tr( "Scale factor (z-axis)" ), Qgis::ProcessingNumberParameterType::Double, 1.0 );
117 zScale->setIsDynamic( true );
118 zScale->setDynamicPropertyDefinition( QgsPropertyDefinition( u"SCALE_Z"_s, QObject::tr( "Scale factor (z-axis)" ), QgsPropertyDefinition::Double ) );
119 zScale->setDynamicLayerParameterName( u"INPUT"_s );
120 addParameter( zScale.release() );
121
122 auto mScale = std::make_unique<QgsProcessingParameterNumber>( u"SCALE_M"_s, QObject::tr( "Scale factor (m values)" ), Qgis::ProcessingNumberParameterType::Double, 1.0 );
123 mScale->setIsDynamic( true );
124 mScale->setDynamicPropertyDefinition( QgsPropertyDefinition( u"SCALE_M"_s, QObject::tr( "Scale factor (m values)" ), QgsPropertyDefinition::Double ) );
125 mScale->setDynamicLayerParameterName( u"INPUT"_s );
126 addParameter( mScale.release() );
127
128 auto rotation = std::make_unique<QgsProcessingParameterNumber>( u"ROTATION_Z"_s, QObject::tr( "Rotation around z-axis (degrees counter-clockwise)" ), Qgis::ProcessingNumberParameterType::Double, 0.0 );
129 rotation->setIsDynamic( true );
130 rotation->setDynamicPropertyDefinition( QgsPropertyDefinition( u"ROTATION_Z"_s, QObject::tr( "Rotation around z-axis (degrees counter-clockwise)" ), QgsPropertyDefinition::Double ) );
131 rotation->setDynamicLayerParameterName( u"INPUT"_s );
132 addParameter( rotation.release() );
133}
134
135bool QgsAffineTransformationAlgorithm::prepareAlgorithm( const QVariantMap &parameters, QgsProcessingContext &context, QgsProcessingFeedback * )
136{
137 mDeltaX = parameterAsDouble( parameters, u"DELTA_X"_s, context );
138 mDynamicDeltaX = QgsProcessingParameters::isDynamic( parameters, u"DELTA_X"_s );
139 if ( mDynamicDeltaX )
140 mDeltaXProperty = parameters.value( u"DELTA_X"_s ).value<QgsProperty>();
141
142 mDeltaY = parameterAsDouble( parameters, u"DELTA_Y"_s, context );
143 mDynamicDeltaY = QgsProcessingParameters::isDynamic( parameters, u"DELTA_Y"_s );
144 if ( mDynamicDeltaY )
145 mDeltaYProperty = parameters.value( u"DELTA_Y"_s ).value<QgsProperty>();
146
147 mDeltaZ = parameterAsDouble( parameters, u"DELTA_Z"_s, context );
148 mDynamicDeltaZ = QgsProcessingParameters::isDynamic( parameters, u"DELTA_Z"_s );
149 if ( mDynamicDeltaZ )
150 mDeltaZProperty = parameters.value( u"DELTA_Z"_s ).value<QgsProperty>();
151
152 mDeltaM = parameterAsDouble( parameters, u"DELTA_M"_s, context );
153 mDynamicDeltaM = QgsProcessingParameters::isDynamic( parameters, u"DELTA_M"_s );
154 if ( mDynamicDeltaM )
155 mDeltaMProperty = parameters.value( u"DELTA_M"_s ).value<QgsProperty>();
156
157 mScaleX = parameterAsDouble( parameters, u"SCALE_X"_s, context );
158 mDynamicScaleX = QgsProcessingParameters::isDynamic( parameters, u"SCALE_X"_s );
159 if ( mDynamicScaleX )
160 mScaleXProperty = parameters.value( u"SCALE_X"_s ).value<QgsProperty>();
161
162 mScaleY = parameterAsDouble( parameters, u"SCALE_Y"_s, context );
163 mDynamicScaleY = QgsProcessingParameters::isDynamic( parameters, u"SCALE_Y"_s );
164 if ( mDynamicScaleY )
165 mScaleYProperty = parameters.value( u"SCALE_Y"_s ).value<QgsProperty>();
166
167 mScaleZ = parameterAsDouble( parameters, u"SCALE_Z"_s, context );
168 mDynamicScaleZ = QgsProcessingParameters::isDynamic( parameters, u"SCALE_Z"_s );
169 if ( mDynamicScaleZ )
170 mScaleZProperty = parameters.value( u"SCALE_Z"_s ).value<QgsProperty>();
171
172 mScaleM = parameterAsDouble( parameters, u"SCALE_M"_s, context );
173 mDynamicScaleM = QgsProcessingParameters::isDynamic( parameters, u"SCALE_M"_s );
174 if ( mDynamicScaleM )
175 mScaleMProperty = parameters.value( u"SCALE_M"_s ).value<QgsProperty>();
176
177 mRotationZ = parameterAsDouble( parameters, u"ROTATION_Z"_s, context );
178 mDynamicRotationZ = QgsProcessingParameters::isDynamic( parameters, u"ROTATION_Z"_s );
179 if ( mDynamicRotationZ )
180 mRotationZProperty = parameters.value( u"ROTATION_Z"_s ).value<QgsProperty>();
181
182 return true;
183}
184
185QgsFeatureList QgsAffineTransformationAlgorithm::processFeature( const QgsFeature &feature, QgsProcessingContext &context, QgsProcessingFeedback * )
186{
187 QgsFeature f = feature;
188 if ( f.hasGeometry() )
189 {
190 QgsGeometry geometry = f.geometry();
191
192 double deltaX = mDeltaX;
193 if ( mDynamicDeltaX )
194 deltaX = mDeltaXProperty.valueAsDouble( context.expressionContext(), deltaX );
195 double deltaY = mDeltaY;
196 if ( mDynamicDeltaY )
197 deltaY = mDeltaYProperty.valueAsDouble( context.expressionContext(), deltaY );
198 double deltaZ = mDeltaZ;
199 if ( mDynamicDeltaZ )
200 deltaZ = mDeltaZProperty.valueAsDouble( context.expressionContext(), deltaZ );
201 double deltaM = mDeltaM;
202 if ( mDynamicDeltaM )
203 deltaM = mDeltaMProperty.valueAsDouble( context.expressionContext(), deltaM );
204
205 if ( deltaZ != 0.0 && !geometry.constGet()->is3D() )
206 geometry.get()->addZValue( 0 );
207 if ( deltaM != 0.0 && !geometry.constGet()->isMeasure() )
208 geometry.get()->addMValue( 0 );
209
210 double scaleX = mScaleX;
211 if ( mDynamicScaleX )
212 scaleX = mScaleXProperty.valueAsDouble( context.expressionContext(), scaleX );
213 double scaleY = mScaleY;
214 if ( mDynamicScaleY )
215 scaleY = mScaleYProperty.valueAsDouble( context.expressionContext(), scaleY );
216 double scaleZ = mScaleZ;
217 if ( mDynamicScaleZ )
218 scaleZ = mScaleZProperty.valueAsDouble( context.expressionContext(), scaleZ );
219 double scaleM = mScaleM;
220 if ( mDynamicScaleM )
221 scaleM = mScaleMProperty.valueAsDouble( context.expressionContext(), scaleM );
222
223 double rotationZ = mRotationZ;
224 if ( mDynamicRotationZ )
225 rotationZ = mRotationZProperty.valueAsDouble( context.expressionContext(), rotationZ );
226
227 QTransform transform;
228 transform.translate( deltaX, deltaY );
229 transform.rotate( rotationZ );
230 transform.scale( scaleX, scaleY );
231
232 geometry.transform( transform, deltaZ, scaleZ, deltaM, scaleM );
233 f.setGeometry( geometry );
234 }
235 return QgsFeatureList() << f;
236}
237
238Qgis::WkbType QgsAffineTransformationAlgorithm::outputWkbType( Qgis::WkbType inputWkbType ) const
239{
240 Qgis::WkbType wkb = inputWkbType;
241 if ( mDeltaZ != 0.0 )
242 wkb = QgsWkbTypes::addZ( wkb );
243 if ( mDeltaM != 0.0 )
244 wkb = QgsWkbTypes::addM( wkb );
245 return wkb;
246}
247
248
249bool QgsAffineTransformationAlgorithm::supportInPlaceEdit( const QgsMapLayer *l ) const
250{
251 const QgsVectorLayer *layer = qobject_cast<const QgsVectorLayer *>( l );
252 if ( !layer )
253 return false;
254
256 return false;
257
258 // If the type differs there is no sense in executing the algorithm and drop the result
259 const Qgis::WkbType inPlaceWkbType = layer->wkbType();
260 return inPlaceWkbType == outputWkbType( inPlaceWkbType );
261}
WkbType
The WKB type describes the number of dimensions a geometry has.
Definition qgis.h:294
@ Double
Double/float values.
Definition qgis.h:3921
virtual bool addZValue(double zValue=0)=0
Adds a z-dimension to the geometry, initialized to a preset value.
bool isMeasure() const
Returns true if the geometry contains m values.
bool is3D() const
Returns true if the geometry is 3D and contains a z-value.
virtual bool addMValue(double mValue=0)=0
Adds a measure to the geometry, initialized to a preset value.
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition qgsfeature.h:60
QgsGeometry geometry
Definition qgsfeature.h:71
bool hasGeometry() const
Returns true if the feature has an associated geometry.
void setGeometry(const QgsGeometry &geometry)
Set the feature's geometry.
A geometry is the spatial representation of a feature.
Qgis::GeometryOperationResult transform(const QgsCoordinateTransform &ct, Qgis::TransformDirection direction=Qgis::TransformDirection::Forward, bool transformZ=false)
Transforms this geometry as described by the coordinate transform ct.
QgsAbstractGeometry * get()
Returns a modifiable (non-const) reference to the underlying abstract geometry primitive.
const QgsAbstractGeometry * constGet() const
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
Base class for all map layer types.
Definition qgsmaplayer.h:83
Contains information about the context in which a processing algorithm is executed.
QgsExpressionContext & expressionContext()
Returns the expression context.
bool supportInPlaceEdit(const QgsMapLayer *layer) const override
Checks whether this algorithm supports in-place editing on the given layer Default implementation for...
Base class for providing feedback from a processing algorithm.
static bool isDynamic(const QVariantMap &parameters, const QString &name)
Returns true if the parameter with matching name is a dynamic parameter, and must be evaluated once f...
Definition for a property.
Definition qgsproperty.h:47
@ Double
Double value (including negative values).
Definition qgsproperty.h:56
A store for object properties.
double valueAsDouble(const QgsExpressionContext &context, double defaultValue=0.0, bool *ok=nullptr) const
Calculates the current value of the property and interprets it as a double.
Represents a vector layer which manages a vector based dataset.
Q_INVOKABLE Qgis::WkbType wkbType() const final
Returns the WKBType or WKBUnknown in case of error.
static Qgis::WkbType addM(Qgis::WkbType type)
Adds the m dimension to a WKB type and returns the new type.
static Qgis::WkbType addZ(Qgis::WkbType type)
Adds the z dimension to a WKB type and returns the new type.
QList< QgsFeature > QgsFeatureList