QGIS API Documentation 4.1.0-Master (3fcefe620d1)
Loading...
Searching...
No Matches
qgsphongmaterialsettings.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsphongmaterialsettings.h
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#ifndef QGSPHONGMATERIALSETTINGS_H
17#define QGSPHONGMATERIALSETTINGS_H
18
19#include "qgis_core.h"
21
22#include <QColor>
23
24class QgsMaterial;
25class QDomElement;
26
37{
38 public:
40
41 QString type() const override;
42
47
52
54 bool equals( const QgsAbstractMaterialSettings *other ) const override;
56
58 QColor ambient() const { return mAmbient; }
60 QColor diffuse() const { return mDiffuse; }
62 QColor specular() const { return mSpecular; }
64 double shininess() const { return mShininess; }
65
70 double opacity() const { return mOpacity; }
71
81 double ambientCoefficient() const { return mAmbientCoefficient; }
82
92 double diffuseCoefficient() const { return mDiffuseCoefficient; }
93
103 double specularCoefficient() const { return mSpecularCoefficient; }
104
106 void setAmbient( const QColor &ambient ) { mAmbient = ambient; }
108 void setDiffuse( const QColor &diffuse ) { mDiffuse = diffuse; }
110 void setSpecular( const QColor &specular ) { mSpecular = specular; }
112 void setShininess( double shininess ) { mShininess = shininess; }
113
118 void setOpacity( double opacity ) { mOpacity = opacity; }
119
129 void setAmbientCoefficient( double coefficient ) { mAmbientCoefficient = coefficient; }
130
140 void setDiffuseCoefficient( double coefficient ) { mDiffuseCoefficient = coefficient; }
141
151 void setSpecularCoefficient( double coefficient ) { mSpecularCoefficient = coefficient; }
152
165 QColor averageColor() const override;
166
183 void setColorsFromBase( const QColor &baseColor, float metallic );
184
200 void setColorsFromBase( const QColor &baseColor ) override;
201
202 void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
203 void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const override;
204
205 // TODO c++20 - replace with = default
206 bool operator==( const QgsPhongMaterialSettings &other ) const
207 {
208 return mAmbient == other.mAmbient
209 && mDiffuse == other.mDiffuse
210 && mOpacity == other.mOpacity
211 && mSpecular == other.mSpecular
212 && mShininess == other.mShininess
213 && mAmbientCoefficient == other.mAmbientCoefficient
214 && mDiffuseCoefficient == other.mDiffuseCoefficient
215 && mSpecularCoefficient == other.mSpecularCoefficient
217 }
218
219 private:
220 QColor mAmbient { QColor::fromRgbF( 0.1f, 0.1f, 0.1f, 1.0f ) };
221 QColor mDiffuse { QColor::fromRgbF( 0.7f, 0.7f, 0.7f, 1.0f ) };
222 QColor mSpecular { QColor::fromRgbF( 1.0f, 1.0f, 1.0f, 1.0f ) };
223 double mShininess = 0.0;
224
225 double mAmbientCoefficient = 1.0;
226 double mDiffuseCoefficient = 1.0;
227 double mSpecularCoefficient = 1.0;
228
229 double mOpacity = 1.0;
230};
231
232
233#endif // QGSPHONGMATERIALSETTINGS_H
MaterialRenderingTechnique
Material rendering techniques.
Definition qgis.h:4375
Abstract base class for material settings.
virtual void writeXml(QDomElement &element, const QgsReadWriteContext &) const
Writes settings to a DOM element.
virtual void readXml(const QDomElement &element, const QgsReadWriteContext &)
Reads settings from a DOM element.
virtual QColor averageColor() const =0
Returns an approximate color representing the blended material color.
virtual QString type() const =0
Returns the unique type name for the material.
virtual void setColorsFromBase(const QColor &baseColor)=0
Decomposes a base color into the material's color components, and sets the material's colors accordin...
QgsPropertyCollection dataDefinedProperties() const
Returns the symbol material property collection, used for data defined overrides.
Base class for all materials used within QGIS 3D views.
Definition qgsmaterial.h:40
QSet< QgsAbstractMaterialSettings::Property > supportedProperties() const override
Returns the set of data-defined properties supported by this material.
double ambientCoefficient() const
Returns the coefficient for the ambient color contribution (ie strength factor of the ambient color).
void setOpacity(double opacity)
Sets opacity of the surface.
bool operator==(const QgsPhongMaterialSettings &other) const
void setDiffuse(const QColor &diffuse)
Sets diffuse color component.
bool equals(const QgsAbstractMaterialSettings *other) const override
Returns true if this settings exactly matches an other settings.
void setDiffuseCoefficient(double coefficient)
Sets the coefficient for the diffuse color contribution (ie strength factor of the diffuse color).
void setShininess(double shininess)
Sets shininess of the surface.
QColor diffuse() const
Returns diffuse color component.
double opacity() const
Returns the opacity of the surface.
static bool supportsTechnique(Qgis::MaterialRenderingTechnique technique)
Returns true if the specified technique is supported by the Phong material.
QColor specular() const
Returns specular color component.
QColor ambient() const
Returns ambient color component.
void setAmbient(const QColor &ambient)
Sets ambient color component.
void setSpecularCoefficient(double coefficient)
Sets the coefficient for the specular color contribution (ie strength factor of the specular color).
double specularCoefficient() const
Returns the coefficient for the specular color contribution (ie strength factor of the specular color...
static QgsAbstractMaterialSettings * create()
Returns a new instance of QgsPhongMaterialSettings.
QgsPhongMaterialSettings * clone() const override
Clones the material settings.
double shininess() const
Returns shininess of the surface.
QgsPhongMaterialSettings()=default
double diffuseCoefficient() const
Returns the coefficient for the diffuse color contribution (ie strength factor of the diffuse color).
void setSpecular(const QColor &specular)
Sets specular color component.
void setAmbientCoefficient(double coefficient)
Sets the coefficient for the ambient color contribution (ie strength factor of the ambient color).
A container for the context for various read/write operations on objects.
#define SIP_FACTORY
Definition qgis_sip.h:83