QGIS API Documentation 3.41.0-Master (cea29feecf2)
Loading...
Searching...
No Matches
qgsabstractmaterialsettings.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsabstractmaterialsettings.h
3 --------------------------------------
4 Date : July 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
16#ifndef QGSABSTRACTMATERIALSETTINGS_H
17#define QGSABSTRACTMATERIALSETTINGS_H
18
19#include "qgis_3d.h"
20#include "qgis_sip.h"
21
22#include <QColor>
24#include "qgsmaterial.h"
25
26class QDomElement;
28class QgsLineMaterial;
30
31#ifndef SIP_RUN
32#if QT_VERSION < QT_VERSION_CHECK( 6, 0, 0 )
33namespace Qt3DRender
34{
35 class QGeometry;
36}
37#else
38namespace Qt3DCore
39{
40 class QGeometry;
41}
42#endif
43#endif //SIP_RUN
44
60
61
71class _3D_EXPORT QgsMaterialContext
72{
73 public:
79 bool isSelected() const { return mIsSelected; }
80
86 void setIsSelected( bool isSelected ) { mIsSelected = isSelected; }
87
93 QColor selectionColor() const { return mSelectedColor; }
94
100 void setSelectionColor( const QColor &color ) { mSelectedColor = color; }
101
102 private:
103 bool mIsSelected = false;
104
105 QColor mSelectedColor;
106};
107
108
118{
119#ifdef SIP_RUN
121 if ( sipCpp->type() == QLatin1String( "gooch" ) )
122 {
123 sipType = sipType_QgsGoochMaterialSettings;
124 }
125 else if ( sipCpp->type() == QLatin1String( "phong" ) )
126 {
127 sipType = sipType_QgsPhongMaterialSettings;
128 }
129 else if ( sipCpp->type() == "phongtextured" )
130 {
131 sipType = sipType_QgsPhongTexturedMaterialSettings;
132 }
133 else if ( sipCpp->type() == "simpleline" )
134 {
135 sipType = sipType_QgsSimpleLineMaterialSettings;
136 }
137 else if ( sipCpp->type() == "null" )
138 {
139 sipType = sipType_QgsNullMaterialSettings;
140 }
141 else
142 {
143 sipType = 0;
144 }
145 SIP_END
146#endif
147
148 public:
149 virtual ~QgsAbstractMaterialSettings() = default;
150
154 virtual QString type() const = 0;
155
162
164 virtual void readXml( const QDomElement &element, const QgsReadWriteContext & );
165
167 virtual void writeXml( QDomElement &element, const QgsReadWriteContext & ) const;
168
174 virtual bool equals( const QgsAbstractMaterialSettings *other ) const = 0;
175
176#ifndef SIP_RUN
177
185
189 virtual QMap<QString, QString> toExportParameters() const = 0;
190
194 virtual void addParametersToEffect( Qt3DRender::QEffect *effect, const QgsMaterialContext &materialContext ) const = 0;
195
196 // *INDENT-OFF*
199 {
200 Diffuse,
201 Ambient,
202 Warm,
203 Cool,
204 Specular
205 };
206 // *INDENT-ON*
207
212 void setDataDefinedProperties( const QgsPropertyCollection &collection );
213
218 QgsPropertyCollection dataDefinedProperties() const;
219
224 const QgsPropertiesDefinition &propertyDefinitions() const;
225
230#if QT_VERSION < QT_VERSION_CHECK( 6, 0, 0 )
231 virtual void applyDataDefinedToGeometry( Qt3DRender::QGeometry *geometry, int vertexCount, const QByteArray &dataDefinedBytes ) const;
232#else
233 virtual void applyDataDefinedToGeometry( Qt3DCore::QGeometry *geometry, int vertexCount, const QByteArray &dataDefinedBytes ) const;
234#endif
235
242 virtual QByteArray dataDefinedVertexColorsAsByte( const QgsExpressionContext &expressionContext ) const;
243
248 virtual int dataDefinedByteStride() const { return 0; }
249#endif
250
251 private:
252 QgsPropertyCollection mDataDefinedProperties;
253 static QgsPropertiesDefinition sPropertyDefinitions;
254 void initPropertyDefinitions() const;
255};
256
257
258#endif // QGSABSTRACTMATERIALSETTINGS_H
virtual bool equals(const QgsAbstractMaterialSettings *other) const =0
Returns true if this settings exactly matches an other settings.
virtual QMap< QString, QString > toExportParameters() const =0
Returns the parameters to be exported to .mtl file.
virtual QgsAbstractMaterialSettings * clone() const =0
Clones the material settings.
virtual int dataDefinedByteStride() const
Returns byte stride of the data defined colors,used to fill the vertex colors data defined buffer for...
virtual void addParametersToEffect(Qt3DRender::QEffect *effect, const QgsMaterialContext &materialContext) const =0
Adds parameters from the material to a destination effect.
virtual ~QgsAbstractMaterialSettings()=default
virtual QString type() const =0
Returns the unique type name for the material.
virtual QgsMaterial * toMaterial(QgsMaterialSettingsRenderingTechnique technique, const QgsMaterialContext &context) const =0
Creates a new QgsMaterial object representing the material settings.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
QColor selectionColor() const
Returns the color for representing materials in a selected state.
void setIsSelected(bool isSelected)
Sets whether the material should represent a selected state.
void setSelectionColor(const QColor &color)
Sets the color for representing materials in a selected state.
bool isSelected() const
Returns true if the material should represent a selected state.
A grouped map of multiple QgsProperty objects, each referenced by a integer key value.
The class is used as a container of context for various read/write operations on other objects.
QgsMaterialSettingsRenderingTechnique
Material rendering techniques 3.
@ Points
Point based rendering, requires point data.
@ Triangles
Triangle based rendering (default)
@ TrianglesFromModel
Triangle based rendering, using a model object source.
@ Lines
Line based rendering, requires line data.
@ TrianglesDataDefined
Triangle based rendering with possibility of datadefined color.
@ InstancedPoints
Instanced based rendering, requiring triangles and point data.
@ TrianglesWithFixedTexture
Triangle based rendering, using a fixed, non-user-configurable texture (e.g. for terrain rendering)
#define SIP_CONVERT_TO_SUBCLASS_CODE(code)
Definition qgis_sip.h:191
#define SIP_MONKEYPATCH_SCOPEENUM_UNNEST(OUTSIDE_CLASS, FORMERNAME)
Definition qgis_sip.h:271
#define SIP_ABSTRACT
Definition qgis_sip.h:213
#define SIP_FACTORY
Definition qgis_sip.h:76
#define SIP_END
Definition qgis_sip.h:208
QMap< int, QgsPropertyDefinition > QgsPropertiesDefinition
Definition of available properties.