QGIS API Documentation 4.1.0-Master (31622b25bb0)
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;
55
57 QColor ambient() const { return mAmbient; }
59 QColor diffuse() const { return mDiffuse; }
61 QColor specular() const { return mSpecular; }
63 double shininess() const { return mShininess; }
64
69 double opacity() const { return mOpacity; }
70
80 double ambientCoefficient() const { return mAmbientCoefficient; }
81
91 double diffuseCoefficient() const { return mDiffuseCoefficient; }
92
102 double specularCoefficient() const { return mSpecularCoefficient; }
103
105 void setAmbient( const QColor &ambient ) { mAmbient = ambient; }
107 void setDiffuse( const QColor &diffuse ) { mDiffuse = diffuse; }
109 void setSpecular( const QColor &specular ) { mSpecular = specular; }
111 void setShininess( double shininess ) { mShininess = shininess; }
112
117 void setOpacity( double opacity ) { mOpacity = opacity; }
118
128 void setAmbientCoefficient( double coefficient ) { mAmbientCoefficient = coefficient; }
129
139 void setDiffuseCoefficient( double coefficient ) { mDiffuseCoefficient = coefficient; }
140
150 void setSpecularCoefficient( double coefficient ) { mSpecularCoefficient = coefficient; }
151
164 QColor averageColor() const override;
165
182 void setColorsFromBase( const QColor &baseColor, float metallic );
183
199 void setColorsFromBase( const QColor &baseColor ) override;
200
201 void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
202 void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const override;
203
204 // TODO c++20 - replace with = default
205 bool operator==( const QgsPhongMaterialSettings &other ) const
206 {
207 return mAmbient == other.mAmbient
208 && mDiffuse == other.mDiffuse
209 && mOpacity == other.mOpacity
210 && mSpecular == other.mSpecular
211 && mShininess == other.mShininess
212 && mAmbientCoefficient == other.mAmbientCoefficient
213 && mDiffuseCoefficient == other.mDiffuseCoefficient
214 && mSpecularCoefficient == other.mSpecularCoefficient
216 }
217
218 private:
219 QColor mAmbient { QColor::fromRgbF( 0.1f, 0.1f, 0.1f, 1.0f ) };
220 QColor mDiffuse { QColor::fromRgbF( 0.7f, 0.7f, 0.7f, 1.0f ) };
221 QColor mSpecular { QColor::fromRgbF( 1.0f, 1.0f, 1.0f, 1.0f ) };
222 double mShininess = 0.0;
223
224 double mAmbientCoefficient = 1.0;
225 double mDiffuseCoefficient = 1.0;
226 double mSpecularCoefficient = 1.0;
227
228 double mOpacity = 1.0;
229};
230
231
232#endif // QGSPHONGMATERIALSETTINGS_H
MaterialRenderingTechnique
Material rendering techniques.
Definition qgis.h:4342
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
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