3 Basic shading material used for rendering based on the Phong shading model with three color components: ambient, diffuse and specular. More...

#include <qgsphongmaterialsettings.h>

Inheritance diagram for QgsPhongMaterialSettings:

[legend]

Public Member Functions
	QgsPhongMaterialSettings ()=default
	Constructor for QgsPhongMaterialSettings. More...

void	addParametersToEffect (Qt3DRender::QEffect *effect) const override
	Adds parameters from the material to a destination effect. More...

QColor	ambient () const
	Returns ambient color component. More...

QgsPhongMaterialSettings *	clone () const override
	Clones the material settings. More...

QColor	diffuse () const
	Returns diffuse color component. More...

bool	operator== (const QgsPhongMaterialSettings &other) const

void	readXml (const QDomElement &elem, const QgsReadWriteContext &context) override
	Reads settings from a DOM element. More...

void	setAmbient (const QColor &ambient)
	Sets ambient color component. More...

void	setDiffuse (const QColor &diffuse)
	Sets diffuse color component. More...

void	setShininess (float shininess)
	Sets shininess of the surface. More...

void	setSpecular (const QColor &specular)
	Sets specular color component. More...

float	shininess () const
	Returns shininess of the surface. More...

QColor	specular () const
	Returns specular color component. More...

QMap< QString, QString >	toExportParameters () const override
	Returns the parameters to be exported to .mtl file. More...

Qt3DRender::QMaterial *	toMaterial (QgsMaterialSettingsRenderingTechnique technique, const QgsMaterialContext &context) const override
	Creates a new QMaterial object representing the material settings. More...

QString	type () const override
	Returns the unique type name for the material. More...

void	writeXml (QDomElement &elem, const QgsReadWriteContext &context) const override
	Writes settings to a DOM element. More...

Public Member Functions inherited from QgsAbstractMaterialSettings
virtual	~QgsAbstractMaterialSettings ()=default

Static Public Member Functions
static QgsAbstractMaterialSettings *	create ()
	Returns a new instance of QgsPhongMaterialSettings. More...

static bool	supportsTechnique (QgsMaterialSettingsRenderingTechnique technique)
	Returns `true` if the specified technique is supported by the Phong material. More...

Detailed Description

3 Basic shading material used for rendering based on the Phong shading model with three color components: ambient, diffuse and specular.

Warning: This is not considered stable API, and may change in future QGIS releases. It is exposed to the Python bindings as a tech preview only.

Since: QGIS 3.0

Definition at line 36 of file qgsphongmaterialsettings.h.

Constructor & Destructor Documentation

◆ QgsPhongMaterialSettings()

QgsPhongMaterialSettings::QgsPhongMaterialSettings ( )

default

Constructor for QgsPhongMaterialSettings.

Member Function Documentation

◆ addParametersToEffect()

void QgsPhongMaterialSettings::addParametersToEffect ( Qt3DRender::QEffect * effect ) const

overridevirtual

Adds parameters from the material to a destination effect.

Implements QgsAbstractMaterialSettings.

Definition at line 117 of file qgsphongmaterialsettings.cpp.

◆ ambient()

QColor QgsPhongMaterialSettings::ambient ( ) const

inline

Returns ambient color component.

Definition at line 60 of file qgsphongmaterialsettings.h.

◆ clone()

QgsPhongMaterialSettings * QgsPhongMaterialSettings::clone ( ) const

overridevirtual

Clones the material settings.

Caller takes ownership of the returned object.

Implements QgsAbstractMaterialSettings.

Definition at line 54 of file qgsphongmaterialsettings.cpp.

◆ create()

QgsAbstractMaterialSettings * QgsPhongMaterialSettings::create ( )

static

Returns a new instance of QgsPhongMaterialSettings.

Definition at line 49 of file qgsphongmaterialsettings.cpp.

◆ diffuse()

QColor QgsPhongMaterialSettings::diffuse ( ) const

inline

Returns diffuse color component.

Definition at line 62 of file qgsphongmaterialsettings.h.

◆ operator==()

bool QgsPhongMaterialSettings::operator== ( const QgsPhongMaterialSettings & other ) const

inline

Definition at line 86 of file qgsphongmaterialsettings.h.

◆ readXml()

void QgsPhongMaterialSettings::readXml	(	const QDomElement &	element,
		const QgsReadWriteContext &	context
	)

overridevirtual

Reads settings from a DOM element.

Implements QgsAbstractMaterialSettings.

Definition at line 59 of file qgsphongmaterialsettings.cpp.

◆ setAmbient()

void QgsPhongMaterialSettings::setAmbient ( const QColor & ambient )

inline

Sets ambient color component.

Definition at line 71 of file qgsphongmaterialsettings.h.

◆ setDiffuse()

void QgsPhongMaterialSettings::setDiffuse ( const QColor & diffuse )

inline

Sets diffuse color component.

Definition at line 73 of file qgsphongmaterialsettings.h.

◆ setShininess()

void QgsPhongMaterialSettings::setShininess ( float shininess )

inline

Sets shininess of the surface.

Definition at line 77 of file qgsphongmaterialsettings.h.

◆ setSpecular()

void QgsPhongMaterialSettings::setSpecular ( const QColor & specular )

inline

Sets specular color component.

Definition at line 75 of file qgsphongmaterialsettings.h.

◆ shininess()

float QgsPhongMaterialSettings::shininess ( ) const

inline

Returns shininess of the surface.

Definition at line 66 of file qgsphongmaterialsettings.h.

◆ specular()

QColor QgsPhongMaterialSettings::specular ( ) const

inline

Returns specular color component.

Definition at line 64 of file qgsphongmaterialsettings.h.

◆ supportsTechnique()

bool QgsPhongMaterialSettings::supportsTechnique ( QgsMaterialSettingsRenderingTechnique technique )

static

Returns true if the specified technique is supported by the Phong material.

Definition at line 33 of file qgsphongmaterialsettings.cpp.

◆ toExportParameters()

QMap< QString, QString > QgsPhongMaterialSettings::toExportParameters ( ) const

overridevirtual

Returns the parameters to be exported to .mtl file.

Implements QgsAbstractMaterialSettings.

Definition at line 107 of file qgsphongmaterialsettings.cpp.

◆ toMaterial()

Qt3DRender::QMaterial * QgsPhongMaterialSettings::toMaterial	(	QgsMaterialSettingsRenderingTechnique	technique,
		const QgsMaterialContext &	context
	)		const

overridevirtual

Creates a new QMaterial object representing the material settings.

The technique argument specifies the rendering technique which will be used with the returned material.

Implements QgsAbstractMaterialSettings.

Definition at line 76 of file qgsphongmaterialsettings.cpp.

◆ type()

QString QgsPhongMaterialSettings::type ( ) const

overridevirtual

Returns the unique type name for the material.

Implements QgsAbstractMaterialSettings.

Definition at line 28 of file qgsphongmaterialsettings.cpp.

◆ writeXml()

void QgsPhongMaterialSettings::writeXml	(	QDomElement &	element,
		const QgsReadWriteContext &	context
	)		const

overridevirtual

Writes settings to a DOM element.

Implements QgsAbstractMaterialSettings.

Definition at line 67 of file qgsphongmaterialsettings.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.16.0+99unstable/src/3d/materials/qgsphongmaterialsettings.h
/build/qgis-3.16.0+99unstable/src/3d/materials/qgsphongmaterialsettings.cpp

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ QgsPhongMaterialSettings()

Member Function Documentation

◆ addParametersToEffect()

◆ ambient()

◆ clone()

◆ create()

◆ diffuse()

◆ operator==()

◆ readXml()

◆ setAmbient()

◆ setDiffuse()

◆ setShininess()

◆ setSpecular()

◆ shininess()

◆ specular()

◆ supportsTechnique()

◆ toExportParameters()

◆ toMaterial()

◆ type()

◆ writeXml()