QGIS API Documentation 3.29.0-Master (da8bb1db43)
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_3d.h"
21
22#include <QColor>
23
24class QDomElement;
25
37{
38 public:
39
44
45 QString type() const override;
46
50 static bool supportsTechnique( QgsMaterialSettingsRenderingTechnique technique );
51
56
57 QgsPhongMaterialSettings *clone() const override SIP_FACTORY;
58
60 QColor ambient() const { return mAmbient; }
62 QColor diffuse() const { return mDiffuse; }
64 QColor specular() const { return mSpecular; }
66 float shininess() const { return mShininess; }
67
72 float opacity() const { return mOpacity; }
73
74 QMap<QString, QString> toExportParameters() const override;
75
77 void setAmbient( const QColor &ambient ) { mAmbient = ambient; }
79 void setDiffuse( const QColor &diffuse ) { mDiffuse = diffuse; }
81 void setSpecular( const QColor &specular ) { mSpecular = specular; }
83 void setShininess( float shininess ) { mShininess = shininess; }
84
89 void setOpacity( float opacity ) { mOpacity = opacity; }
90
91
92
93 void readXml( const QDomElement &elem, const QgsReadWriteContext &context ) override;
94 void writeXml( QDomElement &elem, const QgsReadWriteContext &context ) const override;
95
96#ifndef SIP_RUN
97 Qt3DRender::QMaterial *toMaterial( QgsMaterialSettingsRenderingTechnique technique, const QgsMaterialContext &context ) const override SIP_FACTORY;
98 void addParametersToEffect( Qt3DRender::QEffect *effect ) const override;
99
100 QByteArray dataDefinedVertexColorsAsByte( const QgsExpressionContext &expressionContext ) const override;
101 int dataDefinedByteStride() const override;
102#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
103 void applyDataDefinedToGeometry( Qt3DRender::QGeometry *geometry, int vertexCount, const QByteArray &data ) const override;
104#else
105 void applyDataDefinedToGeometry( Qt3DCore::QGeometry *geometry, int vertexCount, const QByteArray &data ) const override;
106#endif
107#endif
108
109 // TODO c++20 - replace with = default
110 bool operator==( const QgsPhongMaterialSettings &other ) const
111 {
112 return mAmbient == other.mAmbient &&
113 mDiffuse == other.mDiffuse &&
114 mOpacity == other.mOpacity &&
115 mSpecular == other.mSpecular &&
116 mShininess == other.mShininess;
117 }
118
119 private:
120 QColor mAmbient{ QColor::fromRgbF( 0.1f, 0.1f, 0.1f, 1.0f ) };
121 QColor mDiffuse{ QColor::fromRgbF( 0.7f, 0.7f, 0.7f, 1.0f ) };
122 QColor mSpecular{ QColor::fromRgbF( 1.0f, 1.0f, 1.0f, 1.0f ) };
123 float mShininess = 0.0f;
124 float mOpacity = 1.0f;
125
127 Qt3DRender::QMaterial *dataDefinedMaterial() const;
128};
129
130
131#endif // QGSPHONGMATERIALSETTINGS_H
virtual void writeXml(QDomElement &element, const QgsReadWriteContext &) const
Writes settings to a DOM element.
virtual QByteArray dataDefinedVertexColorsAsByte(const QgsExpressionContext &expressionContext) const
Returns byte array corresponding to the data defined colors depending of the expressionContext,...
virtual QMap< QString, QString > toExportParameters() const =0
Returns the parameters to be exported to .mtl file.
virtual void readXml(const QDomElement &element, const QgsReadWriteContext &)
Reads settings from a DOM element.
virtual int dataDefinedByteStride() const
Returns byte stride of the data defined colors,used to fill the vertex colors data defined buffer for...
virtual Qt3DRender::QMaterial * toMaterial(QgsMaterialSettingsRenderingTechnique technique, const QgsMaterialContext &context) const =0
Creates a new QMaterial object representing the material settings.
virtual QString type() const =0
Returns the unique type name for the material.
virtual void addParametersToEffect(Qt3DRender::QEffect *effect) const =0
Adds parameters from the material to a destination effect.
virtual void applyDataDefinedToGeometry(Qt3DCore::QGeometry *geometry, int vertexCount, const QByteArray &dataDefinedBytes) const
Applies the data defined bytes, dataDefinedBytes, on the geometry by filling a specific vertex buffer...
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
bool operator==(const QgsPhongMaterialSettings &other) const
void setDiffuse(const QColor &diffuse)
Sets diffuse color component.
QColor diffuse() const
Returns diffuse color component.
QColor specular() const
Returns specular color component.
void setOpacity(float opacity)
Sets opacity of the surface.
void setAmbient(const QColor &ambient)
Sets ambient color component.
float shininess() const
Returns shininess of the surface.
float opacity() const
Returns the opacity of the surface.
QgsPhongMaterialSettings()=default
Constructor for QgsPhongMaterialSettings.
void setShininess(float shininess)
Sets shininess of the surface.
void setSpecular(const QColor &specular)
Sets specular color component.
The class is used as a container of context for various read/write operations on other objects.
QgsMaterialSettingsRenderingTechnique
Material rendering techniques 3.
#define SIP_FACTORY
Definition: qgis_sip.h:76