QGIS API Documentation 4.3.0-Master (0cfde48c85b)
Loading...
Searching...
No Matches
qgssimplelinematerial3dhandler.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgssimplelinematerial3dhandler.cpp
3 --------------------------------------
4 Date : August 2020
5 Copyright : (C) 2020 by Nyall Dawson
6 Email : nyall dot dawson 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
17
18#include "qgs3dutils.h"
19#include "qgslinematerial_p.h"
20#include "qgslinestring.h"
21#include "qgslinevertexdata_p.h"
23
24#include <QMap>
25#include <QString>
26#include <Qt3DCore/QAttribute>
27#include <Qt3DCore/QBuffer>
28#include <Qt3DCore/QGeometry>
29#include <Qt3DExtras/Qt3DWindow>
30#include <Qt3DRender/QEffect>
31#include <Qt3DRender/QParameter>
32#include <Qt3DRender/QTexture>
33
34using namespace Qt::StringLiterals;
35
36
38{
39 const QgsSimpleLineMaterialSettings *lineSettings = dynamic_cast< const QgsSimpleLineMaterialSettings * >( settings );
40 Q_ASSERT( lineSettings );
41
42 switch ( technique )
43 {
51 return nullptr;
52
54 {
55 if ( context.isHighlighted() )
56 {
57 // QgsHighlightMaterial does not support lines
58 return nullptr;
59 }
60
61 QgsLineMaterial *mat = new QgsLineMaterial;
62 if ( !context.isSelected() )
63 {
64 mat->setLineColor( lineSettings->ambient() );
65 mat->setUseVertexColors( lineSettings->dataDefinedProperties().isActive( QgsAbstractMaterialSettings::Property::Ambient ) );
66 }
67 else
68 {
69 // update the material with selection colors
70 mat->setLineColor( context.selectionColor() );
71 mat->setUseVertexColors( false );
72 }
73 return mat;
74 }
75 }
76 return nullptr;
77}
78
80{
81 const QgsSimpleLineMaterialSettings *lineSettings = dynamic_cast< const QgsSimpleLineMaterialSettings * >( settings );
82 Q_ASSERT( lineSettings );
83
84 QMap<QString, QString> parameters;
85 parameters[u"Ka"_s] = u"%1 %2 %3"_s.arg( lineSettings->ambient().redF() ).arg( lineSettings->ambient().greenF() ).arg( lineSettings->ambient().blueF() );
86 return parameters;
87}
88
90{
91 const QgsSimpleLineMaterialSettings *lineSettings = dynamic_cast< const QgsSimpleLineMaterialSettings * >( settings );
92 Q_ASSERT( lineSettings );
93
94 const QColor ambient = Qgs3DUtils::srgbToLinear( lineSettings->dataDefinedProperties().valueAsColor( QgsAbstractMaterialSettings::Property::Ambient, expressionContext, lineSettings->ambient() ) );
95
96 QByteArray array;
97 array.resize( sizeof( unsigned char ) * 3 );
98 unsigned char *fptr = reinterpret_cast<unsigned char *>( array.data() );
99
100 *fptr++ = static_cast<unsigned char>( ambient.red() );
101 *fptr++ = static_cast<unsigned char>( ambient.green() );
102 *fptr++ = static_cast<unsigned char>( ambient.blue() );
103 return array;
104}
105
106void QgsSimpleLineMaterial3DHandler::applyDataDefinedToGeometry( const QgsAbstractMaterialSettings *, Qt3DCore::QGeometry *geometry, int instanceCount, const QByteArray &data ) const
107{
108 Qt3DCore::QBuffer *dataBuffer = new Qt3DCore::QBuffer( geometry );
109
110 Qt3DCore::QAttribute *colorAttribute = new Qt3DCore::QAttribute( geometry );
111 colorAttribute->setName( u"dataDefinedColor"_s );
112 colorAttribute->setVertexBaseType( Qt3DCore::QAttribute::UnsignedByte );
113 colorAttribute->setVertexSize( 3 );
114 colorAttribute->setAttributeType( Qt3DCore::QAttribute::VertexAttribute );
115 colorAttribute->setBuffer( dataBuffer );
116 colorAttribute->setByteStride( 3 * sizeof( unsigned char ) );
117 colorAttribute->setByteOffset( 0 );
118 colorAttribute->setCount( instanceCount );
119 colorAttribute->setDivisor( 1 );
120 geometry->addAttribute( colorAttribute );
121
122 dataBuffer->setData( data );
123}
124
125QList<QgsAbstractMaterial3DHandler::PreviewMeshType> QgsSimpleLineMaterial3DHandler::previewMeshTypes() const
126{
127 PreviewMeshType lines;
128 lines.type = u"lines"_s;
129 lines.displayName = QObject::tr( "Lines" );
130 return { lines };
131}
132
133Qt3DCore::QEntity *QgsSimpleLineMaterial3DHandler::createPreviewMesh( const QString &, Qt3DCore::QEntity *parent ) const
134{
135 QgsLineVertexData lineVertexData;
136 constexpr double s = 1.0;
137 // just a boring old flat square
138 lineVertexData.addLineString( QgsLineString( { -s, s, s, -s, -s }, { -s, -s, s, s, -s }, { 0, 0, 0, 0, 0 } ) );
139
140 Qt3DCore::QEntity *entity = lineVertexData.createSegmentEntity( nullptr );
141 entity->setParent( parent );
142
143 if ( Qt3DCore::QEntity *joinEntity = lineVertexData.createJoinEntity( nullptr ) )
144 joinEntity->setParent( entity );
145
146 return entity;
147}
148
150 const QgsAbstractMaterialSettings *settings, const QString &type, const QgsMaterialContext &context, QWindow *window, Qt3DCore::QEntity *parent
151) const
152{
153 Qt3DCore::QEntity *root = new Qt3DCore::QEntity( parent );
154 Qt3DCore::QEntity *mesh = createPreviewMesh( type, root );
155
157 QgsLineMaterial *lineMaterial = qobject_cast<QgsLineMaterial *>( mat );
158 Q_ASSERT( lineMaterial );
159 lineMaterial->setLineWidth( 2 );
160
161 mat->setParent( mesh );
162 mesh->addComponent( mat );
163
164 QgsLineMaterial *joinMaterial = nullptr;
165 const QList<QgsLineMaterial *> childLineMaterials = mesh->findChildren<QgsLineMaterial *>();
166 for ( QgsLineMaterial *candidate : childLineMaterials )
167 {
168 if ( candidate->part() == QgsLineMaterial::LinePart::Join )
169 {
170 joinMaterial = candidate;
171 break;
172 }
173 }
174 if ( joinMaterial )
175 lineMaterial->copyLineParametersTo( joinMaterial );
176
177 if ( window )
178 {
179 // ensure viewport size is updated if preview widget window size changes
180 auto updateViewport = [lineMaterial, joinMaterial, window]() {
181 const QSizeF size( window->width(), window->height() );
182 lineMaterial->setViewportSize( size );
183 if ( joinMaterial )
184 joinMaterial->setViewportSize( size );
185 };
186 QObject::connect( window, &Qt3DExtras::Qt3DWindow::widthChanged, lineMaterial, updateViewport );
187 QObject::connect( window, &Qt3DExtras::Qt3DWindow::heightChanged, lineMaterial, updateViewport );
188 updateViewport();
189 }
190
191 return root;
192}
193
194bool QgsSimpleLineMaterial3DHandler::updatePreviewScene( Qt3DCore::QEntity *sceneRoot, const QgsAbstractMaterialSettings *settings, const QgsMaterialContext & ) const
195{
196 const QgsSimpleLineMaterialSettings *lineSettings = qgis::down_cast< const QgsSimpleLineMaterialSettings * >( settings );
197
198 const QList<QgsLineMaterial *> materials = sceneRoot->findChildren<QgsLineMaterial *>();
199 for ( QgsLineMaterial *material : materials )
200 material->setLineColor( lineSettings->ambient() );
201
202 return true;
203}
MaterialRenderingTechnique
Material rendering techniques.
Definition qgis.h:4453
@ Points
Point based rendering, requires point data.
Definition qgis.h:4457
@ Triangles
Triangle based rendering (default).
Definition qgis.h:4454
@ TrianglesFromModel
Triangle based rendering, using a model object source.
Definition qgis.h:4459
@ Lines
Line based rendering, requires line data.
Definition qgis.h:4455
@ Billboards
Flat billboard rendering.
Definition qgis.h:4461
@ TrianglesDataDefined
Triangle based rendering with possibility of datadefined color.
Definition qgis.h:4460
@ InstancedPoints
Instanced based rendering, requiring triangles and point data.
Definition qgis.h:4456
@ TrianglesWithFixedTexture
Triangle based rendering, using a fixed, non-user-configurable texture (e.g. for terrain rendering).
Definition qgis.h:4458
static QColor srgbToLinear(const QColor &color)
Converts a SRGB color to a linear color.
Abstract base class for material settings.
QgsPropertyCollection dataDefinedProperties() const
Returns the symbol material property collection, used for data defined overrides.
QColor valueAsColor(int key, const QgsExpressionContext &context, const QColor &defaultColor=QColor(), bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as a color.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
Line string geometry type, with support for z-dimension and m-values.
Context settings for a material.
QColor selectionColor() const
Returns the color for representing materials in a selected state.
bool isSelected() const
Returns true if the material should represent a selected state.
bool isHighlighted() const
Returns true if the material should represent a highlighted state.
Base class for all materials used within QGIS 3D views.
Definition qgsmaterial.h:40
bool isActive(int key) const final
Returns true if the collection contains an active property with the specified key.
QMap< QString, QString > toExportParameters(const QgsAbstractMaterialSettings *settings) const override
Returns the parameters to be exported to .mtl file.
QList< PreviewMeshType > previewMeshTypes() const override
Returns a list of available preview mesh types for the material.
QByteArray dataDefinedVertexColorsAsByte(const QgsAbstractMaterialSettings *settings, const QgsExpressionContext &expressionContext) const override
Returns byte array corresponding to the data defined colors depending of the expressionContext,...
bool updatePreviewScene(Qt3DCore::QEntity *sceneRoot, const QgsAbstractMaterialSettings *settings, const QgsMaterialContext &context) const override
Updates an existing material preview scene with new material settings.
QgsMaterial * toMaterial(const QgsAbstractMaterialSettings *settings, Qgis::MaterialRenderingTechnique technique, const QgsMaterialContext &context) const override
Creates a new QgsMaterial object representing the material settings.
Qt3DCore::QEntity * createPreviewScene(const QgsAbstractMaterialSettings *settings, const QString &type, const QgsMaterialContext &context, QWindow *window, Qt3DCore::QEntity *parent) const override
Builds a complete self-contained scene for previewing the material, using the specified mesh type.
void applyDataDefinedToGeometry(const QgsAbstractMaterialSettings *settings, Qt3DCore::QGeometry *geometry, int vertexCount, const QByteArray &data) const override
Applies the data defined bytes, dataDefinedBytes, on the geometry by filling a specific vertex buffer...
Qt3DCore::QEntity * createPreviewMesh(const QString &type, Qt3DCore::QEntity *parent) const override
Creates a new entity representing a suitable preview mesh for this material type.
Basic shading material used for rendering simple lines as solid line components.
QColor ambient() const
Returns the ambient color component.
Encapsulates information about available preview meshes.
QString displayName
Translated, user-friendly name.