QGIS API Documentation 3.99.0-Master (2fe06baccd8)
Loading...
Searching...
No Matches
qgspoint3dsymbol.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgspoint3dsymbol.cpp
3 --------------------------------------
4 Date : July 2017
5 Copyright : (C) 2017 by Martin Dobias
6 Email : wonder dot sk at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#include "qgspoint3dsymbol.h"
17
18#include "qgs3d.h"
19#include "qgs3dexportobject.h"
20#include "qgs3dsceneexporter.h"
21#include "qgs3dutils.h"
22#include "qgsmarkersymbol.h"
23#include "qgsmaterialregistry.h"
24#include "qgsreadwritecontext.h"
25#include "qgssymbollayerutils.h"
26#include "qgsvectorlayer.h"
28#include "qgsxmlutils.h"
29
31{
32 return new QgsPoint3DSymbol( *this );
33}
34
39
45
47 : mAltClamping( other.altitudeClamping() )
48 , mMaterialSettings( other.materialSettings() ? other.materialSettings()->clone() : nullptr )
49 , mShape( other.shape() )
50 , mShapeProperties( other.shapeProperties() )
51 , mTransform( other.transform() )
52 , mBillboardSymbol( other.billboardSymbol() ? other.billboardSymbol()->clone() : nullptr )
53{
55}
56
58
59void QgsPoint3DSymbol::writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const
60{
61 QDomDocument doc = elem.ownerDocument();
62
63 QDomElement elemDataProperties = doc.createElement( QStringLiteral( "data" ) );
64 elemDataProperties.setAttribute( QStringLiteral( "alt-clamping" ), Qgs3DUtils::altClampingToString( mAltClamping ) );
65 elem.appendChild( elemDataProperties );
66
67 elem.setAttribute( QStringLiteral( "material_type" ), mMaterialSettings->type() );
68 QDomElement elemMaterial = doc.createElement( QStringLiteral( "material" ) );
69 mMaterialSettings->writeXml( elemMaterial, context );
70 elem.appendChild( elemMaterial );
71
72 elem.setAttribute( QStringLiteral( "shape" ), shapeToString( mShape ) );
73
74 QVariantMap shapePropertiesCopy( mShapeProperties );
75 shapePropertiesCopy[QStringLiteral( "model" )] = QVariant( context.pathResolver().writePath( shapePropertiesCopy[QStringLiteral( "model" )].toString() ) );
76
77 QDomElement elemShapeProperties = doc.createElement( QStringLiteral( "shape-properties" ) );
78 elemShapeProperties.appendChild( QgsXmlUtils::writeVariant( shapePropertiesCopy, doc ) );
79 elem.appendChild( elemShapeProperties );
80
81 QDomElement elemTransform = doc.createElement( QStringLiteral( "transform" ) );
82 elemTransform.setAttribute( QStringLiteral( "matrix" ), Qgs3DUtils::matrix4x4toString( mTransform ) );
83 elem.appendChild( elemTransform );
84
85 if ( billboardSymbol() )
86 {
87 const QDomElement symbolElem = QgsSymbolLayerUtils::saveSymbol( QStringLiteral( "symbol" ), billboardSymbol(), doc, context );
88
89 elem.appendChild( symbolElem );
90 }
91}
92
93void QgsPoint3DSymbol::readXml( const QDomElement &elem, const QgsReadWriteContext &context )
94{
95 const QDomElement elemDataProperties = elem.firstChildElement( QStringLiteral( "data" ) );
96 mAltClamping = Qgs3DUtils::altClampingFromString( elemDataProperties.attribute( QStringLiteral( "alt-clamping" ) ) );
97
98 const QDomElement elemMaterial = elem.firstChildElement( QStringLiteral( "material" ) );
99 const QString materialType = elem.attribute( QStringLiteral( "material_type" ), QStringLiteral( "phong" ) );
100 mMaterialSettings.reset( Qgs3D::materialRegistry()->createMaterialSettings( materialType ) );
101 if ( !mMaterialSettings )
102 mMaterialSettings.reset( Qgs3D::materialRegistry()->createMaterialSettings( QStringLiteral( "phong" ) ) );
103 mMaterialSettings->readXml( elemMaterial, context );
104
105 mShape = shapeFromString( elem.attribute( QStringLiteral( "shape" ) ) );
106
107 const QDomElement elemShapeProperties = elem.firstChildElement( QStringLiteral( "shape-properties" ) );
108 mShapeProperties = QgsXmlUtils::readVariant( elemShapeProperties.firstChildElement() ).toMap();
109 mShapeProperties[QStringLiteral( "model" )] = QVariant( context.pathResolver().readPath( mShapeProperties[QStringLiteral( "model" )].toString() ) );
110
111 const QDomElement elemTransform = elem.firstChildElement( QStringLiteral( "transform" ) );
112 mTransform = Qgs3DUtils::stringToMatrix4x4( elemTransform.attribute( QStringLiteral( "matrix" ) ) );
113
114 const QDomElement symbolElem = elem.firstChildElement( QStringLiteral( "symbol" ) );
115
117}
118
119QList<Qgis::GeometryType> QgsPoint3DSymbol::compatibleGeometryTypes() const
120{
121 return QList<Qgis::GeometryType>() << Qgis::GeometryType::Point;
122}
123
125{
126 const QgsVectorLayerElevationProperties *props = qgis::down_cast<const QgsVectorLayerElevationProperties *>( const_cast<QgsVectorLayer *>( layer )->elevationProperties() );
127
128 mAltClamping = props->clamping();
129 mTransform.data()[13] = static_cast<float>( props->zOffset() );
130 mShapeProperties[QStringLiteral( "length" )] = props->extrusionEnabled() ? static_cast<float>( props->extrusionHeight() ) : 0.0f;
131}
132
134{
135 if ( shape == QLatin1String( "sphere" ) )
137 else if ( shape == QLatin1String( "cone" ) )
139 else if ( shape == QLatin1String( "cube" ) )
141 else if ( shape == QLatin1String( "torus" ) )
143 else if ( shape == QLatin1String( "plane" ) )
145 else if ( shape == QLatin1String( "extruded-text" ) )
147 else if ( shape == QLatin1String( "model" ) )
149 else if ( shape == QLatin1String( "billboard" ) )
151 else // "cylinder" (default)
153}
154
156{
157 switch ( shape )
158 {
160 return QStringLiteral( "cylinder" );
162 return QStringLiteral( "sphere" );
164 return QStringLiteral( "cone" );
166 return QStringLiteral( "cube" );
168 return QStringLiteral( "torus" );
170 return QStringLiteral( "plane" );
172 return QStringLiteral( "extruded-text" );
174 return QStringLiteral( "model" );
176 return QStringLiteral( "billboard" );
177 default:
178 Q_ASSERT( false );
179 return QString();
180 }
181}
182
183QVariant QgsPoint3DSymbol::shapeProperty( const QString &property ) const
184{
185 switch ( mShape )
186 {
188 {
189 if ( property == QLatin1String( "length" ) )
190 {
191 const float length = mShapeProperties.value( property ).toFloat();
192 if ( length == 0 )
193 return 10;
194 return length;
195 }
196 else if ( property == QLatin1String( "radius" ) )
197 {
198 const float radius = mShapeProperties.value( property ).toFloat();
199 if ( radius == 0 )
200 return 10;
201 return radius;
202 }
203 break;
204 }
206 {
207 if ( property == QLatin1String( "radius" ) )
208 {
209 const float radius = mShapeProperties.value( property ).toFloat();
210 if ( radius == 0 )
211 return 10;
212 return radius;
213 }
214 break;
215 }
217 {
218 if ( property == QLatin1String( "length" ) )
219 {
220 const float length = mShapeProperties.value( property ).toFloat();
221 if ( length == 0 )
222 return 10;
223 return length;
224 }
225 break;
226 }
228 {
229 if ( property == QLatin1String( "size" ) )
230 {
231 const float size = mShapeProperties.value( property ).toFloat();
232 if ( size == 0 )
233 return 10;
234 return size;
235 }
236 break;
237 }
239 {
240 if ( property == QLatin1String( "radius" ) )
241 {
242 const float radius = mShapeProperties.value( property ).toFloat();
243 if ( radius == 0 )
244 return 10;
245 return radius;
246 }
247 else if ( property == QLatin1String( "minorRadius" ) )
248 {
249 const float minorRadius = mShapeProperties.value( property ).toFloat();
250 if ( minorRadius == 0 )
251 return 5;
252 return minorRadius;
253 }
254 break;
255 }
257 {
258 if ( property == QLatin1String( "size" ) )
259 {
260 const float size = mShapeProperties.value( property ).toFloat();
261 if ( size == 0 )
262 return 10;
263 return size;
264 }
265 break;
266 }
268 {
269 if ( property == QLatin1String( "depth" ) )
270 {
271 const float depth = mShapeProperties.value( property ).toFloat();
272 if ( depth == 0 )
273 return 1;
274 return depth;
275 }
276 break;
277 }
278
281 break;
282 }
283 return mShapeProperties.value( property );
284}
285
287{
288 return mTransform.data()[14];
289}
290
292{
293 return mMaterialSettings.get();
294}
295
297{
298 if ( materialSettings == mMaterialSettings.get() )
299 return;
300
301 mMaterialSettings.reset( materialSettings );
302}
303
304bool QgsPoint3DSymbol::exportGeometries( Qgs3DSceneExporter *exporter, Qt3DCore::QEntity *entity, const QString &objectNamePrefix ) const
305{
307 {
308 Qt3DRender::QSceneLoader *sceneLoader = entity->findChild<Qt3DRender::QSceneLoader *>();
309 if ( sceneLoader )
310 {
311 const QVector<Qgs3DExportObject *> objects = exporter->processSceneLoaderGeometries( sceneLoader, objectNamePrefix );
312 for ( Qgs3DExportObject *obj : objects )
313 {
314 obj->setSmoothEdges( exporter->smoothEdges() );
315 obj->setupMaterial( materialSettings() );
316 }
317 exporter->mObjects << objects;
318 }
319 else
320 {
321 const QList<Qt3DRender::QMesh *> meshes = entity->findChildren<Qt3DRender::QMesh *>();
322 for ( Qt3DRender::QMesh *mesh : meshes )
323 {
324 Qgs3DExportObject *object = exporter->processGeometryRenderer( mesh, objectNamePrefix );
325 if ( !object )
326 continue;
327 object->setSmoothEdges( exporter->smoothEdges() );
328 object->setupMaterial( materialSettings() );
329 exporter->mObjects << object;
330 }
331 }
332 return true;
333 }
334 else if ( shape() == Qgis::Point3DShape::Billboard )
335 {
336 Qgs3DExportObject *obj = exporter->processPoints( entity, objectNamePrefix );
337 if ( obj )
338 {
339 exporter->mObjects << obj;
340 return true;
341 }
342 }
343 else
344 {
345 const QVector<Qgs3DExportObject *> objects = exporter->processInstancedPointGeometry( entity, objectNamePrefix );
346 for ( Qgs3DExportObject *obj : objects )
347 {
348 obj->setupMaterial( materialSettings() );
349 exporter->mObjects << obj;
350 }
351 return true;
352 }
353 return false;
354}
355
357{
358 return mBillboardSymbol.get();
359}
360
362{
363 mBillboardSymbol.reset( symbol );
364}
Point3DShape
3D point shape types.
Definition qgis.h:4124
@ Plane
Flat plane.
Definition qgis.h:4130
@ Cylinder
Cylinder.
Definition qgis.h:4125
@ Torus
Torus.
Definition qgis.h:4129
@ ExtrudedText
Extruded text.
Definition qgis.h:4131
@ Model
Model.
Definition qgis.h:4132
@ Sphere
Sphere.
Definition qgis.h:4126
@ Billboard
Billboard.
Definition qgis.h:4133
@ Point
Points.
Definition qgis.h:359
Manages the data of each object of the scene (positions, normals, texture coordinates ....
void setSmoothEdges(bool smoothEdges)
Sets whether triangles edges will look smooth.
Entity that handles the exporting of 3D scenes.
bool smoothEdges() const
Returns whether the triangles will look smooth.
static Qgis::AltitudeClamping altClampingFromString(const QString &str)
Converts a string to a value from AltitudeClamping enum.
static QString matrix4x4toString(const QMatrix4x4 &m)
Converts a 4x4 transform matrix to a string.
static QString altClampingToString(Qgis::AltitudeClamping altClamp)
Converts a value from AltitudeClamping enum to a string.
static QMatrix4x4 stringToMatrix4x4(const QString &str)
Convert a string to a 4x4 transform matrix.
static QgsMaterialRegistry * materialRegistry()
Returns the material registry, used for managing 3D materials.
Definition qgs3d.cpp:85
Abstract base class for 3D symbols that are used by VectorLayer3DRenderer objects.
void setDataDefinedProperties(const QgsPropertyCollection &collection)
Sets the symbol layer's property collection, used for data defined overrides.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the symbol layer's property collection, used for data defined overrides.
Abstract base class for material settings.
double zOffset() const
Returns the z offset, which is a fixed offset amount which should be added to z values from the layer...
A marker symbol type, for rendering Point and MultiPoint geometries.
QString writePath(const QString &filename) const
Prepare a filename to save it to the project file.
QString readPath(const QString &filename) const
Turn filename read from the project file to an absolute path.
Basic shading material used for rendering based on the Phong shading model with three color component...
static QString shapeToString(Qgis::Point3DShape shape)
Returns string from a shape enum value.
~QgsPoint3DSymbol() override
void setDefaultPropertiesFromLayer(const QgsVectorLayer *layer) override
Sets default properties for the symbol based on a layer's configuration.
QgsAbstractMaterialSettings * materialSettings() const
Returns material settings used for shading of the symbol.
static QgsAbstract3DSymbol * create()
Creates a new QgsPoint3DSymbol.
void writeXml(QDomElement &elem, const QgsReadWriteContext &context) const override
Writes symbol configuration to the given DOM element.
QgsPoint3DSymbol()
Constructor for QgsPoint3DSymbol with default QgsMarkerSymbol as the billboardSymbol.
QMatrix4x4 transform() const
Returns transform for individual objects represented by the symbol.
QgsMarkerSymbol * billboardSymbol() const
Returns a symbol for billboard.
Qgis::Point3DShape shape() const
Returns 3D shape for points.
float billboardHeight() const
Returns how much the billboard should be elevated upwards.
QList< Qgis::GeometryType > compatibleGeometryTypes() const override
Returns the list of the vector layer geometry types which are compatible with this symbol.
bool exportGeometries(Qgs3DSceneExporter *exporter, Qt3DCore::QEntity *entity, const QString &objectNamePrefix) const override
Exports the geometries contained within the hierarchy of entity.
void setBillboardSymbol(QgsMarkerSymbol *symbol)
Set symbol for billboard and the ownership is transferred.
QVariantMap shapeProperties() const
Returns a key-value dictionary of point shape properties.
Qgis::AltitudeClamping altitudeClamping() const
Returns method that determines altitude (whether to clamp to feature to terrain).
QgsAbstract3DSymbol * clone() const override
Returns a new instance of the symbol with the same settings.
void setMaterialSettings(QgsAbstractMaterialSettings *materialSettings)
Sets the material settings used for shading of the symbol.
void readXml(const QDomElement &elem, const QgsReadWriteContext &context) override
Reads symbol configuration from the given DOM element.
QVariant shapeProperty(const QString &property) const
Returns the value for a specific shape property.
static Qgis::Point3DShape shapeFromString(const QString &shape)
Returns shape enum value from a string.
A container for the context for various read/write operations on objects.
const QgsPathResolver & pathResolver() const
Returns path resolver for conversion between relative and absolute paths.
static std::unique_ptr< QgsSymbol > loadSymbol(const QDomElement &element, const QgsReadWriteContext &context)
Attempts to load a symbol from a DOM element.
static QDomElement saveSymbol(const QString &symbolName, const QgsSymbol *symbol, QDomDocument &doc, const QgsReadWriteContext &context)
Writes a symbol definition to XML.
static QgsSymbol * defaultSymbol(Qgis::GeometryType geomType)
Returns a new default symbol for the specified geometry type.
Vector layer specific subclass of QgsMapLayerElevationProperties.
double extrusionHeight() const
Returns the feature extrusion height.
Qgis::AltitudeClamping clamping() const
Returns the altitude clamping method, which dictates how feature heights are interpreted with respect...
bool extrusionEnabled() const
Returns true if extrusion is enabled.
Represents a vector layer which manages a vector based dataset.
static QDomElement writeVariant(const QVariant &value, QDomDocument &doc)
Write a QVariant to a QDomElement.
static QVariant readVariant(const QDomElement &element)
Read a QVariant from a QDomElement.