Class that can transform vertices of a mesh by expression. More...
#include <qgsmeshadvancedediting.h>
Public Member Functions | |
| QgsMeshTransformVerticesByExpression ()=default | |
| bool | calculate (QgsMeshLayer *layer) |
Calculates the transformed vertices of the mesh layer, returns false if this leads to topological or geometrical errors. | |
| void | setExpressions (const QString &expressionX, const QString &expressionY, const QString &expressionZ) |
| Sets the expressions for the coordinates transformation. | |
| QString | text () const override |
| Returns a short text string describing what this advanced edit does. Default implementation return a void string. | |
| QgsMeshVertex | transformedVertex (QgsMeshLayer *layer, int vertexIndex) const |
| Returns the transformed vertex from its index vertexIndex for the mesh layer. | |
 Public Member Functions inherited from QgsMeshAdvancedEditing | |
| QgsMeshAdvancedEditing () | |
| virtual | ~QgsMeshAdvancedEditing () |
| void | clear () |
| Removes all data provided to the editing or created by the editing. | |
| virtual bool | isFinished () const |
Returns whether the advanced edit is finished, if not, this edit has to be applied again with QgsMeshEditor::advancedEdit() until is finished returns true. | |
| QString | message () const |
| Returns a message that can be provided by the advanced editing when applying is done. | |
| void | setInputFaces (const QList< int > faceIndexes) |
| Sets the input faces indexes that will be used for the editing. | |
| void | setInputVertices (const QList< int > verticesIndexes) |
| Sets the input vertices indexes that will be used for the editing. | |
| Public Member Functions inherited from QgsTopologicalMesh::Changes | |
| QVector< QgsMeshFace > | addedFaces () const |
| Returns the face that are added with this changes. | |
| QVector< QgsMeshVertex > | addedVertices () const |
| Returns the added vertices with this changes. | |
| QList< int > | changedCoordinatesVerticesIndexes () const |
| Returns the indexes of vertices that have changed coordinates. | |
| bool | isEmpty () const |
| Returns whether changes are empty, that there is nothing to change. | |
| QList< int > | nativeFacesIndexesGeometryChanged () const |
| Returns a list of the native face indexes that have a geometry changed. | |
| QList< QgsPointXY > | newVerticesXYValues () const |
| Returns the new (X,Y) values of vertices that have changed their coordinates. | |
| QList< double > | newVerticesZValues () const |
| Returns the new Z values of vertices that have changed their coordinates. | |
| QList< QgsPointXY > | oldVerticesXYValues () const |
| Returns the old (X,Y) values of vertices that have changed their coordinates. | |
| QList< int > | removedFaceIndexes () const |
| Returns the indexes of the faces that are removed with this changes. | |
| QVector< QgsMeshFace > | removedFaces () const |
| Returns the faces that are removed with this changes. | |
| QList< int > | verticesToRemoveIndexes () const |
| Returns the indexes of vertices to remove. | |
Friends | |
| class | TestQgsMeshEditor |
Detailed Description
Class that can transform vertices of a mesh by expression.
Each coordinates are associated with an expression that can be defined with function returning the current coordinates (see setExpressions()):
- $vertex_x
- $vertex_y
- $vertex_z
Example: Transposing a mesh and translate following axe X with a distance of 50 and increase the level of the mesh with an height of 80 when previous X coordinate is under 100 and de crease the level of 150 when X is under 100:
expressionX: "$vertex_y + 50" expressionY: "$vertex_x" expressionZ: "if( $vertex_x <= 100 , $vertex_z + 80 , $vertex_z - 150)"
- Since
- QGIS 3.22
Definition at line 162 of file qgsmeshadvancedediting.h.
Constructor & Destructor Documentation
◆ QgsMeshTransformVerticesByExpression()
|
default |
Member Function Documentation
◆ calculate()
| bool QgsMeshTransformVerticesByExpression::calculate | ( | QgsMeshLayer * | layer | ) |
Calculates the transformed vertices of the mesh layer, returns false if this leads to topological or geometrical errors.
The mesh layer must be in edit mode.
- Note
- this method not apply new vertices to the mesh layer but only store the calculated transformation that can be apply later with QgsMeshEditor::advancedEdit()
Definition at line 626 of file qgsmeshadvancedediting.cpp.
◆ setExpressions()
| void QgsMeshTransformVerticesByExpression::setExpressions | ( | const QString & | expressionX, |
| const QString & | expressionY, | ||
| const QString & | expressionZ | ||
| ) |
Sets the expressions for the coordinates transformation.
- Note
- Expressions are optional for each coordinate, the coordinate will not be transformed if the string is void.
Definition at line 766 of file qgsmeshadvancedediting.cpp.
◆ text()
|
overridevirtual |
Returns a short text string describing what this advanced edit does. Default implementation return a void string.
Reimplemented from QgsMeshAdvancedEditing.
Definition at line 761 of file qgsmeshadvancedediting.cpp.
◆ transformedVertex()
| QgsMeshVertex QgsMeshTransformVerticesByExpression::transformedVertex | ( | QgsMeshLayer * | layer, |
| int | vertexIndex | ||
| ) | const |
Returns the transformed vertex from its index vertexIndex for the mesh layer.
If layer is not the same than the one used to make the calculation, this will create an undefined behavior
Definition at line 782 of file qgsmeshadvancedediting.cpp.
Friends And Related Symbol Documentation
◆ TestQgsMeshEditor
|
friend |
Definition at line 201 of file qgsmeshadvancedediting.h.
The documentation for this class was generated from the following files:
- /build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/core/mesh/qgsmeshadvancedediting.h
- /build/qgis-3.41.0+git20241122+3440c17df1d+99sid/src/core/mesh/qgsmeshadvancedediting.cpp
