QGIS API Documentation 4.0.0-Norrköping (1ddcee3d0e4)
Loading...
Searching...
No Matches
qgspolygon3dsymbol.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgspolygon3dsymbol.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 "qgspolygon3dsymbol.h"
17
18#include "qgs3d.h"
19#include "qgs3dsceneexporter.h"
20#include "qgs3dutils.h"
21#include "qgscolorutils.h"
22#include "qgsmaterialregistry.h"
24#include "qgsvectorlayer.h"
26
27#include <QString>
28#include <Qt3DCore/QEntity>
29
30using namespace Qt::StringLiterals;
31
33 : mMaterialSettings( std::make_unique<QgsPhongMaterialSettings>() )
34{}
35
37
39{
40 auto result = std::make_unique<QgsPolygon3DSymbol>();
41 result->mAltClamping = mAltClamping;
42 result->mAltBinding = mAltBinding;
43 result->mOffset = mOffset;
44 result->mExtrusionHeight = mExtrusionHeight;
45 result->mMaterialSettings.reset( mMaterialSettings->clone() );
46 result->mCullingMode = mCullingMode;
47 result->mInvertNormals = mInvertNormals;
48 result->mAddBackFaces = mAddBackFaces;
49 result->mExtrusionFaces = mExtrusionFaces;
50 result->mEdgesEnabled = mEdgesEnabled;
51 result->mEdgeWidth = mEdgeWidth;
52 result->mEdgeColor = mEdgeColor;
53 copyBaseSettings( result.get() );
54 return result.release();
55}
56
57void QgsPolygon3DSymbol::writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const
58{
59 Q_UNUSED( context )
60
61 QDomDocument doc = elem.ownerDocument();
62
63 QDomElement elemDataProperties = doc.createElement( u"data"_s );
64 elemDataProperties.setAttribute( u"alt-clamping"_s, Qgs3DUtils::altClampingToString( mAltClamping ) );
65 elemDataProperties.setAttribute( u"alt-binding"_s, Qgs3DUtils::altBindingToString( mAltBinding ) );
66 elemDataProperties.setAttribute( u"offset"_s, mOffset );
67 elemDataProperties.setAttribute( u"extrusion-height"_s, mExtrusionHeight );
68 elemDataProperties.setAttribute( u"culling-mode"_s, Qgs3DUtils::cullingModeToString( mCullingMode ) );
69 elemDataProperties.setAttribute( u"invert-normals"_s, mInvertNormals ? u"1"_s : u"0"_s );
70 elemDataProperties.setAttribute( u"add-back-faces"_s, mAddBackFaces ? u"1"_s : u"0"_s );
71 elemDataProperties.setAttribute( u"rendered-facade"_s, qgsEnumValueToKey( mExtrusionFaces ) );
72 elem.appendChild( elemDataProperties );
73
74 elem.setAttribute( u"material_type"_s, mMaterialSettings->type() );
75 QDomElement elemMaterial = doc.createElement( u"material"_s );
76 mMaterialSettings->writeXml( elemMaterial, context );
77 elem.appendChild( elemMaterial );
78
79 QDomElement elemDDP = doc.createElement( u"data-defined-properties"_s );
80 mDataDefinedProperties.writeXml( elemDDP, propertyDefinitions() );
81 elem.appendChild( elemDDP );
82
83 QDomElement elemEdges = doc.createElement( u"edges"_s );
84 elemEdges.setAttribute( u"enabled"_s, mEdgesEnabled ? u"1"_s : u"0"_s );
85 elemEdges.setAttribute( u"width"_s, mEdgeWidth );
86 elemEdges.setAttribute( u"color"_s, QgsColorUtils::colorToString( mEdgeColor ) );
87 elem.appendChild( elemEdges );
88}
89
90void QgsPolygon3DSymbol::readXml( const QDomElement &elem, const QgsReadWriteContext &context )
91{
92 Q_UNUSED( context )
93
94 const QDomElement elemDataProperties = elem.firstChildElement( u"data"_s );
95 mAltClamping = Qgs3DUtils::altClampingFromString( elemDataProperties.attribute( u"alt-clamping"_s ) );
96 mAltBinding = Qgs3DUtils::altBindingFromString( elemDataProperties.attribute( u"alt-binding"_s ) );
97 mOffset = elemDataProperties.attribute( u"offset"_s ).toFloat();
98 mExtrusionHeight = elemDataProperties.attribute( u"extrusion-height"_s ).toFloat();
99 mCullingMode = Qgs3DUtils::cullingModeFromString( elemDataProperties.attribute( u"culling-mode"_s ) );
100 mInvertNormals = elemDataProperties.attribute( u"invert-normals"_s ).toInt();
101 mAddBackFaces = elemDataProperties.attribute( u"add-back-faces"_s ).toInt();
102 mExtrusionFaces = qgsEnumKeyToValue( elemDataProperties.attribute( u"rendered-facade"_s ), Qgis::ExtrusionFace::Walls | Qgis::ExtrusionFace::Roof );
103
104 const QDomElement elemMaterial = elem.firstChildElement( u"material"_s );
105 const QString materialType = elem.attribute( u"material_type"_s, u"phong"_s );
106 mMaterialSettings.reset( Qgs3D::materialRegistry()->createMaterialSettings( materialType ) );
107 if ( !mMaterialSettings )
108 mMaterialSettings.reset( Qgs3D::materialRegistry()->createMaterialSettings( u"phong"_s ) );
109 mMaterialSettings->readXml( elemMaterial, context );
110
111 const QDomElement elemDDP = elem.firstChildElement( u"data-defined-properties"_s );
112 if ( !elemDDP.isNull() )
113 mDataDefinedProperties.readXml( elemDDP, propertyDefinitions() );
114
115 const QDomElement elemEdges = elem.firstChildElement( u"edges"_s );
116 if ( !elemEdges.isNull() )
117 {
118 mEdgesEnabled = elemEdges.attribute( u"enabled"_s ).toInt();
119 mEdgeWidth = elemEdges.attribute( u"width"_s ).toFloat();
120 mEdgeColor = QgsColorUtils::colorFromString( elemEdges.attribute( u"color"_s ) );
121 }
122}
123
124QList<Qgis::GeometryType> QgsPolygon3DSymbol::compatibleGeometryTypes() const
125{
126 return QList<Qgis::GeometryType>() << Qgis::GeometryType::Polygon;
127}
128
130{
131 const QgsVectorLayerElevationProperties *props = qgis::down_cast<const QgsVectorLayerElevationProperties *>( const_cast<QgsVectorLayer *>( layer )->elevationProperties() );
132
133 mAltClamping = props->clamping();
134 mAltBinding = props->binding();
135 mExtrusionHeight = props->extrusionEnabled() ? static_cast<float>( props->extrusionHeight() ) : 0.0f;
137 {
139 }
140 else
141 {
142 mDataDefinedProperties.setProperty( QgsAbstract3DSymbol::Property::ExtrusionHeight, QgsProperty() );
143 }
145 {
147 }
148 else
149 {
150 mDataDefinedProperties.setProperty( QgsAbstract3DSymbol::Property::Height, QgsProperty() );
151 }
152 mOffset = static_cast<float>( props->zOffset() );
153}
154
159
161{
162 return mMaterialSettings.get();
163}
164
166{
167 if ( materialSettings == mMaterialSettings.get() )
168 return;
169
170 mMaterialSettings.reset( materialSettings );
171}
172
173bool QgsPolygon3DSymbol::exportGeometries( Qgs3DSceneExporter *exporter, Qt3DCore::QEntity *entity, const QString &objectNamePrefix ) const
174{
175 QList<Qt3DCore::QEntity *> subEntities = entity->findChildren<Qt3DCore::QEntity *>( QString(), Qt::FindDirectChildrenOnly );
176 // sort geometries by their name in order to always export them in the same way:
177 std::sort( subEntities.begin(), subEntities.end(), []( const Qt3DCore::QEntity *a, const Qt3DCore::QEntity *b ) { return a->objectName() < b->objectName(); } );
178
179 if ( subEntities.isEmpty() )
180 {
181 const QList<Qt3DRender::QGeometryRenderer *> renderers = entity->findChildren<Qt3DRender::QGeometryRenderer *>();
182 const int startSize = exporter->mObjects.size();
183 for ( Qt3DRender::QGeometryRenderer *renderer : renderers )
184 {
185 Qgs3DExportObject *object = exporter->processGeometryRenderer( renderer, objectNamePrefix );
186 if ( object )
187 {
188 exporter->processEntityMaterial( entity, object );
189 exporter->mObjects.push_back( object );
190 }
191 }
192 return exporter->mObjects.size() > startSize;
193 }
194 else
195 {
196 bool out = false;
197 QString prefix;
198 for ( Qt3DCore::QEntity *e : subEntities )
199 {
200 if ( e->objectName().isEmpty() )
201 prefix = objectNamePrefix;
202 else
203 prefix = e->objectName() + "_";
204
205 out |= exportGeometries( exporter, e, prefix );
206 }
207 return out;
208 }
209}
210
212{
213 switch ( side )
214 {
215 case 0:
216 mExtrusionFaces = Qgis::ExtrusionFace::NoFace;
217 break;
218 case 1:
219 mExtrusionFaces = Qgis::ExtrusionFace::Walls;
220 break;
221 case 2:
222 mExtrusionFaces = Qgis::ExtrusionFace::Roof;
223 break;
224 case 3:
226 break;
227 case 7:
229 break;
230 default:
231 break;
232 }
233}
234
236{
237 const int flags = static_cast<int>( mExtrusionFaces );
238
240 return 7;
241 else if ( flags == static_cast<int>( Qgis::ExtrusionFace::Walls | Qgis::ExtrusionFace::Roof ) )
242 return 3;
243 else if ( flags == static_cast<int>( Qgis::ExtrusionFace::Roof ) )
244 return 2;
245 else if ( flags == static_cast<int>( Qgis::ExtrusionFace::Walls ) )
246 return 1;
247 else
248 return 0;
249}
@ Polygon
Polygons.
Definition qgis.h:382
Manages the data of each object of the scene (positions, normals, texture coordinates ....
Entity that handles the exporting of 3D scenes.
static Qgs3DTypes::CullingMode cullingModeFromString(const QString &str)
Converts a string to a value from CullingMode enum.
static Qgis::AltitudeClamping altClampingFromString(const QString &str)
Converts a string to a value from AltitudeClamping enum.
static Qgis::AltitudeBinding altBindingFromString(const QString &str)
Converts a string to a value from AltitudeBinding enum.
static QString cullingModeToString(Qgs3DTypes::CullingMode mode)
Converts a value from CullingMode enum to a string.
static QString altClampingToString(Qgis::AltitudeClamping altClamp)
Converts a value from AltitudeClamping enum to a string.
static QString altBindingToString(Qgis::AltitudeBinding altBind)
Converts a value from AltitudeBinding enum to a string.
static QgsMaterialRegistry * materialRegistry()
Returns the material registry, used for managing 3D materials.
Definition qgs3d.cpp:99
Abstract base class for 3D symbols that are used by VectorLayer3DRenderer objects.
@ ExtrusionHeight
Extrusion height (zero means no extrusion).
Abstract base class for material settings.
static QColor colorFromString(const QString &string)
Decodes a string into a color value.
static QString colorToString(const QColor &color)
Encodes a color into a string value.
QgsPropertyCollection & dataDefinedProperties()
Returns a reference to the object's property collection, used for data defined overrides.
double zOffset() const
Returns the z offset, which is a fixed offset amount which should be added to z values from the layer...
Basic shading material used for rendering based on the Phong shading model with three color component...
void writeXml(QDomElement &elem, const QgsReadWriteContext &context) const override
static QgsAbstract3DSymbol * create() SIP_FACTORY
Creates a new QgsPolygon3DSymbol.
QgsAbstractMaterialSettings * materialSettings() const
Returns material settings used for shading of the symbol.
QgsAbstract3DSymbol * clone() const override SIP_FACTORY
Q_DECL_DEPRECATED void setRenderedFacade(int side) SIP_DEPRECATED
Sets which facade of the buildings is rendered (0 for None, 1 for Walls, 2 for Roof,...
void setMaterialSettings(QgsAbstractMaterialSettings *materialSettings SIP_TRANSFER)
Sets the material settings used for shading of the symbol.
~QgsPolygon3DSymbol() override
bool exportGeometries(Qgs3DSceneExporter *exporter, Qt3DCore::QEntity *entity, const QString &objectNamePrefix) const override SIP_SKIP
Exports the geometries contained within the hierarchy of entity.
void setDefaultPropertiesFromLayer(const QgsVectorLayer *layer) override
Q_DECL_DEPRECATED int renderedFacade() SIP_DEPRECATED
Returns which facade of the buildings is rendered (0 for None, 1 for Walls, 2 for Roof,...
void readXml(const QDomElement &elem, const QgsReadWriteContext &context) override
QList< Qgis::GeometryType > compatibleGeometryTypes() const override
bool isActive(int key) const final
Returns true if the collection contains an active property with the specified key.
QgsProperty property(int key) const final
Returns a matching property from the collection, if one exists.
A store for object properties.
A container for the context for various read/write operations on objects.
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...
Qgis::AltitudeBinding binding() const
Returns the altitude binding method, which determines how altitude is bound to individual vertices in...
bool extrusionEnabled() const
Returns true if extrusion is enabled.
Represents a vector layer which manages a vector based dataset.
T qgsEnumKeyToValue(const QString &key, const T &defaultValue, bool tryValueAsKey=true, bool *returnOk=nullptr)
Returns the value corresponding to the given key of an enum.
Definition qgis.h:7176
QString qgsEnumValueToKey(const T &value, bool *returnOk=nullptr)
Returns the value for the given key of an enum.
Definition qgis.h:7157