QGIS API Documentation 4.1.0-Master (3b8ef1f72a3)
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
152 void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
153 void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const override;
154
155 // TODO c++20 - replace with = default
156 bool operator==( const QgsPhongMaterialSettings &other ) const
157 {
158 return mAmbient == other.mAmbient
159 && mDiffuse == other.mDiffuse
160 && mOpacity == other.mOpacity
161 && mSpecular == other.mSpecular
162 && mShininess == other.mShininess
163 && mAmbientCoefficient == other.mAmbientCoefficient
164 && mDiffuseCoefficient == other.mDiffuseCoefficient
165 && mSpecularCoefficient == other.mSpecularCoefficient
167 }
168
169 private:
170 QColor mAmbient { QColor::fromRgbF( 0.1f, 0.1f, 0.1f, 1.0f ) };
171 QColor mDiffuse { QColor::fromRgbF( 0.7f, 0.7f, 0.7f, 1.0f ) };
172 QColor mSpecular { QColor::fromRgbF( 1.0f, 1.0f, 1.0f, 1.0f ) };
173 double mShininess = 0.0;
174
175 double mAmbientCoefficient = 1.0;
176 double mDiffuseCoefficient = 1.0;
177 double mSpecularCoefficient = 1.0;
178
179 double mOpacity = 1.0;
180};
181
182
183#endif // QGSPHONGMATERIALSETTINGS_H
MaterialRenderingTechnique
Material rendering techniques.
Definition qgis.h:4327
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 QString type() const =0
Returns the unique type name for the material.
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