A PBR metal rough shading material used for rendering. More...

#include <qgsmetalroughmaterialsettings.h>

Inheritance diagram for QgsMetalRoughMaterialSettings:

Public Member Functions
	QgsMetalRoughMaterialSettings ()=default
QColor	averageColor () const override
	Returns an approximate color representing the blended material color.
QColor	baseColor () const
	Returns the base material color.
QgsMetalRoughMaterialSettings *	clone () const override
	Clones the material settings.
QColor	emissionColor () const
	Returns the material's emissive color.
double	emissionFactor () const
	Returns the emission factor, which dictates the strength of the emission effect.
bool	equals (const QgsAbstractMaterialSettings *other) const override
	Returns `true` if this settings exactly matches an other settings.
double	metalness () const
	Returns the material's metalness, as a value between 0 and 1.
double	opacity () const
	Returns the opacity of the surface.
bool	operator== (const QgsMetalRoughMaterialSettings &other) const
void	readXml (const QDomElement &elem, const QgsReadWriteContext &context) override
	Reads settings from a DOM element.
double	roughness () const
	Returns the material's roughness, as a value between 0 and 1.
void	setBaseColor (const QColor &color)
	Sets the base material color.
void	setColorsFromBase (const QColor &baseColor) override
	Decomposes a base color into the material's color components, and sets the material's color accordingly.
void	setEmissionColor (const QColor &color)
	Sets the material's emissive color.
void	setEmissionFactor (double factor)
	Sets the emission factor, which dictates the strength of the emission effect.
void	setMetalness (double metalness)
	Sets the material's metalness, as a value between 0 and 1.
void	setOpacity (double opacity)
	Sets the opacity of the surface.
void	setRoughness (double roughness)
	Sets the material's roughness, as a value between 0 and 1.
QString	type () const override
	Returns the unique type name for the material.
void	writeXml (QDomElement &elem, const QgsReadWriteContext &context) const override
	Writes settings to a DOM element.
Public Member Functions inherited from QgsAbstractMaterialSettings
virtual	~QgsAbstractMaterialSettings ()=default
QgsPropertyCollection	dataDefinedProperties () const
	Returns the symbol material property collection, used for data defined overrides.
const QgsPropertiesDefinition &	propertyDefinitions () const
	Returns a reference to the material properties definition, used for data defined overrides.
virtual bool	requiresTangents () const
	Returns `true` if the material requires tangents generated during triangulation.
virtual bool	requiresTextureCoordinates () const
	Returns `true` if the material requires texture coordinates to be generated during triangulation.
void	setDataDefinedProperties (const QgsPropertyCollection &collection)
	Sets the material property collection, used for data defined overrides.

Static Public Member Functions
static QgsAbstractMaterialSettings *	create ()
	Returns a new instance of QgsMetalRoughMaterialSettings.
static bool	supportsTechnique (Qgis::MaterialRenderingTechnique technique)
	Returns `true` if the specified technique is supported by the metal rough material.

Additional Inherited Members
Public Types inherited from QgsAbstractMaterialSettings
enum class	Property : int { Diffuse , Ambient , Warm , Cool , Specular , BaseColor , EmissionColor }
	Data definable properties. More...

Detailed Description

A PBR metal rough shading material used for rendering.

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.36

Definition at line 35 of file qgsmetalroughmaterialsettings.h.

Constructor & Destructor Documentation

◆ QgsMetalRoughMaterialSettings()

QgsMetalRoughMaterialSettings::QgsMetalRoughMaterialSettings ( )

default

Member Function Documentation

◆ averageColor()

QColor QgsMetalRoughMaterialSettings::averageColor ( ) const

overridevirtual

Returns an approximate color representing the blended material color.

Since this material contains only a single color, this function simply returns baseColor().

See also: baseColor()

Since: QGIS 4.2

Implements QgsAbstractMaterialSettings.

Definition at line 101 of file qgsmetalroughmaterialsettings.cpp.

◆ baseColor()

QColor QgsMetalRoughMaterialSettings::baseColor ( ) const

inline

Returns the base material color.

See also: setBaseColor()

Definition at line 60 of file qgsmetalroughmaterialsettings.h.

◆ clone()

QgsMetalRoughMaterialSettings * QgsMetalRoughMaterialSettings::clone ( ) const

overridevirtual

Clones the material settings.

Caller takes ownership of the returned object.

Implements QgsAbstractMaterialSettings.

Definition at line 53 of file qgsmetalroughmaterialsettings.cpp.

◆ create()

QgsAbstractMaterialSettings * QgsMetalRoughMaterialSettings::create ( )

static

Returns a new instance of QgsMetalRoughMaterialSettings.

Definition at line 48 of file qgsmetalroughmaterialsettings.cpp.

◆ emissionColor()

QColor QgsMetalRoughMaterialSettings::emissionColor ( ) const

inline

Returns the material's emissive color.

See also: setEmissionColor()

Since: QGIS 4.2

Definition at line 82 of file qgsmetalroughmaterialsettings.h.

◆ emissionFactor()

double QgsMetalRoughMaterialSettings::emissionFactor ( ) const

inline

Returns the emission factor, which dictates the strength of the emission effect.

A value of 1.0 indicates that the emission color values should be used directly. Larger values result in more light emission.

See also: setEmissionFactor(); emissionColor()

Since: QGIS 4.2

Definition at line 95 of file qgsmetalroughmaterialsettings.h.

◆ equals()

bool QgsMetalRoughMaterialSettings::equals ( const QgsAbstractMaterialSettings * other ) const

overridevirtual

Returns true if this settings exactly matches an other settings.

Since: QGIS 3.42

Implements QgsAbstractMaterialSettings.

Definition at line 58 of file qgsmetalroughmaterialsettings.cpp.

◆ metalness()

double QgsMetalRoughMaterialSettings::metalness ( ) const

inline

Returns the material's metalness, as a value between 0 and 1.

See also: setMetalness()

Definition at line 67 of file qgsmetalroughmaterialsettings.h.

◆ opacity()

double QgsMetalRoughMaterialSettings::opacity ( ) const

inline

Returns the opacity of the surface.

See also: setOpacity()

Since: QGIS 4.2

Definition at line 103 of file qgsmetalroughmaterialsettings.h.

◆ operator==()

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

inline

Definition at line 184 of file qgsmetalroughmaterialsettings.h.

◆ readXml()

void QgsMetalRoughMaterialSettings::readXml	(	const QDomElement &	element,
		const QgsReadWriteContext &	)

overridevirtual

Reads settings from a DOM element.

Reimplemented from QgsAbstractMaterialSettings.

Definition at line 67 of file qgsmetalroughmaterialsettings.cpp.

◆ roughness()

double QgsMetalRoughMaterialSettings::roughness ( ) const

inline

Returns the material's roughness, as a value between 0 and 1.

See also: setRoughness()

Definition at line 74 of file qgsmetalroughmaterialsettings.h.

◆ setBaseColor()

void QgsMetalRoughMaterialSettings::setBaseColor ( const QColor & color )

inline

Sets the base material color.

See also: baseColor()

Definition at line 122 of file qgsmetalroughmaterialsettings.h.

◆ setColorsFromBase()

void QgsMetalRoughMaterialSettings::setColorsFromBase ( const QColor & baseColor )

overridevirtual

Decomposes a base color into the material's color components, and sets the material's color accordingly.

Since this material contains only a single color, this function is equivalent to calling setBaseColor(baseColor).

Parameters

baseColor The color to decompose

See also: setBaseColor()

Since: QGIS 4.2

Implements QgsAbstractMaterialSettings.

Definition at line 106 of file qgsmetalroughmaterialsettings.cpp.

◆ setEmissionColor()

void QgsMetalRoughMaterialSettings::setEmissionColor ( const QColor & color )

inline

Sets the material's emissive color.

See also: emissionColor()

Since: QGIS 4.2

Definition at line 152 of file qgsmetalroughmaterialsettings.h.

◆ setEmissionFactor()

void QgsMetalRoughMaterialSettings::setEmissionFactor ( double factor )

inline

Sets the emission factor, which dictates the strength of the emission effect.

A value of 1.0 indicates that the emission color values should be used directly. Larger values result in more light emission.

See also: emissionFactor(); setEmissionColor()

Since: QGIS 4.2

Definition at line 165 of file qgsmetalroughmaterialsettings.h.

◆ setMetalness()

void QgsMetalRoughMaterialSettings::setMetalness ( double metalness )

inline

Sets the material's metalness, as a value between 0 and 1.

See also: metalness()

Definition at line 129 of file qgsmetalroughmaterialsettings.h.

◆ setOpacity()

void QgsMetalRoughMaterialSettings::setOpacity ( double opacity )

inline

Sets the opacity of the surface.

See also: opacity()

Since: QGIS 4.2

Definition at line 144 of file qgsmetalroughmaterialsettings.h.

◆ setRoughness()

void QgsMetalRoughMaterialSettings::setRoughness ( double roughness )

inline

Sets the material's roughness, as a value between 0 and 1.

See also: roughness()

Definition at line 136 of file qgsmetalroughmaterialsettings.h.

◆ supportsTechnique()

bool QgsMetalRoughMaterialSettings::supportsTechnique ( Qgis::MaterialRenderingTechnique technique )

static

Returns true if the specified technique is supported by the metal rough material.

Definition at line 29 of file qgsmetalroughmaterialsettings.cpp.

◆ type()

QString QgsMetalRoughMaterialSettings::type ( ) const

overridevirtual

Returns the unique type name for the material.

Implements QgsAbstractMaterialSettings.

Definition at line 24 of file qgsmetalroughmaterialsettings.cpp.

◆ writeXml()

void QgsMetalRoughMaterialSettings::writeXml	(	QDomElement &	element,
		const QgsReadWriteContext &	) const

overridevirtual

Writes settings to a DOM element.

Reimplemented from QgsAbstractMaterialSettings.

Definition at line 82 of file qgsmetalroughmaterialsettings.cpp.

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

/build/qgis-4.1.0+git20260524+d6fb7a379fb+99sid/src/core/3d/materials/qgsmetalroughmaterialsettings.h
/build/qgis-4.1.0+git20260524+d6fb7a379fb+99sid/src/core/3d/materials/qgsmetalroughmaterialsettings.cpp

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ QgsMetalRoughMaterialSettings()

Member Function Documentation

◆ averageColor()

◆ baseColor()

◆ clone()

◆ create()

◆ emissionColor()

◆ emissionFactor()

◆ equals()

◆ metalness()

◆ opacity()

◆ operator==()

◆ readXml()

◆ roughness()

◆ setBaseColor()

◆ setColorsFromBase()

◆ setEmissionColor()

◆ setEmissionFactor()

◆ setMetalness()

◆ setOpacity()

◆ setRoughness()

◆ supportsTechnique()

◆ type()

◆ writeXml()