QgsMaterialSettingsMetadata Class Reference

Convenience metadata class that uses static functions to create a 3D material settings object and its widget. More...

#include <qgsmaterialregistry.h>

Inheritance diagram for QgsMaterialSettingsMetadata:

Public Member Functions
	QgsMaterialSettingsMetadata (const QString &type, const QString &visibleName, QgsMaterialSettingsCreateFunc pfCreate, QgsMaterialSettingsSupportsTechniqueFunc pfSupportsTechnique, QgsMaterialSettingsWidgetFunc pfWidget=nullptr, const QIcon &icon=QIcon())
	Constructor for QgsMaterialSettingsMetadata, with the specified type and visibleName.
QgsAbstractMaterialSettings *	create () override
	Creates a new instance of this material settings type.
QgsMaterialSettingsCreateFunc	createFunction () const
	Returns the material settings' creation function.
QgsMaterialSettingsWidget *	createWidget () override
	Create a widget for configuring a material of this type.
const QgsAbstractMaterial3DHandler *	handler () const
	Returns the material settings' 3D handler.
void	setHandler (QgsAbstractMaterial3DHandler *handler)
	Sets the material settings' 3D handler.
void	setWidgetFunction (QgsMaterialSettingsWidgetFunc function)
	Sets the material settings' widget creation function.
bool	supportsTechnique (Qgis::MaterialRenderingTechnique technique) const override
	Returns true if the material type supports the specified rendering technique.
QgsMaterialSettingsWidgetFunc	widgetFunction () const
	Returns the material settings' widget creation function.
Public Member Functions inherited from QgsMaterialSettingsAbstractMetadata
	QgsMaterialSettingsAbstractMetadata (const QString &type, const QString &visibleName, const QIcon &icon=QIcon())
	Constructor for QgsMaterialSettingsAbstractMetadata, with the specified type and visibleName.
virtual	~QgsMaterialSettingsAbstractMetadata ()=default
QIcon	icon () const
	Returns an icon representing the material type, if available.
virtual const QgsAbstractMaterial3DHandler *	material3DHandler ()
	Returns 3D handler relating to the material.
QString	type () const
	Returns the unique material type string.
QString	visibleName () const
	Returns the material's visible (translated) name.

Detailed Description

Convenience metadata class that uses static functions to create a 3D material settings object and its widget.

Note

Not available in Python bindings.

Since

QGIS 3.16

Definition at line 133 of file qgsmaterialregistry.h.

Constructor & Destructor Documentation

QgsMaterialSettingsMetadata()

QgsMaterialSettingsMetadata::QgsMaterialSettingsMetadata ( const QString & type, const QString & visibleName, QgsMaterialSettingsCreateFunc pfCreate, QgsMaterialSettingsSupportsTechniqueFunc pfSupportsTechnique, QgsMaterialSettingsWidgetFunc pfWidget = nullptr, const QIcon & icon = QIcon() )

inline

Constructor for QgsMaterialSettingsMetadata, with the specified type and visibleName.

The pfCreate, pfSupportsTechnique and pfWidget arguments are used to specify static functions for creating the material settings type and configuration widget.

An optional icon can be specified to represent the material type.

Definition at line 144 of file qgsmaterialregistry.h.

Member Function Documentation

create()

QgsAbstractMaterialSettings * QgsMaterialSettingsMetadata::create ( )

inlineoverridevirtual

Creates a new instance of this material settings type.

Caller takes ownership of the returned object.

Implements QgsMaterialSettingsAbstractMetadata.

Definition at line 191 of file qgsmaterialregistry.h.

createFunction()

QgsMaterialSettingsCreateFunc QgsMaterialSettingsMetadata::createFunction ( ) const

inline

Returns the material settings' creation function.

Definition at line 161 of file qgsmaterialregistry.h.

createWidget()

QgsMaterialSettingsWidget * QgsMaterialSettingsMetadata::createWidget ( )

inlineoverridevirtual

Create a widget for configuring a material of this type.

Can return nullptr if there's no GUI.

Note

Not available in Python bindings

Reimplemented from QgsMaterialSettingsAbstractMetadata.

Definition at line 193 of file qgsmaterialregistry.h.

handler()

const QgsAbstractMaterial3DHandler * QgsMaterialSettingsMetadata::handler ( ) const

inline

Returns the material settings' 3D handler.

See also

setHandler()

Definition at line 182 of file qgsmaterialregistry.h.

setHandler()

void QgsMaterialSettingsMetadata::setHandler ( QgsAbstractMaterial3DHandler * handler )

inline

Sets the material settings' 3D handler.

See also

handler()

Definition at line 189 of file qgsmaterialregistry.h.

setWidgetFunction()

void QgsMaterialSettingsMetadata::setWidgetFunction ( QgsMaterialSettingsWidgetFunc function )

inline

Sets the material settings' widget creation function.

See also

widgetFunction()

Definition at line 175 of file qgsmaterialregistry.h.

supportsTechnique()

bool QgsMaterialSettingsMetadata::supportsTechnique ( Qgis::MaterialRenderingTechnique technique ) const

inlineoverridevirtual

Returns true if the material type supports the specified rendering technique.

Implements QgsMaterialSettingsAbstractMetadata.

Definition at line 192 of file qgsmaterialregistry.h.

widgetFunction()

QgsMaterialSettingsWidgetFunc QgsMaterialSettingsMetadata::widgetFunction ( ) const

inline

Returns the material settings' widget creation function.

See also

setWidgetFunction()

Definition at line 168 of file qgsmaterialregistry.h.

---

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

• /build/qgis-4.1.0+git20260503+376402f9aeb+99sid/src/core/3d/materials/qgsmaterialregistry.h